kybernus 3.0.0 → 3.1.0

package/templates/nodejs-express/hexagonal/src/adapters/inbound/http/PaymentController.ts.hbs

@@ -1,57 +1,40 @@
-import { Request, Response, NextFunction } from 'express';
+import { Request, Response } from 'express';
 import { PaymentService } from '../../../core/PaymentService';
 
 export class PaymentController {
     constructor(private readonly paymentService: PaymentService) {}
 
-    /**
-     * POST /api/payments/checkout
-     * Requires authentication.
-     */
-    createCheckout = async (req: Request, res: Response, next: NextFunction) => {
-        try {
-            const userId = (req as any).userId as string;
-            const { priceId } = req.body;
-
-            if (!priceId) {
-                return res.status(400).json({ error: 'priceId is required' });
-            }
+    async createCheckoutSession(req: Request, res: Response) {
+        const { priceId } = req.body;
+        const userId = (req as any).user?.id as string;
 
+        try {
             const session = await this.paymentService.createCheckoutSession(userId, priceId);
             res.json({ url: session.url });
-        } catch (err) {
-            next(err);
+        } catch (error: any) {
+            res.status(400).json({ error: error.message });
         }
-    };
+    }
+
+    async createPortalSession(req: Request, res: Response) {
+        const userId = (req as any).user?.id as string;
 
-    /**
-     * POST /api/payments/portal
-     * Requires authentication.
-     */
-    createPortal = async (req: Request, res: Response, next: NextFunction) => {
         try {
-            const userId = (req as any).userId as string;
             const session = await this.paymentService.createPortalSession(userId);
             res.json({ url: session.url });
-        } catch (err) {
-            next(err);
+        } catch (error: any) {
+            res.status(400).json({ error: error.message });
         }
-    };
+    }
+
+    async handleWebhook(req: Request, res: Response) {
+        const sig = req.headers['stripe-signature'] as string;
 
-    /**
-     * POST /api/payments/webhook
-     * No authentication – Stripe sends the raw body here.
-     */
-    handleWebhook = async (req: Request, res: Response, next: NextFunction) => {
         try {
-            const signature = req.headers['stripe-signature'] as string;
-            if (!signature) {
-                return res.status(400).json({ error: 'Missing stripe-signature header' });
-            }
-            const result = await this.paymentService.handleWebhook(req.body, signature);
+            const result = await this.paymentService.handleWebhook(req.body, sig);
             res.json(result);
-        } catch (err) {
-            next(err);
+        } catch (error: any) {
+            res.status(400).send(`Webhook Error: ${error.message}`);
         }
-    };
+    }
 }

package/templates/nodejs-express/hexagonal/src/adapters/outbound/persistence/prisma.ts.hbs

@@ -0,0 +1,2 @@
+import { PrismaClient } from '@prisma/client';
+export const prisma = new PrismaClient();

package/templates/nodejs-express/hexagonal/src/config.ts.hbs

@@ -0,0 +1,9 @@
+import dotenv from 'dotenv';
+dotenv.config();
+
+export const config = {
+  port: process.env.PORT || 3000,
+  env: process.env.NODE_ENV || 'development',
+  jwtSecret: process.env.JWT_SECRET || 'secret',
+  frontendUrl: process.env.FRONTEND_URL || 'http://localhost:3001',
+};

package/templates/nodejs-express/hexagonal/src/core/AuthService.ts.hbs

@@ -1,7 +1,7 @@
-import { User } from '../domain/entities/User';
-import { IAuthPort } from '../ports/inbound/IAuthPort';
-import { IUserRepositoryPort } from '../ports/outbound/IUserRepositoryPort';
-import { IPasswordHasherPort, ITokenGeneratorPort } from '../ports/outbound/ISecurityPorts';
+import { User } from './domain/entities/User';
+import { IAuthPort } from './ports/inbound/IAuthPort';
+import { IUserRepositoryPort } from './ports/outbound/IUserRepositoryPort';
+import { IPasswordHasherPort, ITokenGeneratorPort } from './ports/outbound/ISecurityPorts';
 
 /**
 * Auth Service - Application Core
@@ -48,4 +48,4 @@ export class AuthService implements IAuthPort {
         if (!decoded) return null;
         return this.userRepository.findById(decoded.id);
     }
-}
+}

package/templates/nodejs-express/hexagonal/src/core/PaymentService.ts.hbs

@@ -1,9 +1,9 @@
-import { UserRepository } from './ports/UserRepository';
+import { IUserRepositoryPort } from './ports/outbound/IUserRepositoryPort';
 import { StripeAdapter } from '../adapters/outbound/StripeAdapter';
 
 export class PaymentService {
     constructor(
-        private readonly userRepository: UserRepository,
+        private readonly userRepository: IUserRepositoryPort,
         private readonly stripeAdapter: StripeAdapter,
     ) {}
 
@@ -17,11 +17,11 @@ export class PaymentService {
             const customer = await this.stripeAdapter.createCustomer(
                 user.email,
                 user.name,
-                user.id,
+                user.id!,
             );
             customerId = customer.id;
-            user.stripeCustomerId = customerId;
-            await this.userRepository.save(user);
+            const updatedUser = user.withStripeCustomerId(customerId);
+            await this.userRepository.save(updatedUser);
         }
 
         return this.stripeAdapter.createCheckoutSession(
@@ -58,28 +58,13 @@ export class PaymentService {
                 if (userId && session.customer) {
                     const user = await this.userRepository.findById(userId);
                     if (user) {
-                        user.stripeCustomerId = session.customer as string;
-                        await this.userRepository.save(user);
+                        const updatedUser = user.withStripeCustomerId(session.customer as string);
+                        await this.userRepository.save(updatedUser);
                     }
                 }
                 console.log('Checkout completed for user:', userId);
                 break;
             }
-            case 'customer.subscription.updated': {
-                const sub = event.data.object as any;
-                console.log('Subscription updated:', sub.id, '| Status:', sub.status);
-                break;
-            }
-            case 'customer.subscription.deleted': {
-                const sub = event.data.object as any;
-                console.log('Subscription deleted:', sub.id);
-                break;
-            }
-            case 'invoice.payment_failed': {
-                const invoice = event.data.object as any;
-                console.log('Payment failed for invoice:', invoice.id);
-                break;
-            }
             default:
                 console.log('Unhandled Stripe event:', event.type);
         }

package/templates/nodejs-express/hexagonal/src/core/domain/entities/User.ts.hbs

@@ -22,7 +22,27 @@ export class User {
     }
 
     private validatePassword(password: string): void {
-        if (!password || password.length < 8) { throw new Error('Password must be at least 8 characters'); } } withId(id:
-        string): User { return new User(id, this.email, this.name, this.password, this.stripeCustomerId, this.createdAt); }
-        withStripeCustomerId(customerId: string): User { return new User(this.id, this.email, this.name, this.password,
-        customerId, this.createdAt); } }
+        if (!password || password.length < 8) {
+            throw new Error('Password must be at least 8 characters');
+        }
+    }
+
+    static restore(data: any): User {
+        return new User(
+            data.id, 
+            data.email, 
+            data.name, 
+            data.password, 
+            data.stripeCustomerId, 
+            data.createdAt
+        );
+    }
+
+    withId(id: string): User {
+        return new User(id, this.email, this.name, this.password, this.stripeCustomerId, this.createdAt);
+    }
+
+    withStripeCustomerId(customerId: string): User {
+        return new User(this.id, this.email, this.name, this.password, customerId, this.createdAt);
+    }
+}

package/templates/nodejs-express/mvc/.gitignore.hbs

@@ -0,0 +1,42 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build outputs
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+!.env.example
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Coverage
+coverage/
+.nyc_output
+
+# TypeScript
+*.tsbuildinfo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo

package/templates/nodejs-express/mvc/package.json.hbs

@@ -44,8 +44,8 @@
     "@types/bcryptjs": "^2.4.6",
     "typescript": "^5.3.3",
     "tsx": "^4.7.1",
-    "rimraf": "^5.0.5",
-    "eslint": "^9.0.0",
+    "rimraf": "^6.1.2",
+    "eslint": "^9.16.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "prettier": "^3.2.5",
@@ -55,5 +55,15 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "overrides": {
+    "rimraf": "^6.1.2",
+    "glob": "^11.0.0",
+    "inflight": "^1.0.6",
+    "@humanwhocodes/config-array": "^0.13.0",
+    "@humanwhocodes/object-schema": "^2.0.3",
+    "eslint": "^9.16.0",
+    "cookie": "^0.7.2",
+    "minimatch": "^9.0.8"
   }
 }

package/templates/python-fastapi/clean/.gitignore.hbs

@@ -0,0 +1,76 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyo
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# Pytest
+.pytest_cache/
+pytest-cache/
+.cache/
+
+# Coverage
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+*.py,cover
+
+# MyPy / Pyright
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+pyrightconfig.json
+
+# Alembic — keep migrations, ignore autogenerated caches
+# alembic/versions/ is intentionally tracked
+
+# Jupyter
+.ipynb_checkpoints
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo

package/templates/python-fastapi/clean/app/application/services/payment_service.py.hbs

@@ -1,10 +1,10 @@
 import os
-from app.domain.repositories.user_repository import UserRepository
+from app.domain.repositories.user_repository import IUserRepository
 from app.infrastructure.stripe_provider import StripeProvider
 
 
 class PaymentService:
-    def __init__(self, user_repository: UserRepository, stripe_provider: StripeProvider):
+    def __init__(self, user_repository: IUserRepository, stripe_provider: StripeProvider):
         self.user_repository = user_repository
         self.stripe_provider = stripe_provider
 
@@ -30,7 +30,7 @@ class PaymentService:
             customer_id=customer_id,
             price_id=price_id,
             user_id=str(user_id),
-            success_url=f"{os.getenv('FRONTEND_URL')}/success?session_id={{CHECKOUT_SESSION_ID}}",
+            success_url=f"{os.getenv('FRONTEND_URL')}/success?session_id={'{CHECKOUT_SESSION_ID}'}",
             cancel_url=f"{os.getenv('FRONTEND_URL')}/cancel",
         )
         return session.url

package/templates/python-fastapi/clean/app/config.py.hbs

@@ -4,20 +4,19 @@ from functools import lru_cache
 class Settings(BaseSettings):
     PROJECT_NAME: str = "{{projectName}}"
     API_V1_STR: str = "/api/v1"
-    
-    # Database
-    # Use asyncpg for async SQLAlchemy
-    DATABASE_URL: str = "postgresql+asyncpg://postgres:postgres@localhost:5432/{{projectName}}_db"
-    
+
+    # Database — use asyncpg for async SQLAlchemy
+    DATABASE_URL: str = "postgresql+asyncpg://postgres:postgres@localhost:5432/{{projectName}}"
+
     # Security
     SECRET_KEY: str = "change_this_to_a_secure_random_key"
     ALGORITHM: str = "HS256"
     ACCESS_TOKEN_EXPIRE_MINUTES: int = 30
-    
+
     # Stripe
     STRIPE_API_KEY: str | None = None
 
-    model_config = SettingsConfigDict(env_file=".env", case_sensitive=True)
+    model_config = SettingsConfigDict(env_file=".env", case_sensitive=True, extra="ignore")
 
 @lru_cache
 def get_settings():

package/templates/python-fastapi/clean/app/domain/usecases/login_user.py.hbs

@@ -0,0 +1,15 @@
+from app.domain.repositories.user_repository import IUserRepository
+
+
+class LoginUserUseCase:
+    def __init__(self, repo: IUserRepository, hasher, token_gen):
+        self.repo = repo
+        self.hasher = hasher
+        self.token_gen = token_gen
+
+    async def execute(self, email: str, password: str) -> dict:
+        user = await self.repo.find_by_email(email)
+        if not user or not self.hasher.verify(password, user.password):
+            raise ValueError("Invalid email or password")
+        token = self.token_gen.generate(user.id, user.email)
+        return {"user": user, "token": token}

package/templates/python-fastapi/clean/app/infrastructure/http/auth_controller.py.hbs

@@ -2,25 +2,48 @@ from fastapi import APIRouter, HTTPException, Depends
 from pydantic import BaseModel, EmailStr
 from sqlalchemy.ext.asyncio import AsyncSession
 from app.domain.usecases.register_user import RegisterUserUseCase
+from app.domain.usecases.login_user import LoginUserUseCase
 from app.infrastructure.database.postgres_repository import PostgresUserRepository
 from app.infrastructure.security.adapters import BcryptHasher, JwtTokenGenerator
 from app.infrastructure.database.session import get_db
 
 router = APIRouter()
 
-# Dependency Injection Factory
+
+class RegisterRequest(BaseModel):
+    email: EmailStr
+    name: str
+    password: str
+
+class LoginRequest(BaseModel):
+    email: EmailStr
+    password: str
+
+class UserResponse(BaseModel):
+    id: str
+    email: str
+    name: str
+
+class AuthResponse(BaseModel):
+    user: UserResponse
+    token: str
+
+
+# Dependency Injection Factories
 def get_register_usecase(db: AsyncSession = Depends(get_db)) -> RegisterUserUseCase:
     repo = PostgresUserRepository(db)
     hasher = BcryptHasher()
     token_gen = JwtTokenGenerator()
     return RegisterUserUseCase(repo, hasher, token_gen)
 
-class RegisterRequest(BaseModel):
-    email: EmailStr
-    name: str
-    password: str
+def get_login_usecase(db: AsyncSession = Depends(get_db)) -> LoginUserUseCase:
+    repo = PostgresUserRepository(db)
+    hasher = BcryptHasher()
+    token_gen = JwtTokenGenerator()
+    return LoginUserUseCase(repo, hasher, token_gen)
 
-@router.post("/register")
+
+@router.post("/register", response_model=AuthResponse)
 async def register(
     req: RegisterRequest,
     usecase: RegisterUserUseCase = Depends(get_register_usecase)
@@ -30,3 +53,14 @@ async def register(
         return result
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
+
+@router.post("/login", response_model=AuthResponse)
+async def login(
+    req: LoginRequest,
+    usecase: LoginUserUseCase = Depends(get_login_usecase)
+):
+    try:
+        result = await usecase.execute(req.email, req.password)
+        return result
+    except ValueError as e:
+        raise HTTPException(status_code=401, detail=str(e))

package/templates/python-fastapi/clean/app/infrastructure/http/payment_controller.py.hbs

@@ -1,16 +1,17 @@
 from fastapi import APIRouter, HTTPException, Header, Request, Depends
 from pydantic import BaseModel
+from sqlalchemy.ext.asyncio import AsyncSession
 from app.application.services.payment_service import PaymentService
-from app.infrastructure.database.session import AsyncSessionLocal
-from app.infrastructure.database.user_repository import SQLAlchemyUserRepository
+from app.infrastructure.database.session import get_db
+from app.infrastructure.database.postgres_repository import PostgresUserRepository
 from app.infrastructure.stripe_provider import StripeProvider
 from app.infrastructure.security.jwt import get_current_user_id
 
 router = APIRouter()
 
 
-def get_payment_service() -> PaymentService:
-    repo = SQLAlchemyUserRepository(AsyncSessionLocal())
+def get_payment_service(db: AsyncSession = Depends(get_db)) -> PaymentService:
+    repo = PostgresUserRepository(db)
     provider = StripeProvider()
     return PaymentService(user_repository=repo, stripe_provider=provider)
 

package/templates/python-fastapi/clean/app/infrastructure/security/jwt.py.hbs

@@ -0,0 +1,23 @@
+from fastapi import HTTPException, Security
+from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
+from jose import jwt, JWTError
+import os
+
+security = HTTPBearer()
+
+SECRET_KEY = os.getenv("JWT_SECRET", "secret")
+ALGORITHM = "HS256"
+
+
+def get_current_user_id(
+    credentials: HTTPAuthorizationCredentials = Security(security),
+) -> str:
+    try:
+        token = credentials.credentials
+        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
+        user_id: str = payload.get("sub")
+        if user_id is None:
+            raise HTTPException(status_code=401, detail="Invalid authentication credentials")
+        return user_id
+    except JWTError:
+        raise HTTPException(status_code=401, detail="Invalid authentication credentials")

package/templates/python-fastapi/clean/app/main.py.hbs

@@ -1,3 +1,6 @@
+from dotenv import load_dotenv
+load_dotenv()
+
 from contextlib import asynccontextmanager
 from fastapi import FastAPI
 from app.infrastructure.http import auth_controller, payment_controller

package/templates/python-fastapi/clean/docker-compose.yml.hbs

@@ -1,16 +1,4 @@
-version: '3.8'
-
 services:
-  app:
-    build: .
-    container_name: {{kebabCase projectName}}-app
-    ports:
-      - "8000:8000"
-    environment:
-      - DATABASE_URL=postgresql://postgres:postgres@db:5432/{{snakeCase projectName}}
-    depends_on:
-      - db
-
   db:
     image: postgres:15-alpine
     container_name: {{kebabCase projectName}}-db
@@ -23,6 +11,11 @@ services:
     volumes:
       - postgres_data:/var/lib/postgresql/data
     restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
 
 volumes:
   postgres_data:

package/templates/python-fastapi/clean/requirements.txt.hbs

@@ -1,10 +1,13 @@
 fastapi>=0.109.0
 uvicorn[standard]>=0.27.0
 pydantic>=2.5.0
+pydantic[email]>=2.5.0
 pydantic-settings>=2.1.0
 python-dotenv>=1.0.0
 python-jose[cryptography]>=3.3.0
 passlib[bcrypt]>=1.7.4
+bcrypt>=3.0.0,<4.0.0
+greenlet>=3.0.0
 stripe>=8.0.0
 sqlalchemy>=2.0.0
 alembic>=1.13.0

package/templates/python-fastapi/hexagonal/.gitignore.hbs

@@ -0,0 +1,76 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyo
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+!.env.example
+
+# Pytest
+.pytest_cache/
+pytest-cache/
+.cache/
+
+# Coverage
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+*.py,cover
+
+# MyPy / Pyright
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+pyrightconfig.json
+
+# Alembic — keep migrations, ignore autogenerated caches
+# alembic/versions/ is intentionally tracked
+
+# Jupyter
+.ipynb_checkpoints
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo