# Asena

> High-performance IoC web framework built on Bun runtime with decorator-based dependency injection, achieving 200k-300k requests/sec.

- Skill: `hk-vk/asena` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add hk-vk/asena`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hk-vk/asena/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hk-vk (https://skillmd.com/u/hk-vk)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/hk-vk/asena

---


# Testing Examples

> High-performance IoC web framework built on Bun runtime with decorator-based dependency injection, achieving 200k-300k requests/sec.

Section: Docs
Source: https://asena.sh/raw/philosophy.md

`Spring Boot` and `Quarkus` have established proven patterns for enterprise application development, but developers transitioning to TypeScript often find themselves reimplementing familiar concepts or adapting to unfamiliar architectures. `AsenaJS` addresses this gap by bringing automatic component discovery and field-based dependency injection to the `Bun` ecosystem.

The framework eliminates boilerplate through automatic scanning of decorator-annotated classes, removing the need for explicit module declarations or manual wiring. Components marked with `@Controller`, `@Service`, or `@Repository` (via the asena-drizzle package) are discovered and registered automatically, allowing developers to focus on business logic rather than configuration. Combined with Bun's native performance characteristics, this delivers both the familiar developer experience of Spring Boot and the speed expected from a modern JavaScript runtime.

`AsenaJS` is designed to make developers familiar with `Spring Boot` and `Quarkus` feel at home in the TypeScript ecosystem. As the framework evolves, we remain committed to this philosophy — bringing more proven patterns from the Java world while maintaining the performance advantages that `Bun` provides and the flexibility of TypeScript.

## Available Resources

### Core Principles

### What Asena Is Not

### Related

- **Get Started**
  - URL: /docs/get-started

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Adapters Overview**
  - URL: /docs/adapters/overview

- **Testing Overview**
  - URL: /docs/testing/overview

- **Roadmap**
  - URL: /docs/roadmap

### Prerequisites

- **Bun**
  - URL: https://bun.sh

### Option 1: With Asena CLI (Recommended)

### Option 2: Manual Setup

### Project Structure

### Next Steps

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **Scheduled Tasks**
  - URL: /docs/concepts/scheduled-tasks

- **Frontend Controller**
  - URL: /docs/concepts/frontend-controller

- **OpenAPI**
  - URL: /docs/packages/openapi

- **Redis**
  - URL: /docs/packages/redis

- **CLI Commands**
  - URL: /docs/cli/commands

- **Examples**
  - URL: /docs/examples

### Common Issues

### Complete REST API

### WebSocket Chat Application

### Authentication with Middleware

### Rate Limiting

### CORS Configuration

### OpenAPI Auto-Documentation

### Redis Caching

### Scheduled Tasks

### Frontend Controller

### Related Documentation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Scheduled Tasks**
  - URL: /docs/concepts/scheduled-tasks

- **Frontend Controller**
  - URL: /docs/concepts/frontend-controller

- **PostProcessor**
  - URL: /docs/concepts/post-processor

- **OpenAPI Package**
  - URL: /docs/packages/openapi

- **Redis Package**
  - URL: /docs/packages/redis

- **Drizzle Package**
  - URL: /docs/packages/drizzle

- **Logger Package**
  - URL: /docs/packages/logger

### Production Applications

### Why These Projects Chose Asena

### Stats & Insights

### Submit Your Project

- **GitHub Issues**
  - URL: https://github.com/AsenaJs/Asena/issues/new

- **Edit on GitHub**
  - URL: https://github.com/AsenaJs/Website/edit/master/docs/showcase.md

- **Link**: **Include This Information**
```markdown
- Project Name: [Name]
- Website: 
- Description: [Brief description]
- GitHub: https://github.com/... (optional)
- Tech Stack: [Technologies used] (optional)
- Asena Features: [Controllers, WebSocket, etc.]
```
  - URL: https://...

### Get Inspired

- **Get Started**
  - URL: /docs/get-started

- **Examples**
  - URL: /docs/examples

- **WebSocket Guide**
  - URL: /docs/concepts/websocket

- **OpenAPI**
  - URL: /docs/packages/openapi

- **Redis**
  - URL: /docs/packages/redis

- **Scheduled Tasks**
  - URL: /docs/concepts/scheduled-tasks

- **CLI Tools**
  - URL: /docs/cli/overview

### Community

- **AsenaJs/Asena**
  - URL: https://github.com/AsenaJs/Asena

- **Report bugs or request features**
  - URL: https://github.com/AsenaJs/Asena/issues

### Related

- **Examples**
  - URL: /docs/examples

- **Roadmap**
  - URL: /docs/roadmap

- **Get Started**
  - URL: /docs/get-started

- **GitHub Repository**
  - URL: https://github.com/AsenaJs/Asena

### ✅ Current Release (v0.10.x)

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Signal handling**
  - URL: /docs/concepts/lifecycle#signal-handling

- **`keepAlive`**
  - URL: /docs/concepts/lifecycle#keepalive-and-headless-workers

- **Liveness and readiness probes**
  - URL: /docs/concepts/lifecycle#health-probes

- **Decorator Inheritance**
  - URL: /docs/concepts/inheritance

- **its own config hook**
  - URL: /docs/guides/error-handling#not-found

- **Uniform error handling**
  - URL: /docs/guides/error-handling#adapter-logging

- **One `HttpException`**
  - URL: /docs/guides/error-handling#throwing-http-exceptions

- **Validation**
  - URL: /docs/concepts/validation

- **Static File Serving**
  - URL: /docs/concepts/static-files

- **multi-pod transport**
  - URL: /docs/concepts/websocket#multi-pod-websocket

- **Ulak**
  - URL: /docs/concepts/ulak

- **Scheduled Tasks**
  - URL: /docs/concepts/scheduled-tasks

- **FrontendController**
  - URL: /docs/concepts/frontend-controller

- **PostProcessor**
  - URL: /docs/concepts/post-processor

- **Graceful Server Shutdown**
  - URL: /docs/concepts/lifecycle#stop-sequence

- **Microservices**
  - URL: /docs/concepts/microservices

- **mockComponent**
  - URL: /docs/testing/mock-component

- **createTestApp**
  - URL: /docs/testing/test-app

- **createWebTest**
  - URL: /docs/testing/web-test

- **strict mode (trailing slash)**
  - URL: /docs/adapters/hono#trailing-slash-strict-mode

- **@asenajs/asena-logger**
  - URL: /docs/packages/logger

- **@asenajs/asena-drizzle**
  - URL: /docs/packages/drizzle

- **@asenajs/asena-openapi**
  - URL: /docs/packages/openapi

- **@asenajs/asena-redis**
  - URL: /docs/packages/redis

- **@asenajs/asena-kafka**
  - URL: /docs/packages/kafka

- **@asenajs/asena-otel**
  - URL: /docs/packages/opentelemetry

- **`asena-config.ts`**
  - URL: /docs/cli/configuration

### 📋 Planned for v1.0

- **shipped in v0.10**
  - URL: /docs/concepts/lifecycle

### 💡 Future Ideas (CLI)

### 🎯 Release Philosophy

### 🤝 Community Involvement

### 📅 Release Schedule

### 🔮 Long-Term Vision

### Related

- **Get Started**
  - URL: /docs/get-started

- **CLI Overview**
  - URL: /docs/cli/overview

- **GitHub Repository**
  - URL: https://github.com/AsenaJs/Asena

- **Examples**
  - URL: /docs/examples

### Quick Start

### The @Controller Decorator

### HTTP Method Decorators

### Working with Request Data

### Sending Responses

### Context API Reference

### Service Injection

### Middleware Integration

### Validation

### Combining Features

### Best Practices

### Related Documentation

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Inheritance**
  - URL: /docs/concepts/inheritance

- **Context API**
  - URL: /docs/concepts/context

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Hono Adapter**
  - URL: /docs/adapters/hono

### What is a Service?

### Creating a Service

### Using Services in Controllers

### Service Dependencies

### Layered Architecture

### Service Patterns

### Service Scopes

### Lifecycle Hooks

### String-based vs Class-based Injection

### @Service Decorator API

### Asena-Specific Best Practices

### Testing Services

### Related Documentation

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Controllers**
  - URL: /docs/concepts/controllers

- **Ulak - WebSocket Messaging System**
  - URL: /docs/concepts/ulak

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Drizzle ORM**
  - URL: /docs/packages/drizzle

- **Testing Guide**
  - URL: /docs/guides/testing

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Inheritance**
  - URL: /docs/concepts/inheritance

- **Repository Pattern**
  - URL: /docs/packages/drizzle

- **Testing Strategies**
  - URL: /docs/guides/testing

### What is Dependency Injection?

### Basic Injection with @Inject

### Injection with Expressions

### Strategy Pattern with @Strategy

### Lifecycle Hooks

### Service Scopes

### Injecting into Different Components

### Reaching the container from outside

- **`@OnStart`**
  - URL: /docs/concepts/lifecycle

- **Inheritance**
  - URL: /docs/concepts/inheritance

### Complete Example

### Best Practices

### Related Documentation

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Services**
  - URL: /docs/concepts/services

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **Service Scopes**
  - URL: /docs/concepts/services#service-scopes

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware**
  - URL: /docs/concepts/middleware

### `@OnStart`

### `@OnStop`

### Where the hooks sit

### Ordering rules

- **Inheritance**
  - URL: /docs/concepts/inheritance

### Failure policy

### Who takes part

### Stopping the server

### Signal handling

### `keepAlive` and headless workers

### Health probes

### `server.resolve()`

### Upgrading from 0.9.x

### Related

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection#lifecycle-hooks

- **PostProcessor**
  - URL: /docs/concepts/post-processor

- **Microservices**
  - URL: /docs/concepts/microservices#graceful-shutdown

- **Inheritance**
  - URL: /docs/concepts/inheritance

- **Scheduled Tasks**
  - URL: /docs/concepts/scheduled-tasks

### What is Middleware?

### Creating Middleware

### Middleware Levels

### Common Middleware Patterns

### Built-in Middleware

### Middleware with Dependency Injection

### Middleware Execution Order

### Stopping Middleware Chain

### Best Practices

### Related Documentation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Validation**
  - URL: /docs/concepts/validation

- **Configuration**
  - URL: /docs/guides/configuration

- **Validation**
  - URL: /docs/concepts/validation

- **Context API**
  - URL: /docs/concepts/context

- **Configuration**
  - URL: /docs/guides/configuration

### What is Context?

### Quick Start

### Core Properties

### Request Data Methods

### Response Methods

### Cookie Management

### State Management

### WebSocket Support

### Streaming

### Advanced Methods

### Common Patterns

### Utility Methods

### Adapter-Specific Features

### API Reference

### Best Practices

### Related Documentation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware**
  - URL: /docs/concepts/middleware

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Hono Adapter**
  - URL: /docs/adapters/hono

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Error Handling**
  - URL: /docs/guides/error-handling

### Installation

### Why Use Validation?

### Quick Start

### ValidationService API

### Validation Hooks

### Validation Error Responses

### Integration with Controllers

### Zod Schema Definition

### Asena-Specific Best Practices

### ValidationSchema Types

### Complete Example

### Related Documentation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware**
  - URL: /docs/concepts/middleware

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Context API**
  - URL: /docs/concepts/context

- **Zod Documentation**
  - URL: https://zod.dev

- **Middleware**
  - URL: /docs/concepts/middleware

- **Error Handling**
  - URL: /docs/guides/configuration

- **Context API**
  - URL: /docs/concepts/context

### Quick Start

### Configuration

### Lifecycle Hooks

### Examples

### Best Practices

### Common Use Cases

### Troubleshooting

### Related

- **Controllers**
  - URL: /docs/concepts/controllers.md

- **Middleware**
  - URL: /docs/concepts/middleware.md

- **Context**
  - URL: /docs/concepts/context.md

### Creating a WebSocket Service

### WebSocket Lifecycle Methods

### Socket API

### Built-in Room Management

### Broadcasting

### WebSocket Middleware

### Using WebSocket in Services

### Real-World Example: Notification System

### Error Handling

### Multi-Pod WebSocket

### Best Practices

### Breaking Circular Dependencies with Ulak

### Related Documentation

- **Ulak - WebSocket Messaging System**
  - URL: /docs/concepts/ulak

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Hono Adapter**
  - URL: /docs/adapters/hono

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

### Key Features

### Quick Start

### Core Features

### Decorators

### Event Patterns

### Advanced Usage

### Examples

### Best Practices

### Troubleshooting

### Related

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection.md

- **Inheritance**
  - URL: /docs/concepts/inheritance.md

- **Services**
  - URL: /docs/concepts/services.md

- **Ulak**
  - URL: /docs/concepts/ulak.md

### Key Features

### Quick Start

### Headless Mode

### Delivery Semantics

- **start hooks run from `server.start()`**
  - URL: /docs/concepts/lifecycle#onstart

### Multiple Named Transports

### Graceful Shutdown

### InMemoryTransport (Development & Testing)

### Distributed Tracing

### Error Handling

### Writing a Custom Transport

### Comparison with the In-Process Event System

### Related

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Inheritance**
  - URL: /docs/concepts/inheritance

### The Problem

### The Solution

### Getting Started

### Three Ways to Use Ulak

### API Reference

### Error Handling

### Lifecycle Management

### Best Practices

### Testing

### Advanced Examples

### Migration Guide

### Type Definitions

### See Also

- **WebSocket**
  - URL: /docs/concepts/websocket.md

- **Microservices**
  - URL: /docs/concepts/microservices.md

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection.md

- **Services**
  - URL: /docs/concepts/services.md

- **MockComponent**
  - URL: /docs/testing/mock-component.md

### Quick Start

### @Schedule Decorator

### AsenaSchedule Interface

### Dependency Injection

### CronRunner Service

### Real-World Examples

### Best Practices

### Related Documentation

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Configuration**
  - URL: /docs/guides/configuration

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Redis**
  - URL: /docs/packages/redis

### Quick Start

### @FrontendController Decorator

### @Page Decorator

### How It Works

### Multiple Pages

### HTML File Structure

### FrontendController vs Controller

### Production Build

### Best Practices

### Related Documentation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Static File Serving**
  - URL: /docs/concepts/static-files

- **Middleware**
  - URL: /docs/concepts/middleware

- **Configuration**
  - URL: /docs/guides/configuration

- **Controllers**
  - URL: /docs/concepts/controllers

- **Static File Serving**
  - URL: /docs/concepts/static-files

- **Middleware**
  - URL: /docs/concepts/middleware

### When to Use PostProcessor

### Quick Start

### ComponentPostProcessor Interface

### @PostProcessor Decorator

### Lifecycle

- **`@OnStart`**
  - URL: /docs/concepts/lifecycle

### Two Modes of Operation

### Real-World Example: OpenAPI PostProcessor

### Bootstrap Priority

### Dependency Injection in PostProcessors

### @OnStart vs @PostProcessor

### Best Practices

### Related Documentation

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **OpenAPI**
  - URL: /docs/packages/openapi

- **Configuration**
  - URL: /docs/guides/configuration

- **OpenAPI**
  - URL: /docs/packages/openapi

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Services**
  - URL: /docs/concepts/services

### The rule, in one sentence

### What is inherited

### `@Implements` is inherited; the component name is not

### Guards follow the routes they protect

### How overrides resolve

### Conflicts that fail the build

### Inherited handlers are logged at startup

### Practical pattern: a shared platform package

### Related

- **Controllers**
  - URL: /docs/concepts/controllers

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Microservices**
  - URL: /docs/concepts/microservices

- **Event System**
  - URL: /docs/concepts/event-system

- **Drizzle**
  - URL: /docs/packages/drizzle

### What is an Adapter?

### Available Adapters

### Performance Comparison

### Feature Comparison

### Choosing the Right Adapter

### Quick Start Comparison

### Context API

### Migration Between Adapters

### Advanced Adapter Configuration

### Creating Custom Adapters

### Recommendations

### Related Documentation

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Hono Adapter**
  - URL: /docs/adapters/hono

- **Context API**
  - URL: /docs/concepts/context

- **Middleware Guide**
  - URL: /docs/concepts/middleware

- **Ergenecore features**
  - URL: /docs/adapters/ergenecore

- **Hono adapter usage**
  - URL: /docs/adapters/hono

- **Context API**
  - URL: /docs/concepts/context

### What is Ergenecore?

### Why Choose Ergenecore?

### Installation

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

- **Zod**
  - URL: https://zod.dev

### Quick Start

### Factory Functions

### Built-in Middleware

### Performance & Architecture

### Ergenecore-Specific Features

### Best Practices

### Troubleshooting

### Related Documentation

- **Adapters Overview**
  - URL: /docs/adapters/overview

- **Hono Adapter**
  - URL: /docs/adapters/hono

- **Context API**
  - URL: /docs/concepts/context

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Configuration**
  - URL: /docs/guides/configuration

- **Context API**
  - URL: /docs/concepts/context

- **Middleware patterns**
  - URL: /docs/concepts/middleware

- **Validation strategies**
  - URL: /docs/concepts/validation

### What is Hono Adapter?

### Why Choose Hono Adapter?

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

- **Hono**
  - URL: https://hono.dev

- **Zod**
  - URL: https://zod.dev

### Quick Start

### Factory Function

### Built-in Middleware

### Hono-Specific Features

### Migrating from Standalone Hono

### Testing

### Best Practices

### Troubleshooting

### Related Documentation

- **Adapters Overview**
  - URL: /docs/adapters/overview

- **Ergenecore Adapter**
  - URL: /docs/adapters/ergenecore

- **Context API**
  - URL: /docs/concepts/context

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **Testing Guide**
  - URL: /docs/guides/testing

- **Hono Documentation**
  - URL: https://hono.dev/

- **Context API**
  - URL: /docs/concepts/context

- **Middleware patterns**
  - URL: /docs/concepts/middleware

- **@Override decorator**
  - URL: /docs/concepts/middleware#override-decorator

### Installation

- **Bun**
  - URL: https://bun.sh

### Quick Start

### Using Logger in Your Application

### AsenaLogger API

### Log Levels

### Output Format

### Real-World Examples

### Custom Winston Configuration

### Best Practices

### Related Documentation

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Configuration**
  - URL: /docs/guides/configuration

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Winston Documentation**
  - URL: https://github.com/winstonjs/winston

- **Error Handling**
  - URL: /docs/guides/configuration

- **Middleware patterns**
  - URL: /docs/concepts/middleware

- **Services architecture**
  - URL: /docs/concepts/services

### Features

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

- **drizzle-orm**
  - URL: https://orm.drizzle.team

### Supported Databases

### Quick Start

### @Database Decorator API

### @Repository Decorator API

### @Drizzle Decorator API

### Database Configuration

### Repository Methods

### Advanced Queries

### Multiple Databases

### Transactions

### Best Practices

### Related Documentation

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Inheritance**
  - URL: /docs/concepts/inheritance

- **Configuration**
  - URL: /docs/guides/configuration

- **Drizzle ORM Documentation**
  - URL: https://orm.drizzle.team/

- **Services**
  - URL: /docs/concepts/services

- **Testing**
  - URL: /docs/guides/testing

### Features

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

- **Zod**
  - URL: https://zod.dev

### Quick Start

### How It Works

### Validator Mapping

### @Hidden Decorator

### Configuration

### Swagger UI

### Best Practices

### Related Documentation

- **Validation**
  - URL: /docs/concepts/validation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware**
  - URL: /docs/concepts/middleware

- **Configuration**
  - URL: /docs/guides/configuration

- **request validation**
  - URL: /docs/concepts/validation

- **Controllers**
  - URL: /docs/concepts/controllers

- **Middleware patterns**
  - URL: /docs/concepts/middleware

### Features

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

### Quick Start

### How Auto-Tracing Works

### OtelService API

### OtelTracingMiddleware

### Shutdown

### Configuration

### Sampling

### Route Exclusion

### Outgoing Request Context Propagation

### Microservice Messaging Instrumentation

### Testing

### Best Practices

### Related Documentation

- **PostProcessor**
  - URL: /docs/concepts/post-processor

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Configuration**
  - URL: /docs/guides/configuration

- **Middleware**
  - URL: /docs/concepts/middleware

- **Services**
  - URL: /docs/concepts/services

- **Sampling**
  - URL: #sampling

### Features

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

### Quick Start

### Adapter Selection

### API Reference

### Configuration

### Multi-Pod WebSocket Transport

### Microservice Transport (Redis Streams)

- **write idempotent handlers**
  - URL: /docs/concepts/microservices#idempotent-handlers

- **Reply loss across an outage**
  - URL: #reply-loss-across-an-outage

### Best Practices

### Related Documentation

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Microservices**
  - URL: /docs/concepts/microservices

- **Configuration**
  - URL: /docs/guides/configuration

- **Services**
  - URL: /docs/concepts/services

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **WebSocket**
  - URL: /docs/concepts/websocket

- **multi-pod transport**
  - URL: /docs/concepts/websocket#multi-pod-websocket

- **Services**
  - URL: /docs/concepts/services

- **microservice layer**
  - URL: /docs/concepts/microservices

### Features

### Installation

- **Bun**
  - URL: https://bun.sh

- **@asenajs/asena**
  - URL: https://github.com/AsenaJs/Asena

- **kafkajs**
  - URL: https://kafka.js.org

### Quick Start

### Service Client

### Microservice Transport

- **write idempotent handlers**
  - URL: /docs/concepts/microservices#idempotent-handlers

### External Topics (interop)

- **messageId dedup**
  - URL: /docs/concepts/microservices#idempotent-handlers

### Best Practices

### Troubleshooting

### Client Roadmap

- **bun#4290**
  - URL: https://github.com/oven-sh/bun/issues/4290

- **broker-tracked delivery attempts**
  - URL: #delivery-attempts

### Related Documentation

- **Microservices**
  - URL: /docs/concepts/microservices

- **Redis**
  - URL: /docs/packages/redis

- **OpenTelemetry**
  - URL: /docs/packages/opentelemetry

### What is Asena CLI?

### Key Features

### Getting Started

### Documentation

- **Installation**
  - URL: /docs/cli/installation

- **Commands**
  - URL: /docs/cli/commands

- **Configuration**
  - URL: /docs/cli/configuration

- **Examples**
  - URL: /docs/cli/examples

### Requirements

### Related Resources

- **Get Started Guide**
  - URL: /docs/get-started

- **Adapters Overview**
  - URL: /docs/adapters/overview

- **CLI Examples**
  - URL: /docs/cli/examples

- **Install the CLI**
  - URL: /docs/cli/installation

- **Learn CLI Commands**
  - URL: /docs/cli/commands

- **Try the Examples**
  - URL: /docs/cli/examples

### Prerequisites

- **Bun runtime**
  - URL: https://bun.sh

### Install Asena CLI

### Verify Installation

### Update Asena CLI

### Uninstall

### Troubleshooting

### Next Steps

- **Create your first project**
  - URL: /docs/cli/examples

- **Learn CLI commands**
  - URL: /docs/cli/commands

- **Configure your project**
  - URL: /docs/cli/configuration

- **CLI Overview**
  - URL: /docs/cli/overview

- **CLI Commands**
  - URL: /docs/cli/commands

- **Get Started Guide**
  - URL: /docs/get-started

### Installation

### asena create

### asena generate

- **Suffix Configuration**
  - URL: /docs/cli/suffix-configuration

### asena dev start

### asena build

### asena init

### Command Reference

### Related Documentation

- **Configuration**
  - URL: /docs/cli/configuration

- **Suffix Configuration**
  - URL: /docs/cli/suffix-configuration

- **CLI Examples**
  - URL: /docs/cli/examples

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **WebSocket**
  - URL: /docs/concepts/websocket

- **CLI Configuration**
  - URL: /docs/cli/configuration

- **CLI Examples**
  - URL: /docs/cli/examples

- **Controllers**
  - URL: /docs/concepts/controllers

### defineConfig Helper

### Configuration Options

### Default Configuration

### Configuration Properties

### Build Options Reference

### Environment-Specific Configuration

### Advanced Build Options

### Configuration Examples

### Bun Bundler Options

### Best Practices

### Troubleshooting

### .asena/config.json

### Related Documentation

- **CLI Commands**
  - URL: /docs/cli/commands

- **Suffix Configuration**
  - URL: /docs/cli/suffix-configuration

- **CLI Examples**
  - URL: /docs/cli/examples

- **Deployment**
  - URL: /docs/guides/deployment

- **Bun Bundler**
  - URL: https://bun.com/docs/bundler

- **CLI Commands**
  - URL: /docs/cli/commands

- **Deployment**
  - URL: /docs/guides/deployment

- **CLI Examples**
  - URL: /docs/cli/examples

### What are Suffixes?

### Configuration File

### Default Suffixes

### Configuration Options

### Examples

### Best Practices

### Configuration Comparison

### Manual Configuration

### Related Commands

### Related Documentation

- **CLI Configuration**
  - URL: /docs/cli/configuration

- **CLI Commands**
  - URL: /docs/cli/commands

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **CLI Commands**
  - URL: /docs/cli/commands

- **Controllers**
  - URL: /docs/concepts/controllers

### Prerequisites

- **Bun runtime**
  - URL: https://bun.sh

### Step 1: Install Asena CLI

### Step 2: Create a New Project

### Step 3: Verify Project Setup

### Step 4: Create a Controller

### Step 5: Create a Service

### Step 6: Build for Production

### Project Structure

### Next Steps

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **Middleware**
  - URL: /docs/concepts/middleware

- **Database integration**
  - URL: /docs/packages/drizzle

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Production**
  - URL: /docs/guides/deployment

- **CLI Commands**
  - URL: /docs/cli/commands

- **CLI Configuration**
  - URL: /docs/cli/configuration

- **Get Started Guide**
  - URL: /docs/get-started

- **Adapters**
  - URL: /docs/adapters/overview

### Quick Start

### API Reference

### serveOptions() Method

### onError() Method

### onNotFound() Method

### globalMiddlewares() Method

### transport() Method

### Complete Example

### Technical Details

- **`@OnStart`**
  - URL: /docs/concepts/lifecycle

### Best Practices

### Troubleshooting

### Related Documentation

- **Middleware**
  - URL: /docs/concepts/middleware

- **Error Handling**
  - URL: /docs/guides/error-handling

- **WebSocket**
  - URL: /docs/concepts/websocket

- **CLI Configuration**
  - URL: /docs/cli/configuration

- **Middleware patterns**
  - URL: /docs/concepts/middleware

- **Error Handling**
  - URL: /docs/guides/error-handling

- **WebSocket**
  - URL: /docs/concepts/websocket

### Why Error Handling Matters

### Philosophy

### Basic Error Handling

### Global Error Handler

### Custom Error Classes

### Not Found

### Validation Errors

### Best Practices

### Common Patterns

### Related

- **Middleware**
  - URL: /docs/concepts/middleware

- **Validation**
  - URL: /docs/concepts/validation

- **Logger Package**
  - URL: /docs/packages/logger

- **Context API**
  - URL: /docs/concepts/context

### Quick Start

### Graceful Shutdown and Probes

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle#signal-handling

- **Health probes**
  - URL: /docs/concepts/lifecycle#health-probes

### Related Documentation

- **CLI Build Command**
  - URL: /docs/cli/commands#build

- **CLI Configuration**
  - URL: /docs/cli/configuration

- **Server Configuration**
  - URL: /docs/guides/configuration

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

### Bun Test Runner

### Automatic Dependency Mocking

### Two Levels of Testing

### Import Path

### What You Can Test

### Main Testing Utilities

### Advanced Features

### How It Works

### Next Steps

- **MockComponent API**
  - URL: /docs/testing/mock-component

- **Examples**
  - URL: /docs/testing/examples

- **Bun Test Documentation**
  - URL: https://bun.sh/docs/cli/test

### Quick Start

### API Reference

- **MockComponentOptions**
  - URL: #mockcomponentoptions

### Advanced Usage Patterns

### Technical Details

### Related

- **Testing Overview**
  - URL: /docs/testing/overview

- **createTestApp**
  - URL: /docs/testing/test-app

- **createWebTest**
  - URL: /docs/testing/web-test

- **Examples**
  - URL: /docs/testing/examples

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Bun Test Documentation**
  - URL: https://bun.sh/docs/cli/test

### Options

### Replacing components with mocks

### Fluent HTTP assertions

### Cleanup

### Dispatch modes

### The container

### Known behaviours

- **`@OnStart` and `@OnStop` run for real.**
  - URL: /docs/concepts/lifecycle

### Related

- **Component Lifecycle**
  - URL: /docs/concepts/lifecycle

- **createWebTest**
  - URL: /docs/testing/web-test

- **MockComponent API**
  - URL: /docs/testing/mock-component

- **Testing Overview**
  - URL: /docs/testing/overview

### Options

### What runs for real

### The `mocks` object

### Mock shape

### Promoting a mock back to the real thing

### Explicit overrides

### Known behaviours

- **start hook**
  - URL: /docs/concepts/lifecycle

### Related

- **createTestApp**
  - URL: /docs/testing/test-app

- **MockComponent API**
  - URL: /docs/testing/mock-component

- **Testing Overview**
  - URL: /docs/testing/overview

### Testing Controllers

### Testing Services

### Testing WebSockets

### Testing Middleware

### Integration Testing Patterns

### Related

- **Testing Overview**
  - URL: /docs/testing/overview

- **MockComponent API**
  - URL: /docs/testing/mock-component

- **createTestApp**
  - URL: /docs/testing/test-app

- **createWebTest**
  - URL: /docs/testing/web-test

- **Dependency Injection**
  - URL: /docs/concepts/dependency-injection

- **Controllers**
  - URL: /docs/concepts/controllers

- **Services**
  - URL: /docs/concepts/services

- **WebSocket**
  - URL: /docs/concepts/websocket

- **Middleware**
  - URL: /docs/concepts/middleware

## Additional Resources (Optional)

### Step 7: Add Middleware (Optional)

## How to Use This Skill

Reference these resources when working with Testing Examples.