ルートを作る

ルートはHonolusインスタンスが公開するデコレーターで登録します。

import type { ServerInfo } from '@sonolus/core'
import type { SonolusContext } from '@untitledsekai/honolus'
import { sonolus } from '../app'

@sonolus.route.server.info
export class InfoHandler {
    async handle(context: SonolusContext): Promise<ServerInfo> {
        return { sections: [] }
    }
}

ハンドラーはリクエストごとに生成されます。戻り値の型を明記すると、Sonolus protocolと異なるレスポンスをコンパイル時に検出できます。

detailやsubmitでは、SonolusContextの後にpath parameterや検証済みrequestが渡されます。検索値、session、pagination、headerはcontextから取得できます。

@sonolus.route.server.post.detail
class PostDetailHandler {
    async handle(context: SonolusContext, itemName: string) {
        return loadPost(itemName, context.localization)
    }
}

登録済みrouteはsonolus.getRouteManifest()、最小OpenAPI文書はsonolus.getOpenApiDocument()で取得できます。