commit d5b6bb0636b0d4b8bae39888542cecaf7e89b909 · dunkirk.sh/hackatime-bot

+53
README.md
···

       30
       30
        
           <img src="/.github/images/has_account.webp" width="500" alt="creating an account - success"/>

     

       31
       31
        
       </p>

     

       32
       32
        
       

     

       33
       33
       +
       ### From a developer's perspective

     

       34
       34
       +
       

     

       35
       35
       +
       There is a sweet message queue that is used to handle all hackatime slack messages. This is handled and persisted across restarts with `bun:sqlite`. To access the queue you need an admin token which you can ask me for on slack ([@krn](https://hackclub.slack.com/team/U062UG485EE)).

     

       36
       36
       +
       

     

       37
       37
       +
       The queue is interacted with via a `POST` request to `/slack/message` with a `channel`, `text`, and (optionally) `blocks` json encoded in the body.

     

       38
       38
       +
       

     

       39
       39
       +
       ```bash

     

       40
       40
       +
       curl -X POST "https://hackatime-bot.kierank.hackclub.app/slack/message" \

     

       41
       41
       +
       -H "Content-Type: application/json" \

     

       42
       42
       +
       -H "Authorization: Bearer NOTLEEKINGTHATLOL" \

     

       43
       43
       +
       -d '{

     

       44
       44
       +
         "channel": "U062UG485EE",

     

       45
       45
       +
         "text": "Hello from hackatime!"

     

       46
       46
       +
       }'

     

       47
       47
       +
       ```

     

       48
       48
       +
       

     

       49
       49
       +
       or via fetch with blocks

     

       50
       50
       +
       

     

       51
       51
       +
       ```typescript

     

       52
       52
       +
       await fetch("https://hackatime-bot.kierank.hackclub.app/slack/message", {

     

       53
       53
       +
         method: "POST",

     

       54
       54
       +
         headers: {

     

       55
       55
       +
           "Content-Type": "application/json",

     

       56
       56
       +
           Authorization: `Bearer ${process.env.MESSAGE_QUEUE_TOKEN}`,

     

       57
       57
       +
         },

     

       58
       58
       +
         body: JSON.stringify({

     

       59
       59
       +
           channel: "U062UG485EE",

     

       60
       60
       +
           text: "Hello from hackatime!",

     

       61
       61
       +
           blocks: [

     

       62
       62
       +
             {

     

       63
       63
       +
               type: "section",

     

       64
       64
       +
               text: {

     

       65
       65
       +
                 type: "mrkdwn",

     

       66
       66
       +
                 text: "Hello from hackatime!",

     

       67
       67
       +
               },

     

       68
       68
       +
             },

     

       69
       69
       +
             {

     

       70
       70
       +
               type: "divider",

     

       71
       71
       +
             },

     

       72
       72
       +
             {

     

       73
       73
       +
               type: "context",

     

       74
       74
       +
               elements: [

     

       75
       75
       +
                 {

     

       76
       76
       +
                   type: "mrkdwn",

     

       77
       77
       +
                   text: "This is a message from the hackatime slack bot!",

     

       78
       78
       +
                 },

     

       79
       79
       +
               ],

     

       80
       80
       +
             },

     

       81
       81
       +
           ],

     

       82
       82
       +
         }),

     

       83
       83
       +
       });

     

       84
       84
       +
       ```

     

       85
       85
       +
       

     

       33
       86
        
       ## Devving

     

       34
       87
        
       

     

       35
       88
        
       Create a slack app as per the [manifest.yaml](manifest.yaml) and an env as below