Hono Routing Controllers

A TypeScript-based decorator-driven routing solution for Hono.js, inspired by routing-controllers, featuring dependency injection and middleware support.

Warning
⚠️ This project is currently under active development and not production-ready.
Expect breaking changes and missing features. Use at your own risk!

🚨 Important Notice

This is experimental software - not recommended for production use.
Current status: Proof of Concept stage. Core functionality is being validated.

Features

• 🎯 Decorator-based route definitions (@Controller, @Get, @Post, etc.)
• 💉 Custom dependency injection container
• 🛡️ Middleware support
• 📜 TypeScript-first approach
• 🔌 External Hono instance integration

Installation

1. Install the package:

pnpm install hono-routing-controllers

1. Install required peer dependencies:

pnpm install hono reflect-metadata

3. Add reflect-metadata import at the entry point of your application:

import 'reflect-metadata';

4. Its important to set these options in tsconfig.json file of your project:

{
  "emitDecoratorMetadata": true,
  "experimentalDecorators": true
}

🚀 Quick Start

1. Create Controller

import { Controller, Get } from 'hono-routing-controllers';
import { Context } from 'hono';

@Controller('/users')
export class UserController {
    @Get('/')
    findAll(c: Context) {
        return c.json([{ id: 1, name: 'John' }]);
    }
}

2. Initialize

import { Hono } from 'hono';
import { useRoutingController } from 'hono-routing-controllers';
import { UserController } from './controllers/UserController';

const app = new Hono();

useRoutingController(app, {
    controllers: [UserController]
});

app.listen(3000, () => {
    console.log('Server running on http://localhost:3000');
});

📚 API Reference

🎨 Decorators

| Decorator | Parameters | Description | |-------------|------------------|------------------------| | @Controller | path: string | Class route prefix | | @Get | path: string | GET route handler | | @Post | path: string | POST route handler | | @Put | path: string | PUT route handler | | @Delete | path: string | DELETE route handler | | @UseBefore | ...middlewares | Apply middleware(s) |

⚙ Configuration

useRoutingController(
  app: Hono, 
  options: {
    controllers: Array<new () => any>
  }
)

� Development

pnpm run dev
pnpm run build
pnpm run test

🛑 Current Limitations

• ❌ Missing comprehensive test coverage
• ❌ API surface may change dramatically
• ❌ Documentation is incomplete
• ❌ Not security audited
• ❌ Performance not optimized

🧪 Development Goals

| Status | Feature | |--------|--------------------------| | ✅ Done | Basic routing | | 🟡 Partial | Middleware support | | 🚧 WIP | Dependency injection | | ❌ Todo | Error handling | | ❌ Todo | Validation decorators |

🤝 Contributing

Fork the repository

1. Create your feature branch:

   git checkout -b feature/AmazingFeature

2. Commit your changes:

   git commit -m 'Add some AmazingFeature'

3. Push to the branch:

   git push origin feature/AmazingFeature

4. Open a Pull Request

📅 Roadmap

• Stable core API
• Full test coverage
• Production readiness

Experimental Use Only
This package is shared for early feedback and collaborative development.
Not suitable for mission-critical applications. Breaking changes may occur without notice.

📄 License

MIT © Hasibur Rahman