create-hest-app/templates/cqrs_scalar/src/index.ts

Create HestJS-powered applications with one command

import { HestFactory, logger } from '@hestjs/core';
import '@hestjs/scalar'; // 导入scalar扩展
import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { AppModule } from './app.module';
import { exceptionMiddleware, responseMiddleware } from './common/middleware';

async function bootstrap() {
  try {
    logger.info('🚀 Starting HestJS application...');

    // 创建 Hono 实例
    const hono = new Hono();
    hono.use(cors()); // 使用 Hono 的 CORS 中间件
    hono.use('*', exceptionMiddleware); // 异常处理中间件
    hono.use('*', responseMiddleware); // 响应包装中间件
    // hono.use('*', log()); // 使用 Hono 的日志中间件

    const app = await HestFactory.create(hono, AppModule);

    // 设置OpenAPI规范端点
    app.useSwagger(
      {
        info: {
          title: 'HestJS CQRS Demo API',
          version: '1.0.0',
          description:
            'A demonstration of HestJS CQRS framework capabilities with Scalar API documentation (Auto-discovered controllers)',
        },
        servers: [
          {
            url: 'http://localhost:3002',
            description: 'Development server',
          },
        ],
      },
      {
        path: '/docs',
        theme: 'elysia', // 使用elysia主题
        enableMarkdown: true,
        markdownPath: '/api-docs.md',
      },
    );

    logger.info('📚 API Documentation available at:');
    logger.info('  • Scalar UI: http://localhost:3002/docs');
    logger.info('  • OpenAPI JSON: http://localhost:3002/openapi.json');
    logger.info('  • Markdown (for LLMs): http://localhost:3002/api-docs.md');

    const server = Bun.serve({
      port: 3002,
      fetch: hono.fetch,
      reusePort: true, // 启用端口复用
    });

    logger.info(`🎉 Server is running on http://localhost:${server.port}`);
  } catch (error) {
    // 使用新的简化语法直接传递错误对象
    logger.error('❌ Failed to start application:', error);
    process.exit(1);
  }
}

bootstrap();