kybernus 1.0.1 → 1.1.0

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:

package/templates/nodejs-express/pro/mvc/infra/main.tf.hbs

@@ -1,83 +0,0 @@
-# Terraform Infrastructure for {{projectName}}
-
-terraform {
-  required_version = ">= 1.0.0"
-
-  required_providers {
-    aws = {
-      source = "hashicorp/aws"
-      version = "~> 5.0"
-    }
-  }
-
-# Uncomment for remote state (recommended for production)
-# backend "s3" {
-# bucket = "your-terraform-state-bucket"
-# key = "{{projectNameKebabCase}}/terraform.tfstate"
-# region = "us-east-1"
-# encrypt = true
-# dynamodb_table = "terraform-locks"
-# }
-}
-
-provider "aws" {
-  region = var.aws_region
-}
-
-# Variables
-variable "aws_region" {
-  description = "AWS region"
-  type = string
-  default = "us-east-1"
-}
-
-variable "environment" {
-  description = "Environment name (dev, staging, prod)"
-  type = string
-  default = "dev"
-}
-
-variable "app_name" {
-  description = "Application name"
-  type = string
-  default = "{{projectNameKebabCase}}"
-}
-
-# VPC
-module "vpc" {
-  source = "./modules/vpc"
-
-  app_name = var.app_name
-  environment = var.environment
-}
-
-# ECS Cluster
-module "ecs" {
-  source = "./modules/ecs"
-
-  app_name = var.app_name
-  environment = var.environment
-  vpc_id = module.vpc.vpc_id
-  subnet_ids = module.vpc.private_subnet_ids
-}
-
-# RDS PostgreSQL
-module "rds" {
-  source = "./modules/rds"
-
-  app_name = var.app_name
-  environment = var.environment
-  vpc_id = module.vpc.vpc_id
-  subnet_ids = module.vpc.private_subnet_ids
-  security_group_id = module.vpc.db_security_group_id
-}
-
-# Outputs
-output "ecs_cluster_name" {
-  value = module.ecs.cluster_name
-}
-
-output "rds_endpoint" {
-  value = module.rds.endpoint
-  sensitive = true
-}

package/templates/nodejs-express/pro/mvc/infra/modules/ecs/main.tf.hbs

@@ -1,54 +0,0 @@
-# ECS Module
-
-variable "app_name" {
-  type = string
-}
-
-variable "environment" {
-  type = string
-}
-
-variable "vpc_id" {
-  type = string
-}
-
-variable "subnet_ids" {
-  type = list(string)
-}
-
-# ECS Cluster
-resource "aws_ecs_cluster" "main" {
-  name = "${var.app_name}-${var.environment}"
-
-  setting {
-    name = "containerInsights"
-    value = "enabled"
-  }
-
-  tags = {
-    Name = "${var.app_name}-${var.environment}"
-    Environment = var.environment
-  }
-}
-
-# ECS Capacity Provider
-resource "aws_ecs_cluster_capacity_providers" "main" {
-  cluster_name = aws_ecs_cluster.main.name
-
-  capacity_providers = ["FARGATE", "FARGATE_SPOT"]
-
-  default_capacity_provider_strategy {
-    base = 1
-    weight = 100
-    capacity_provider = "FARGATE"
-  }
-}
-
-# Outputs
-output "cluster_name" {
-  value = aws_ecs_cluster.main.name
-}
-
-output "cluster_arn" {
-  value = aws_ecs_cluster.main.arn
-}