feat(plays): add utcOffset param to plays by date

Author: BlueSCar

src/app/plays/controller.ts

@@ -66,13 +66,15 @@ export class PlaysController extends Controller {
    * Retrieve all plays for a given UTC date
    * @param date Required date filter in ISO 8601 format (YYYY-MM-DD)
    * @param shootingPlaysOnly Optional filter to only return shooting plays
+   * @param utcOffset Optional UTC offset in hours to adjust the date range
    */
   @Get('date')
   public async getPlaysByDate(
     @Query() date: Date,
     @Query() shootingPlaysOnly?: boolean,
+    @Query() utcOffset?: number,
   ): Promise<PlayInfo[]> {
-    return await getPlaysByDate(date, shootingPlaysOnly);
+    return await getPlaysByDate(date, shootingPlaysOnly, utcOffset);
   }
 
   /**

src/app/plays/service.ts

@@ -55,8 +55,13 @@ export const getPlaysByTournament = async (
 export const getPlaysByDate = async (
   date: Date,
   shootingPlaysOnly?: boolean,
+  utcOffset?: number,
 ): Promise<PlayInfo[]> => {
   const endRange = new Date(date);
+  if (utcOffset) {
+    date.setHours(date.getHours() + utcOffset);
+  }
+
   endRange.setDate(date.getDate() + 1);
   return await getPlays(
     undefined,