// Copyright (c) HashiCorp, Inc. // SPDX-License-Identifier: BUSL-1.1 package static import ( "context" "time" "github.com/hashicorp/boundary/internal/errors" "github.com/hashicorp/boundary/internal/host" "github.com/hashicorp/boundary/internal/pagination" ) // ListHosts lists up to page size hosts, filtering out entries that // do not pass the filter item function. It will automatically request // more hosts from the database, at page size chunks, to fill the page. // It returns a new list token used to continue pagination or refresh items. // Hosts are ordered by create time descending (most recently created first). func ListHosts( ctx context.Context, grantsHash []byte, pageSize int, filterItemFn pagination.ListFilterFunc[host.Host], repo *Repository, hostCatalogId string, ) (*pagination.ListResponse[host.Host], error) { const op = "plugin.ListHosts" 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 hostCatalogId == "": return nil, errors.New(ctx, errors.InvalidParameter, op, "missing host catalog ID") } listItemsFn := func(ctx context.Context, lastPageItem host.Host, limit int) ([]host.Host, time.Time, error) { opts := []Option{ WithLimit(limit), } if lastPageItem != nil { opts = append(opts, WithStartPageAfterItem(lastPageItem)) } sHosts, listTime, err := repo.listHosts(ctx, hostCatalogId, opts...) if err != nil { return nil, time.Time{}, err } var hosts []host.Host for _, host := range sHosts { hosts = append(hosts, host) } return hosts, listTime, nil } return pagination.List(ctx, grantsHash, pageSize, filterItemFn, listItemsFn, repo.estimatedHostCount) }