NexaNode Backend Framework

A modern, TypeScript-based backend framework built on Node.js, designed for creating scalable, maintainable, and type-safe applications with ease.

🚀 Core Features

• Type-Safe Architecture: Built with TypeScript for enhanced developer experience and compile-time safety
• Decorator-Based Routing: Intuitive API design using decorators for clean and maintainable code
• Base Classes: Extensible BaseController and BaseRepository for consistent patterns
• Authentication & Authorization: Built-in JWT authentication with middleware support
• Database Integration: Seamless TypeORM integration with PostgreSQL
• Rate Limiting: Configurable request rate limiting to protect your APIs
• Error Handling: Comprehensive error management system with custom error types
• Logging: Structured logging system using Winston
• Middleware Support: Flexible middleware system for request processing
• Migration Tools: Built-in database migration scripts and utilities

🛠️ Tech Stack

• Runtime: Node.js
• Language: TypeScript
• Web Framework: Express.js
• Database: PostgreSQL
• ORM: TypeORM
• Authentication: JWT
• Logging: Winston
• Request Validation: Class Validator & Class Transformer

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/nexanode.git

# Install dependencies
npm install

🔧 Configuration

1. Create a .env file in the root directory
2. Configure your environment variables:

PORT=3000
NODE_ENV=development
DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=your_username
DB_PASSWORD=your_password
DB_DATABASE=your_database
JWT_SECRET=your_jwt_secret

🚀 Quick Start

// Example Controller
import { Controller, Get, Post } from "../decorators/route";
import { BaseController } from "../core/BaseController";

@Controller("/users")
export class UserController extends BaseController {
  @Get("/")
  async getUsers() {
    return { message: "Users retrieved successfully" };
  }

  @Post("/")
  async createUser() {
    return { message: "User created successfully" };
  }
}

📚 Project Structure

src/
├── config/          # Configuration files
├── controllers/     # API Controllers
├── core/           # Framework core classes
├── decorators/     # TypeScript decorators
├── entities/       # TypeORM entities
├── middleware/     # Express middleware
├── repositories/   # Data access layer
├── scripts/        # Utility scripts
├── types/          # TypeScript type definitions
└── utils/          # Helper utilities

🔒 Security Features

• JWT-based authentication
• Rate limiting protection
• Request validation
• Secure error handling
• Type-safe operations

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.