plugin

type DevServerChecker interface {
	IsManaged(pluginID string) bool
}

type LoadPluginOptions struct {
	DevMode       bool
	DevModePath   string
	ExistingState *plugintypes.PluginState
}

type Manager interface {
	// Initialize discovers and loads all plugins that are currently installed in the plugin directory,
	// and initializes them with the appropriate controllers.
	Initialize(ctx context.Context) error

	// Run starts until the the passed in context is cancelled
	Run(ctx context.Context)

	// Shutdown stops the plugin manager and all plugins.
	Shutdown()

	// InstallInDevMode installs a plugin from the given path, and sets up a watcher to recompile and reload the plugin
	// when changes are detected. Will prompt the user for a path.
	InstallInDevMode() (*config.PluginMeta, error)

	// InstallFromPathPrompt installs a plugin from the given path, prompting the user for the location
	// with a window dialog.
	InstallFromPathPrompt() (*config.PluginMeta, error)

	// InstallPluginFromPath installs a plugin from the given path. It will validate the plugin
	// and then load it into the manager.
	InstallPluginFromPath(path string) (*config.PluginMeta, error)

	// InstallPluginVersion installs a plugin with a specified version from the plugin registry.
	// It returns an error if it does not exist.
	InstallPluginVersion(pluginID string, version string) (*config.PluginMeta, error)

	// LoadPlugin loads a plugin at the given path. It will validate the plugin
	// and then load it into the manager.
	LoadPlugin(id string, opts *LoadPluginOptions) (types.Plugin, error)

	// ReloadPlugin reloads a plugin at the given path. It will validate the plugin
	// and then load it into the manager.
	ReloadPlugin(id string) (types.Plugin, error)

	// UninstallPlugin uninstalls a plugin from the manager, and removes it from the filesystem.
	UninstallPlugin(id string) (types.Plugin, error)

	// GetPlugin returns the plugin with the given plugin ID.
	GetPlugin(id string) (types.Plugin, error)

	// ListPlugins returns a list of all plugins that are currently registered with the manager.
	ListPlugins() []types.Plugin

	// ListAvailablePlugins returns a list of all plugins that are available and supported for the
	// user's IDE environment.
	ListAvailablePlugins() ([]registry.AvailablePlugin, error)

	// SearchPlugins searches the marketplace with filters.
	SearchPlugins(query, category, sort string) ([]registry.AvailablePlugin, error)

	// GetPluginReadme fetches the README for a marketplace plugin.
	GetPluginReadme(pluginID string) (string, error)

	// GetPluginVersions fetches version info for a marketplace plugin.
	GetPluginVersions(pluginID string) ([]registry.VersionInfo, error)

	// GetPluginReviews fetches reviews for a marketplace plugin.
	GetPluginReviews(pluginID string, page int) ([]registry.Review, error)

	// GetPluginDownloadStats fetches download statistics for a marketplace plugin.
	GetPluginDownloadStats(pluginID string) (*registry.DownloadStats, error)

	// GetPluginReleaseHistory fetches version history for a marketplace plugin.
	GetPluginReleaseHistory(pluginID string) ([]registry.VersionInfo, error)

	// GetPluginMeta returns the plugin metadata for the given plugin ID.
	GetPluginMeta(id string) (config.PluginMeta, error)

	// ListPlugins returns a list of all plugins that are currently registered with the manager.
	ListPluginMetas() []config.PluginMeta

	// SetDevServerChecker sets the dev server checker used to skip the old
	// rebuild pipeline for plugins managed by the DevServerManager.
	SetDevServerChecker(checker DevServerChecker)

	// SetDevServerManager sets the dev server manager used to auto-start
	// dev servers for plugins in dev mode.
	SetDevServerManager(mgr *devserver.DevServerManager)
}

type PluginBuilder struct{}

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