kybernus 1.0.0

package/templates/nodejs-express/free/mvc/src/controllers/healthController.ts.hbs

@@ -0,0 +1,20 @@
+import { Request, Response } from 'express';
+
+/**
+ * Health check controller
+ */
+class HealthController {
+  /**
+   * Check server health
+   */
+  check(req: Request, res: Response) {
+    res.status(200).json({
+      status: 'ok',
+      message: '{{pascalCase projectName}} API is running',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+    });
+  }
+}
+
+export default new HealthController();

package/templates/nodejs-express/free/mvc/src/index.ts.hbs

@@ -0,0 +1,12 @@
+import app from './app';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+const PORT = process.env.PORT || 3000;
+
+app.listen(PORT, () => {
+  console.log(`🚀 {{pascalCase projectName}} server running on port ${PORT}`);
+  console.log(`📝 Environment: ${process.env.NODE_ENV || 'development'}`);
+  console.log(`🔗 Health check: http://localhost:${PORT}/api/health`);
+});

package/templates/nodejs-express/free/mvc/src/middleware/errorHandler.ts.hbs

@@ -0,0 +1,22 @@
+import { Request, Response, NextFunction } from 'express';
+
+/**
+ * Global error handling middleware
+ */
+export function errorHandler(
+  err: Error,
+  req: Request,
+  res: Response,
+  next: NextFunction
+) {
+  console.error('❌ Error:', err);
+
+  const statusCode = res.statusCode !== 200 ? res.statusCode : 500;
+
+  res.status(statusCode).json({
+    error: {
+      message: err.message,
+      ...(process.env.NODE_ENV === 'development' && { stack: err.stack }),
+    },
+  });
+}

package/templates/nodejs-express/free/mvc/src/routes/index.ts.hbs

@@ -0,0 +1,14 @@
+import { Router } from 'express';
+import healthController from '../controllers/healthController';
+
+const router = Router();
+
+// Health check endpoint
+router.get('/health', healthController.check);
+
+// Add your routes here
+// Example:
+// import userRoutes from './userRoutes';
+// router.use('/users', userRoutes);
+
+export default router;

package/templates/nodejs-express/free/mvc/template.json

@@ -0,0 +1,18 @@
+{
+    "name": "Node.js Express MVC",
+    "tier": "free",
+    "stack": "nodejs-express",
+    "version": "1.0.0",
+    "description": "Express.js REST API with TypeScript and MVC architecture",
+    "targetVersions": {
+        "node": ">=18.0.0",
+        "express": "^4.18.0",
+        "typescript": "^5.0.0"
+    },
+    "requiredConfig": [
+        "projectName"
+    ],
+    "optionalConfig": [
+        "useAI"
+    ]
+}

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

@@ -0,0 +1,18 @@
+{
+  "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/clean/.env.example.hbs

@@ -0,0 +1,19 @@
+# {{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/clean/.github/workflows/ci-cd.yml.hbs

@@ -0,0 +1,88 @@
+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/clean/Dockerfile.hbs

@@ -0,0 +1,45 @@
+# 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/clean/README.md.hbs

@@ -0,0 +1,41 @@
+# {{projectName}}
+
+> Generated by [Kybernus CLI](https://kybernus.dev) 🚀 (Pro - Clean Architecture)
+
+## Architecture
+
+This project follows **Clean Architecture** principles:
+
+```
+src/
+├── domain/ # Business logic (entities, use cases)
+│ ├── entities/ # Domain models
+│ ├── repositories/ # Repository interfaces
+│ └── usecases/ # Business use cases
+├── application/ # Application services
+│ └── services/ # Use case orchestration
+├── infrastructure/ # External concerns
+│ ├── database/ # Repository implementations
+│ ├── http/ # Express controllers
+│ └── providers/ # External services (JWT, bcrypt)
+└── shared/ # Shared utilities
+```
+
+## Quick Start
+
+```bash
+npm install
+cp .env.example .env
+npm run dev
+```
+
+## Key Principles
+
+1. **Dependency Rule**: Dependencies point inward (infrastructure → application → domain)
+2. **Entities**: Pure business objects with no framework dependencies
+3. **Use Cases**: Application-specific business rules
+4. **Interface Adapters**: Controllers, presenters, gateways
+
+---
+
+Made with ❤️ using [Kybernus Pro](https://kybernus.dev/pro)

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

@@ -0,0 +1,18 @@
+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/clean/infra/main.tf.hbs

@@ -0,0 +1,83 @@
+# 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/clean/infra/modules/ecs/main.tf.hbs

@@ -0,0 +1,54 @@
+# 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
+}

package/templates/nodejs-express/pro/clean/infra/modules/rds/main.tf.hbs

@@ -0,0 +1,88 @@
+# RDS Module
+
+variable "app_name" {
+  type = string
+}
+
+variable "environment" {
+  type = string
+}
+
+variable "vpc_id" {
+  type = string
+}
+
+variable "subnet_ids" {
+  type = list(string)
+}
+
+variable "security_group_id" {
+  type = string
+}
+
+# DB Subnet Group
+resource "aws_db_subnet_group" "main" {
+  name = "${var.app_name}-${var.environment}"
+  subnet_ids = var.subnet_ids
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}"
+    Environment = var.environment
+  }
+}
+
+# RDS PostgreSQL Instance
+resource "aws_db_instance" "main" {
+  identifier = "${var.app_name}-${var.environment}"
+
+  engine = "postgres"
+  engine_version = "16"
+  instance_class = "db.t3.micro"
+
+  allocated_storage = 20
+  max_allocated_storage = 100
+  storage_type = "gp3"
+  storage_encrypted = true
+
+  db_name = replace(var.app_name, "-", "_")
+  username = "postgres"
+  password = random_password.db_password.result
+
+  db_subnet_group_name = aws_db_subnet_group.main.name
+  vpc_security_group_ids = [var.security_group_id]
+
+  backup_retention_period = 7
+  skip_final_snapshot = var.environment != "prod"
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}"
+    Environment = var.environment
+  }
+}
+
+# Random password for DB
+resource "random_password" "db_password" {
+  length = 32
+  special = false
+}
+
+# Store password in SSM
+resource "aws_ssm_parameter" "db_password" {
+  name = "/${var.app_name}/${var.environment}/db-password"
+  description = "Database password for ${var.app_name}"
+  type = "SecureString"
+  value = random_password.db_password.result
+
+  tags = {
+    Environment = var.environment
+  }
+}
+
+# Outputs
+output "endpoint" {
+  value = aws_db_instance.main.endpoint
+}
+
+output "db_name" {
+  value = aws_db_instance.main.db_name
+}

package/templates/nodejs-express/pro/clean/infra/modules/vpc/main.tf.hbs

@@ -0,0 +1,107 @@
+# VPC Module
+
+variable "app_name" {
+  type = string
+}
+
+variable "environment" {
+  type = string
+}
+
+# VPC
+resource "aws_vpc" "main" {
+  cidr_block = "10.0.0.0/16"
+  enable_dns_hostnames = true
+  enable_dns_support = true
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}-vpc"
+    Environment = var.environment
+  }
+}
+
+# Public Subnets
+resource "aws_subnet" "public" {
+  count = 2
+  vpc_id = aws_vpc.main.id
+  cidr_block = "10.0.${count.index + 1}.0/24"
+  availability_zone = data.aws_availability_zones.available.names[count.index]
+
+  map_public_ip_on_launch = true
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}-public-${count.index + 1}"
+    Environment = var.environment
+  }
+}
+
+# Private Subnets
+resource "aws_subnet" "private" {
+  count = 2
+  vpc_id = aws_vpc.main.id
+  cidr_block = "10.0.${count.index + 10}.0/24"
+  availability_zone = data.aws_availability_zones.available.names[count.index]
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}-private-${count.index + 1}"
+    Environment = var.environment
+  }
+}
+
+# Internet Gateway
+resource "aws_internet_gateway" "main" {
+  vpc_id = aws_vpc.main.id
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}-igw"
+    Environment = var.environment
+  }
+}
+
+# Data source for AZs
+data "aws_availability_zones" "available" {
+  state = "available"
+}
+
+# Security Group for DB
+resource "aws_security_group" "db" {
+  name = "${var.app_name}-${var.environment}-db-sg"
+  description = "Security group for database"
+  vpc_id = aws_vpc.main.id
+
+  ingress {
+    from_port = 5432
+    to_port = 5432
+    protocol = "tcp"
+    cidr_blocks = ["10.0.0.0/16"]
+  }
+
+  egress {
+    from_port = 0
+    to_port = 0
+    protocol = "-1"
+    cidr_blocks = ["0.0.0.0/0"]
+  }
+
+  tags = {
+    Name = "${var.app_name}-${var.environment}-db-sg"
+    Environment = var.environment
+  }
+}
+
+# Outputs
+output "vpc_id" {
+  value = aws_vpc.main.id
+}
+
+output "public_subnet_ids" {
+  value = aws_subnet.public[*].id
+}
+
+output "private_subnet_ids" {
+  value = aws_subnet.private[*].id
+}
+
+output "db_security_group_id" {
+  value = aws_security_group.db.id
+}