Asena

Appearance

Roadmap ​

This page outlines the current state of Asena Framework and our plans for future development. Our goal is to build a production-ready, high-performance IoC framework for Bun with enterprise-grade features.

Living Document

This roadmap is updated regularly as we complete features and adjust priorities based on community feedback.

✅ Current Release (v0.7.x) ​

These features are stable and production-ready in the current release:

Core Framework ​

  • Dependency Injection Container - Full IoC container with constructor, property, and method injection
  • Decorator-Based API - TypeScript decorators for controllers, services, middleware, and more
  • Controller System - REST API controllers with route decorators (@Get, @Post, @Put, @Delete, @Patch, @All, @Route)
  • Service Layer - Service components with lifecycle management
  • Middleware System - Global, pattern-based, controller, and route-level middleware
  • Context API - Unified request context abstraction across adapters
  • WebSocket Support - Decorator-based WebSocket with namespace, room management, and multi-pod transport
  • Configuration Management - @Config decorator for server configuration
  • EventService Support - Built-in native EventService support with @EventService and @On
  • Scheduled Tasks - Cron-based task scheduling with @Schedule and CronRunner
  • FrontendController - Serve HTML pages using Bun's native HTML imports with @FrontendController and @Page
  • PostProcessor - Component lifecycle hooks for metadata collection and instance transformation
  • SSE/Streaming - Server-Sent Events with stream(), streamSSE(), streamText()
  • Duplicate Route Detection - Prevents accidental route conflicts at startup
  • Graceful Server Shutdown - server.stop() with proper resource cleanup

Adapters ​

  • Ergenecore Adapter - Native Bun adapter with SIMD-accelerated routing, streaming, and unified HttpException
  • Hono Adapter - Hono-based adapter with strict mode (trailing slash), streaming, and middleware compatibility

Official Packages ​

CLI Tools ​

  • Project Scaffolding - asena create command for project generation
  • Code Generation - Generate controllers, services, middleware, WebSocket services
  • Project Bundling - asena build command bundles your project based on asena-config.ts, significantly improving performance by reducing cold start time and package size

📋 Planned for v1.0 ​

These features are planned for the v1.0 release and will make Asena enterprise-ready:

Plugin System ​

A powerful plugin architecture allowing third-party extensions.

Features:

  • Plugin lifecycle hooks (onLoad, onStart, onStop)
  • Plugin dependency resolution
  • Plugin configuration management
  • Official plugin registry

Use Cases:

  • Authentication plugins (OAuth, JWT, SAML)
  • Database adapters (PostgreSQL, MySQL, MongoDB)
  • Monitoring and APM integrations

💡 Future Ideas (CLI) ​

These features are under consideration for future CLI releases:

Dev Console (Quarkus-inspired) ​

Interactive development console for debugging and inspection.

Planned Features:

  • Web-based dashboard running during development
  • Live route inspection and testing
  • Request/response logging
  • Performance metrics in real-time

Inspiration: Similar to Quarkus Dev UI

Container Visualizer ​

Visual representation of IoC container dependencies.

Planned Features:

  • Dependency graph visualization
  • Service lifecycle tracking
  • Circular dependency detection

Benefits:

  • Understanding service dependencies

No Timeline Yet

These CLI features are ideas under discussion and do not have a fixed release timeline.

🎯 Release Philosophy ​

Version Strategy ​

  • v0.x.x - Pre-1.0 releases with breaking changes possible
  • v1.0.0 - First stable release with API stability guarantees
  • v1.x.x - Patch and minor releases with backward compatibility
  • v2.0.0 - Major release with new features and potential breaking changes

Stability Guarantees ​

VersionStatusBreaking ChangesProduction Use
v0.6.xPreviousPossibleYes (with caution)
v0.7.xCurrentPossibleYes (with caution)
v1.0.0+StableSemantic versioningRecommended

Development Priorities ​

  1. Stability First - Bug fixes and reliability improvements take priority
  2. Performance - Maintain Bun's performance advantages
  3. Developer Experience - Clear APIs, great documentation, helpful errors
  4. Community Feedback - Feature requests and issues guide our roadmap

🤝 Community Involvement ​

How to Contribute ​

We welcome contributions in many forms:

  • Code Contributions - Submit PRs for features or bug fixes
  • Documentation - Improve guides, add examples, fix typos
  • Feature Requests - Open GitHub issues with your ideas
  • Bug Reports - Report issues with reproducible examples
  • Testing - Test pre-release versions and provide feedback

Feature Request Process ​

  1. Open a GitHub issue with the feature-request label
  2. Describe the use case and expected behavior
  3. Community discussion and feedback
  4. Core team review and prioritization
  5. Implementation and release

📅 Release Schedule ​

Current Cycle ​

  • v0.7.0 - Released April 2026 (OpenAPI, Redis, OTel, FrontendController, Schedule, PostProcessor, Streaming)
  • v1.0.0 - TBD (Plugin system)

Follow Progress

Track development progress on our GitHub repository and join discussions in GitHub Issues.

🔮 Long-Term Vision ​

Our vision for Asena is to become the go-to framework for Bun-based web applications, combining:

  • Enterprise-Grade Features - Plugin system, observability, API documentation
  • Developer Experience - Intuitive APIs, excellent tooling, comprehensive docs
  • Performance - Native Bun speed with minimal overhead
  • Ecosystem - Rich collection of official and community packages

Released under the MIT License.

Copyright © 2024-present Asena Framework