kybernus 3.0.1 → 3.2.0

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

@@ -1,71 +1,71 @@
 {
-"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",
-"migrate:dev": "prisma migrate dev",
-"migrate:deploy": "prisma migrate deploy",
-"generate": "prisma generate"
-},
-"keywords": [
-"express",
-"api",
-"typescript",
-"hexagonal-architecture",
-"prisma",
-"zod"
-],
-"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",
-"zod": "^3.22.4",
-"express-async-errors": "^3.1.1",
-"@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",
+    "migrate:dev": "prisma migrate dev",
+    "migrate:deploy": "prisma migrate deploy",
+    "generate": "prisma generate"
+  },
+  "keywords": [
+    "express",
+    "api",
+    "typescript",
+    "hexagonal-architecture",
+    "prisma",
+    "zod"
+  ],
+  "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",
+    "zod": "^3.22.4",
+    "express-async-errors": "^3.1.1",
+    "@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/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

@@ -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}