Plugins: Add auto-update functionality (#3487) * Plugins: Add auto-update functionality * Check if directory is a git repo * Display message if any plugins were loaded
Signed| @@ -210,3 +210,5 @@ claude: | ||
| 210 | 210 | cachingAtDepth: -1 |
| 211 | 211 | # -- SERVER PLUGIN CONFIGURATION -- |
| 212 | 212 | enableServerPlugins: false |
| 213 | +# Attempt to automatically update server plugins on startup | |
| 214 | +enableServerPluginsAutoUpdate: true | |
| @@ -48,6 +48,13 @@ async function updatePlugins() { | ||
| 48 | 48 | console.log(`Updating plugin ${color.green(directory)}...`); |
| 49 | 49 | const pluginPath = path.join(pluginsPath, directory); |
| 50 | 50 | const pluginRepo = git(pluginPath); |
| 51 | + | |
| 52 | + const isRepo = await pluginRepo.checkIsRepo(); | |
| 53 | + if (!isRepo) { | |
| 54 | + console.log(`Directory ${color.yellow(directory)} is not a Git repository`); | |
| 55 | + continue; | |
| 56 | + } | |
| 57 | + | |
| 51 | 58 | await pluginRepo.fetch(); |
| 52 | 59 | const commitHash = await pluginRepo.revparse(['HEAD']); |
| 53 | 60 | const trackingBranch = await pluginRepo.revparse(['--abbrev-ref', '@{u}']); |
| @@ -3,8 +3,12 @@ import path from 'node:path'; | ||
| 3 | 3 | import url from 'node:url'; |
| 4 | 4 | |
| 5 | 5 | import express from 'express'; |
| 6 | 6 | import { getConfigValuedefault as git } from './util.jssimple-git'; |
| 7 | -const enableServerPlugins = getConfigValue('enableServerPlugins', false); | |
| 7 | +import { sync as commandExistsSync } from 'command-exists'; | |
| 8 | +import { getConfigValue, color } from './util.js'; | |
| 9 | + | |
| 10 | +const enableServerPlugins = !!getConfigValue('enableServerPlugins', false); | |
| 11 | +const enableServerPluginsAutoUpdate = !!getConfigValue('enableServerPluginsAutoUpdate', true); | |
| 8 | 12 | |
| 9 | 13 | /** |
| 10 | 14 | * Map of loaded plugins. |
| @@ -54,6 +58,8 @@ export async function loadPlugins(app, pluginsPath) { | ||
| 54 | 58 | return emptyFn; |
| 55 | 59 | } |
| 56 | 60 | |
| 61 | + await updatePlugins(pluginsPath); | |
| 62 | + | |
| 57 | 63 | for (const file of files) { |
| 58 | 64 | const pluginFilePath = path.join(pluginsPath, file); |
| 59 | 65 | |
| @@ -70,6 +76,10 @@ export async function loadPlugins(app, pluginsPath) { | ||
| 70 | 76 | await loadFromFile(app, pluginFilePath, exitHooks); |
| 71 | 77 | } |
| 72 | 78 | |
| 79 | + if (loadedPlugins.size > 0) { | |
| 80 | + console.log(`${loadedPlugins.size} server plugin(s) are currently loaded. Make sure you know exactly what they do, and only install plugins from trusted sources!`); | |
| 81 | + } | |
| 82 | + | |
| 73 | 83 | // Call all plugin "exit" functions at once and wait for them to finish |
| 74 | 84 | return () => Promise.all(exitHooks.map(exitFn => exitFn())); |
| 75 | 85 | } |
| @@ -214,3 +224,65 @@ async function initPlugin(app, plugin, exitHooks) { | ||
| 214 | 224 | |
| 215 | 225 | return true; |
| 216 | 226 | } |
| 227 | + | |
| 228 | +/** | |
| 229 | + * Automatically update all git plugins in the ./plugins directory | |
| 230 | + * @param {string} pluginsPath Path to plugins directory | |
| 231 | + */ | |
| 232 | +async function updatePlugins(pluginsPath) { | |
| 233 | + if (!enableServerPluginsAutoUpdate) { | |
| 234 | + return; | |
| 235 | + } | |
| 236 | + | |
| 237 | + const directories = fs.readdirSync(pluginsPath) | |
| 238 | + .filter(file => !file.startsWith('.')) | |
| 239 | + .filter(file => fs.statSync(path.join(pluginsPath, file)).isDirectory()); | |
| 240 | + | |
| 241 | + if (directories.length === 0) { | |
| 242 | + return; | |
| 243 | + } | |
| 244 | + | |
| 245 | + console.log(color.blue('Auto-updating server plugins... Set'), color.yellow('enableServerPluginsAutoUpdate: false'), color.blue('in config.yaml to disable this feature.')); | |
| 246 | + | |
| 247 | + if (!commandExistsSync('git')) { | |
| 248 | + console.error(color.red('Git is not installed. Please install Git to enable auto-updating of server plugins.')); | |
| 249 | + return; | |
| 250 | + } | |
| 251 | + | |
| 252 | + let pluginsToUpdate = 0; | |
| 253 | + | |
| 254 | + for (const directory of directories) { | |
| 255 | + try { | |
| 256 | + const pluginPath = path.join(pluginsPath, directory); | |
| 257 | + const pluginRepo = git(pluginPath); | |
| 258 | + | |
| 259 | + const isRepo = await pluginRepo.checkIsRepo(); | |
| 260 | + if (!isRepo) { | |
| 261 | + continue; | |
| 262 | + } | |
| 263 | + | |
| 264 | + await pluginRepo.fetch(); | |
| 265 | + const commitHash = await pluginRepo.revparse(['HEAD']); | |
| 266 | + const trackingBranch = await pluginRepo.revparse(['--abbrev-ref', '@{u}']); | |
| 267 | + const log = await pluginRepo.log({ | |
| 268 | + from: commitHash, | |
| 269 | + to: trackingBranch, | |
| 270 | + }); | |
| 271 | + | |
| 272 | + if (log.total === 0) { | |
| 273 | + continue; | |
| 274 | + } | |
| 275 | + | |
| 276 | + pluginsToUpdate++; | |
| 277 | + await pluginRepo.pull(); | |
| 278 | + const latestCommit = await pluginRepo.revparse(['HEAD']); | |
| 279 | + console.log(`Plugin ${color.green(directory)} updated to commit ${color.cyan(latestCommit)}`); | |
| 280 | + } catch (error) { | |
| 281 | + console.error(color.red(`Failed to update plugin ${directory}: ${error.message}`)); | |
| 282 | + } | |
| 283 | + } | |
| 284 | + | |
| 285 | + if (pluginsToUpdate === 0) { | |
| 286 | + console.log('All plugins are up to date.'); | |
| 287 | + } | |
| 288 | +} | |