Merge pull request #235 from yusuftomilola/skill-rating

feat(skill-rating): add abandon threshold, percentile, and player-facing rating endpoints

Author: Mkalbani

src/skill-rating/controllers/rating.controller.ts

@@ -0,0 +1,56 @@
+import {
+  Controller,
+  Get,
+  Param,
+  Query,
+  Logger,
+} from '@nestjs/common';
+import { SkillRatingService } from '../skill-rating.service';
+import { PlayerRating } from '../entities/player-rating.entity';
+import { PlayerRatingDetails } from '../skill-rating.service';
+
+/**
+ * GET /players/me/rating   — authenticated player's rating, tier, and percentile
+ * GET /players/:id/rating  — another player's rating (respects privacy settings)
+ */
+@Controller('players')
+export class PlayerRatingController {
+  private readonly logger = new Logger(PlayerRatingController.name);
+
+  constructor(private readonly skillRatingService: SkillRatingService) {}
+
+  @Get('me/rating')
+  async getMyRating(
+    @Query('userId') userId: string,
+  ): Promise<PlayerRatingDetails> {
+    return this.skillRatingService.getPlayerRatingWithDetails(userId);
+  }
+
+  @Get(':id/rating')
+  async getPlayerRating(
+    @Param('id') targetUserId: string,
+    @Query('requestingUserId') requestingUserId?: string,
+  ): Promise<PlayerRatingDetails> {
+    return this.skillRatingService.getPublicPlayerRating(targetUserId, requestingUserId);
+  }
+}
+
+/**
+ * GET /ratings/leaderboard — top 100 players by skill rating,
+ * kept separate from the score-based leaderboard.
+ */
+@Controller('ratings')
+export class RatingsController {
+  constructor(private readonly skillRatingService: SkillRatingService) {}
+
+  @Get('leaderboard')
+  async getLeaderboard(
+    @Query('limit') limit = '100',
+    @Query('offset') offset = '0',
+  ): Promise<PlayerRating[]> {
+    return this.skillRatingService.getLeaderboard(
+      parseInt(limit, 10),
+      parseInt(offset, 10),
+    );
+  }
+}

src/skill-rating/skill-rating.module.ts

@@ -2,6 +2,7 @@ import { Module } from '@nestjs/common';
 import { TypeOrmModule } from '@nestjs/typeorm';
 import { SkillRatingService } from './skill-rating.service';
 import { SkillRatingController } from './skill-rating.controller';
+import { PlayerRatingController, RatingsController } from './controllers/rating.controller';
 import { PlayerRating } from './entities/player-rating.entity';
 import { RatingHistory } from './entities/rating-history.entity';
 import { Season } from './entities/season.entity';
@@ -15,7 +16,7 @@ import { ELOService } from './elo.service';
     TypeOrmModule.forFeature([PlayerRating, RatingHistory, Season, User, Puzzle]),
     ScheduleModule.forRoot(),
   ],
-  controllers: [SkillRatingController],
+  controllers: [SkillRatingController, PlayerRatingController, RatingsController],
   providers: [SkillRatingService, ELOService],
   exports: [SkillRatingService],
 })