Add an api/stats endpoint

[KenEucker]

The stats endpoint should provide stats for a given game that include:

• Highest number of tags per day (amount, date)
• longest streak of daily tags (amount of days, date range)
• total number of players
• total number of tags
• longest time between tags

It might take too long to provide all of these stats in a single serverless function call. If so, then we should provide a mechanism to only provide the stats we can in the amount of time we have, then try to store stats and provide stored stats with a datetime that tracks how up to date the stats are.

[KenEucker]

I just had a thought about how to address the longer function call here:

1. The stats should come from a call to the BikeTag API (https://GitHub.com/KenEucker/biketag-api) using sanity. This can be done first in biketag-vue manually and then that code can be transferred to the biketag-api project.
2. A call should be made to a background function called generate-stats that generates all of the stats it can and saves that data into sanity.
3. Return the data retrieved from sanity.

This should work well and on the first call will return no data, just a message that says "generating stats...". On subsequent calls, it will return everything it can from sanity. This way, the background function has up to 15 minutes to complete stats calculations and save them into the sanity db.

[KenEucker]

Code has been deployed for this! Thanks again to @zatr for their help on this!

We have the following stats available:

playersWithMostTagsInOneDay
playersWithLongestTagStreakDaysData
gameTotalNumberOfPlayers
gameTotalNumberOfTags
gameHighestNumberTagsPerOneDayData
gameHighestNumberTagsPerSevenDaysData
gameLongestDailyTagStreakData
gameLongestTimeBetweenTags

Here is the current data for the Denver game, as a sample:

{
        "playersWithMostTagsInOneDay": [
            {
                "playerName": "jzak",
                "tagCount": 3,
                "tagDate": "2025-05-27T22:05:45.000Z"
            },
            {
                "playerName": "ADUMB",
                "tagCount": 3,
                "tagDate": "2025-06-02T04:18:45.000Z"
            }
        ],
        "playersWithLongestTagStreakDaysData": [
            {
                "playerName": "wintery_mix",
                "longestStreakData": {
                    "longestStreakDaysCount": 3,
                    "longestStreakStartDate": "2024-04-26T18:28:02.000Z",
                    "longestStreakEndDate": "2024-04-28T23:13:43.000Z"
                }
            },
            {
                "playerName": "ADUMB",
                "longestStreakData": {
                    "longestStreakDaysCount": 3,
                    "longestStreakStartDate": "2025-06-01T17:54:55.000Z",
                    "longestStreakEndDate": "2025-06-03T23:56:20.000Z"
                }
            }
        ],
        "gameTotalNumberOfPlayers": 87,
        "gameTotalNumberOfTags": 351,
        "gameHighestNumberTagsPerOneDayData": {
            "tagCount": 10,
            "dayCount": 1,
            "startDate": "2025-06-02T17:39:25.000Z",
            "endDate": "2025-06-03T16:40:58.000Z"
        },
        "gameHighestNumberTagsPerSevenDaysData": {
            "tagCount": 30,
            "dayCount": 7,
            "startDate": "2025-05-27T18:32:12.000Z",
            "endDate": "2025-06-03T16:40:58.000Z"
        },
        "gameLongestDailyTagStreakData": {
            "longestStreakDaysCount": 17,
            "longestStreakStartDate": "2025-05-24T01:42:08.000Z",
            "longestStreakEndDate": "2025-06-08T21:07:34.000Z"
        },
        "gameLongestTimeBetweenTags": {
            "timeBetweenTagsDays": 260,
            "startDate": "2020-07-14T17:38:40.000Z",
            "endDate": "2021-03-31T22:51:05.000Z",
            "staleTagNumber": 3
        }
    },