extraction

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

type CacheEntry struct {
	// Content is the cached file content
	Content *FileContent

	// ETag is the HTTP ETag for conditional requests
	ETag string

	// ExpiresAt is when the cache entry expires
	ExpiresAt time.Time
}

type ExtractionResult struct {
	// Metadata contains all extracted key-value pairs
	Metadata map[string]string

	// Labels contains rendered labels ready for GitHub
	Labels map[string]string

	// Errors contains any non-fatal errors encountered
	Errors []error

	// ProcessingTime is how long extraction took
	ProcessingTime time.Duration
}

type Extractor interface {
	// Name returns the unique name of this extractor
	Name() string

	// Extract extracts metadata from the given PR using the file fetcher.
	// Returns a map of key-value pairs representing the extracted metadata.
	Extract(ctx context.Context, pr github.PullRequest, fetcher FileFetcher) (map[string]string, error)

	// Required returns true if this extractor must succeed for qualification to pass
	Required() bool
}

type ExtractorConfig struct {
	// Name is the extractor name
	Name string `json:"name" yaml:"name"`

	// Type is the extractor type (version, environment, layout, annotation)
	Type string `json:"type" yaml:"type"`

	// FilePath is the file to extract from (for file-based extractors)
	FilePath string `json:"filePath,omitempty" yaml:"filePath,omitempty"`

	// Key is the YAML/JSON key to extract
	Key string `json:"key,omitempty" yaml:"key,omitempty"`

	// JSONPath is the JSONPath expression for complex extraction
	JSONPath string `json:"jsonPath,omitempty" yaml:"jsonPath,omitempty"`

	// Pattern is a regex pattern for pattern-based extraction
	Pattern string `json:"pattern,omitempty" yaml:"pattern,omitempty"`

	// DefaultValue is used if extraction fails
	DefaultValue string `json:"defaultValue,omitempty" yaml:"defaultValue,omitempty"`

	// Required indicates if this extraction must succeed
	Required bool `json:"required" yaml:"required"`

	// Transform specifies value transformation (lowercase, uppercase, trim)
	Transform string `json:"transform,omitempty" yaml:"transform,omitempty"`
}

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

type FileContent struct {
	// Path is the file path in the repository
	Path string

	// Content is the decoded file content
	Content []byte

	// SHA is the Git SHA of the file
	SHA string

	// Size is the file size in bytes
	Size int64

	// FetchedAt is when the file was fetched
	FetchedAt time.Time
}

type FileFetcher interface {
	// GetFile fetches a file from a PR with caching support.
	// Uses the PR's head SHA as the ref for file retrieval.
	GetFile(ctx context.Context, pr github.PullRequest, path string) (*FileContent, error)

	// GetFileWithRef fetches a file from a specific Git ref.
	GetFileWithRef(ctx context.Context, repo github.Repository, path string, ref string) (*FileContent, error)

	// ClearCache clears the entire cache.
	ClearCache()
}

type LabelComposer interface {
	// Compose renders label templates using extracted metadata.
	// Returns a map of label names to their rendered values.
	Compose(metadata map[string]string) (map[string]string, error)
}

type LabelTemplate struct {
	// Name is the label name pattern (e.g., "cd/version:{version}")
	Name string `json:"name" yaml:"name"`

	// MetadataKey is the metadata key to use for rendering
	MetadataKey string `json:"metadataKey" yaml:"metadataKey"`

	// DefaultValue is used if metadata key is missing
	DefaultValue string `json:"defaultValue,omitempty" yaml:"defaultValue,omitempty"`

	// Prefix is the label prefix (e.g., "cd/")
	Prefix string `json:"prefix,omitempty" yaml:"prefix,omitempty"`
}