kybernus 2.0.10 → 2.1.1

package/templates/java-spring/hexagonal/src/main/java/{{packagePath}}/{domain/usecase → core/ports/inbound}/LoginUserUseCase.java.hbs

@@ -1,10 +1,10 @@
-package {{packageName}}.domain.usecase;
+package {{packageName}}.core.ports.inbound;
 
-import {{packageName}}.domain.entity.User;
-import {{packageName}}.domain.repository.UserRepository;
+import {{packageName}}.core.domain.User;
+import {{packageName}}.core.ports.outbound.UserRepository;
 
 /**
-* Login User Use Case - Domain Layer
+* Login User Use Case - Inbound Port
 */
 public class LoginUserUseCase {
     private final UserRepository userRepository;
@@ -12,8 +12,8 @@ public class LoginUserUseCase {
     private final RegisterUserUseCase.TokenGenerator tokenGenerator;
 
     public LoginUserUseCase(UserRepository userRepository,
-    RegisterUserUseCase.PasswordEncoder passwordEncoder,
-    RegisterUserUseCase.TokenGenerator tokenGenerator) {
+                            RegisterUserUseCase.PasswordEncoder passwordEncoder,
+                            RegisterUserUseCase.TokenGenerator tokenGenerator) {
         this.userRepository = userRepository;
         this.passwordEncoder = passwordEncoder;
         this.tokenGenerator = tokenGenerator;
@@ -24,7 +24,7 @@ public class LoginUserUseCase {
 
     public Output execute(Input input) {
         User user = userRepository.findByEmail(input.email())
-        .orElseThrow(() -> new IllegalArgumentException("Invalid credentials"));
+                .orElseThrow(() -> new IllegalArgumentException("Invalid credentials"));
 
         if (!passwordEncoder.matches(input.password(), user.getPassword())) {
             throw new IllegalArgumentException("Invalid credentials");
@@ -33,4 +33,4 @@ public class LoginUserUseCase {
         String token = tokenGenerator.generate(user.getId(), user.getEmail());
         return new Output(user, token);
     }
-}
+}

package/templates/java-spring/hexagonal/src/main/java/{{packagePath}}/{domain/usecase → core/ports/inbound}/RegisterUserUseCase.java.hbs

@@ -1,18 +1,17 @@
-package {{packageName}}.domain.usecase;
+package {{packageName}}.core.ports.inbound;
 
-import {{packageName}}.domain.entity.User;
-import {{packageName}}.domain.repository.UserRepository;
+import {{packageName}}.core.domain.User;
+import {{packageName}}.core.ports.outbound.UserRepository;
 
 /**
-* Register User Use Case - Domain Layer
+* Register User Use Case - Inbound Port
 */
 public class RegisterUserUseCase {
     private final UserRepository userRepository;
     private final PasswordEncoder passwordEncoder;
     private final TokenGenerator tokenGenerator;
 
-    public RegisterUserUseCase(UserRepository userRepository, PasswordEncoder passwordEncoder, TokenGenerator
-    tokenGenerator) {
+    public RegisterUserUseCase(UserRepository userRepository, PasswordEncoder passwordEncoder, TokenGenerator tokenGenerator) {
         this.userRepository = userRepository;
         this.passwordEncoder = passwordEncoder;
         this.tokenGenerator = tokenGenerator;
@@ -34,7 +33,7 @@ public class RegisterUserUseCase {
         return new Output(savedUser, token);
     }
 
-    // Port interfaces
+    // Port interfaces for needed services
     public interface PasswordEncoder {
         String encode(String rawPassword);
         boolean matches(String rawPassword, String encodedPassword);
@@ -43,4 +42,4 @@ public class RegisterUserUseCase {
     public interface TokenGenerator {
         String generate(String userId, String email);
     }
-}
+}

package/templates/java-spring/hexagonal/src/main/java/{{packagePath}}/{domain/repository → core/ports/outbound}/UserRepository.java.hbs

@@ -1,10 +1,10 @@
-package {{packageName}}.domain.repository;
+package {{packageName}}.core.ports.outbound;
 
-import {{packageName}}.domain.entity.User;
+import {{packageName}}.core.domain.User;
 import java.util.Optional;
 
 /**
-* User Repository Interface - Domain Layer
+* User Repository Port - Outbound
 * Defines the contract for user persistence
 */
 public interface UserRepository {
@@ -12,4 +12,4 @@ public interface UserRepository {
     Optional<User> findByEmail(String email);
     User save(User user);
     void delete(String id);
-}
+}

package/templates/java-spring/hexagonal/src/main/java/{{packagePath}}/{application → core}/service/AuthService.java.hbs

@@ -1,13 +1,13 @@
-package {{packageName}}.application.service;
+package {{packageName}}.core.service;
 
-import {{packageName}}.domain.entity.User;
-import {{packageName}}.domain.repository.UserRepository;
-import {{packageName}}.domain.usecase.LoginUserUseCase;
-import {{packageName}}.domain.usecase.RegisterUserUseCase;
+import {{packageName}}.core.domain.User;
+import {{packageName}}.core.ports.outbound.UserRepository;
+import {{packageName}}.core.ports.inbound.LoginUserUseCase;
+import {{packageName}}.core.ports.inbound.RegisterUserUseCase;
 import org.springframework.stereotype.Service;
 
 /**
-* Auth Service - Application Layer
+* Auth Service - Application Layer / Service
 * Orchestrates use cases
 */
 @Service
@@ -16,8 +16,8 @@ public class AuthService {
     private final LoginUserUseCase loginUserUseCase;
 
     public AuthService(UserRepository userRepository,
-    RegisterUserUseCase.PasswordEncoder passwordEncoder,
-    RegisterUserUseCase.TokenGenerator tokenGenerator) {
+                       RegisterUserUseCase.PasswordEncoder passwordEncoder,
+                       RegisterUserUseCase.TokenGenerator tokenGenerator) {
         this.registerUserUseCase = new RegisterUserUseCase(userRepository, passwordEncoder, tokenGenerator);
         this.loginUserUseCase = new LoginUserUseCase(userRepository, passwordEncoder, tokenGenerator);
     }
@@ -33,4 +33,4 @@ public class AuthService {
         var result = loginUserUseCase.execute(new LoginUserUseCase.Input(email, password));
         return new AuthResponse(result.token(), result.user().getId(), result.user().getEmail(), result.user().getName());
     }
-}
+}

package/templates/java-spring/hexagonal/src/main/java/{{packagePath}}/{{projectNamePascalCase}}Application.java.hbs

@@ -9,6 +9,6 @@ public class {{projectNamePascalCase}}Application {
     public static void main(String[] args) {
         SpringApplication.run({{projectNamePascalCase}}Application.class, args);
         System.out.println("🚀 {{projectNamePascalCase}} running!");
-        System.out.println("📐 Architecture: Clean Architecture");
+        System.out.println("🔷 Architecture: Hexagonal Architecture");
     }
-}
+}

package/templates/java-spring/hexagonal/src/main/resources/application.properties.hbs

@@ -0,0 +1,18 @@
+spring.application.name={{projectNameKebabCase}}
+
+# Database Configuration
+spring.datasource.url=jdbc:postgresql://postgres:5432/{{projectNameKebabCase}}
+spring.datasource.username=postgres
+spring.datasource.password=postgres
+spring.datasource.driver-class-name=org.postgresql.Driver
+
+# JPA / Hibernate
+spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
+spring.jpa.hibernate.ddl-auto=update
+spring.jpa.show-sql=true
+spring.jpa.properties.hibernate.format_sql=true
+
+# JWT
+application.security.jwt.secret-key={{jwtSecretKey}}
+application.security.jwt.expiration=86400000
+application.security.jwt.refresh-token.expiration=604800000

package/templates/nestjs/clean/package.json.hbs

@@ -7,7 +7,10 @@
     "build": "nest build",
     "start": "node dist/main.js",
     "lint": "eslint \"{src,test}/**/*.ts\"",
-    "test": "jest"
+    "test": "jest",
+    "migrate:dev": "prisma migrate dev",
+    "migrate:deploy": "prisma migrate deploy",
+    "generate": "prisma generate"
   },
   "dependencies": {
     "@nestjs/common": "^10.3.0",
@@ -16,6 +19,7 @@
     "@nestjs/jwt": "^10.2.0",
     "@nestjs/passport": "^10.0.3",
     "@nestjs/platform-express": "^10.3.0",
+    "@prisma/client": "^5.10.2",
     "bcryptjs": "^2.4.3",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
@@ -32,6 +36,8 @@
     "@types/node": "^20.11.0",
     "@types/passport-jwt": "^4.0.0",
     "@types/uuid": "^9.0.7",
-    "typescript": "^5.3.3"
+    "prisma": "^5.10.2",
+    "typescript": "^5.3.3",
+    "eslint": "^8.56.0"
   }
-}
+}

package/templates/nestjs/clean/prisma/schema.prisma.hbs

@@ -0,0 +1,20 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id               String   @id @default(uuid())
+  email            String   @unique
+  name             String
+  password         String
+  stripeCustomerId String?  @map("stripe_customer_id")
+  createdAt        DateTime @default(now()) @map("created_at")
+  updatedAt        DateTime @updatedAt @map("updated_at")
+
+  @@map("users")
+}

package/templates/nestjs/clean/src/app.module.ts.hbs

@@ -0,0 +1,17 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { AuthModule } from './auth.module';
+import { PrismaService } from './infrastructure/database/prisma.service';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+    AuthModule,
+  ],
+  controllers: [],
+  providers: [PrismaService],
+  exports: [PrismaService], // Export PrismaService if other modules need it
+})
+export class AppModule {}

package/templates/nestjs/clean/src/auth.module.ts.hbs

@@ -1,17 +1,19 @@
 import { Module } from '@nestjs/common';
 import { RegisterUseCase } from './domain/use-cases/register.use-case';
 import { IUserRepository } from './domain/repositories/user.repository';
-import { InMemoryUserRepository } from './infrastructure/database/in-memory.repository';
+import { PrismaUserRepository } from './infrastructure/database/repositories/prisma.user.repository';
+import { PrismaService } from './infrastructure/database/prisma.service';
 import { AuthController } from './infrastructure/http/auth.controller';
 
 @Module({
-    providers: [
-        RegisterUseCase,
-        {
-            provide: IUserRepository,
-            useClass: InMemoryUserRepository,
-        },
-    ],
-    controllers: [AuthController],
+  providers: [
+    PrismaService,
+    RegisterUseCase,
+    {
+      provide: IUserRepository,
+      useClass: PrismaUserRepository,
+    },
+  ],
+  controllers: [AuthController],
 })
-export class AuthModule {}
+export class AuthModule {}

package/templates/nestjs/clean/src/infrastructure/database/prisma.service.ts.hbs

@@ -0,0 +1,13 @@
+import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+  async onModuleInit() {
+    await this.$connect();
+  }
+
+  async onModuleDestroy() {
+    await this.$disconnect();
+  }
+}

package/templates/nestjs/clean/src/infrastructure/database/repositories/prisma.user.repository.ts.hbs

@@ -0,0 +1,32 @@
+import { Injectable } from '@nestjs/common';
+import { IUserRepository } from '../../../../domain/repositories/user.repository';
+import { User } from '../../../../domain/entities/user.entity';
+import { PrismaService } from '../prisma.service';
+
+@Injectable()
+export class PrismaUserRepository implements IUserRepository {
+  constructor(private prisma: PrismaService) {}
+
+  async findByEmail(email: string): Promise<User | null> {
+    const user = await this.prisma.user.findUnique({ where: { email } });
+    if (!user) return null;
+    return new User(user.id, user.name, user.email, user.password);
+  }
+
+  async save(user: User): Promise<User> {
+    const savedUser = await this.prisma.user.upsert({
+      where: { email: user.email },
+      update: {
+        name: user.name,
+        password: user.password,
+      },
+      create: {
+        id: user.id,
+        name: user.name,
+        email: user.email,
+        password: user.password,
+      },
+    });
+    return new User(savedUser.id, savedUser.name, savedUser.email, savedUser.password);
+  }
+}

package/templates/nestjs/clean/src/main.ts.hbs

@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { ValidationPipe } from '@nestjs/common';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
+  app.enableCors();
+  await app.listen(process.env.PORT || 3000);
+}
+bootstrap();

package/templates/nestjs/hexagonal/package.json.hbs

@@ -7,7 +7,10 @@
     "build": "nest build",
     "start": "node dist/main.js",
     "lint": "eslint \"{src,test}/**/*.ts\"",
-    "test": "jest"
+    "test": "jest",
+    "migrate:dev": "prisma migrate dev",
+    "migrate:deploy": "prisma migrate deploy",
+    "generate": "prisma generate"
   },
   "dependencies": {
     "@nestjs/common": "^10.3.0",
@@ -16,6 +19,7 @@
     "@nestjs/jwt": "^10.2.0",
     "@nestjs/passport": "^10.0.3",
     "@nestjs/platform-express": "^10.3.0",
+    "@prisma/client": "^5.10.2",
     "bcryptjs": "^2.4.3",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
@@ -32,6 +36,8 @@
     "@types/node": "^20.11.0",
     "@types/passport-jwt": "^4.0.0",
     "@types/uuid": "^9.0.7",
-    "typescript": "^5.3.3"
+    "prisma": "^5.10.2",
+    "typescript": "^5.3.3",
+    "eslint": "^8.56.0"
   }
-}
+}

package/templates/nestjs/hexagonal/prisma/schema.prisma

@@ -0,0 +1,20 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id               String   @id @default(uuid())
+  email            String   @unique
+  name             String
+  password         String
+  stripeCustomerId String?  @map("stripe_customer_id")
+  createdAt        DateTime @default(now()) @map("created_at")
+  updatedAt        DateTime @updatedAt @map("updated_at")
+
+  @@map("users")
+}

package/templates/nestjs/hexagonal/src/adapters/outbound/persistence/prisma.service.ts.hbs

@@ -0,0 +1,13 @@
+import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { PrismaClient } from '@prisma/client';
+
+@Injectable()
+export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+  async onModuleInit() {
+    await this.$connect();
+  }
+
+  async onModuleDestroy() {
+    await this.$disconnect();
+  }
+}

package/templates/nestjs/hexagonal/src/adapters/outbound/persistence/prisma.user.adapter.ts.hbs

@@ -0,0 +1,32 @@
+import { Injectable } from '@nestjs/common';
+import { IUserRepositoryPort } from '../../../../core/ports/ports';
+import { User } from '../../../../core/domain/user.entity';
+import { PrismaService } from './prisma.service';
+
+@Injectable()
+export class PrismaUserAdapter implements IUserRepositoryPort {
+  constructor(private prisma: PrismaService) {}
+
+  async findByEmail(email: string): Promise<User | null> {
+    const user = await this.prisma.user.findUnique({ where: { email } });
+    if (!user) return null;
+    return new User(user.id, user.name, user.email, user.password);
+  }
+
+  async save(user: User): Promise<User> {
+    const savedUser = await this.prisma.user.upsert({
+      where: { email: user.email },
+      update: {
+        name: user.name,
+        password: user.password,
+      },
+      create: {
+        id: user.id,
+        name: user.name,
+        email: user.email,
+        password: user.password,
+      },
+    });
+    return new User(savedUser.id, savedUser.name, savedUser.email, savedUser.password);
+  }
+}

package/templates/nestjs/hexagonal/src/app.module.ts.hbs

@@ -0,0 +1,17 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { AuthModule } from './auth.module';
+import { PrismaService } from './adapters/outbound/persistence/prisma.service';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+    AuthModule,
+  ],
+  controllers: [],
+  providers: [PrismaService],
+  exports: [PrismaService],
+})
+export class AppModule {}

package/templates/nestjs/hexagonal/src/auth.module.ts.hbs

@@ -1,19 +1,21 @@
 import { Module } from '@nestjs/common';
 import { AuthService } from './core/auth.service';
 import { HttpAdapter } from './adapters/inbound/http.adapter';
-import { PersistenceAdapter } from './adapters/outbound/persistence.adapter';
+import { PrismaUserAdapter } from './adapters/outbound/persistence/prisma.user.adapter';
+import { PrismaService } from './adapters/outbound/persistence/prisma.service';
 
 @Module({
-    providers: [
-        {
-            provide: 'IAuthPort',
-            useClass: AuthService,
-        },
-        {
-            provide: 'IUserRepositoryPort',
-            useClass: PersistenceAdapter,
-        },
-    ],
-    controllers: [HttpAdapter],
+  providers: [
+    PrismaService,
+    {
+      provide: 'IAuthPort',
+      useClass: AuthService,
+    },
+    {
+      provide: 'IUserRepositoryPort',
+      useClass: PrismaUserAdapter,
+    },
+  ],
+  controllers: [HttpAdapter],
 })
-export class AuthModule {}
+export class AuthModule {}

package/templates/nestjs/hexagonal/src/main.ts.hbs

@@ -0,0 +1,11 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { ValidationPipe } from '@nestjs/common';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
+  app.enableCors();
+  await app.listen(process.env.PORT || 3000);
+}
+bootstrap();

package/templates/nextjs/mvc/package.json.hbs

@@ -1,34 +1,37 @@
 {
-"name": "{{kebabCase projectName}}",
-"version": "1.0.0",
-"private": true,
-"scripts": {
-"dev": "next dev",
-"build": "next build",
-"start": "next start",
-"lint": "next lint",
-"db:generate": "prisma generate",
-"db:push": "prisma db push",
-"db:studio": "prisma studio"
-},
-"dependencies": {
-"next": "^16.0.0",
-"react": "^19.0.0",
-"react-dom": "^19.0.0",
-"@prisma/client": "^5.9.0",
-"next-auth": "^4.24.5",
-"stripe": "^14.14.0"
-},
-"devDependencies": {
-"@types/node": "^20.11.0",
-"@types/react": "^19.0.0",
-"@types/react-dom": "^19.0.0",
-"autoprefixer": "^10.4.17",
-"eslint": "^9.0.0",
-"eslint-config-next": "^16.0.0",
-"postcss": "^8.4.33",
-"prisma": "^5.9.0",
-"tailwindcss": "^3.4.1",
-"typescript": "^5.3.3"
+  "name": "{{kebabCase projectName}}",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push",
+    "db:studio": "prisma studio"
+  },
+  "dependencies": {
+    "next": "^16.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "@prisma/client": "^5.10.2",
+    "next-auth": "^4.24.6",
+    "stripe": "^14.14.0",
+    "zod": "^3.22.4",
+    "bcryptjs": "^2.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "@types/react": "^18.2.57",
+    "@types/react-dom": "^18.2.19",
+    "@types/bcryptjs": "^2.4.6",
+    "autoprefixer": "^10.4.17",
+    "eslint": "^8.56.0",
+    "eslint-config-next": "14.1.0",
+    "postcss": "^8.4.33",
+    "prisma": "^5.10.2",
+    "tailwindcss": "^3.4.1",
+    "typescript": "^5.3.3"
+  }
 }
-}

package/templates/nextjs/mvc/prisma/schema.prisma.hbs

@@ -7,12 +7,15 @@ datasource db {
   url      = env("DATABASE_URL")
 }
 
-// Add your models here
-// Example:
-// model User {
-//   id        Int      @id @default(autoincrement())
-//   email     String   @unique
-//   name      String?
-//   createdAt DateTime @default(now())
-//   updatedAt DateTime @updatedAt
-// }
+model User {
+  id               String   @id @default(uuid())
+  email            String   @unique
+  name             String?
+  password         String?  // Optional for OAuth, required for credentials
+  stripeCustomerId String?  @map("stripe_customer_id")
+  image            String?
+  createdAt        DateTime @default(now()) @map("created_at")
+  updatedAt        DateTime @updatedAt @map("updated_at")
+
+  @@map("users")
+}

package/templates/nextjs/mvc/src/lib/db.ts

@@ -0,0 +1,15 @@
+import { PrismaClient } from '@prisma/client';
+
+const prismaClientSingleton = () => {
+  return new PrismaClient();
+};
+
+type PrismaClientSingleton = ReturnType<typeof prismaClientSingleton>;
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClientSingleton | undefined;
+};
+
+export const db = globalForPrisma.prisma ?? prismaClientSingleton();
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;

package/templates/nodejs-express/clean/docker-compose.yml.hbs

@@ -1,18 +1,17 @@
 version: '3.8'
 
 services:
-  postgres:
+  db:
     image: postgres:15-alpine
-    container_name: {{kebabCase projectName}}-db
+    restart: always
     environment:
       POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: postgres
-      POSTGRES_DB: {{snakeCase projectName}}
+      POSTGRES_PASSWORD: password
+      POSTGRES_DB: {{kebabCase projectName}}_db
     ports:
-      - "5432:5432"
+      - '5432:5432'
     volumes:
       - postgres_data:/var/lib/postgresql/data
-    restart: unless-stopped
 
 volumes:
   postgres_data: