Add Electron test harness with example plugin

This commit is contained in:
2026-04-18 20:20:47 +10:00
parent 905fdc25b8
commit 93dbef6a59
6 changed files with 1627 additions and 0 deletions

237
test/electron/renderer.js Normal file
View File

@@ -0,0 +1,237 @@
/**
* Renderer process entry point for the plugin-manager Electron test harness.
*
* Uses a dynamic import() to load the ESM @paarrot/plugin-manager dist,
* then loads the example plugin from disk and demonstrates every API surface.
*/
(async () => {
const { pathToFileURL } = require('url');
const path = require('path');
const fs = require('fs');
// Resolve the plugin-manager dist entry using a file:// URL so Electron can
// import an ESM module located inside node_modules.
const pmEntry = path.join(
__dirname, 'node_modules', '@paarrot', 'plugin-manager', 'dist', 'index.js'
);
const { PluginRegistry, createPluginContext } = await import(pathToFileURL(pmEntry).href);
// ---------------------------------------------------------------------------
// Logging helper — writes to the on-screen log panel
// ---------------------------------------------------------------------------
const logEl = document.getElementById('log');
/** @param {'log'|'info'|'success'|'error'|'warn'} type */
function addLog(message, type = 'log') {
const entry = document.createElement('div');
entry.className = `log-entry log-${type}`;
entry.textContent = `[${new Date().toLocaleTimeString()}] ${message}`;
logEl.appendChild(entry);
logEl.scrollTop = logEl.scrollHeight;
}
// ---------------------------------------------------------------------------
// Registry
// ---------------------------------------------------------------------------
const registry = new PluginRegistry({
storage: localStorage,
onThemeRegistered: (themeId, _className, css) => {
const el = document.createElement('style');
el.id = `plugin-theme-${themeId}`;
el.textContent = css;
document.head.appendChild(el);
addLog(`Theme registered: ${themeId}`, 'info');
},
onThemeUnregistered: (themeId) => {
document.getElementById(`plugin-theme-${themeId}`)?.remove();
addLog(`Theme unregistered: ${themeId}`, 'info');
},
});
// ---------------------------------------------------------------------------
// Load the example plugin from disk (CJS eval — same pattern as cinny)
// ---------------------------------------------------------------------------
const pluginPath = path.join(__dirname, 'plugins', 'example-plugin', 'index.js');
const pluginCode = fs.readFileSync(pluginPath, 'utf-8');
const pluginExports = {};
const mod = { exports: pluginExports };
// eslint-disable-next-line no-new-func
new Function('module', 'exports', pluginCode)(mod, pluginExports);
const plugin = mod.exports;
// ---------------------------------------------------------------------------
// Simple in-process event emitter (stands in for a real client like Matrix)
// ---------------------------------------------------------------------------
const eventEmitter = {
_handlers: {},
on(event, handler) {
(this._handlers[event] ??= []).push(handler);
},
off(event, handler) {
this._handlers[event] = (this._handlers[event] ?? []).filter(h => h !== handler);
},
emit(event, data) {
(this._handlers[event] ?? []).forEach(h => h(data));
},
};
// ---------------------------------------------------------------------------
// Plugin context
// ---------------------------------------------------------------------------
const context = createPluginContext(
{
pluginId: 'example-plugin',
eventClient: eventEmitter,
onNotify: (opts) =>
addLog(`[${opts.type?.toUpperCase() ?? 'NOTIFY'}] ${opts.title}: ${opts.body}`, 'info'),
},
registry
);
// Intercept context logging so it appears in the UI panel
context.log = (...args) => {
console.log('[Plugin example-plugin]', ...args);
registry.addLog('example-plugin', 'log', args);
addLog(args.map(String).join(' '), 'log');
};
// ---------------------------------------------------------------------------
// Register + load
// ---------------------------------------------------------------------------
registry.registerPlugin('example-plugin', plugin, context);
await plugin.onLoad(context);
document.getElementById('status-badge').textContent = 'example-plugin loaded';
document.getElementById('status-badge').classList.add('loaded');
addLog('example-plugin loaded successfully', 'success');
// Populate registered command list
const cmdListEl = document.getElementById('cmd-list');
cmdListEl.innerHTML = registry
.getCommands()
.map(c => `<li><code>/${c.name}</code> — ${c.command.description ?? ''}</li>`)
.join('');
// Render settings form
renderSettings();
// ---------------------------------------------------------------------------
// UI — Commands
// ---------------------------------------------------------------------------
const cmdInput = document.getElementById('cmd-input');
const cmdResult = document.getElementById('cmd-result');
document.getElementById('cmd-run').addEventListener('click', async () => {
const raw = cmdInput.value.trim();
if (!raw.startsWith('/')) {
addLog('Commands must start with /', 'error');
return;
}
const [name, ...rest] = raw.slice(1).split(' ');
try {
const result = await registry.executeCommand(name, rest.join(' '));
cmdResult.textContent = result ?? '(no output)';
addLog(`/${name}: ${result ?? '(no output)'}`, 'success');
} catch (err) {
cmdResult.textContent = err.message;
addLog(err.message, 'error');
}
cmdInput.value = '';
});
cmdInput.addEventListener('keydown', (e) => {
if (e.key === 'Enter') document.getElementById('cmd-run').click();
});
// ---------------------------------------------------------------------------
// UI — Message Interceptor
// ---------------------------------------------------------------------------
document.getElementById('msg-send').addEventListener('click', async () => {
const content = document.getElementById('msg-input').value;
const msg = { content, roomId: 'test-room', eventType: 'm.room.message' };
const processed = await registry.processBeforeSend(msg);
document.getElementById('msg-result').textContent =
`Original: "${content}"\nProcessed: "${processed.content}"`;
addLog(`Intercepted: "${content}" → "${processed.content}"`, 'log');
});
// ---------------------------------------------------------------------------
// UI — Theme
// ---------------------------------------------------------------------------
document.getElementById('theme-apply').addEventListener('click', () => {
const themes = registry.getPluginThemes();
if (!themes.length) { addLog('No plugin themes registered', 'error'); return; }
const theme = themes[0];
document.body.className = theme.className;
addLog(`Applied theme: ${theme.name}`, 'success');
});
document.getElementById('theme-reset').addEventListener('click', () => {
document.body.className = '';
addLog('Theme reset', 'log');
});
// ---------------------------------------------------------------------------
// UI — Custom Events
// ---------------------------------------------------------------------------
document.getElementById('event-fire').addEventListener('click', () => {
const payload = { from: 'UI button', timestamp: Date.now() };
eventEmitter.emit('test-event', payload);
addLog(`Fired test-event with payload: ${JSON.stringify(payload)}`, 'log');
});
// ---------------------------------------------------------------------------
// Settings renderer
// ---------------------------------------------------------------------------
function renderSettings() {
const schema = registry.getPluginSettingsSchema('example-plugin');
if (!schema) return;
const container = document.getElementById('settings-container');
container.innerHTML = '';
for (const [key, def] of Object.entries(schema)) {
const value = registry.getPluginSetting('example-plugin', key);
const row = document.createElement('div');
row.className = 'setting-row';
const label = document.createElement('label');
label.textContent = def.label ?? key;
row.appendChild(label);
let input;
if (def.type === 'boolean') {
input = document.createElement('input');
input.type = 'checkbox';
input.checked = !!value;
input.addEventListener('change', () => {
registry.setPluginSetting('example-plugin', key, input.checked);
addLog(`Setting "${key}" = ${input.checked}`, 'log');
});
} else if (def.type === 'select') {
input = document.createElement('select');
(def.options ?? []).forEach((opt) => {
const o = document.createElement('option');
o.value = opt.value;
o.textContent = opt.label;
if (opt.value === value) o.selected = true;
input.appendChild(o);
});
input.addEventListener('change', () => {
registry.setPluginSetting('example-plugin', key, input.value);
addLog(`Setting "${key}" = ${input.value}`, 'log');
});
} else {
input = document.createElement('input');
input.type = 'text';
input.value = value ?? '';
input.addEventListener('change', () => {
registry.setPluginSetting('example-plugin', key, input.value);
addLog(`Setting "${key}" = "${input.value}"`, 'log');
});
}
row.appendChild(input);
container.appendChild(row);
}
}
})();