plugin

type Artifact struct {
	// Name is the artifact name.
	Name string `json:"name"`
	// Path is the artifact path (local file or URL).
	Path string `json:"path"`
	// Type is the artifact type (file, url, etc.).
	Type string `json:"type"`
	// Size is the artifact size in bytes.
	Size int64 `json:"size,omitempty"`
	// Checksum is the artifact checksum.
	Checksum string `json:"checksum,omitempty"`
}

type ArtifactProto struct {
	Name     string
	Path     string
	Type     string
	Size     int64
	Checksum string
}

type CategorizedChanges struct {
	// Features lists feature commits.
	Features []ConventionalCommit `json:"features,omitempty"`
	// Fixes lists bug fix commits.
	Fixes []ConventionalCommit `json:"fixes,omitempty"`
	// Breaking lists breaking change commits.
	Breaking []ConventionalCommit `json:"breaking,omitempty"`
	// Performance lists performance improvement commits.
	Performance []ConventionalCommit `json:"performance,omitempty"`
	// Refactor lists refactoring commits.
	Refactor []ConventionalCommit `json:"refactor,omitempty"`
	// Docs lists documentation commits.
	Docs []ConventionalCommit `json:"docs,omitempty"`
	// Other lists other commits.
	Other []ConventionalCommit `json:"other,omitempty"`
}

type CategorizedChangesProto struct {
	Features    []*ConventionalCommitProto
	Fixes       []*ConventionalCommitProto
	Breaking    []*ConventionalCommitProto
	Performance []*ConventionalCommitProto
	Refactor    []*ConventionalCommitProto
	Docs        []*ConventionalCommitProto
	Other       []*ConventionalCommitProto
}

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

type ConventionalCommit struct {
	// Hash is the commit hash.
	Hash string `json:"hash"`
	// Type is the commit type (feat, fix, etc.).
	Type string `json:"type"`
	// Scope is the optional scope.
	Scope string `json:"scope,omitempty"`
	// Description is the commit description.
	Description string `json:"description"`
	// Body is the commit body.
	Body string `json:"body,omitempty"`
	// Breaking indicates if this is a breaking change.
	Breaking bool `json:"breaking"`
	// BreakingDescription is the breaking change description.
	BreakingDescription string `json:"breaking_description,omitempty"`
	// Issues lists referenced issues.
	Issues []string `json:"issues,omitempty"`
	// Author is the commit author.
	Author string `json:"author,omitempty"`
	// Date is the commit date.
	Date string `json:"date,omitempty"`
}

type ConventionalCommitProto struct {
	Hash                string
	Type                string
	Scope               string
	Description         string
	Body                string
	Breaking            bool
	BreakingDescription string
	Issues              []string
	Author              string
	Date                string
}

type Empty struct{}

type ExecuteRequest struct {
	// Hook is the hook being executed.
	Hook Hook `json:"hook"`
	// Config is the plugin-specific configuration.
	Config map[string]any `json:"config"`
	// Context contains the release context.
	Context ReleaseContext `json:"context"`
	// DryRun indicates if this is a dry run.
	DryRun bool `json:"dry_run"`
}

type ExecuteRequestProto struct {
	Hook    HookProto
	Config  string
	Context *ReleaseContextProto
	DryRun  bool
}

type ExecuteResponse struct {
	// Success indicates if the execution was successful.
	Success bool `json:"success"`
	// Message is an optional message about the execution.
	Message string `json:"message,omitempty"`
	// Error is the error message if execution failed.
	Error string `json:"error,omitempty"`
	// Outputs contains any outputs from the plugin.
	Outputs map[string]any `json:"outputs,omitempty"`
	// Artifacts lists any artifacts created by the plugin.
	Artifacts []Artifact `json:"artifacts,omitempty"`
}

type ExecuteResponseProto struct {
	Success   bool
	Message   string
	Error     string
	Outputs   string
	Artifacts []*ArtifactProto
}

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

type GRPCPlugin struct {
	plugin.Plugin
	Impl Plugin
}

type GRPCServer struct {
	UnimplementedPluginServer
	Impl Plugin
}

type Hook string

type HookProto int32

type Info struct {
	// Name is the plugin name.
	Name string `json:"name"`
	// Version is the plugin version.
	Version string `json:"version"`
	// Description is a short description of the plugin.
	Description string `json:"description"`
	// Author is the plugin author.
	Author string `json:"author"`
	// Hooks lists the hooks this plugin supports.
	Hooks []Hook `json:"hooks"`
	// ConfigSchema is a JSON schema for the plugin configuration.
	ConfigSchema string `json:"config_schema,omitempty"`
}

type MentionFormat int

type Plugin interface {
	// GetInfo returns metadata about the plugin.
	GetInfo() Info

	// Execute runs the plugin for the given hook.
	Execute(ctx context.Context, req ExecuteRequest) (*ExecuteResponse, error)

	// Validate validates the plugin configuration.
	// The context allows for cancellation of long-running validation operations.
	Validate(ctx context.Context, config map[string]any) (*ValidateResponse, error)
}

type PluginClient interface {
	GetInfo(ctx context.Context, in *Empty, opts ...grpc.CallOption) (*PluginInfo, error)
	Execute(ctx context.Context, in *ExecuteRequestProto, opts ...grpc.CallOption) (*ExecuteResponseProto, error)
	Validate(ctx context.Context, in *ValidateRequestProto, opts ...grpc.CallOption) (*ValidateResponseProto, error)
}

type PluginInfo struct {
	Name         string
	Version      string
	Description  string
	Author       string
	Hooks        []string
	ConfigSchema string
}

type PluginServer interface {
	GetInfo(context.Context, *Empty) (*PluginInfo, error)
	Execute(context.Context, *ExecuteRequestProto) (*ExecuteResponseProto, error)
	Validate(context.Context, *ValidateRequestProto) (*ValidateResponseProto, error)
}

type ReleaseContext struct {
	// Version is the release version (e.g., "1.2.3").
	Version string `json:"version"`
	// PreviousVersion is the previous release version.
	PreviousVersion string `json:"previous_version,omitempty"`
	// TagName is the full tag name (e.g., "v1.2.3").
	TagName string `json:"tag_name"`
	// ReleaseType is the type of release (major, minor, patch).
	ReleaseType string `json:"release_type"`
	// RepositoryURL is the repository URL.
	RepositoryURL string `json:"repository_url,omitempty"`
	// RepositoryOwner is the repository owner.
	RepositoryOwner string `json:"repository_owner,omitempty"`
	// RepositoryName is the repository name.
	RepositoryName string `json:"repository_name,omitempty"`
	// Branch is the branch being released from.
	Branch string `json:"branch"`
	// CommitSHA is the HEAD commit SHA.
	CommitSHA string `json:"commit_sha"`
	// Changelog is the generated changelog content.
	Changelog string `json:"changelog,omitempty"`
	// ReleaseNotes is the generated release notes.
	ReleaseNotes string `json:"release_notes,omitempty"`
	// Changes contains the categorized changes.
	Changes *CategorizedChanges `json:"changes,omitempty"`
	// Environment contains filtered environment variables.
	Environment map[string]string `json:"environment,omitempty"`
}

type ReleaseContextProto struct {
	Version         string
	PreviousVersion string
	TagName         string
	ReleaseType     string
	RepositoryUrl   string
	RepositoryOwner string
	RepositoryName  string
	Branch          string
	CommitSha       string
	Changelog       string
	ReleaseNotes    string
	Changes         *CategorizedChangesProto
	Environment     map[string]string
}

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

type UnimplementedPluginServer struct{}

type ValidateRequestProto struct {
	Config string
}

type ValidateResponse struct {
	// Valid indicates if the configuration is valid.
	Valid bool `json:"valid"`
	// Errors lists validation errors.
	Errors []ValidationError `json:"errors,omitempty"`
}

type ValidateResponseProto struct {
	Valid  bool
	Errors []*ValidationErrorProto
}

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

type ValidationError struct {
	// Field is the field that failed validation.
	Field string `json:"field"`
	// Message is the error message.
	Message string `json:"message"`
	// Code is an optional error code.
	Code string `json:"code,omitempty"`
}

type ValidationErrorProto struct {
	Field   string
	Message string
	Code    string
}