PluginEngine

PluginEngine is a TypeScript library designed for extensible application architecture. It employs a Publish-Subscribe pattern with middleware support, allowing for a decoupled, event-driven architecture.

1import { PluginEngine, Plugin } from 'plugin-engine';
2
3// Initialize PluginEngine
4const engine = new PluginEngine<{ httpRequest: { request: string } }>();
5
6// Define a logging plugin with 'enter' hook
7const logPlugin: Plugin<{ request: string }> = {
8  name: 'Log',
9  enter: (data, context) => {
10    console.log(`Request: ${data.request}`);
11    // 'context.abortWith' can be used to short-circuit the event chain
12  },
13};
14
15// Register the plugin to an 'httpRequest' event
16engine.on('httpRequest', logPlugin);
17
18// Define a modification plugin with 'enter' hook
19const modifyPlugin: Plugin<{ request: string }> = {
20  name: 'Modify',
21  enter: (data) => {
22    data.request = `Modified: ${data.request}`;
23    return data;
24  },
25};
26
27// Register the modification plugin
28engine.on('httpRequest', modifyPlugin);
29
30// Execute the 'httpRequest' event
31engine.exec('httpRequest', { request: 'GET /home' }).then((result) => {
32  console.log(`Final Request: ${result.request}`);
33});
34// Output: "Request: GET /home", "Request: Modified: GET /home", "Final Request: Modified: GET /home"

Key Concepts:

• enter and exit hooks: Plugins can have enter and exit hooks that run when an event is executed.

• abortWith: Within the context argument in the plugin, you can use abortWith to immediately stop the processing of subsequent plugins and return the current state of the event data.

• Asynchronous Execution: The exec method returns a promise, allowing for asynchronous event handling.

• Error Handling: Plugins can define an error method to handle exceptions gracefully. PluginEngine?