clients/v1: add RolesService client methods

[jac]

Add the client methods for the new RolesService.
This includes the RegisterRoleResources method used to register resources with SAMS for the SAMS+Entitle integration.

Test plan

CI

Ran locally with the following client code

package main

import (
	"context"
	"fmt"
	"os"
	"strings"

	"github.com/davecgh/go-spew/spew"
	sams "github.com/sourcegraph/sourcegraph-accounts-sdk-go"
	clientsv1 "github.com/sourcegraph/sourcegraph-accounts-sdk-go/clients/v1"
	"github.com/sourcegraph/sourcegraph-accounts-sdk-go/roles"
	"golang.org/x/oauth2/clientcredentials"

	"sourcegraph-accounts/internal/strutil"
)

var (
	server                  = fmt.Sprintf("http://localhost:%s", os.Getenv("PORT"))
	clientCredentialsConfig = clientcredentials.Config{
		ClientID:     os.Getenv("ACCOUNTS_CLIENT_EXAMPLE_CLIENT_ID"),
		ClientSecret: os.Getenv("ACCOUNTS_CLIENT_EXAMPLE_CLIENT_SECRET"),
		TokenURL:     fmt.Sprintf("%s/oauth/token", server),
		Scopes: strings.Split(
			strutil.Coalesce(
				os.Getenv("ACCOUNTS_CLIENT_EXAMPLE_CLIENT_SCOPES"),
				"openid,profile,email",
			),
			","),
	}
)

func main() {
	ctx := context.Background()
	client, err := sams.NewClientV1(
		sams.ClientV1Config{
			ConnConfig: sams.ConnConfig{
				ExternalURL: server,
			},
			TokenSource: clientCredentialsConfig.TokenSource(ctx),
		},
	)
	if err != nil {
		spew.Dump(err)
		return
	}

	resources := [][]*clientsv1.RoleResource{
		{
			{
				ResourceId:  "example-resource-1",
				DisplayName: "Example Resource 1",
			},
			{
				ResourceId:  "example-resource-2",
				DisplayName: "Example Resource 2",
			},
			{
				ResourceId:  "example-resource-3",
				DisplayName: "Example Resource 3",
			},
		},
		{
			{
				ResourceId:  "example-resource-10",
				DisplayName: "Example Resource 10",
			},
			{
				ResourceId:  "example-resource-20",
				DisplayName: "Example Resource 20",
			},
			{
				ResourceId:  "example-resource-30",
				DisplayName: "Example Resource 30",
			},
		},
		{
			{
				ResourceId:  "example-resource-100",
				DisplayName: "Example Resource 100",
			},
			{
				ResourceId:  "example-resource-200",
				DisplayName: "Example Resource 200",
			},
			{
				ResourceId:  "example-resource-300",
				DisplayName: "Example Resource 300",
			},
		},
	}
	index := 0
	count, err := client.Roles().RegisterRoleResources(ctx, sams.RegisterResourcesMetadata{
		ResourceType: roles.EnterpriseSubscription,
	}, func() ([]*clientsv1.RoleResource, error) {
		if index >= len(resources) {
			return nil, nil
		}
		result := resources[index]
		index++
		return result, nil
	})
	spew.Dump(count, err)
}

Output:

(uint64) 9
(interface {}) <nil>

[unknwon]

Request changes because let's make sure some important details are described correctly.

[unknwon]

🚀