feat: add documentation of API (/w refactor of routes)

api/index.js

@@ -1,12 +1,14 @@
 import { Hono } from 'hono'
 import { serveStatic } from 'hono/serve-static.module'
-import leaderboard from '../db/leaderboard.json'
-import teams from '../db/teams.json'
-import presidents from '../db/presidents.json'
-import topScorers from '../db/top_scorers.json'
-import coaches from '../db/coaches.json'
-import mvp from '../db/mvp.json'
-import topAssists from '../db/top_assists.json'
+
+import { coachesApi } from './routes/coaches.routes'
+import { mvpApi } from './routes/mvp.routes'
+import { presidentApi } from './routes/presidents.routes'
+import { teamsApi } from './routes/teams.routes'
+import { topScorersApi } from './routes/top-scorers.routes'
+import { topAssistApi } from './routes/top-assists.routes'
+import { leaderboardApi } from './routes/leaderboard.routes'
+
 
 const app = new Hono()
 
@@ -85,80 +87,13 @@ app.get('/', (ctx) =>
 	])
 )
 
-app.get('/leaderboard', (ctx) => {
-	return ctx.json(leaderboard)
-})
-
-app.get('/leaderboard/:teamId', (ctx) => {
-	const teamId = ctx.req.param('teamId')
-	const foundTeam = leaderboard.find((stats) => stats.team.id === teamId)
-
-	return foundTeam ? ctx.json(foundTeam) : ctx.json({ message: 'Team not found' }, 404)
-})
-
-app.get('/teams', (ctx) => {
-	return ctx.json(teams)
-})
-
-app.get('/presidents', (ctx) => {
-	return ctx.json(presidents)
-})
-
-app.get('/top-scorers', (ctx) => {
-	return ctx.json(topScorers)
-})
-
-app.get('/top-scorers/:rank', (ctx) => {
-	const ranking = ctx.req.param('rank')
-	const foundScorer = topScorers.find((scorer) => scorer.ranking === ranking)
-
-	return foundScorer ? ctx.json(foundScorer) : ctx.json({ message: 'Top scorer not found' }, 404)
-})
-
-app.get('/top-assists', (ctx) => {
-	return ctx.json(topAssists)
-})
-
-app.get('/top-assists/:rank', (ctx) => {
-	const ranking = ctx.req.param('rank')
-	const foundAssister = topAssists.find((assister) => assister.rank === ranking)
-
-	return foundAssister
-		? ctx.json(foundAssister)
-		: ctx.json({ message: 'Top assister not found' }, 404)
-})
-
-app.get('/mvp', (ctx) => {
-	return ctx.json(mvp)
-})
-
-app.get('/coaches', (ctx) => {
-	return ctx.json(coaches)
-})
-
-app.get('/coaches/:teamId', (ctx) => {
-	const teamId = ctx.req.param('teamId')
-	const teamName = teams.find((team) => team.id === teamId)
-	const foundedCoach = coaches.find((coach) => coach.teamName === teamName)
-
-	return foundedCoach ? ctx.json(foundedCoach) : ctx.json({ message: 'Coach not found' }, 404)
-})
-
-app.get('/presidents/:id', (ctx) => {
-	const id = ctx.req.param('id')
-	const foundPresident = presidents.find((president) => president.id === id)
-
-	return foundPresident
-		? ctx.json(foundPresident)
-		: ctx.json({ message: 'President not found' }, 404)
-})
-
-app.get('/teams/:id', (ctx) => {
-	const id = ctx.req.param('id')
-	const foundTeam = teams.find((team) => team.id === id)
-
-	return foundTeam ? ctx.json(foundTeam) : ctx.json({ message: 'Team not found' }, 404)
-})
+app.route('/coachs', coachesApi)
+app.route('/leaderboard', leaderboardApi)
+app.route('/mvp', mvpApi)
+app.route('/presidents', presidentApi)
+app.route('/teams', teamsApi)
+app.route('/top-assists', topAssistApi)
+app.route('/top-scorers', topScorersApi)
 
 app.get('/static/*', serveStatic({ root: './' }))
 

api/routes/coaches.routes.js

@@ -0,0 +1,29 @@
+import { Hono } from 'hono'
+
+import coaches from '../../db/coaches.json'
+import teams from '../../db/teams.json'
+
+const coachesApi = new Hono()
+
+/**
+	@api {GET} /coaches Get all coaches
+	@apiName GetCoaches
+	@APIGroup Coaches
+	@apiSuccess {Object[]} Coaches list.
+	@apiSuccess {String} coaches.name Name of coach.
+	@apiSuccess {String} coaches.teamName Name of team belongs to coach.
+	@apiSuccess {String} coaches.image Image o the coach.
+*/
+coachesApi.get('/', (ctx) => {
+  return ctx.json(coaches)
+})
+
+coachesApi.get('/:teamId', (ctx) => {
+	const teamId = ctx.req.param('teamId')
+	const teamName = teams.find((team) => team.id === teamId)
+	const foundedCoach = coaches.find((coach) => coach.teamName === teamName)
+
+	return foundedCoach ? ctx.json(foundedCoach) : ctx.json({ message: 'Coach not found' }, 404)
+})
+
+export { coachesApi }

api/routes/leaderboard.routes.js

@@ -0,0 +1,48 @@
+import { Hono } from 'hono'
+
+import leaderboard from '../../db/leaderboard.json'
+
+const leaderboardApi = new Hono()
+
+/**
+	@api {GET} /teams Get all teams
+	@apiName GetTeams
+	@APIGroup Teams
+	@apiSuccess {Object[]} team list.
+	@apiSuccess {Number} teams.id Team ID.
+	@apiSuccess {String} teams.name Team name.
+	@apiSuccess {String} teams.image Team image.
+	@apiSuccess {String} teams.url Team URL.
+	@apiSuccess {Number} presindent.id ID of President belongs to team.
+	@apiSuccess {String} teams.channel URL of channel of the team.
+	@apiSuccess {Array} teams.socialNetwork List of networks of the team.
+	@apiSuccess {Array} teams.players List of players belongs to team.
+	@apiSuccess {String} teams.coach Name of the coach.
+*/
+leaderboardApi.get('/', (ctx) => {
+	return ctx.json(leaderboard)
+})
+
+/**
+	@api {GET} /teams/teamId Get team by ID
+	@apiName GetTeams
+	@APIGroup Teams
+	@apiSuccess {Number} teams.id Team ID.
+	@apiSuccess {String} teams.name Team name.
+	@apiSuccess {String} teams.image Team image.
+	@apiSuccess {String} teams.url Team URL.
+	@apiSuccess {Number} presindent.id ID of President belongs to team.
+	@apiSuccess {String} teams.channel URL of channel of the team.
+	@apiSuccess {Array} teams.socialNetwork List of networks of the team.
+	@apiSuccess {Array} teams.players List of players belongs to team.
+	@apiSuccess {String} teams.coach Name of the coach.
+	@apiError (404) {Object} NotFoundError Team not found.
+*/
+leaderboardApi.get('/:teamId', (ctx) => {
+	const teamId = ctx.req.param('teamId')
+	const foundTeam = leaderboard.find((stats) => stats.team.id === teamId)
+
+	return foundTeam ? ctx.json(foundTeam) : ctx.json({ message: 'Team not found' }, 404)
+})
+
+export { leaderboardApi }

api/routes/mvp.routes.js

@@ -0,0 +1,23 @@
+import { Hono } from 'hono'
+
+import mvp from '../../db/mvp.json'
+
+const mvpApi = new Hono()
+
+/**
+	@api {GET} /mvp Get all presidents
+	@apiName GetMVPPlayers
+	@APIGroup MVP
+	@apiSuccess {Object[]} MVP List of players.
+	@apiSuccess {String} MVP.playerName MVP player's name.
+	@apiSuccess {String} MVP.gamesPlayed Player games.
+	@apiSuccess {String} MVP.mvps Number of MVPs
+	@apiSuccess {String} MVP.rank Ranking position
+	@apiSuccess {String} MVP.team Team belongs to player
+	@apiSuccess {String} MVP.image Logo of the team
+*/
+mvpApi.get('/', (ctx) => {
+  return ctx.json(mvp)
+})
+
+export { mvpApi }

api/routes/presidents.routes.js

@@ -0,0 +1,40 @@
+import { Hono } from 'hono'
+
+import presidents from '../../db/presidents.json'
+
+const presidentApi = new Hono()
+
+/**
+	@api {GET} /presidents Get all presidents
+	@apiName GetPresidents
+	@APIGroup Presidents
+	@apiSuccess {Object[]} presidents list.
+	@apiSuccess {Number} presidents.id President ID.
+	@apiSuccess {String} presidents.name President name.
+	@apiSuccess {String} presidents.party President political party.
+*/
+presidentApi.get('/', (ctx) => {
+	return ctx.json(presidents)
+})
+/**
+	@api {GET} /presidents/:id Get a president by ID
+	@apiName GetPresidentById
+	@APIGroup Presidents
+	@apiParam {Number} id President ID.
+	@apiSuccess {Object} president President object.
+	@apiSuccess {Number} president.id President ID.
+	@apiSuccess {String} president.name President name.
+	@apiSuccess {String} president.party President political party.
+	@apiError (404) {Object} NotFoundError President not found.
+*/
+presidentApi.get('/:id', (ctx) => {
+	const id = ctx.req.param('id')
+	const foundPresident = presidents.find((president) => president.id === id)
+	if (!foundPresident) {
+		return ctx.json({ message: 'President not found' }, 404)
+	}
+
+	return ctx.json(foundPresident)
+})
+
+export { presidentApi }

api/routes/teams.routes.js

@@ -0,0 +1,50 @@
+import { Hono } from 'hono'
+
+import teams from '../../db/teams.json'
+
+const teamsApi = new Hono()
+
+/**
+	@api {GET} /teams Get all teams
+	@apiName GetTeams
+	@APIGroup Teams
+	@apiSuccess {Object[]} team list.
+	@apiSuccess {Number} teams.id Team ID.
+	@apiSuccess {String} teams.name Team name.
+	@apiSuccess {String} teams.image Team image.
+	@apiSuccess {String} teams.url Team URL.
+	@apiSuccess {Number} presindent.id ID of President belongs to team.
+	@apiSuccess {String} teams.channel URL of channel of the team.
+	@apiSuccess {Array} teams.socialNetwork List of networks of the team.
+	@apiSuccess {Array} teams.players List of players belongs to team.
+	@apiSuccess {String} teams.coach Name of the coach.
+*/
+teamsApi.get('/', (ctx) => {
+  return ctx.json(teams)
+})
+
+/**
+	@api {GET} /teams/id Get team by ID
+	@apiName GetTeams
+	@APIGroup Teams
+	@apiSuccess {Number} teams.id Team ID.
+	@apiSuccess {String} teams.name Team name.
+	@apiSuccess {String} teams.image Team image.
+	@apiSuccess {String} teams.url Team URL.
+	@apiSuccess {Number} presindent.id ID of President belongs to team.
+	@apiSuccess {String} teams.channel URL of channel of the team.
+	@apiSuccess {Array} teams.socialNetwork List of networks of the team.
+	@apiSuccess {Array} teams.players List of players belongs to team.
+	@apiSuccess {String} teams.coach Name of the coach.
+	@apiError (404) {Object} NotFoundError Team not found.
+*/
+teamsApi.get('/:id', (ctx) => {
+  const id = ctx.req.param('id')
+  const foundTeam = teams.find((team) => team.id === id)
+
+  return foundTeam
+    ? ctx.json(foundTeam)
+    : ctx.json({ message: 'Team not found' }, 404)
+})
+
+export { teamsApi }

api/routes/top-assists.routes.js

@@ -0,0 +1,30 @@
+import { Hono } from 'hono'
+
+import topAssists from '../../db/top_assists.json'
+
+const topAssistApi = new Hono()
+
+/**
+	@api {GET} /top-scores Get Top Scorers
+	@apiName GetTopScorers
+	@APIGroup Top Scorers
+	@apiSuccess {Object[]} Top Scorers.
+	@apiSuccess {String} topScorer.playerName Top Scorer's name.
+	@apiSuccess {String} topScorer.gamesPlayed Played games.
+	@apiSuccess {String} topScorer.goals Number of goals
+	@apiSuccess {String} topScorer.rank Ranking position
+	@apiSuccess {String} topScorer.team Team belongs to player
+	@apiSuccess {String} topScorer.image Logo of the team
+*/
+topAssistApi.get('/', (ctx) => {
+  return ctx.json(topAssists)
+})
+
+topAssistApi.get('/:rank', (ctx) => {
+	const ranking = ctx.req.param('rank')
+	const foundAssist = topAssists.find((scorer) => scorer.ranking === ranking)
+
+	return foundAssist ? ctx.json(foundAssist) : ctx.json({ message: 'Top assist not found' }, 404)
+})
+
+export { topAssistApi }

api/routes/top-scorers.routes.js

@@ -0,0 +1,30 @@
+import { Hono } from 'hono'
+
+import topScorers from '../../db/top_scorers.json'
+
+const topScorersApi = new Hono()
+
+/**
+	@api {GET} /top-scores Get Top Scorers
+	@apiName GetTopScorers
+	@APIGroup Top Scorers
+	@apiSuccess {Object[]} Top Scorers.
+	@apiSuccess {String} topScorer.playerName Top Scorer's name.
+	@apiSuccess {String} topScorer.gamesPlayed Played games.
+	@apiSuccess {String} topScorer.goals Number of goals
+	@apiSuccess {String} topScorer.rank Ranking position
+	@apiSuccess {String} topScorer.team Team belongs to player
+	@apiSuccess {String} topScorer.image Logo of the team
+*/
+topScorersApi.get('/', (ctx) => {
+  return ctx.json(topScorers)
+})
+
+topScorersApi.get('/:rank', (ctx) => {
+	const ranking = ctx.req.param('rank')
+	const foundScorer = topScorers.find((scorer) => scorer.ranking === ranking)
+
+	return foundScorer ? ctx.json(foundScorer) : ctx.json({ message: 'Top scorer not found' }, 404)
+})
+
+export { topScorersApi }