plugins

type APIPlugin interface {
	EnterprisePlugin

	// RegisterRoutes adds plugin-specific API endpoints
	// Returns a map of route path -> handler
	RegisterRoutes() map[string]any
}

type BackupInfo struct {
	ID        string
	Timestamp int64
	Size      int64
	Location  string
	Metadata  map[string]string
}

type BackupPlugin interface {
	EnterprisePlugin

	// Backup performs a backup operation
	Backup(ctx context.Context, destination string) error

	// Restore performs a restore operation
	Restore(ctx context.Context, source string) error

	// ListBackups returns available backups
	ListBackups(ctx context.Context) ([]BackupInfo, error)
}

type EnterprisePlugin interface {
	// Name returns the plugin name (e.g., "cloudflare-vectorize", "r2-backup")
	Name() string

	// Version returns the plugin version
	Version() string

	// RequiredFeatures returns the edition features this plugin requires
	RequiredFeatures() []string

	// Initialize is called when the plugin is loaded
	// The license parameter contains the validated Enterprise license
	Initialize(ctx context.Context, license *licensing.License, config map[string]any) error

	// Start begins plugin operation (called after all plugins are initialized)
	Start(ctx context.Context) error

	// Stop gracefully shuts down the plugin
	Stop(ctx context.Context) error

	// HealthCheck returns the plugin's health status
	HealthCheck(ctx context.Context) error
}

type MonitoringPlugin interface {
	EnterprisePlugin

	// GetMetrics returns plugin-specific metrics
	GetMetrics(ctx context.Context) (map[string]any, error)
}

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

type PluginMetadata struct {
	Name             string
	Version          string
	Description      string
	Author           string
	License          string
	RequiredFeatures []string
	RequiredVersion  string // Minimum GraphDB version required
}

type StoragePlugin interface {
	EnterprisePlugin

	// AttachToStorage integrates the plugin with the graph storage
	AttachToStorage(storage *storage.GraphStorage) error
}