Koatty 🚀

Koa2 + TypeScript + IOC = Koatty. Koatty is a progressive Node.js framework for building efficient and scalable server-side applications. It's perfect for crafting enterprise-level APIs, microservices, and full-stack applications with TypeScript excellence.

Why Koatty? 💡

• 🚄 High Performance: Built on top of Koa2 with optimized architecture
• 🧩 Full-Featured: Supports gRPC, HTTP, WebSocket, scheduled tasks, and more
• 🧠 TypeScript First: Native TypeScript support with elegant OOP design
• 🌀 Spring-like IOC Container: Powerful dependency injection system with autowiring
• ✂️ AOP Support: Aspect-oriented programming with decorator-based interceptors
• 🔌 Extensible Architecture: Plugin system with dependency injection
• 📦 Modern Tooling: CLI scaffolding, testing utilities, and production-ready configurations
• 🌐 Protocol Agnostic: Write once, deploy as HTTP/gRPC/WebSocket services

New Features ✨

• HTTP, HTTPS, HTTP2, gRPC, and WebSocket server support ✔️
• Environment-based configuration loading, command-line argument parsing (process.argv), and environment variable parsing (process.env) ✔️
• @ExceptionHandler() for global exception handling ✔️
• Graceful shutdown and pre-exit events ✔️
• Custom decorators bound to app events ✔️
• GraphQL integration ✔️
• Full-stack tracing through OpenTelemetry ✔️
• Middleware binding to controllers and method routes ✔️
• gRPC streaming support ✔️
• Swagger OpenAPI 3.0 support 💪

Core Features ✨

📡 Multi-Protocol Support

// config/config.ts
export default {
  ...
  protocol: "grpc", // Server protocol 'http' | 'https' | 'http2' | 'grpc' | 'ws' | 'wss' | 'graphql'
  ...
}

💉 Dependency Injection

@Service()
export class UserService {
  async findUser(id: number) {
    return { id, name: 'Koatty User' };
  }
}

@Controller()
export class IndexController {
    app: App;
    ctx: KoattyContext;
    @Config("protocol")
    conf: { protocol: string };
    ...

    @Autowired()
    private userService: UserService;

    async test(id: number) {
        const info = await this.userService.findUser(id);
        ...
    }
}

✂️ Aspect-Oriented Programming

@Aspect()
export class LogAspect implements IAspect {
  app: App;

  run() {
    console.log('LogAspect');
  }
}

// Apply aspect to controller
@Controller()
@BeforeEach(LogAspect)
export class UserController {
  ...
  @After(LogAspect)
  test() {
    ...
  }
}

🔌 Plugin System

// plugin/logger.ts
export class LoggerPlugin implements IPlugin {
  app: App;

  run() {
    // todo something or hook on app.event
    Logger.Debug("LoggerPlugin");
    return Promise.resolve();
  }
}

Benchmarks 📊

Framework	Requests/sec	Latency	Memory Usage
Koatty	13,321	1.43ms	54MB
Express	12,456	1.45ms	52MB
NestJS	11,892	1.51ms	63MB

Tested on AWS t3.micro with 100 concurrent connections

Documentation 📚

• 中文文档
• Getting Started Guide
• API Reference
• Recipes & Best Practices
• Example

Quick Start ⚡

1. Install CLI:

npm install -g koatty_cli

2. Create Project:

koatty new awesome-app

3. Run Development Server:

cd awesome-app
npm run dev

Community 🌍

• GitHub Discussions

Contributors ✨

Thanks to these amazing developers:

License 📄

BSD-3 © Koatty Team