Class PluginLoader

Discovers and loads lessel plugins.

Plugins can be:

npm packages named @lessel/plugin-* in node_modules
Local files referenced by path in lessel.config.json
Registry plugins in the local plugins/ directory
Directly registered via code

Index

Constructors

Methods

executeForEvent getAll getForSchema loadPlugin registerPlugin scanLocalPluginsDir scanNodeModules setSandboxEnabled startAll stopAll

Constructors

constructor

new PluginLoader(store: Store): PluginLoader
Parameters
- store: Store
Returns PluginLoader
- Defined in packages/core/src/plugin/PluginLoader.ts:21

Methods

executeForEvent

executeForEvent(event: MessageEvent, context: PluginContext): Promise<void>
Execute all plugins that match the given event's schema. Registry plugins are executed in a sandboxed VM context.
Parameters
- event: MessageEvent
- context: PluginContext
Returns Promise<void>
- Defined in packages/core/src/plugin/PluginLoader.ts:190

getAll

getAll(): LesselPlugin[]
Get all loaded plugins.

Returns LesselPlugin[]
- Defined in packages/core/src/plugin/PluginLoader.ts:132

getForSchema

getForSchema(schemaName: string): LesselPlugin[]
Get plugins that match a given schema name.
Parameters
- schemaName: string
Returns LesselPlugin[]
- Defined in packages/core/src/plugin/PluginLoader.ts:139

loadPlugin

loadPlugin(source: string): LesselPlugin | null
Load a plugin from an npm package, file path, or local plugins directory.
Parameters
- source: string
Returns LesselPlugin | null
- Defined in packages/core/src/plugin/PluginLoader.ts:87

registerPlugin

registerPlugin(plugin: LesselPlugin): void
Register a plugin directly (for programmatic use).
Parameters
- plugin: LesselPlugin
Returns void
- Defined in packages/core/src/plugin/PluginLoader.ts:125

scanLocalPluginsDir

scanLocalPluginsDir(): string[]
Scan the local plugins/ directory for registry-installed plugins. Each subdirectory with a package.json is treated as a plugin.

Returns string[]
- Defined in packages/core/src/plugin/PluginLoader.ts:60

scanNodeModules

scanNodeModules(): string[]
Scan node_modules for @lessel/plugin-* packages.

Returns string[]
- Defined in packages/core/src/plugin/PluginLoader.ts:36

setSandboxEnabled

setSandboxEnabled(enabled: boolean): void
Enable or disable sandboxed execution. Sandboxed plugins run in a restricted VM context with no filesystem access.
Parameters
- enabled: boolean
Returns void
- Defined in packages/core/src/plugin/PluginLoader.ts:29

startAll

startAll(context: PluginContext): Promise<void>
Call onStart for all plugins. Before onStart, auto-registers any schemas the plugin ships with.
Parameters
- context: PluginContext
Returns Promise<void>
- Defined in packages/core/src/plugin/PluginLoader.ts:151

stopAll

stopAll(): Promise<void>
Call onStop for all plugins.

Returns Promise<void>
- Defined in packages/core/src/plugin/PluginLoader.ts:174