v1alpha1

type Bearer struct {
	metav1.TypeMeta `json:",inline"`
	// Standard list metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Spec holds information about the request being evaluated.
	Spec BearerSpec `json:"spec"`
	// Status holds status for the Bearer
	Status BearerStatus `json:"status,omitempty"`
}

type BearerList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Bearer `json:"items"`
}

type BearerPhase string

type BearerSpec struct {
	// URL is the URL that is being checked for authorization.
	URL string `json:"url"`

	// Priority represents the relative importance of this manifest when multiple manifests exist.
	Priority int64 `json:"priority"`

	// MaximumRetry is the number of times the chunk has been retried.
	// +default=3
	MaximumRetry int64 `json:"maximumRetry,omitempty"`
}

type BearerStatus struct {
	// HandlerName is the name of the handler.
	HandlerName string `json:"handlerName"`

	// Phase represents the current phase of the manifest.
	Phase BearerPhase `json:"phase,omitempty"`

	// TokenInfo contains information about the authentication token
	TokenInfo *BearerTokenInfo `json:"tokenInfo,omitempty"`

	// Retry is the number of times the manifest has been retried.
	Retry int64 `json:"retry,omitempty"`

	// Conditions holds conditions for the Bearer.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type BearerTokenInfo struct {
	// Token is the actual authentication token string
	Token string `json:"token"`

	// ExpiresIn is the duration in seconds until the token expires
	ExpiresIn int64 `json:"expires_in,omitempty"`

	// IssuedAt is the timestamp when the token was issued
	IssuedAt metav1.Time `json:"issued_at,omitempty"`
}

type Blob struct {
	metav1.TypeMeta `json:",inline"`
	// Standard list metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Spec holds information about the request being evaluated.
	Spec BlobSpec `json:"spec"`
	// Status holds status for the Blob
	Status BlobStatus `json:"status,omitempty"`
}

type BlobDestination struct {
	// Name is the name of the destination.
	Name string `json:"name"`

	// Path is the filesystem path where the blob should be stored.
	Path string `json:"path"`

	// ReverifySha256 indicates whether the blob's content should be verified with SHA256 checksum.
	// If true, the blob will be verified after download using the ContentSha256 value.
	ReverifySha256 bool `json:"reverifySha256,omitempty"`

	// SkipIfExists indicates whether to skip the download if the blob already exists at the destination.
	SkipIfExists bool `json:"skipIfExists,omitempty"`
}

type BlobList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Blob `json:"items"`
}

type BlobPhase string

type BlobSource struct {
	// URL is the source URL of the blob.
	URL string `json:"url"`

	// BearerName is the name of the Bearer resource that should be used for authentication.
	BearerName string `json:"bearerName,omitempty"`
}

type BlobSpec struct {
	// Source is the source of the blob.
	Source []BlobSource `json:"source"`

	// Destination is the destination of the blob.
	Destination []BlobDestination `json:"destination"`

	// Priority represents the relative importance of this blob when multiple blobs exist.
	Priority int64 `json:"priority"`

	// MinimumChunkSize represents the minimum size of each chunk when splitting the blob.
	MinimumChunkSize int64 `json:"minimumChunkSize,omitempty"`

	// ChunkSize represents the size of each chunk when splitting the blob.
	ChunkSize int64 `json:"chunkSize,omitempty"`

	// ChunksNumber represents the total number of chunks that the blob will be split into.
	ChunksNumber int64 `json:"chunksNumber,omitempty"`

	// ContentSha256 is the sha256 checksum of the blob content being verified.
	ContentSha256 string `json:"contentSha256,omitempty"`

	// MaximumRunning is the maximum number of running chunks allowed for this blob.
	// +default=2
	MaximumRunning int64 `json:"maximumRunning,omitempty"`

	// MaximumPending is the maximum number of pending chunks allowed for this blob.
	// +default=1
	MaximumPending int64 `json:"maximumPending,omitempty"`

	// MaximumRetry is the number of times the chunk has been retried.
	// +default=3
	MaximumRetry int64 `json:"maximumRetry,omitempty"`
}

type BlobStatus struct {
	// HandlerName is the name of the handler.
	HandlerName string `json:"handlerName"`

	// Phase represents the current phase of the blob.
	Phase BlobPhase `json:"phase,omitempty"`

	// Total represents the total amount of work to be done for this blob.
	Total int64 `json:"total,omitempty"`

	// AcceptRanges represents the accept-ranges header of the response.
	AcceptRanges bool `json:"acceptRanges,omitempty"`

	// Progress is the progress of the blob.
	Progress int64 `json:"progress,omitempty"`

	// PendingChunks is the number of pending chunks for this blob.
	PendingChunks int64 `json:"pendingChunks,omitempty"`

	// RunningChunks is the number of running chunks for this blob.
	RunningChunks int64 `json:"runningChunks,omitempty"`

	// SucceededChunks is the number of succeeded chunks for this blob.
	SucceededChunks int64 `json:"succeededChunks,omitempty"`

	// FailedChunks is the number of failed chunks for this blob.
	FailedChunks int64 `json:"failedChunks,omitempty"`

	// Retry is the number of times the blob has been retried.
	Retry int64 `json:"retry,omitempty"`

	// Conditions holds conditions for the Blob.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type Chunk struct {
	metav1.TypeMeta `json:",inline"`
	// Standard list metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// Spec holds information about the request being evaluated.
	Spec ChunkSpec `json:"spec"`
	// Status holds status for the Chunk
	Status ChunkStatus `json:"status,omitempty"`
}

type ChunkHTTP struct {
	// Request defines the HTTP request parameters
	Request ChunkHTTPRequest `json:"request"`

	// Response defines the expected HTTP response for validation
	Response ChunkHTTPResponse `json:"response"`
}

type ChunkHTTPRequest struct {
	// Method is the HTTP method (GET, POST, PUT, DELETE, etc)
	Method string `json:"method"`

	// URL is the target URL for the request
	URL string `json:"url"`

	// Headers contains the HTTP headers for the request
	// +optional
	Headers map[string]string `json:"headers,omitempty"`
}

type ChunkHTTPResponse struct {
	// StatusCode is the expected HTTP status code
	StatusCode int `json:"statusCode"`

	// Headers contains the HTTP headers from the response
	Headers map[string]string `json:"headers,omitempty"`
}

type ChunkList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Chunk `json:"items"`
}

type ChunkPhase string

type ChunkSpec struct {
	// Source is the source of the chunk.
	Source ChunkHTTP `json:"source"`

	// BearerName is the name of the Bearer resource that should be used for authentication.
	BearerName string `json:"bearerName,omitempty"`

	// Destination is the destination of the chunk.
	Destination []ChunkHTTP `json:"destination,omitempty"`

	// Priority represents the relative importance of this chunk when multiple chunks exist.
	Priority int64 `json:"priority"`

	// Total represents the total amount of work to be done for this chunk.
	Total int64 `json:"total,omitempty"`

	// ChunkIndex represents the part number in a multipart upload operation.
	// 0 means not part of a multipart upload, >0 means the part number (1-based index).
	ChunkIndex int64 `json:"chunkIndex,omitempty"`

	// ChunksNumber represents the total number of chunks that the chunk is part of in a multipart operation.
	ChunksNumber int64 `json:"chunksNumber,omitempty"`

	// Sha256PartialPreviousName indicates if this is an initial block when set to "-"
	Sha256PartialPreviousName string `json:"sha256PartialPreviousName,omitempty"`

	// Sha256 is the expected SHA256 hash of the complete content
	Sha256 string `json:"sha256,omitempty"`

	// MaximumRetry is the number of times the chunk has been retried.
	MaximumRetry int64 `json:"maximumRetry,omitempty"`

	// InlineResponseBody indicates whether the response body should be inlined in the status
	InlineResponseBody bool `json:"inlineResponseBody,omitempty"`
}

type ChunkStatus struct {
	// HandlerName is the name of the handler.
	HandlerName string `json:"handlerName"`

	// Phase represents the current phase of the chunk.
	Phase ChunkPhase `json:"phase,omitempty"`

	// Progress is the progress of the chunk.
	Progress int64 `json:"progress,omitempty"`

	// SourceResponse is the response from the source resource
	SourceResponse *ChunkHTTPResponse `json:"sourceResponse,omitempty"`

	// ResponseBody contains the raw response body from the source resource
	ResponseBody []byte `json:"responseBody,omitempty"`

	// SourceProgress is the progress of reading the source resource
	SourceProgress int64 `json:"sourceProgress,omitempty"`

	// DestinationProgresses tracks progress of writing to destination resources
	DestinationProgresses []int64 `json:"destinationProgresses,omitempty"`

	// Sha256Partial contains sha256 hash that is partially calculated and saved
	Sha256Partial []byte `json:"sha256Partial,omitempty"`

	// Sha256 is the sha256 hash of the resource snapshot being verified.
	Sha256 string `json:"sha256,omitempty"`

	// Etag is the ETag of the resource snapshot being verified.
	Etags []string `json:"etags,omitempty"`

	// Retry is the number of times the chunk has been retried.
	Retry int64 `json:"retry,omitempty"`

	// Retryable indicates whether the chunk can be retried.
	Retryable bool `json:"retryable,omitempty"`

	// Conditions holds conditions for the Chunk.
	// +patchMergeKey=type
	// +patchStrategy=merge
	// +listType=map
	// +listMapKey=type
	Conditions []Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
}

type Condition struct {
	// Type of condition in CamelCase or in foo.example.com/CamelCase.
	// Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be
	// useful (see .node.status.conditions), the ability to deconflict is important.
	// The regex it matches is (dns1123SubdomainFmt/)?(qualifiedNameFmt)
	Type string `json:"type"`

	// Message is a human readable message indicating details about the transition.
	// This may be an empty string.
	Message string `json:"message"`
}

type ConditionStatus string

type Multipart struct {
	metav1.TypeMeta `json:",inline"`
	// Standard list metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// DestinationNames contains the names of destination resources for multipart uploads
	DestinationNames []string `json:"destinationNames,omitempty"`

	// UploadIDs holds the list of upload IDs for multipart uploads
	UploadIDs []string `json:"uploadIDs,omitempty"`

	// UploadEtags holds the etags of uploaded parts for multipart uploads
	UploadEtags []UploadEtags `json:"uploadEtags,omitempty"`
}

type MultipartList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Multipart `json:"items"`
}

type UploadEtags struct {
	Size  int64    `json:"size,omitempty"`
	Etags []string `json:"etags,omitempty"`
}