// Copyright (c) HashiCorp, Inc. // SPDX-License-Identifier: BUSL-1.1 package iam import ( "context" "time" "github.com/hashicorp/boundary/internal/errors" "github.com/hashicorp/boundary/internal/pagination" ) // ListRoles lists up to page size roles, filtering out entries that // do not pass the filter item function. It will automatically request // more roles from the database, at page size chunks, to fill the page. // It returns a new list token used to continue pagination or refresh items. // Roles are ordered by create time descending (most recently created first). func ListRoles( ctx context.Context, grantsHash []byte, pageSize int, filterItemFn pagination.ListFilterFunc[*Role], repo *Repository, withScopeIds []string, ) (*pagination.ListResponse[*Role], error) { const op = "iam.ListRoles" switch { case len(grantsHash) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing grants hash") case pageSize < 1: return nil, errors.New(ctx, errors.InvalidParameter, op, "page size must be at least 1") case filterItemFn == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing filter item callback") case repo == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing repo") case len(withScopeIds) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing scope ids") } listItemsFn := func(ctx context.Context, lastPageItem *Role, limit int) ([]*Role, time.Time, error) { opts := []Option{ WithLimit(limit), } if lastPageItem != nil { opts = append(opts, WithStartPageAfterItem(lastPageItem)) } return repo.listRoles(ctx, withScopeIds, opts...) } return pagination.List(ctx, grantsHash, pageSize, filterItemFn, listItemsFn, repo.estimatedRoleCount) } // ListUsers lists up to page size users, filtering out entries that // do not pass the filter item function. It will automatically request // more users from the database, at page size chunks, to fill the page. // It returns a new list token used to continue pagination or refresh items. // Users are ordered by create time descending (most recently created first). func ListUsers( ctx context.Context, grantsHash []byte, pageSize int, filterItemFn pagination.ListFilterFunc[*User], repo *Repository, withScopeIds []string, ) (*pagination.ListResponse[*User], error) { const op = "iam.ListUsers" switch { case len(grantsHash) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing grants hash") case pageSize < 1: return nil, errors.New(ctx, errors.InvalidParameter, op, "page size must be at least 1") case filterItemFn == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing filter item callback") case repo == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing repo") case withScopeIds == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing scope ids") } listItemsFn := func(ctx context.Context, lastPageItem *User, limit int) ([]*User, time.Time, error) { opts := []Option{ WithLimit(limit), } if lastPageItem != nil { opts = append(opts, WithStartPageAfterItem(lastPageItem)) } return repo.ListUsers(ctx, withScopeIds, opts...) } return pagination.List(ctx, grantsHash, pageSize, filterItemFn, listItemsFn, repo.estimatedUserCount) } // ListGroups lists up to page size groups, filtering out entries that // do not pass the filter item function. It will automatically request // more groups from the database, at page size chunks, to fill the page. // It returns a new list token used to continue pagination or refresh items. // Groups are ordered by create time descending (most recently created first). func ListGroups( ctx context.Context, grantsHash []byte, pageSize int, filterItemFn pagination.ListFilterFunc[*Group], repo *Repository, withScopeIds []string, ) (*pagination.ListResponse[*Group], error) { const op = "iam.ListGroups" switch { case len(grantsHash) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing grants hash") case pageSize < 1: return nil, errors.New(ctx, errors.InvalidParameter, op, "page size must be at least 1") case filterItemFn == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing filter item callback") case repo == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing repo") case withScopeIds == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing scope ids") } listItemsFn := func(ctx context.Context, lastPageItem *Group, limit int) ([]*Group, time.Time, error) { opts := []Option{ WithLimit(limit), } if lastPageItem != nil { opts = append(opts, WithStartPageAfterItem(lastPageItem)) } return repo.listGroups(ctx, withScopeIds, opts...) } return pagination.List(ctx, grantsHash, pageSize, filterItemFn, listItemsFn, repo.estimatedGroupCount) } // ListScopes lists up to page size scopes, filtering out entries that // do not pass the filter item function. It will automatically request // more scopes from the database, at page size chunks, to fill the page. // It returns a new list token used to continue pagination or refresh items. // Scopes are ordered by create time descending (most recently created first). func ListScopes( ctx context.Context, grantsHash []byte, pageSize int, filterItemFn pagination.ListFilterFunc[*Scope], repo *Repository, withParentIds []string, ) (*pagination.ListResponse[*Scope], error) { const op = "iam.ListScopes" switch { case len(grantsHash) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing grants hash") case pageSize < 1: return nil, errors.New(ctx, errors.InvalidParameter, op, "page size must be at least 1") case filterItemFn == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing filter item callback") case repo == nil: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing repo") case len(withParentIds) == 0: return nil, errors.New(ctx, errors.InvalidParameter, op, "missing parent ids") } listItemsFn := func(ctx context.Context, lastPageItem *Scope, limit int) ([]*Scope, time.Time, error) { opts := []Option{ WithLimit(limit), } if lastPageItem != nil { opts = append(opts, WithStartPageAfterItem(lastPageItem)) } return repo.listScopes(ctx, withParentIds, opts...) } return pagination.List(ctx, grantsHash, pageSize, filterItemFn, listItemsFn, repo.estimatedScopeCount) }