Asena Hono Adapter

HTTP and WebSocket adapter implementation based on Hono web framework for Asena.js.

Features

• Fast and modern API endpoints with Hono web framework
• High performance with Bun runtime
• Full type support with TypeScript
• HTTP and WebSocket adapter support
• Easy integration and usage
• Validation support with Zod
• Decorators for controller-based routing

Request pipeline order: global middlewares → route middlewares → validator → handler.

Requirements

• Bun v1.4 or higher
• @asenajs/asena v0.12.0 or higher (peer dependency)
• Hono v4.12.9 or higher (peer dependency)
• Zod v4.3.6 or higher (peer dependency)
• TypeScript v5.8.2 or above

Installation

bun add @asenajs/hono-adapter hono zod

hono and zod are peer dependencies - this adapter offers the wrapper, your project owns the libraries it wraps. That is what keeps your code and the adapter on a single copy of hono; two copies mean two HTTPException classes, and a deliberate 403 thrown from the wrong one is answered 500.

Usage

Server Setup (index.ts)

import { AsenaServer } from '@asenajs/asena';
import { DefaultLogger } from "@asenajs/asena/logger";
import { createHonoAdapter } from '@asenajs/hono-adapter';

const [adapter, logger] = createHonoAdapter(new DefaultLogger());

await new AsenaServer(adapter)
  .logger(logger)
  .port(3000)
  .start(true);

Controller Example

import { Controller } from '@asenajs/asena/decorators';
import { Get } from '@asenajs/asena/decorators/http';
import type { Context } from '@asenajs/hono-adapter';

@Controller()
export class TestController {
  @Get("/")
  public async me(context: Context) {
    return context.send("Hello World!");
  }
}

API Documentation

createHonoAdapter(logger, options)

Helper function used to create a Hono adapter.

Parameters:

• logger (Logger): Logger instance from Asena

Returns:

• A tuple with [adapter, logger]

Testing

Asena Hono Adapter uses Bun's built-in test framework for unit and integration testing.

Running Tests

# Run all tests
bun test

# Run tests with watch mode
bun test:watch

# Run tests with coverage report
bun test:coverage

Test Structure

• Unit Tests: Test individual components in isolation

  • HonoAdapter.test.ts - Tests for the HTTP adapter
  • HonoContextWrapper.test.ts - Tests for the context wrapper
  • HonoWebsocketAdapter.test.ts - Tests for the WebSocket adapter

• Integration Tests: Test how components work together

  • integration.test.ts - End-to-end tests for the adapter

Writing Tests

Example test for a controller:

import { describe, expect, it } from "bun:test";
import { AsenaServer } from "@asenajs/asena";
import { createHonoAdapter } from "@asenajs/hono-adapter";
import { DefaultLogger } from "@asenajs/asena/logger";
import { YourController } from "../path/to/your/controller";

describe("YourController", () => {
  let server;
  let baseUrl;
  
  beforeEach(async () => {
    // 10000-31999: below the kernel's ephemeral floor (net.ipv4.ip_local_port_range,
    // 32768-60999). A server port drawn from that range collides with the outbound
    // sockets the suite itself holds open - TIME_WAIT included - and Bun.serve then
    // fails with EADDRINUSE, randomly, in whichever test happened to draw it.
    const port = 10000 + Math.floor(Math.random() * 22000);
    const [adapter, logger] = createHonoAdapter(new DefaultLogger());
    const app = new AsenaServer(adapter).logger(logger).port(port);
    
    app.register(YourController);
    
    server = await app.start();
    baseUrl = `http://localhost:${port}`;
  });
  
  afterEach(() => {
    server.stop();
  });
  
  it("should respond correctly", async () => {
    const response = await fetch(`${baseUrl}/your-endpoint`);
    const data = await response.json();
    
    expect(response.status).toBe(200);
    expect(data).toEqual({ /* expected response */ });
  });
});

Development

To run the project in development mode:

bun run build

License

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