lua

type CommandsModule ¶

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

CommandsModule exposes `hive.commands(map)` and accumulates registered commands. Read them out via Commands() after the entrypoint runs.

A CommandsModule is single-use: registration writes into its commands map, so create a fresh instance per Runtime.

func (m *CommandsModule) Commands() map[string]config.UserCommand

func (m *CommandsModule) Register(state *glua.LState, hive *glua.LTable) error

type HostModule ¶

type HostModule interface {
	Register(state *glua.LState, hive *glua.LTable) error
}

HostModule registers part of the `hive` host API on the Lua state. Each module owns its own state and the field(s) it attaches to the hive table; adding a new API surface is "implement Register and pass an instance to NewRuntime."

type LogModule ¶

type LogModule struct {
	PluginName string
}

LogModule exposes `hive.log.{debug,info,warn,error}` functions that emit to the standard Hive log with a "plugin" field tagged with PluginName.

func (m *LogModule) Register(state *glua.LState, hive *glua.LTable) error

type Plugin ¶

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

Plugin adapts a Lua entry file to Hive's plugin interface.

func New(cfg config.LuaPluginConfig) *Plugin

func (p *Plugin) Available() bool

func (p *Plugin) Close() error

func (p *Plugin) Commands() map[string]config.UserCommand

func (p *Plugin) Init(_ context.Context) error

func (p *Plugin) Name() string

func (p *Plugin) StatusProvider() plugins.StatusProvider

type PluginInfoModule ¶

type PluginInfoModule struct {
	Name       string
	Entry      string
	ModuleRoot string
}

PluginInfoModule exposes static metadata about the running plugin via `hive.plugin.{name,entry,module_root}`.

func (m *PluginInfoModule) Register(state *glua.LState, hive *glua.LTable) error

type Runtime ¶

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

Runtime owns a sandboxed Lua state for a Hive plugin. The state is private: callers interact through LoadEntrypoint / CallEntrypoint / Close.

func NewRuntime(moduleRoot string, modules ...HostModule) (*Runtime, error)

func (r *Runtime) CallEntrypoint(entrypoint *glua.LFunction) error

func (r *Runtime) Close()

func (r *Runtime) LoadEntrypoint(path string) (*glua.LFunction, error)