[rest] add joiner to commissioner joiner table and get status of joiner …

[martinzi]

…by indirect 'addThreadDeviceTask' processing

This PR is a carve-out from PR2514 to ease review. It implements the 'addThreadDeviceTask' to add a Joiner and auto-start on-mesh commissioner after POST:

• POST addThreadDeviceTask on api/actions/
• GET api/actions and GET api/actions/actionId
• DELETE api/actions

The commit also provides limited integration tests, see tests/restjsonapi.

Please follow below steps to reproduce and install/build OTBR.

1. Checkout this PR

2. Build and Install OTBR as usual, e.g. on a Raspberry Pi

3. Restart the OTBR. sudo systemctl restart otbr-agent

4. To monitor the log [Errors|Warnings|Info] please open a different terminal instance and use following command:

tail -f /var/log/syslog | grep otbr

5. Send POST request using Bruno or cURL to join a new device into your network.

curl -X POST -H 'Content-Type: application/vnd.api+json' http://localhost:8081/api/actions -d '{"data": [{"type": "addThreadDeviceTask", "attributes": {"eui": "6234567890AACDEA", "pskd": "J01NME", "timeout": 3600}}]}' | jq

should return

{
  "data": [
    {
      "id": "2d5a8844-b1bc-4f02-93f0-d87b8c3b4e92",
      "type": "addThreadDeviceTask",
      "attributes": {
        "eui": "6234567890AACDEB",
        "pskd": "J01NME",
        "timeout": 3600,
        "status": "pending"
      },
    }
  ]
}

6. You may check the status and get the full collection of actions.

curl -X GET -H 'Accept: application/vnd.api+json' http://localhost:8081/api/actions | jq

should return

{
  "data": [
    {
      "id": "2d5a8844-b1bc-4f02-93f0-d87b8c3b4e92",
      "type": "addThreadDeviceTask",
      "attributes": {
        "eui": "6234567890AACDEB",
        "pskd": "J01NME",
        "timeout": 3600,
        "status": "pending"
      }
    }
  ],
  "meta": {
    "collection": {
      "offset": 0,
      "limit": 100,
      "total": 1
    }
  }
}

7. View the entry added to the commissioner's table sudo ot-ctl commissioner joiner table and expect

| ID                    | PSKd                             | Expiration |
+-----------------------+----------------------------------+------------+
|      6234567890aacdea |                           J01NME |    3459027 |
Done

8. Start your joiner and after a few seconds repeat above steps 6. and 7.

9. For running the included test script install Bruno-Cli and run the bash script on your border router

cd tests/restjsonapi
source ./install_bruno_cli
./test-restjsonapi-server

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 39.33%. Comparing base (2b41187) to head (594a975).
Report is 817 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #2517       +/-   ##
===========================================
- Coverage   55.77%   39.33%   -16.44%     
===========================================
  Files          87       92        +5     
  Lines        6890    10275     +3385     
  Branches        0      745      +745     
===========================================
+ Hits         3843     4042      +199     
- Misses       3047     6032     +2985     
- Partials        0      201      +201     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[wgtdkp]

@martinzi Thanks for splitting this out!

A few suggestions:

1. could you please update https://github.com/openthread/ot-br-posix/blame/main/src/rest/openapi.yaml for the new REST APIs? We use the OpenAPI Specification for defining our REST API, see https://swagger.io/specification/ for details.
2. could you fix the CI test failures to make sure everything works before we getting into code details? thanks
3. Your code pretty test is failing, this is likely because you didn't format your code. You can use the command script/make-pretty to format your code.

BRs!

[wgtdkp]

Please be aware that there is also another PR adding the commissioner feature to REST API #2515