mini-starter/src/server/api.ts

import { OpenAPIHono } from '@hono/zod-openapi'
import { swaggerUI } from '@hono/swagger-ui'
import { errorHandler } from './utils/errorHandler'
import usersRouter from './api/users/index'
import authRoute from './api/auth/index'
import rolesRoute from './api/roles/index'
import fileRoutes from './api/files/index'
import { AuthContext } from './types/context'
import { AppDataSource } from './data-source'
import { Hono } from 'hono'

const app = new Hono();
const api = new OpenAPIHono<AuthContext>()

api.onError(errorHandler)

// Rate limiting
api.use('/api/v1/*', async (c, next) => {
  const ip = c.req.header('x-forwarded-for') || c.req.header('cf-connecting-ip')
  // 实现速率限制逻辑
  await next()
})

// 数据库初始化中间件
api.use('/api/v1/*', async (c, next) => {
  if(!AppDataSource.isInitialized) {
    await AppDataSource.initialize();
  }
  await next();
})

// 注册Bearer认证方案
api.openAPIRegistry.registerComponent('securitySchemes','bearerAuth',{
  type:'http',
  scheme:'bearer',
  bearerFormat:'JWT',
  description:'使用JWT进行认证'
})

// OpenAPI documentation endpoint
if(!import.meta.env.PROD){
  api.doc31('/doc', {
    openapi: '3.1.0',
    info: {
      title: 'API Documentation',
      version: '1.0.0'
    },
    security: [{
      bearerAuth: []
    }]
    // servers: [{ url: '/api/v1' }]
  })

  app.get('/ui', swaggerUI({
    url: '/doc',
    persistAuthorization: true,
    manuallySwaggerUIHtml: (asset) => `
      <div>
        <div id="swagger-ui"></div>
        <link rel="stylesheet" href="https://ai-oss.d8d.fun/swagger-ui-dist/swagger-ui.css" />
        <script src="https://ai-oss.d8d.fun/swagger-ui-dist/swagger-ui-bundle.js" crossorigin="anonymous"></script>
        <script>
          window.onload = () => {
            window.ui = SwaggerUIBundle({
              dom_id: '#swagger-ui',
              url: '/doc',
              persistAuthorization: true
            })
          }
        </script>
      </div>
    `
  }))
}



const userRoutes = api.route('/api/v1/users', usersRouter)
const authRoutes = api.route('/api/v1/auth', authRoute)
const roleRoutes = api.route('/api/v1/roles', rolesRoute)
const fileApiRoutes = api.route('/api/v1/files', fileRoutes)

export type AuthRoutes = typeof authRoutes
export type UserRoutes = typeof userRoutes
export type RoleRoutes = typeof roleRoutes
export type FileRoutes = typeof fileApiRoutes

app.route('/', api)
export default app