aws

type AccountCursor struct {
	Offset     int
	NextMarker *string
}

type Adapter struct {
	Client Client
}

type AttachedGroupPoliciesHandler struct {
	Client *iam.Client
}

type AttachedRolePoliciesHandler struct {
	Client *iam.Client
}

type AttachedUserPoliciesHandler struct {
	Client *iam.Client
}

type Auth struct {
	// AccessKey is the access key to authenticate with the AWS.
	AccessKey string

	// SecretKey is the secret key to authenticate with the AWS.
	SecretKey string

	// Region is the AWS region to query.
	Region string
}

type Client interface {
	GetPage(ctx context.Context, request *Request) (*Response, *framework.Error)
}

type ClientConfig struct {
	AWSConfig *aws.Config
}

type Config struct {
	// Common configuration
	*config.CommonConfig

	// Region is the AWS region to query.
	Region string `json:"region"`

	// EntityConfig is a map containing the config required for each entity associated with this
	EntityConfig map[string]*EntityConfig `json:"entityConfig,omitempty"`

	// ResourceAccountRoles is a list of roleARNs.
	ResourceAccountRoles []string `json:"resourceAccountRoles,omitempty"`
}

type Datasource struct {
	Client         *http.Client
	AWSConfig      *aws.Config
	MaxConcurrency int
}

type EntityConfig struct {
	// PathPrefix is the path prefix to filter the entities.
	PathPrefix *string `json:"pathPrefix,omitempty"`
}

type EntityGetter[T any] interface {
	// The Get method retrieves the specified entity.
	//
	// Parameters:
	//
	//   ctx: Context for cancellation and deadlines.
	//   entity: Entity of type T to be retrieved.
	//
	// Returns:
	//
	//   T: Retrieved entity detail of type T.
	//   error: Error, if any.
	Get(ctx context.Context, entity T) (T, error)
}

type EntityInfo struct {
	// MemberOf Specifies the entity name to which the member belong.
	MemberOf *string
	// CollectionAttribute is the attribute that contains the collection name.
	CollectionAttribute *string
	// Identifiers contains the attributes that can be used to uniquely identify the entity.
	Identifiers *Identifiers
}

type EntityLister[T any] interface {
	// The List method retrieves a list of entities with pagination support.
	//
	// Parameters:
	//
	//   ctx: Context for cancellation and deadlines.
	//   opts: Options to control the List operation, such as filtering and pagination.
	//
	// Returns:
	//
	//   []T: Slice of entities of type T.
	//   *string: Token for the next page.
	//   error: Error, if any.
	List(ctx context.Context, opts *Options) ([]T, *string, error)
}

type GroupHandler struct {
	Client *iam.Client
}

type GroupMemberHandler struct {
	Client *iam.Client
}

type IDPHandler struct {
	Client *iam.Client
}

type Identifiers struct {
	// ArnAttribute is the attribute that contains the Arn of the entity.
	// This is used to extract the AccountID.
	//
	// [Example: Arn, PolicyArn, etc.]
	ArnAttribute string

	// UniqueName of the AWS entity helps to get the entity.
	UniqueName string
}

type InputParams struct {
	PathPrefix *string // An optional prefix to filter the entities based on their path.
	MaxItems   *int32  // An optional limit on the number of entities to fetch.
	Marker     *string // An optional marker to indicate the starting point for the next set of results.
}

type Options struct {
	InputParams

	EntityName         string  // The name of the entity for which the request is made.
	UniqueName         *string // Unique Name associated with the entity, used for identification.
	UniqueID           *string // Unique ID associated with the entity, used for identification.
	AccountIDRequested bool    // A flag indicating whether the Account ID is requested to be included in the response.
	IsMember           bool    // A flag indicating whether the entity is a member of another entity.
	MaxConcurrent      int     // The maximum number of concurrent requests to make.
}

type PolicyHandler struct {
	Client *iam.Client
}

type Request struct {
	Auth

	// PageSize is the maximum number of objects to return from the entity.
	MaxItems int32

	// EntityExternalID is the external ID of the entity.
	// The external ID should match the API's resource name.
	EntityExternalID string

	// AccountIDRequested is a boolean that indicates whether the account ID is requested.
	AccountIDRequested bool

	// EntityConfig is a map containing the config required for each entity associated with this
	EntityConfig map[string]*EntityConfig

	// Cursor identifies the first object of the page to return, as returned by
	// the last request for the entity.
	// nil in the request for the first page.
	Cursor *pagination.CompositeCursor[string]

	// RequestTimeoutSeconds is the timeout duration for requests made to datasources.
	// This should be set to the number of seconds to wait before timing out.
	RequestTimeoutSeconds int

	// Ordered is a boolean that indicates whether the results should be ordered.
	Ordered bool

	// ResourceAccountRoles is a list of roleARNs.
	ResourceAccountRoles []string
}

type ResourceAccount struct {
	// RoleARN is the ARN of the role to assume in the account.
	RoleARN string `json:"roleARN"`
}

type Response struct {
	// StatusCode is an HTTP status code.
	StatusCode int

	// RetryAfterHeader is the Retry-After response HTTP header, if set.
	RetryAfterHeader string

	// Objects is the list of items returned by the datasource.
	// May be empty.
	Objects []map[string]any

	// NextCursor is the cursor that identifies the first object of the next page.
	// nil if this is the last page in this full sync.
	NextCursor *pagination.CompositeCursor[string]
}

type RoleHandler struct {
	Client *iam.Client
}

type UserHandler struct {
	Client *iam.Client
}