[public-api] Implement experimental ListTeams

[easyCZ]

Description

Implements experimental TeamsService.ListTeams

Related Issue(s)

• Part of Implement and use ListTeams #14310
• Depends on [gitpod-protocol] Add support for getTeams to golang client #14300
• Depends on [public-api] Implement experimental TeamsService.CreateTeam #14152
• Used in [dashboard] ListTeams using PublicAPI #14313

How to test

Unit tests.

1. Open up preview, log-in
2. Obtain a token by running the below in the browser console

   await window._gp.gitpodService.server.generateNewGitpodToken({ type: 1, scopes: ["function:getGitpodTokenScopes",
   	"function:createTeam",
   	"function:getTeamMembers",
   	"function:getGenericInvite",
   	"function:getTeams",
   	"resource:default",]})

3. Set your credentials on the command line:

   BEARER_TOKEN="<token>"

4. Create a couple of teams, adjusting the <team_name_X> variable

	curl \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $BEARER_TOKEN" \
    --data '{ "name": "<team_name_1>" }' \
    https://api.mp-papi-list-teams.preview.gitpod-dev.com/gitpod.experimental.v1.TeamsService/CreateTeam

	curl \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $BEARER_TOKEN" \
    --data '{ "name": "<team_name_2>" }' \
    https://api.mp-papi-list-teams.preview.gitpod-dev.com/gitpod.experimental.v1.TeamsService/CreateTeam

6. Hit the list endpoint, adjusting the <team_name> variable

	curl \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $BEARER_TOKEN" \
    --data '{ }' \
    https://api.mp-papi-list-teams.preview.gitpod-dev.com/gitpod.experimental.v1.TeamsService/ListTeams

{
  "teams": [
    {
      "id": "47fd227c-19b0-49e2-8ee6-7e00ddb6526a",
      "name": "milans2",
      "slug": "milans2",
      "members": [
        {
          "userId": "c269e49a-4c20-4d65-b762-6acac9df7aa5",
          "role": "TEAM_ROLE_OWNER"
        }
      ],
      "teamInvitation": {
        "id": "redacted"
      }
    },
    {
      "id": "97532eb7-54d3-452c-98f9-321024382fba",
      "name": "milans1",
      "slug": "milans1",
      "members": [
        {
          "userId": "c269e49a-4c20-4d65-b762-6acac9df7aa5",
          "role": "TEAM_ROLE_OWNER"
        }
      ],
      "teamInvitation": {
        "id": "8743a6f7-b103-4c87-9d02-8ed531e8cfaa"
      }
    },
    {
      "id": "ae8e46e9-071f-4a19-877e-5a681794fa65",
      "name": "foobaz",
      "slug": "foobaz",
      "members": [
        {
          "userId": "c269e49a-4c20-4d65-b762-6acac9df7aa5",
          "role": "TEAM_ROLE_OWNER"
        }
      ],
      "teamInvitation": {
        "id": "redacted"
      }
    }
  ]
}

Release Notes

NONE

Documentation

Werft options:

• /werft with-local-preview
  If enabled this will build install/preview
• /werft with-preview
• /werft with-large-vm
• /werft with-integration-tests=all
  Valid options are all, workspace, webapp, ide

[werft-gitpod-dev-com]

started the job as gitpod-build-mp-papi-list-teams.1 because the annotations in the pull request description changed
(with .werft/ from main)

[andrew-farries]

LGTM