ranger-nf / hack-hour

Every Hour = More Power. Keep track of each hour of work you get done on your project.

Hack Hour (Arcade)

Hack Hour is a project tracker & time management tool for hacking on projects. It's currently being used to track hours as a part of Hack Club's Arcade and is on slack as @hakkuun (but her name is heidi 😊).

API

/ping

Returns with pong. Check if the thing is alive

/status

Get specific details on the status of hack hour (heidi)

Example Response:

{
    "activeSessions": -1,
    "airtableConnected": false,
    "slackConnected": false,
}

/api/clock/:slackId

Depreciated. Use /api/session/:slackId instead.

Responds with unix timestamp of the expected end time of the current session for the user.

/api/session/:slackId

Gets the latest session for the user.

Example Response:

{
    "ok": true,
    "data": {
        "id": "slackId",
        "createdAt": "2024-06-23T02:49:17.900Z",
        "time": 60,
        "elapsed": 12,
        "remaining": 48,
        "endTime": "2024-06-23T03:08:00.000Z",
        "goal": "No Goal",
        "paused": true,
        "completed": false
    }
}

/api/stats/:slackId

Gets the stats for the user.

Example Response:

{
    "ok": true,
    "data": {
        "sessions": 0,
        "total": 0,
    }
}

/api/goals/:slackId

Gets the goals for the user.

Example Response:

{
    "ok": true,
    "data": {
        "goals": [
            {
                "name": "No Goal",
                "minutes": 0,
            }
        ]
    }
}

/api/history/:slackId

Gets the history for the user.

Example Response:

{
    "ok": true,
    "data": [
        {
            "createdAt": "2024-06-23T05:09:04.105Z",
            "time": 60,
            "elapsed": 23,
            "goal": "No Goal",
            "ended": false,
            "work": "123"
        }
    ]
}