feat: list users scim v2 endpoint (#9187)

# Which Problems Are Solved
- Adds support for the list users SCIM v2 endpoint

# How the Problems Are Solved
- Adds support for the list users SCIM v2 endpoints under `GET
/scim/v2/{orgID}/Users` and `POST /scim/v2/{orgID}/Users/.search`

# Additional Changes
- adds a new function `SearchUserMetadataForUsers` to the query layer to
query a metadata keyset for given user ids
- adds a new function `NewUserMetadataExistsQuery` to the query layer to
query a given metadata key value pair exists
- adds a new function `CountUsers` to the query layer to count users
without reading any rows
- handle `ErrorAlreadyExists` as scim errors `uniqueness`
- adds `NumberLessOrEqual` and `NumberGreaterOrEqual` query comparison
methods
- adds `BytesQuery` with `BytesEquals` and `BytesNotEquals` query
comparison methods

# Additional Context
Part of #8140
Supported fields for scim filters:
* `meta.created`
* `meta.lastModified`
* `id`
* `username`
* `name.familyName`
* `name.givenName`
* `emails` and `emails.value`
* `active` only eq and ne
* `externalId` only eq and ne

internal/api/scim/resources/resource_list_test.go

@@ -0,0 +1,79 @@
+package resources
+
+import (
+	"reflect"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestListRequest_validate(t *testing.T) {
+	tests := []struct {
+		name    string
+		req     *ListRequest
+		want    *ListRequest
+		wantErr bool
+	}{
+		{
+			name: "valid",
+			req: &ListRequest{
+				SortOrder: ListRequestSortOrderAsc,
+			},
+		},
+		{
+			name: "invalid sort order",
+			req: &ListRequest{
+				SortOrder: "fooBar",
+			},
+			wantErr: true,
+		},
+		{
+			name: "count too big",
+			req: &ListRequest{
+				Count:     99999999,
+				SortOrder: ListRequestSortOrderAsc,
+			},
+			wantErr: true,
+		},
+		{
+			name: "negative start index",
+			req: &ListRequest{
+				StartIndex: -1,
+				Count:      10,
+				SortOrder:  ListRequestSortOrderAsc,
+			},
+			want: &ListRequest{
+				StartIndex: 1,
+				Count:      10,
+				SortOrder:  ListRequestSortOrderAsc,
+			},
+		},
+		{
+			name: "negative count",
+			req: &ListRequest{
+				StartIndex: 10,
+				Count:      -1,
+				SortOrder:  ListRequestSortOrderAsc,
+			},
+			want: &ListRequest{
+				StartIndex: 10,
+				Count:      0,
+				SortOrder:  ListRequestSortOrderAsc,
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			err := tt.req.validate()
+			if tt.wantErr {
+				assert.Error(t, err)
+			} else {
+				assert.NoError(t, err)
+			}
+
+			if tt.want != nil && !reflect.DeepEqual(tt.req, tt.want) {
+				t.Errorf("got: %#v, want: %#v", tt.req, tt.want)
+			}
+		})
+	}
+}