Refactor use scenario api to OpenAPI route

api/schema/scenario.ts

@@ -1,5 +1,8 @@
 import { LocalizedText } from './localized'
 import { AttendeeMetadata } from './attendee'
+import { Path, Str } from '@cloudflare/itty-router-openapi'
+
+export const ScenarioIdPath = Path(Str, { description: 'scenarion name to apply' })
 
 export type Scenario = {
   order: number

worker/controller/use.ts

@@ -4,7 +4,8 @@ import * as schema from '@api/schema'
 import { RunAttendeeScenario } from '@api/command'
 import { AttendeeInfo } from '@api/query'
 import { datetimeToUnix } from '@api/utils'
-import { get } from '@worker/router'
+import { Get } from '@worker/router'
+import { OpenAPIRoute, OpenAPIRouteSchema } from '@cloudflare/itty-router-openapi'
 
 export type UseRequest = {
   attendeeInfo: AttendeeInfo
@@ -31,9 +32,18 @@ function formatScenario(scenario: Record<string, any>) {
   return result
 }
 
-export class UseController {
-  @get('/use/:scenarioId')
-  async use({ attendeeInfo, runAttendeeScenario, scenarioId, query }: UseRequest) {
+@Get('/use/:scenarioId')
+export class ApplyScenario extends OpenAPIRoute {
+  static schema: OpenAPIRouteSchema = {
+    description: 'Use scenario',
+    tags: ['Event'],
+    parameters: {
+      token: schema.OptionalTokenQuery,
+      scenarioId: schema.ScenarioIdPath,
+    },
+  }
+
+  async handle({ attendeeInfo, runAttendeeScenario, scenarioId, query }: UseRequest) {
     if (!query.token) {
       throw new StatusError(400, 'token required')
     }

worker/index.ts

@@ -22,7 +22,6 @@ const router = OpenAPIRouter({
 router.all('*', withParams).all('*', withCommands).all('*', withQueries).all('*', withTestability)
 
 const _Controllers = [
-  Controller.UseController,
   Controller.PuzzleStatus,
   Controller.PuzzleDeliverer,
   Controller.PuzzleDashboard,