kybernus 3.0.1 → 3.1.0

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

@@ -1,69 +1,69 @@
 {
-"name": "{{kebabCase projectName}}",
-"version": "1.0.0",
-"description": "Generated by Kybernus CLI (Pro)",
-"main": "dist/index.js",
-"scripts": {
-"dev": "tsx watch src/index.ts",
-"build": "rimraf dist && tsc",
-"start": "node dist/index.js",
-"lint": "eslint src/**/*.ts",
-"format": "prettier --write \"src/**/*.ts\"",
-"test": "jest",
-"db:generate": "prisma generate",
-"db:push": "prisma db push"
-},
-"keywords": [
-"express",
-"api",
-"typescript",
-"mvc",
-"saas",
-"stripe",
-"auth"
-],
-"author": "",
-"license": "MIT",
-"dependencies": {
-"express": "^4.18.2",
-"dotenv": "^16.4.5",
-"cors": "^2.8.5",
-"helmet": "^7.1.0",
-"morgan": "^1.10.0",
-"jsonwebtoken": "^9.0.2",
-"bcryptjs": "^2.4.3",
-"stripe": "^14.14.0",
-"@prisma/client": "^5.10.2"
-},
-"devDependencies": {
-"@types/express": "^4.17.21",
-"@types/node": "^20.11.19",
-"@types/cors": "^2.8.17",
-"@types/morgan": "^1.9.9",
-"@types/jsonwebtoken": "^9.0.5",
-"@types/bcryptjs": "^2.4.6",
-"typescript": "^5.3.3",
-"tsx": "^4.7.1",
-"rimraf": "^5.0.5",
-"eslint": "^9.0.0",
-"@typescript-eslint/eslint-plugin": "^8.0.0",
-"@typescript-eslint/parser": "^8.0.0",
-"prettier": "^3.2.5",
-"jest": "^29.7.0",
-"@types/jest": "^29.5.12",
-"prisma": "^5.10.2"
-},
-"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"
+  "name": "{{kebabCase projectName}}",
+  "version": "1.0.0",
+  "description": "Generated by Kybernus CLI (Pro)",
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "rimraf dist && tsc",
+    "start": "node dist/index.js",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest",
+    "db:generate": "prisma generate",
+    "db:push": "prisma db push"
+  },
+  "keywords": [
+    "express",
+    "api",
+    "typescript",
+    "mvc",
+    "saas",
+    "stripe",
+    "auth"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2",
+    "dotenv": "^16.4.5",
+    "cors": "^2.8.5",
+    "helmet": "^7.1.0",
+    "morgan": "^1.10.0",
+    "jsonwebtoken": "^9.0.2",
+    "bcryptjs": "^2.4.3",
+    "stripe": "^14.14.0",
+    "@prisma/client": "^5.10.2"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.19",
+    "@types/cors": "^2.8.17",
+    "@types/morgan": "^1.9.9",
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/bcryptjs": "^2.4.6",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.1",
+    "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",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.12",
+    "prisma": "^5.10.2"
+  },
+  "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

package/templates/python-fastapi/hexagonal/app/adapters/inbound/http_adapter.py.hbs

@@ -5,7 +5,7 @@ from app.core.ports import IAuthPort
 from app.core.domain.user import User as DomainUser
 from app.infrastructure.database.session import get_db
 from app.infrastructure.database.models import UserModel
-from app.adapters.outbound.postgres_user_repository import PostgresUserRepository 
+from app.adapters.outbound.postgres_user_repository import PostgresUserRepository
 from app.core.service import AuthService
 from app.infrastructure.security.adapters import BcryptHasher, JwtTokenGenerator
 
@@ -16,6 +16,10 @@ class RegisterRequest(BaseModel):
     name: str
     password: str
 
+class LoginRequest(BaseModel):
+    email: EmailStr
+    password: str
+
 # Dependency Injection Factory
 def get_auth_service(db: AsyncSession = Depends(get_db)) -> IAuthPort:
     repo = PostgresUserRepository(db)
@@ -36,7 +40,7 @@ async def register(
 
 @router.post("/login")
 async def login(
-    req: RegisterRequest,
+    req: LoginRequest,
     service: IAuthPort = Depends(get_auth_service)
 ):
     try:
@@ -44,10 +48,3 @@ async def login(
         return result
     except ValueError as e:
         raise HTTPException(status_code=401, detail=str(e))
-
-# Setup function for backward compatibility or direct usage 
-# though router is preferred
-def setup_auth_routes(auth_service: IAuthPort):
-    # This pattern is tricky with FastAPIs dependency injection system
-    # It's better to rely on Depends() as implemented above
-    return router

package/templates/python-fastapi/hexagonal/app/adapters/inbound/payment_http_adapter.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.core.payment_service import PaymentService
 from app.adapters.outbound.stripe_adapter import StripeAdapter
-from app.infrastructure.database.session import AsyncSessionLocal
+from app.infrastructure.database.session import get_db
 from app.infrastructure.database.user_repository import SQLAlchemyUserRepository
 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 = SQLAlchemyUserRepository(db)
     adapter = StripeAdapter()
     return PaymentService(user_repository=repo, stripe_adapter=adapter)
 

package/templates/python-fastapi/hexagonal/app/adapters/outbound/stripe_adapter.py.hbs

@@ -1,19 +1,24 @@
 import stripe
 import os
 
-stripe.api_key = os.getenv("STRIPE_SECRET_KEY")
 stripe.api_version = "2026-02-25.clover"
 
 
 class StripeAdapter:
     """Outbound adapter: wraps the Stripe SDK for use by the core domain."""
 
+    def __init__(self):
+        stripe.api_key = os.getenv("STRIPE_SECRET_KEY")
+
     def create_customer(self, email: str, name: str | None = None, user_id: str | None = None):
-        return stripe.Customer.create(
-            email=email,
-            name=name,
-            metadata={"userId": user_id} if user_id else {},
-        )
+        try:
+            return stripe.Customer.create(
+                email=email,
+                name=name,
+                metadata={"userId": user_id} if user_id else {},
+            )
+        except stripe.StripeError as e:
+            raise ValueError(f"Stripe error creating customer: {e.user_message or str(e)}")
 
     def create_checkout_session(
         self,
@@ -23,21 +28,27 @@ class StripeAdapter:
         success_url: str,
         cancel_url: str,
     ):
-        return stripe.checkout.Session.create(
-            mode="subscription",
-            payment_method_types=["card"],
-            line_items=[{"price": price_id, "quantity": 1}],
-            customer=customer_id,
-            success_url=success_url,
-            cancel_url=cancel_url,
-            client_reference_id=str(user_id),
-        )
+        try:
+            return stripe.checkout.Session.create(
+                mode="subscription",
+                payment_method_types=["card"],
+                line_items=[{"price": price_id, "quantity": 1}],
+                customer=customer_id,
+                success_url=success_url,
+                cancel_url=cancel_url,
+                client_reference_id=str(user_id),
+            )
+        except stripe.StripeError as e:
+            raise ValueError(f"Stripe error creating checkout session: {e.user_message or str(e)}")
 
     def create_portal_session(self, customer_id: str, return_url: str):
-        return stripe.billing_portal.Session.create(
-            customer=customer_id,
-            return_url=return_url,
-        )
+        try:
+            return stripe.billing_portal.Session.create(
+                customer=customer_id,
+                return_url=return_url,
+            )
+        except stripe.StripeError as e:
+            raise ValueError(f"Stripe error creating portal session: {e.user_message or str(e)}")
 
     def construct_event(self, payload: bytes, sig_header: str):
         webhook_secret = os.getenv("STRIPE_WEBHOOK_SECRET", "")