builder

type BuildOptions struct {
	// ResourceType represents the resource type.
	ResourceType string

	// ParameterName represents the resource name for resource type.
	ParameterName string

	// ResourceNamePattern represents the resource name pattern used for HTTP routing path.
	ResourceNamePattern string
}

type Builder struct {
	// contains filtered or unexported fields
}

type Namespace struct {
	ResourceNode
	// contains filtered or unexported fields
}

type Operation[T any] struct {
	// Disabled indicates that the operation is disabled. By default, all operations are enabled.
	Disabled bool

	// UpdateFilters is a slice of filters that execute prior to updating a resource.
	UpdateFilters []controller.UpdateFilter[T]

	// DeleteFilters is a slice of filters that execute prior to deleting a resource.
	DeleteFilters []controller.DeleteFilter[T]

	// APIController is the controller function for the API controller frontend.
	APIController server.ControllerFactoryFunc

	// AsyncJobController is the controller function for the async job worker.
	AsyncJobController worker.ControllerFactoryFunc

	// AsyncOperationTimeout is the default timeout duration of async operations for the operation.
	AsyncOperationTimeout time.Duration

	// AsyncOperationRetryAfter is the value of the Retry-After header that will be used for async operations.
	// If this is 0 then the default value of v1.DefaultRetryAfter will be used. Consider setting this to a smaller
	// value like 5 seconds if your operations will complete quickly.
	AsyncOperationRetryAfter time.Duration
}

type OperationRegistration struct {
	// ResourceType represents the resource type.
	ResourceType string

	// ResourceNamePattern represents the resource name pattern used for HTTP routing path.
	ResourceNamePattern string

	// Path represents additional custom action path after resource name.
	Path string

	// Method represents the operation method.
	Method v1.OperationMethod

	// APIController represents the API controller handler.
	APIController server.ControllerFactoryFunc

	// AsyncController represents the async controller handler.
	AsyncController worker.ControllerFactoryFunc
}

type ResourceKind string

type ResourceNode struct {
	// Kind is the resource kind.
	Kind ResourceKind

	// Name is the resource name.
	Name string
	// contains filtered or unexported fields
}

type ResourceOption[P interface {
	*T
	v1.ResourceDataModel
}, T any] struct {

	// ResourceParamName is the parameter name of the resource. This is optional.
	// If not set, the parameter name will be generated by adding "Name" suffix to the resource name.
	ResourceParamName string

	// RequestConverter is the request converter.
	RequestConverter v1.ConvertToDataModel[T]

	// ResponseConverter is the response converter.
	ResponseConverter v1.ConvertToAPIModel[T]

	// ListPlane defines the operation for listing resources by plane scope.
	ListPlane Operation[T]

	// List defines the operation for listing resources by resource group scope.
	List Operation[T]

	// Get defines the operation for getting a resource.
	Get Operation[T]

	// Put defines the operation for creating or updating a resource.
	Put Operation[T]

	// Patch defines the operation for updating a resource.
	Patch Operation[T]

	// Delete defines the operation for deleting a resource.
	Delete Operation[T]

	// Custom defines the custom actions.
	Custom map[string]Operation[T]
	// contains filtered or unexported fields
}

type ResourceOptionBuilder interface {
	// LinkResource links the resource node to the resource option.
	LinkResource(*ResourceNode)

	// ParamName gets the resource name for resource type.
	ParamName() string

	// BuildHandlerOutputs builds the resource outputs which constructs the API routing path and handlers.
	BuildHandlerOutputs(BuildOptions) []*OperationRegistration
}