rapidkit 0.11.2 → 0.12.0

package/templates/kits/fastapi-standard/rapidkit.j2

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# RapidKit CLI - Local project commands
+# This wrapper delegates to .rapidkit/cli.py with smart Python detection
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CLI_PY="${SCRIPT_DIR}/.rapidkit/cli.py"
+
+# Find the best Python to use
+find_python() {
+  # 1. Project venv
+  if [ -x "${SCRIPT_DIR}/.venv/bin/python" ]; then
+    echo "${SCRIPT_DIR}/.venv/bin/python"
+    return 0
+  fi
+  
+  # 2. Poetry's python
+  if command -v poetry >/dev/null 2>&1; then
+    POETRY_PY="$(poetry env info --executable 2>/dev/null || true)"
+    if [ -n "$POETRY_PY" ] && [ -x "$POETRY_PY" ]; then
+      echo "$POETRY_PY"
+      return 0
+    fi
+  fi
+  
+  # 3. System python3
+  if command -v python3 >/dev/null 2>&1; then
+    echo "python3"
+    return 0
+  fi
+  
+  # 4. System python
+  if command -v python >/dev/null 2>&1; then
+    echo "python"
+    return 0
+  fi
+  
+  return 1
+}
+
+# Find Python
+PYTHON_CMD="$(find_python)" || {
+  echo "❌ No Python interpreter found."
+  echo "💡 Install Python 3.11+ and try again."
+  exit 127
+}
+
+# Execute the CLI
+exec "$PYTHON_CMD" "$CLI_PY" "$@"

package/templates/kits/fastapi-standard/src/main.py.j2

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+from contextlib import asynccontextmanager
+from typing import AsyncIterator
+
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 
@@ -9,12 +12,24 @@ from fastapi.middleware.cors import CORSMiddleware
 
 from .routing import api_router
 
+
+@asynccontextmanager
+async def lifespan(app: FastAPI) -> AsyncIterator[None]:
+    """Application lifespan context manager for startup/shutdown events."""
+    # Startup
+    # <<<inject:startup>>>
+    yield
+    # Shutdown
+    # <<<inject:shutdown>>>
+
+
 app = FastAPI(
     title="{{ project_name }}",
     description="{{ description }}",
     version="{{ app_version }}",
     docs_url="/docs",
     redoc_url="/redoc",
+    lifespan=lifespan,
 )
 
 app.add_middleware(
@@ -27,15 +42,3 @@ app.add_middleware(
 
 app.include_router(api_router, prefix="/api")
 # <<<inject:routes>>>
-
-
-@app.on_event("startup")
-async def _on_startup() -> None:
-    """Execute startup hooks provided by modules."""
-    # <<<inject:startup>>>
-
-
-@app.on_event("shutdown")
-async def _on_shutdown() -> None:
-    """Execute shutdown hooks provided by modules."""
-    # <<<inject:shutdown>>>

package/templates/kits/nestjs-standard/.env.example.j2

@@ -0,0 +1,16 @@
+# Application
+APP_NAME={{ project_name | upper | replace('-', '_') }}
+PORT=8000
+HOST=0.0.0.0
+NODE_ENV=development
+
+# Security
+JWT_SECRET=your-super-secret-jwt-key-change-in-production
+JWT_EXPIRATION=1h
+
+# Database (optional)
+# DATABASE_URL=postgresql://user:password@localhost:5432/{{ project_name | replace('-', '_') }}
+
+# Redis (optional)
+# REDIS_HOST=localhost
+# REDIS_PORT=6379

package/templates/kits/nestjs-standard/.eslintrc.js.j2

@@ -0,0 +1,25 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: ['tsconfig.json'],
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'warn',
+  },
+};

package/templates/kits/nestjs-standard/.gitignore.j2

@@ -0,0 +1,26 @@
+# Node artifacts
+node_modules/
+dist/
+.tmp/
+.env
+.env.*
+!.env.example
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDEs
+.idea/
+.vscode/
+
+# Coverage
+coverage/

package/templates/kits/nestjs-standard/.node-version.j2

@@ -0,0 +1 @@
+20

package/templates/kits/nestjs-standard/.nvmrc.j2

@@ -0,0 +1 @@
+20

package/templates/kits/nestjs-standard/.prettierrc.j2

@@ -0,0 +1,7 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "semi": true
+}

package/templates/kits/nestjs-standard/.rapidkit/activate.j2

@@ -0,0 +1,25 @@
+#!/bin/bash
+# RapidKit Environment Activation
+# Usage: source .rapidkit/activate
+
+# Get the directory where this script is located
+RAPIDKIT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$RAPIDKIT_DIR")"
+
+# Add project root to PATH (where rapidkit script lives)
+if [[ ":$PATH:" != *":$PROJECT_ROOT:"* ]]; then
+    export PATH="$PROJECT_ROOT:$PATH"
+    echo "✅ RapidKit activated! You can now use 'rapidkit' commands directly."
+else
+    echo "ℹ️  RapidKit already activated."
+fi
+
+# Show available commands
+echo ""
+echo "📚 Available commands:"
+echo "   rapidkit dev      - Start development server"
+echo "   rapidkit init     - Install dependencies" 
+echo "   rapidkit build    - Build for production"
+echo "   rapidkit test     - Run tests"
+echo "   rapidkit --help   - Show all commands"
+echo ""

package/templates/kits/nestjs-standard/.rapidkit/project.json.j2

@@ -0,0 +1,7 @@
+{
+  "kit_name": "nestjs.standard",
+  "profile": "nestjs/standard",
+  "project_name": "{{ project_name }}",
+  "created_at": "{{ created_at }}",
+  "rapidkit_version": "npm-{{ rapidkit_version }}"
+}

package/templates/kits/nestjs-standard/.rapidkit/rapidkit.j2

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+# RapidKit CLI wrapper for NestJS projects (npm demo template)
+# This script provides local commands that mirror the full RapidKit engine.
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+print_banner() {
+    local emoji="$1"
+    local message="$2"
+    echo "$emoji $message"
+}
+
+check_node() {
+    if ! command -v node &> /dev/null; then
+        echo "❌ Node.js not found. Please install Node.js first."
+        exit 1
+    fi
+}
+
+check_npm_or_pnpm() {
+    if command -v pnpm &> /dev/null; then
+        echo "pnpm"
+    elif command -v npm &> /dev/null; then
+        echo "npm"
+    else
+        echo "❌ Neither npm nor pnpm found. Please install Node.js first."
+        exit 1
+    fi
+}
+
+cmd_init() {
+    print_banner "📦" "Bootstrapping NestJS project (installing dependencies)"
+    check_node
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        pnpm install
+    else
+        npm install
+    fi
+    
+    echo "✅ Dependencies installed successfully!"
+}
+
+cmd_dev() {
+    local port="${1:-8000}"
+    local host="${2:-0.0.0.0}"
+    
+    print_banner "🚀" "Starting NestJS development server with hot reload..."
+    check_node
+    
+    if [ ! -d "node_modules" ]; then
+        echo "❌ node_modules not found. Run 'rapidkit init' first."
+        exit 1
+    fi
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        PORT="$port" HOST="$host" pnpm run start:dev
+    else
+        PORT="$port" HOST="$host" npm run start:dev
+    fi
+}
+
+cmd_start() {
+    local port="${1:-8000}"
+    local host="${2:-0.0.0.0}"
+    
+    print_banner "⚡" "Starting NestJS production server..."
+    check_node
+    
+    if [ ! -d "node_modules" ]; then
+        echo "❌ node_modules not found. Run 'rapidkit init' first."
+        exit 1
+    fi
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        PORT="$port" HOST="$host" pnpm run start:prod
+    else
+        PORT="$port" HOST="$host" npm run start:prod
+    fi
+}
+
+cmd_build() {
+    print_banner "📦" "Building NestJS project..."
+    check_node
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        pnpm run build
+    else
+        npm run build
+    fi
+    
+    echo "✅ Build completed!"
+}
+
+cmd_test() {
+    print_banner "🧪" "Running tests..."
+    check_node
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        pnpm run test
+    else
+        npm run test
+    fi
+}
+
+cmd_lint() {
+    print_banner "🔧" "Running ESLint..."
+    check_node
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        pnpm run lint
+    else
+        npm run lint
+    fi
+}
+
+cmd_format() {
+    print_banner "✨" "Formatting code with Prettier..."
+    check_node
+    
+    local pkg_manager=$(check_npm_or_pnpm)
+    
+    if [ "$pkg_manager" = "pnpm" ]; then
+        pnpm run format
+    else
+        npm run format
+    fi
+}
+
+cmd_help() {
+    print_banner "📚" "RapidKit NestJS Project Commands"
+    echo ""
+    echo "Usage: rapidkit <command> [options]"
+    echo ""
+    echo "Commands:"
+    echo "  init         📦 Initialize project (install dependencies)"
+    echo "  dev          🚀 Start development server with hot reload"
+    echo "  start        ⚡ Start production server"
+    echo "  build        📦 Build for production"
+    echo "  test         🧪 Run tests"
+    echo "  lint         🔧 Lint code"
+    echo "  format       ✨ Format code"
+    echo "  help         📚 Show this help"
+    echo ""
+    echo "Options for dev/start:"
+    echo "  -p, --port <port>   Port number (default: 8000)"
+    echo "  --host <host>       Host address (default: 0.0.0.0)"
+    echo ""
+    echo "💡 Note: This is a demo project. For full RapidKit features:"
+    echo "   pipx install rapidkit"
+}
+
+# Parse command
+COMMAND="${1:-help}"
+shift || true
+
+# Parse options
+PORT="8000"
+HOST="0.0.0.0"
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -p|--port)
+            PORT="$2"
+            shift 2
+            ;;
+        --host)
+            HOST="$2"
+            shift 2
+            ;;
+        -h|--help)
+            cmd_help
+            exit 0
+            ;;
+        *)
+            shift
+            ;;
+    esac
+done
+
+case "$COMMAND" in
+    init)
+        cmd_init
+        ;;
+    dev)
+        cmd_dev "$PORT" "$HOST"
+        ;;
+    start)
+        cmd_start "$PORT" "$HOST"
+        ;;
+    build)
+        cmd_build
+        ;;
+    test)
+        cmd_test
+        ;;
+    lint)
+        cmd_lint
+        ;;
+    format)
+        cmd_format
+        ;;
+    help|-h|--help)
+        cmd_help
+        ;;
+    *)
+        echo "❌ Unknown command: $COMMAND"
+        echo ""
+        cmd_help
+        exit 1
+        ;;
+esac

package/templates/kits/nestjs-standard/README.md.j2

@@ -0,0 +1,97 @@
+# {{ project_name | replace('-', ' ') | title }}
+
+{{ description }}
+
+A production-ready NestJS 11 application generated with RapidKit.
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Node.js >= 20 (check with `node --version`)
+- {{ package_manager }} package manager
+
+### Installation
+
+```bash
+# Install dependencies
+{{ package_manager }} install
+
+# Copy environment file
+cp .env.example .env
+
+# Start development server
+{{ package_manager }} run dev
+```
+
+Your API will be available at `http://localhost:8000`
+API docs available at `http://localhost:8000/docs`
+
+## 📚 Available Scripts
+
+| Command | Description |
+|---------|-------------|
+| `{{ package_manager }} run dev` | Start development server with hot reload |
+| `{{ package_manager }} run build` | Build for production |
+| `{{ package_manager }} start` | Start production server |
+| `{{ package_manager }} test` | Run unit tests |
+| `{{ package_manager }} run test:e2e` | Run e2e tests |
+| `{{ package_manager }} run test:cov` | Run tests with coverage |
+| `{{ package_manager }} run lint` | Lint and fix code |
+| `{{ package_manager }} run format` | Format code with Prettier |
+
+## 📁 Project Structure
+
+```
+{{ project_name }}/
+├── src/
+│   ├── main.ts              # Application entry point
+│   ├── app.module.ts        # Root module
+│   ├── app.controller.ts    # Root controller
+│   ├── app.service.ts       # Root service
+│   ├── config/              # Configuration module
+│   ├── examples/            # Example feature module
+│   └── modules/             # RapidKit modules
+├── test/                    # Test files
+├── package.json             # Dependencies
+├── tsconfig.json            # TypeScript config
+└── nest-cli.json            # NestJS CLI config
+```
+
+## 🔧 Configuration
+
+Environment variables are managed through `.env` file:
+
+- `APP_NAME` - Application name
+- `PORT` - Server port (default: 8000)
+- `HOST` - Server host (default: 0.0.0.0)
+- `NODE_ENV` - Environment (development/production/test)
+
+## 🧪 Example API
+
+The scaffold includes an example Notes API:
+
+```bash
+# Create a note
+curl -X POST http://localhost:8000/examples/notes \
+  -H "Content-Type: application/json" \
+  -d '{"title":"Hello","body":"World"}'
+
+# List all notes
+curl http://localhost:8000/examples/notes
+
+# Get health status
+curl http://localhost:8000/health
+```
+
+## 📖 Learn More
+
+- [NestJS Documentation](https://docs.nestjs.com)
+- [RapidKit Documentation](https://rapidkit.top)
+
+## 📄 License
+
+This project is licensed under the {{ license }} License.
+
+---
+Generated with ❤️ by RapidKit

package/templates/kits/nestjs-standard/jest.config.ts.j2

@@ -0,0 +1,21 @@
+import type { Config } from 'jest';
+
+const config: Config = {
+  moduleFileExtensions: ['js', 'json', 'ts'],
+  rootDir: '.',
+  testEnvironment: 'node',
+  testRegex: '.*\\.spec.ts$',
+  transform: {
+    '^.+\\.ts$': 'ts-jest',
+  },
+  collectCoverageFrom: ['src/**/*.{ts,tsx}', '!src/**/*.module.ts'],
+  coverageDirectory: './coverage',
+  moduleNameMapper: {
+    '^@config/(.*)$': '<rootDir>/src/config/$1',
+    '^@modules/(.*)$': '<rootDir>/src/modules/$1',
+    '^@shared/(.*)$': '<rootDir>/src/shared/$1',
+  },
+  setupFiles: ['dotenv/config'],
+};
+
+export default config;

package/templates/kits/nestjs-standard/nest-cli.json.j2

@@ -0,0 +1,10 @@
+{
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "entryFile": "main",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "webpack": false,
+    "tsConfigPath": "tsconfig.build.json"
+  }
+}

package/templates/kits/nestjs-standard/package.json.j2

@@ -0,0 +1,75 @@
+{
+  "name": "{{ project_name | replace('_', '-') | lower }}",
+  "version": "{{ app_version }}",
+  "description": "{{ description }}",
+  "license": "{{ license }}",
+  "author": "{{ author }}",
+  "engines": {
+    "node": ">=20"
+  },
+  "private": true,
+  "scripts": {
+    "rapidkit": "./.rapidkit/rapidkit",
+    "rapidkit:init": "npm install",
+    "rapidkit:dev": "./.rapidkit/rapidkit dev",
+    "rapidkit:start": "./.rapidkit/rapidkit start",
+    "rapidkit:build": "./.rapidkit/rapidkit build",
+    "rapidkit:test": "./.rapidkit/rapidkit test",
+    "rapidkit:lint": "./.rapidkit/rapidkit lint",
+    "rapidkit:format": "./.rapidkit/rapidkit format",
+    "start": "node dist/main",
+    "dev": "nest start --watch",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "build": "nest build",
+    "lint": "eslint \"{src,test}/**/*.ts\" --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.6",
+    "@nestjs/swagger": "^11.2.3",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.0",
+    "reflect-metadata": "^0.2.1",
+    "rxjs": "^7.8.1",
+    "helmet": "^7.0.0",
+    "compression": "^1.7.4",
+    "winston": "^3.11.0",
+    "joi": "^17.12.1",
+    "@nestjs/terminus": "^11.0.0",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.10",
+    "@nestjs/schematics": "^11.0.7",
+    "@nestjs/testing": "^11.1.6",
+    "@types/compression": "^1.7.5",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.8.5",
+    "@types/supertest": "^2.0.16",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.1.4",
+    "ts-jest": "^29.4.5",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/kits/nestjs-standard/rapidkit.j2

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# RapidKit CLI - Local project commands
+# This wrapper delegates to .rapidkit/rapidkit
+
+exec "$(dirname "$0")/.rapidkit/rapidkit" "$@"

package/templates/kits/nestjs-standard/src/app.controller.ts.j2

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get('health')
+  getHealth() {
+    return this.appService.getHealth();
+  }
+}