Managing the execution of Pluggable Electron activation and extension points is done in the renderer. The activation manager needs to be set up before the other features can be used in the renderer.

The activation and execution managers can be imported in the renderer process by requiring pluggable electron. E.g. import { extensionPoints, activationPoints } from "pluggable-electron"

To access the plugin manager from the renderer, the Plugin Manager must first be initialised in the main process, and facade must be initialised in the renderer. If nodeIntegration is set to true, the facade can be imported directly in the renderer, otherwise this needs to be imported in the preload script. Examples:

const useFacade = require("pluggable-electron/facade")
useFacade()

All of the items described below can be accessed by importing Pluggable Electron in the renderer except for the Facade. This requires a separate import as described above.

ExtensionPoint

Represents a point in the consumer's code that can be extended by a plugin. The plugin can register a callback or object to the extension point. When the extension point is triggered, the provided function will then be called or object will be returned.

Plugin

A slimmed down representation of a plugin for the renderer.

activationPoints : object

This object contains a register of plugin registrations to an activation points, and the means to work with them.

extensionPoints : object

This object contains a register of extension points and the means to work with them.

plugins : object

Helper functions to access the plugin management in the main process. Note that the facade needs to be imported separately as "pluggable-electron/facade" as described above. It is then available on the global window object as describe in the Electron documentation

setup(options) ⇒ void

Set the renderer options for Pluggable Electron. Should be called before any other Pluggable Electron function in the renderer

Extension : Object

An extension registered to an extension point

installOptions : Object.<string, any>

The pacote options used to install the plugin.

importer ⇒ module

Used to import a plugin entry point. Ensure your bundler does no try to resolve this import as the plugins are not known at build time.

Represents a point in the consumer's code that can be extended by a plugin. The plugin can register a callback or object to the extension point. When the extension point is triggered, the provided function will then be called or object will be returned.

Kind: global class

• ExtensionPoint
  • .name : string
  • .register(name, response, [priority]) ⇒ void
  • .unregister(name) ⇒ void
  • .clear() ⇒ void
  • .get(name) ⇒ Object | Callback | undefined
  • .execute(input) ⇒ Array
  • .executeSerial(input) ⇒ Promise.<*>
  • .onRegister(name, callback)
  • .offRegister(name)

Name of the extension point

Kind: instance property of ExtensionPoint

Register new extension with this extension point. The registered response will be executed (if callback) or returned (if object) when the extension point is executed (see below).

Kind: instance method of ExtensionPoint

Remove an extension from the registry. It will no longer be part of the extension point execution.

Kind: instance method of ExtensionPoint

Empty the registry of all extensions.

Kind: instance method of ExtensionPoint

Get a specific extension registered with the extension point

Kind: instance method of ExtensionPoint
Returns: Object | Callback | undefined - The response of the extension. If this is a function the function is returned, not its response.

Execute (if callback) and return or just return (if object) the response for each extension registered to this extension point. Any asynchronous responses will be executed in parallel and the returned array will contain a promise for each of these responses.

Kind: instance method of ExtensionPoint
Returns: Array - List of responses from the extensions.

Execute (if callback) and return the response, or push it to the array if the previous response is an array for each extension registered to this extension point in serial, feeding the result from the last response as input to the next.

Kind: instance method of ExtensionPoint
Returns: Promise.<*> - Result of the last extension that was called

Register a callback to be executed if the list of extensions changes.

Kind: instance method of ExtensionPoint

Unregister a callback from the extension list changes.

Kind: instance method of ExtensionPoint

A slimmed down representation of a plugin for the renderer.

Kind: global class

• Plugin
  • .name : string
  • .url : string
  • .activationPoints : Array.<string>
  • .active : boolean
  • .triggerExport(exp)

Name of the package.

Kind: instance property of Plugin

The electron url where this plugin is located.

Kind: instance property of Plugin

List of activation points.

Kind: instance property of Plugin

Whether this plugin should be activated when its activation points are triggered.

Kind: instance property of Plugin

Trigger an exported callback on the plugin's main file.

Kind: instance method of Plugin

This object contains a register of plugin registrations to an activation points, and the means to work with them.

Kind: global namespace

• activationPoints : object
  • .register(plugin) ⇒ void
  • .trigger(activationPoint) ⇒ Promise.<Boolean>
  • .remove(plugin) ⇒ void
  • .clear() ⇒ void
  • .get() ⇒ Array.<Activation>

Register a plugin with its activation points (as defined in its manifest).

Kind: static method of activationPoints

Trigger all activations registered to the given activation point. See Plugin. This will call the function with the same name as the activation point on the path specified in the plugin.

Kind: static method of activationPoints
Returns: Promise.<Boolean> - Resolves to true when the activations are complete.

Remove a plugin from the activations register.

Kind: static method of activationPoints

Remove all activations from the activation register.

Kind: static method of activationPoints

Fetch all activations.

Kind: static method of activationPoints
Returns: Array.<Activation> - Found extension points

This object contains a register of extension points and the means to work with them.

Kind: global namespace

• extensionPoints : object
  • .add(name) ⇒ void
  • .remove(name) ⇒ void
  • .register(ep, extension, response, [priority]) ⇒ void
  • .unregisterAll(name)
  • .get([ep]) ⇒ Object.<ExtensionPoint> | ExtensionPoint
  • .execute(name, [input]) ⇒ Array
  • .executeSerial(name, [input]) ⇒ Promise.<*>

Create new extension point and add it to the registry.

Kind: static method of extensionPoints

Remove an extension point from the registry.

Kind: static method of extensionPoints

Create extension point if it does not exist and then register the given extension to it.

Kind: static method of extensionPoints

Remove extensions matching regular expression from all extension points.

Kind: static method of extensionPoints

Fetch extension point by name. or all extension points if no name is given.

Kind: static method of extensionPoints
Returns: Object.<ExtensionPoint> | ExtensionPoint - Found extension points

Call all the extensions registered to an extension point synchronously. See execute on ExtensionPoint. Call this at the point in the base code where you want it to be extended.

Kind: static method of extensionPoints
Returns: Array - Result of Promise.all or Promise.allSettled depending on exitOnError

Calls all the extensions registered to the extension point in serial. See executeSerial on ExtensionPoint Call this at the point in the base code where you want it to be extended.

Kind: static method of extensionPoints
Returns: Promise.<*> - Result of the last extension that was called

Helper functions to access the plugin management in the main process. Note that the facade needs to be imported separately as "pluggable-electron/facade" as described above. It is then available on the global window object as describe in the Electron documentation

Kind: global namespace

• plugins : object
  • .install(plugins) ⇒ Promise.<(Array.<Plugin>|false)>
  • .uninstall(plugins, reload) ⇒ Promise.<boolean>
  • .getActive() ⇒ Promise.<Array.<Plugin>>
  • .registerActive() ⇒ Promise.<Array.<Plugin>>
  • .update(plugins, reload) ⇒ Promise.<Array.<Plugin>>
  • .updatesAvailable(plugin) ⇒ Object.<(string|false)>
  • .toggleActive(plugin, active) ⇒ Promise.<Plugin>

Install a new plugin.

Kind: static method of plugins
Returns: Promise.<(Array.<Plugin>|false)> - plugin as defined by the main process. Has property cancelled set to true if installation was cancelled in the main process.

Uninstall provided plugins

Kind: static method of plugins
Returns: Promise.<boolean> - Whether uninstalling the plugins was successful.

Fetch a list of all the active plugins.

Kind: static method of plugins
Returns: Promise.<Array.<Plugin>> - List of plugins as defined by the main process.

Register all the active plugins.

Kind: static method of plugins
Returns: Promise.<Array.<Plugin>> - List of plugins as defined by the main process.

Update provided plugins to its latest version.

Kind: static method of plugins
Returns: Promise.<Array.<Plugin>> - Updated plugin as defined by the main process.

Check if an update is available for provided plugins.

Kind: static method of plugins
Returns: Object.<(string|false)> - Object with plugins as keys and new version if update is available or false as values.

Toggle a plugin's active state. This determines if a plugin should be loaded in initialisation.

Kind: static method of plugins
Returns: Promise.<Plugin> - Updated plugin as defined by the main process.

Set the renderer options for Pluggable Electron. Should be called before any other Pluggable Electron function in the renderer

Kind: global function

An extension registered to an extension point

Kind: global typedef
Properties

The pacote options used to install the plugin.

Kind: global typedef

Used to import a plugin entry point. Ensure your bundler does no try to resolve this import as the plugins are not known at build time.

Kind: global typedef
Returns: module - The module containing the entry point function.