kybernus 1.0.1 → 1.1.3

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

@@ -1,55 +0,0 @@
-{
-  "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 --ext .ts",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "test": "jest"
-  },
-  "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"
-  },
-  "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": "^8.56.0",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "prettier": "^3.2.5",
-    "jest": "^29.7.0",
-    "@types/jest": "^29.5.12"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

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

@@ -1,48 +0,0 @@
-import { Router, Request, Response } from 'express';
-import { IAuthPort } from '../../../core/ports/inbound/IAuthPort';
-
-/**
-* HTTP Auth Controller - Inbound Adapter
-* Adapts HTTP requests to the application port
-*/
-export function createAuthController(authService: IAuthPort): Router {
-    const router = Router();
-
-    router.post('/register', async (req: Request, res: Response) => {
-        try {
-            const { email, name, password } = req.body;
-            const result = await authService.register(email, name, password);
-            res.status(201).json({
-                token: result.token,
-                user: { id: result.user.id, email: result.user.email, name: result.user.name },
-            });
-        } catch (error: any) {
-            res.status(400).json({ error: error.message });
-        }
-    });
-
-    router.post('/login', async (req: Request, res: Response) => {
-        try {
-            const { email, password } = req.body;
-            const result = await authService.login(email, password);
-            res.json({
-                token: result.token,
-                user: { id: result.user.id, email: result.user.email, name: result.user.name },
-            });
-        } catch (error: any) {
-            res.status(401).json({ error: error.message });
-        }
-    });
-
-    router.get('/me', async (req: Request, res: Response) => {
-        const token = req.headers.authorization?.split(' ')[1];
-        if (!token) return res.status(401).json({ error: 'No token' });
-
-        const user = await authService.validateToken(token);
-        if (!user) return res.status(401).json({ error: 'Invalid token' });
-
-        res.json({ user: { id: user.id, email: user.email, name: user.name } });
-    });
-
-    return router;
-}

package/templates/nodejs-express/pro/hexagonal/src/adapters/outbound/SecurityAdapters.ts.hbs

@@ -1,31 +0,0 @@
-import bcrypt from 'bcryptjs';
-import jwt from 'jsonwebtoken';
-import { IPasswordHasherPort, ITokenGeneratorPort } from '../../../core/ports/outbound/ISecurityPorts';
-
-/**
-* Bcrypt Password Hasher Adapter
-*/
-export const bcryptAdapter: IPasswordHasherPort = {
-    async hash(password: string): Promise<string> {
-        return bcrypt.hash(password, 10);
-    },
-    async compare(password: string, hash: string): Promise<boolean> {
-        return bcrypt.compare(password, hash);
-    },
-};
-
-/**
-* JWT Token Generator Adapter
-*/
-export const jwtAdapter: ITokenGeneratorPort = {
-    generate(userId: string, email: string): string {
-        return jwt.sign({ id: userId, email }, process.env.JWT_SECRET || 'secret', { expiresIn: '7d' });
-    },
-    verify(token: string): { id: string; email: string } | null {
-        try {
-            return jwt.verify(token, process.env.JWT_SECRET || 'secret') as { id: string; email: string };
-        } catch {
-            return null;
-        }
-    },
-};

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

@@ -1,38 +0,0 @@
-import { User } from '../../core/domain/entities/User';
-import { IUserRepositoryPort } from '../../core/ports/outbound/IUserRepositoryPort';
-
-/**
-* In-Memory User Repository Adapter
-* Implements the outbound port
-*/
-export class InMemoryUserAdapter implements IUserRepositoryPort {
-    private users: Map<string, User> = new Map();
-
-    async findById(id: string): Promise<User | null> {
-        return this.users.get(id) || null;
-    }
-
-    async findByEmail(email: string): Promise<User | null> {
-        for (const user of this.users.values()) {
-            if (user.email === email) return user;
-        }
-        return null;
-    }
-
-    async save(user: User): Promise<User> {
-        const id = Date.now().toString();
-        const savedUser = user.withId(id);
-        this.users.set(id, savedUser);
-        return savedUser;
-    }
-
-    async update(user: User): Promise<User> {
-        if (!user.id) throw new Error('User must have an ID');
-        this.users.set(user.id, user);
-        return user;
-    }
-
-    async delete(id: string): Promise<void> {
-        this.users.delete(id);
-    }
-}

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

@@ -1,51 +0,0 @@
-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
-* Implements the inbound port using outbound ports
-*/
-export class AuthService implements IAuthPort {
-    constructor(
-        private readonly userRepository: IUserRepositoryPort,
-        private readonly passwordHasher: IPasswordHasherPort,
-        private readonly tokenGenerator: ITokenGeneratorPort
-    ) {}
-
-    async register(email: string, name: string, password: string): Promise<{ user: User; token: string }> {
-        const existingUser = await this.userRepository.findByEmail(email);
-        if (existingUser) {
-            throw new Error('User already exists');
-        }
-
-        const hashedPassword = await this.passwordHasher.hash(password);
-        const user = new User(undefined, email, name, hashedPassword);
-        const savedUser = await this.userRepository.save(user);
-        const token = this.tokenGenerator.generate(savedUser.id!, savedUser.email);
-
-        return { user: savedUser, token };
-    }
-
-    async login(email: string, password: string): Promise<{ user: User; token: string }> {
-        const user = await this.userRepository.findByEmail(email);
-        if (!user) {
-            throw new Error('Invalid credentials');
-        }
-
-        const isValid = await this.passwordHasher.compare(password, user.password);
-        if (!isValid) {
-            throw new Error('Invalid credentials');
-        }
-
-        const token = this.tokenGenerator.generate(user.id!, user.email);
-        return { user, token };
-    }
-
-    async validateToken(token: string): Promise<User | null> {
-        const decoded = this.tokenGenerator.verify(token);
-        if (!decoded) return null;
-        return this.userRepository.findById(decoded.id);
-    }
-}

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

@@ -1,28 +0,0 @@
-/**
-* User Entity - Core Domain
-* Hexagonal Architecture: This is the heart of the hexagon
-*/
-export class User {
-    constructor(
-        public readonly id: string | undefined,
-        public readonly email: string,
-        public readonly name: string,
-        public readonly password: string,
-        public readonly stripeCustomerId?: string,
-        public readonly createdAt: Date = new Date()
-    ) {
-        this.validateEmail(email);
-        this.validatePassword(password);
-    }
-
-    private validateEmail(email: string): void {
-        if (!email || !email.includes('@')) {
-            throw new Error('Invalid email format');
-        }
-    }
-
-    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); } }

package/templates/nodejs-express/pro/hexagonal/src/core/ports/inbound/IAuthPort.ts.hbs

@@ -1,11 +0,0 @@
-import { User } from '../../domain/entities/User';
-
-/**
-* Auth Port - Inbound (Driving) Port
-* Defines what the application CAN DO (use cases)
-*/
-export interface IAuthPort {
-    register(email: string, name: string, password: string): Promise<{ user: User; token: string }>;
-    login(email: string, password: string): Promise<{ user: User; token: string }>;
-    validateToken(token: string): Promise<User | null>;
-}

package/templates/nodejs-express/pro/hexagonal/src/core/ports/outbound/ISecurityPorts.ts.hbs

@@ -1,15 +0,0 @@
-/**
-* Password Hasher Port - Outbound Port
-*/
-export interface IPasswordHasherPort {
-    hash(password: string): Promise<string>;
-    compare(password: string, hash: string): Promise<boolean>;
-}
-
-/**
-* Token Generator Port - Outbound Port
-*/
-export interface ITokenGeneratorPort {
-    generate(userId: string, email: string): string;
-    verify(token: string): { id: string; email: string } | null;
-}

package/templates/nodejs-express/pro/hexagonal/src/core/ports/outbound/IUserRepositoryPort.ts.hbs

@@ -1,13 +0,0 @@
-import { User } from '../../domain/entities/User';
-
-/**
-* User Repository Port - Outbound (Driven) Port
-* Defines what the application NEEDS from the outside world
-*/
-export interface IUserRepositoryPort {
-    findById(id: string): Promise<User | null>;
-    findByEmail(email: string): Promise<User | null>;
-    save(user: User): Promise<User>;
-    update(user: User): Promise<User>;
-    delete(id: string): Promise<void>;
-}

package/templates/nodejs-express/pro/hexagonal/src/index.ts.hbs

@@ -1,41 +0,0 @@
-import express from 'express';
-import cors from 'cors';
-import helmet from 'helmet';
-import morgan from 'morgan';
-import dotenv from 'dotenv';
-
-// Core
-import { AuthService } from './core/AuthService';
-
-// Adapters
-import { InMemoryUserAdapter } from './adapters/outbound/persistence/InMemoryUserAdapter';
-import { bcryptAdapter, jwtAdapter } from './adapters/outbound/SecurityAdapters';
-import { createAuthController } from './adapters/inbound/http/AuthController';
-
-dotenv.config();
-
-const app = express();
-
-// Middleware
-app.use(helmet());
-app.use(cors());
-app.use(morgan('dev'));
-app.use(express.json());
-
-// Dependency Injection - Wire up the hexagon
-const userRepository = new InMemoryUserAdapter();
-const authService = new AuthService(userRepository, bcryptAdapter, jwtAdapter);
-
-// Mount adapters
-app.use('/api/auth', createAuthController(authService));
-
-// Health check
-app.get('/health', (_, res) => res.json({ status: 'ok' }));
-
-const PORT = process.env.PORT || 3000;
-
-app.listen(PORT, () => {
-    console.log(`🚀 {{pascalCase projectName}} running on port ${PORT}`);
-    console.log(`⬡ Architecture: Hexagonal (Ports & Adapters)`);
-    console.log(`🔗 Health check: http://localhost:${PORT}/health`);
-});

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

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "commonjs",
-    "lib": [
-      "ES2022"
-    ],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "moduleResolution": "node",
-    "types": [
-      "node"
-    ]
-  },
-  "include": [
-    "src/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/templates/nodejs-express/pro/mvc/.env.example.hbs

@@ -1,19 +0,0 @@
-# {{projectName}} Environment Variables
-
-# Server
-NODE_ENV=development
-PORT=3000
-
-# Database
-DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{projectNameSnakeCase}}
-
-# Authentication
-JWT_SECRET=your-super-secret-jwt-key-change-in-production
-
-# Stripe
-STRIPE_SECRET_KEY=sk_test_your_stripe_secret_key
-STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret
-STRIPE_PRICE_ID=price_your_price_id
-
-# Frontend URL (for redirects)
-FRONTEND_URL=http://localhost:3001

package/templates/nodejs-express/pro/mvc/.github/workflows/ci-cd.yml.hbs

@@ -1,88 +0,0 @@
-name: CI/CD Pipeline
-
-on:
-  push:
-    branches: [main, develop]
-    pull_request:
-      branches: [main]
-
-      env:
-        NODE_VERSION: '20'
-        AWS_REGION: 'us-east-1'
-
-        jobs:
-          test:
-            runs-on: ubuntu-latest
-
-            steps:
-              - uses: actions/checkout@v4
-
-              - name: Setup Node.js
-              uses: actions/setup-node@v4
-              with:
-                node-version: $\{{ env.NODE_VERSION }}
-                cache: 'npm'
-
-                - name: Install dependencies
-                run: npm ci
-
-                - name: Run linter
-                run: npm run lint --if-present
-
-                - name: Run tests
-                run: npm test --if-present
-
-                - name: Build
-                run: npm run build
-
-                build-and-push:
-                  needs: test
-                  runs-on: ubuntu-latest
-                  if: github.ref == 'refs/heads/main'
-
-                  steps:
-                    - uses: actions/checkout@v4
-
-                    - name: Configure AWS credentials
-                    uses: aws-actions/configure-aws-credentials@v4
-                    with:
-                      aws-access-key-id: $\{{ secrets.AWS_ACCESS_KEY_ID }}
-                      aws-secret-access-key: $\{{ secrets.AWS_SECRET_ACCESS_KEY }}
-                      aws-region: $\{{ env.AWS_REGION }}
-
-                      - name: Login to Amazon ECR
-                      id: login-ecr
-                      uses: aws-actions/amazon-ecr-login@v2
-
-                      - name: Build, tag, and push image to Amazon ECR
-                      env:
-                        ECR_REGISTRY: $\{{ steps.login-ecr.outputs.registry }}
-                        ECR_REPOSITORY: {{projectNameKebabCase}}
-                        IMAGE_TAG: $\{{ github.sha }}
-                        run: |
-                        docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
-                        docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:latest .
-                        docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
-                        docker push $ECR_REGISTRY/$ECR_REPOSITORY:latest
-
-                        deploy:
-                          needs: build-and-push
-                          runs-on: ubuntu-latest
-                          if: github.ref == 'refs/heads/main'
-
-                          steps:
-                            - uses: actions/checkout@v4
-
-                            - name: Configure AWS credentials
-                            uses: aws-actions/configure-aws-credentials@v4
-                            with:
-                              aws-access-key-id: $\{{ secrets.AWS_ACCESS_KEY_ID }}
-                              aws-secret-access-key: $\{{ secrets.AWS_SECRET_ACCESS_KEY }}
-                              aws-region: $\{{ env.AWS_REGION }}
-
-                              - name: Deploy to ECS
-                              run: |
-                              aws ecs update-service \
-                              --cluster {{projectNameKebabCase}}-prod \
-                              --service {{projectNameKebabCase}}-api \
-                              --force-new-deployment

package/templates/nodejs-express/pro/mvc/Dockerfile.hbs

@@ -1,45 +0,0 @@
-# Production Dockerfile for {{projectName}}
-
-# Build stage
-FROM node:20-alpine AS builder
-
-WORKDIR /app
-
-# Copy package files
-COPY package*.json ./
-
-# Install dependencies
-RUN npm ci --only=production
-
-# Copy source code
-COPY . .
-
-# Build TypeScript
-RUN npm run build
-
-# Production stage
-FROM node:20-alpine AS production
-
-WORKDIR /app
-
-# Create non-root user
-RUN addgroup -g 1001 -S nodejs && \
-    adduser -S nodejs -u 1001
-
-# Copy built application
-COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
-COPY --from=builder --chown=nodejs:nodejs /app/node_modules ./node_modules
-COPY --from=builder --chown=nodejs:nodejs /app/package.json ./
-
-# Switch to non-root user
-USER nodejs
-
-# Expose port
-EXPOSE 3000
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
-
-# Start application
-CMD ["node", "dist/index.js"]

package/templates/nodejs-express/pro/mvc/README.md.hbs

@@ -1,85 +0,0 @@
-# {{projectName}}
-
-> Generated by [Kybernus CLI](https://kybernus.dev) 🚀 (Pro Template)
-
-## Stack
-
-- **Runtime**: Node.js 20+
-- **Framework**: Express.js
-- **Language**: TypeScript
-- **Database**: PostgreSQL
-- **Auth**: JWT
-- **Payments**: Stripe
-
-## Quick Start
-
-```bash
-# Install dependencies
-npm install
-
-# Set up environment
-cp .env.example .env
-# Edit .env with your values
-
-# Start development server
-npm run dev
-```
-
-## Pro Features
-
-### Authentication
-
-Endpoints:
-- `POST /api/auth/register` - Register new user
-- `POST /api/auth/login` - Login and get JWT
-- `GET /api/auth/me` - Get current user (protected)
-
-### Payments (Stripe)
-
-Endpoints:
-- `POST /api/payments/checkout` - Create checkout session (protected)
-- `POST /api/payments/portal` - Create customer portal (protected)
-- `POST /api/payments/webhook` - Handle Stripe webhooks
-
-## Infrastructure
-
-The `infra/` folder contains Terraform modules for AWS deployment:
-- VPC with public/private subnets
-- ECS Fargate cluster
-- RDS PostgreSQL database
-
-```bash
-cd infra
-terraform init
-terraform plan
-terraform apply
-```
-
-## Scripts
-
-| Command | Description |
-|---------|-------------|
-| `npm run dev` | Start development server |
-| `npm run build` | Build for production |
-| `npm start` | Start production server |
-| `npm test` | Run tests |
-| `npm run lint` | Run ESLint |
-
-## Docker
-
-```bash
-docker build -t {{projectNameKebabCase}} .
-docker run -p 3000:3000 {{projectNameKebabCase}}
-```
-
-## CI/CD
-
-GitHub Actions workflow included at `.github/workflows/ci-cd.yml`:
-1. Run tests
-2. Build Docker image
-3. Push to ECR
-4. Deploy to ECS
-
----
-
-Made with ❤️ using [Kybernus Pro](https://kybernus.dev/pro)

package/templates/nodejs-express/pro/mvc/docker-compose.yml.hbs

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