#8, add puzzle coupon endpoint

Author: elct9620

api/schema/puzzle.ts

@@ -33,3 +33,7 @@ export const puzzleStatsSchema = z.array(puzzleItemStatSchema)
 export const puzzleRevokeResponseSchema = z.object({
   status: z.string().default('OK'),
 })
+
+export const puzzleCouponRedeemResponseSchema = z.object({
+  status: z.string().default('OK'),
+})

features/puzzle_coupon.feature

@@ -0,0 +1,19 @@
+Feature: Puzzle Coupon
+  Scenario: PUT /event/puzzle/coupon to redeem a puzzle coupon
+    Given there have some booths
+      | token                                | name   | event_id |
+      | 1024914b-ee65-4728-b687-8341f5affa89 | COSCUP | SITCON   |
+    And there have some attendees
+      | token                                | event_id | display_name |
+      | f185f505-d8c0-43ce-9e7b-bb9e8909072d | SITCON   | Aotoki       |
+    When I make a PUT request to "/event/puzzle/coupon?token=1024914b-ee65-4728-b687-8341f5affa89&event_id=SITCON":
+      """
+      {}
+      """
+    Then the response json should be:
+      """
+      {
+        "status": "OK"
+      }
+      """
+    And the response status should be 200

worker/controller/index.ts

@@ -7,3 +7,4 @@ export * from './puzzleDeliverer'
 export * from './puzzleDelivery'
 export * from './puzzleDashboard'
 export * from './revokePuzzle'
+export * from './useCoupon'

worker/controller/useCoupon.ts

@@ -0,0 +1,30 @@
+import { IRequest } from 'itty-router'
+import { OpenAPIRoute, OpenAPIRouteSchema } from '@cloudflare/itty-router-openapi'
+import { Put } from '@worker/router'
+import { json } from '@worker/utils'
+import * as schema from '@api/schema'
+
+export type UseCouponRequest = IRequest
+
+@Put('/event/puzzle/coupon')
+export class UseCoupon extends OpenAPIRoute {
+  static schema: OpenAPIRouteSchema = {
+    summary: "Use attendee's puzzle to redeem coupon",
+    tags: ['Puzzle'],
+    requestBody: {},
+    parameters: {
+      event_id: schema.EventIdQuery,
+      token: schema.OptionalAttendeeTokenQuery,
+    },
+    responses: {
+      '200': {
+        description: 'Result of coupon redemption',
+        schema: schema.puzzleCouponRedeemResponseSchema,
+      },
+    },
+  }
+
+  async handle(_request: UseCouponRequest, _env: unknown, _context: unknown) {
+    return json({ status: 'OK' })
+  }
+}