module

type Descriptor struct {
	Name         string   `json:"name"`         // Unique module identifier
	Version      string   `json:"version"`      // Module version
	Description  string   `json:"description"`  // Human-readable description
	Dependencies []string `json:"dependencies"` // Other modules this depends on
	Optional     bool     `json:"optional"`     // Whether module can be disabled
	ConfigFile   string   `json:"config_file"`  // Path to module's config file
}

type ExtraInfo map[string]any

type Module interface {
	// Name returns the unique module identifier
	// Examples: "login-monitor", "suricata-watcher", "feeds-sync"
	Name() string

	// Init initializes the module with the event bus
	// Called once before Start
	// Should set up internal state but NOT start background work
	Init(bus *eventbus.Bus) error

	// Start begins the module's background work
	// Called after Init
	// Should spawn goroutines for continuous work
	// The context is cancelled when the daemon shuts down
	Start(ctx context.Context) error

	// Stop gracefully shuts down the module
	// Called when daemon is stopping
	// Should clean up resources and wait for goroutines to finish
	Stop() error

	// Status returns the current module status
	// Called on demand for health checks and API responses
	Status() Status
}

type ModuleError struct {
	Module string
	Op     string
	Err    error
}

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

type Status struct {
	Name       string    `json:"name"`        // Module name
	Enabled    bool      `json:"enabled"`     // Whether module is enabled in config
	Running    bool      `json:"running"`     // Whether module is currently running
	Healthy    bool      `json:"healthy"`     // Whether module is functioning correctly
	LastRun    time.Time `json:"last_run"`    // Last time module performed its main task
	LastError  string    `json:"last_error"`  // Last error message (empty if none)
	ErrorCount int       `json:"error_count"` // Total errors since start
	EventCount int64     `json:"event_count"` // Total events processed
	StartTime  time.Time `json:"start_time"`  // When module was started
	Uptime     string    `json:"uptime"`      // Human-readable uptime
	Extra      ExtraInfo `json:"extra"`       // Module-specific status info
}