// Player · Events — this account's participation history (EVENTS.md § API // surface, Phase 14a). Mounted at /api/v1/player/events by player/index.js. // // The group gate is `requireAuth` and it is the whole gate: this is role-agnostic // self-service, like the rest of /player. Staff are a superset of players (see // player/index.js), and an admin reading their own attendance is exactly as // ordinary as a player doing it. // // **No backtick in a `#swagger.parameters` annotation.** Unlike `#swagger.summary` // and `#swagger.description`, which are plain strings, a parameters annotation is // parsed as an object literal — a backtick inside its quoted `description` is // rewritten as a quote, and swagger-autogen then DROPS the whole annotation with a // syntax error rather than failing the build. // // **There is no id parameter, deliberately.** The history is `req.user.id`'s and // nothing else's; a route that took a user id would be one middleware mistake // away from publishing who attended what, which is a question about people // rather than about events. const express = require('express') const ctrl = require('./events.controller') const eventsRouter = express.Router() eventsRouter.get( '/history', // #swagger.tags = ['Player · Events'] // #swagger.summary = 'This account’s event participation' // #swagger.description = 'The events this account took part in, most recent first — the run, when it was, the score a module reported, and the rank once results were published. `rank` is null until then, which is a real state rather than an error. Rehearsals and unlisted events are absent, the same rule the public calendar follows. Keyset paging: pass the last entry’s `id` as `before`.' // #swagger.parameters['limit'] = { in: 'query', required: false, schema: { type: 'integer' }, description: 'Page size, max 200 (default 50).' } // #swagger.parameters['before'] = { in: 'query', required: false, schema: { type: 'integer' }, description: 'Cursor: the id of the last entry on the previous page.' } // #swagger.security = [{ "cookieAuth": [] }, { "bearerAuth": [] }] /* #swagger.responses[200] = { description: 'Participation history', content: { "application/json": { schema: { $ref: "#/components/schemas/PlayerEventHistory" } } } } */ /* #swagger.responses[401] = { description: 'Not signed in', content: { "application/json": { schema: { $ref: "#/components/schemas/Error" } } } } */ ctrl.getHistory, ) module.exports = eventsRouter