plugins

type AggregatedImportSuggestion struct {
	PluginName string
	Suggestion *ImportSuggestion
}

type AuthContext struct {
	WorkDir     string
	StackName   string
	ProgramName string
	// ConfigHashes stores hash of (program + stack) config per plugin for change detection
	ConfigHashes map[string]string
}

type AuthPlugin = p5plugin.AuthPlugin

type AuthPluginGRPC = p5plugin.AuthPluginGRPC

type AuthProvider interface {
	// GetMergedAuthEnv returns combined auth environment variables from all plugins.
	GetMergedAuthEnv() map[string]string

	// GetAllEnv returns all environment variables from all valid credentials.
	GetAllEnv() map[string]string

	// ApplyEnvToProcess sets all credential env vars in the current process environment.
	ApplyEnvToProcess()

	// GetCredentialsSummary returns a summary of all credentials for UI display.
	GetCredentialsSummary() []CredentialsSummary

	// InvalidateCredentials marks credentials for a specific plugin as expired.
	InvalidateCredentials(pluginName string)

	// InvalidateAllCredentials clears all cached credentials.
	InvalidateAllCredentials()
}

type AuthenticateAllCall struct {
	ProgramName string
	StackName   string
	P5Config    *P5Config
	WorkDir     string
}

type AuthenticateResult struct {
	PluginName  string
	Credentials *Credentials
	Error       error
}

type BuiltinImportHelperPlugin interface {
	BuiltinPlugin
	ImportHelperPlugin
}

type BuiltinPlugin interface {
	AuthPlugin
	// Name returns the plugin's registered name (e.g., "env")
	Name() string
}

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

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

type Credentials struct {
	PluginName string
	Env        map[string]string
	ExpiresAt  time.Time // Zero time means never expires (TTL = -1 means always refresh)
	AlwaysCall bool      // True if TTL was -1
}

type CredentialsSummary struct {
	PluginName string
	EnvVars    []string  // List of env var names (not values for security)
	ExpiresAt  time.Time // Zero if never expires
	AlwaysCall bool
	HasError   bool
	Error      string
}

type FakePluginProvider struct {
	// AuthProvider methods
	GetMergedAuthEnvFunc         func() map[string]string
	GetAllEnvFunc                func() map[string]string
	ApplyEnvToProcessFunc        func()
	GetCredentialsSummaryFunc    func() []CredentialsSummary
	InvalidateCredentialsFunc    func(pluginName string)
	InvalidateAllCredentialsFunc func()

	// ImportHelper methods
	GetImportSuggestionsFunc func(ctx context.Context, req *ImportSuggestionsRequest) ([]*AggregatedImportSuggestion, error)
	HasImportHelpersFunc     func() bool

	// PluginProvider methods
	InitializeFunc                      func(ctx context.Context, workDir, programName, stackName string) ([]AuthenticateResult, error)
	CloseFunc                           func(ctx context.Context)
	GetMergedConfigFunc                 func() *P5Config
	ShouldRefreshCredentialsFunc        func(pluginName string, newWorkDir, newStackName, newProgramName string, newProgramConfig, newStackConfig map[string]any) bool
	InvalidateCredentialsForContextFunc func(workDir, stackName, programName string, p5Config *P5Config)
	AuthenticateAllFunc                 func(ctx context.Context, programName, stackName string, p5Config *P5Config, workDir string) ([]AuthenticateResult, error)

	// Default return values
	AuthEnv            map[string]string
	AllEnv             map[string]string
	CredentialsSummary []CredentialsSummary
	ImportSuggestions  []*AggregatedImportSuggestion
	HasImportHelper    bool
	AuthResults        []AuthenticateResult
	MergedConfig       *P5Config
	ShouldRefresh      bool

	// Calls tracks all method invocations.
	Calls struct {
		GetMergedAuthEnv                int
		GetAllEnv                       int
		ApplyEnvToProcess               int
		GetCredentialsSummary           int
		InvalidateCredentials           []string
		InvalidateAllCredentials        int
		GetImportSuggestions            []*ImportSuggestionsRequest
		HasImportHelpers                int
		Initialize                      []InitializeCall
		Close                           int
		GetMergedConfig                 int
		ShouldRefreshCredentials        []ShouldRefreshCredentialsCall
		InvalidateCredentialsForContext []InvalidateCredentialsForContextCall
		AuthenticateAll                 []AuthenticateAllCall
	}
}

type GRPCClient = p5plugin.GRPCClient

type GRPCServer = p5plugin.GRPCServer

type GlobalConfig struct {
	Plugins map[string]PluginConfig `toml:"plugins"`
}

type ImportHelper interface {
	// GetImportSuggestions queries plugins for import ID suggestions.
	GetImportSuggestions(ctx context.Context, req *ImportSuggestionsRequest) ([]*AggregatedImportSuggestion, error)

	// HasImportHelpers returns true if any plugin provides import suggestions.
	HasImportHelpers() bool
}

type ImportHelperGRPCClient = p5plugin.ImportHelperGRPCClient

type ImportHelperGRPCServer = p5plugin.ImportHelperGRPCServer

type ImportHelperPlugin = p5plugin.ImportHelperPlugin

type ImportHelperPluginGRPC = p5plugin.ImportHelperPluginGRPC

type ImportSuggestion = p5plugin.ImportSuggestion

type ImportSuggestionsRequest = p5plugin.ImportSuggestionsRequest

type ImportSuggestionsResponse = p5plugin.ImportSuggestionsResponse

type InitializeCall struct {
	WorkDir     string
	ProgramName string
	StackName   string
}

type InvalidateCredentialsForContextCall struct {
	WorkDir     string
	StackName   string
	ProgramName string
	P5Config    *P5Config
}

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

type P5Config struct {
	Plugins map[string]PluginConfig `yaml:"plugins,omitempty"`
}

type PluginConfig struct {
	// Cmd is the command to run the plugin (path to executable)
	Cmd string `yaml:"cmd" toml:"cmd"`
	// Args are optional arguments to pass to the plugin command
	Args []string `yaml:"args,omitempty" toml:"args,omitempty"`
	// Config is the program-level configuration
	Config map[string]any `yaml:"config,omitempty" toml:"config,omitempty"`
	// Refresh controls when credentials should be refreshed
	Refresh *RefreshTrigger `yaml:"refresh,omitempty" toml:"refresh,omitempty"`

	// Import helper settings
	// ImportHelper enables the import helper capability for this plugin (default: false)
	ImportHelper bool `yaml:"import_helper,omitempty" toml:"import_helper,omitempty"`
	// UseAuthEnv passes merged auth environment variables to import helper requests (default: false)
	UseAuthEnv bool `yaml:"use_auth_env,omitempty" toml:"use_auth_env,omitempty"`
}

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

type PluginProvider interface {
	AuthProvider
	ImportHelper

	// Initialize loads and authenticates plugins based on the current context.
	// This is a convenience method that loads plugins from config and authenticates.
	Initialize(ctx context.Context, workDir, programName, stackName string) ([]AuthenticateResult, error)

	// Close cleans up plugin resources.
	Close(ctx context.Context)

	// GetMergedConfig returns the merged plugin configuration.
	GetMergedConfig() *P5Config

	// ShouldRefreshCredentials determines if credentials should be refreshed for a plugin
	// based on context changes and refresh trigger settings.
	ShouldRefreshCredentials(pluginName string, newWorkDir, newStackName, newProgramName string, newProgramConfig, newStackConfig map[string]any) bool

	// InvalidateCredentialsForContext invalidates credentials based on context change
	// and plugin refresh trigger settings.
	InvalidateCredentialsForContext(workDir, stackName, programName string, p5Config *P5Config)

	// AuthenticateAll runs authentication for all loaded plugins.
	AuthenticateAll(ctx context.Context, programName, stackName string, p5Config *P5Config, workDir string) ([]AuthenticateResult, error)
}

type RefreshTrigger struct {
	// OnWorkspaceChange triggers credential refresh when workspace changes
	// Default: true
	OnWorkspaceChange *bool `yaml:"onWorkspaceChange,omitempty" toml:"onWorkspaceChange,omitempty"`
	// OnStackChange triggers credential refresh when stack changes
	// Default: true
	OnStackChange *bool `yaml:"onStackChange,omitempty" toml:"onStackChange,omitempty"`
	// OnConfigChange triggers credential refresh only when plugin config changes
	// (both program and stack config are compared)
	// Default: false - when true, workspace/stack changes only refresh if config differs
	OnConfigChange *bool `yaml:"onConfigChange,omitempty" toml:"onConfigChange,omitempty"`
}

type ShouldRefreshCredentialsCall struct {
	PluginName       string
	NewWorkDir       string
	NewStackName     string
	NewProgramName   string
	NewProgramConfig map[string]any
	NewStackConfig   map[string]any
}