feat: forward --plugin to JSS — serve a directory and mount apps (0.0.9)

README.md

@@ -28,8 +28,9 @@ Or use directly with npx:
 npx servejss
 ```
 
-servejss requires JSS >= 0.0.211, which never writes `index.html` or `.acl`
-files into the served directory. If the bundled dependency is missing,
+servejss requires JSS >= 0.0.217, which never writes `index.html` or `.acl`
+files into the served directory and supports `--plugin` app mounting.
+If the bundled dependency is missing,
 servejss falls back to a globally installed `jss` — if you have an old
 global install, update it too:
 
@@ -66,7 +67,7 @@ servejss --read-only
   Local:      http://localhost:3000
   Network:    http://192.168.1.5:3000
 
-  Mode:       GET/PUT/DELETE enabled
+  Mode:       GET/PUT/DELETE enabled (public, no auth)
 
   Press Ctrl+C to stop
 ```
@@ -111,6 +112,7 @@ Options:
   --no-port-switching      Do not open a different port if specified one is taken
   -r, --read-only          Disable PUT/DELETE methods (like npx serve)
   --solid                  Enable full Solid protocol features
+  --plugin <module[@prefix]> Mount a JSS app plugin (repeatable)
   -q, --quiet              Suppress all output
   -h, --help               Display help
 ```
@@ -186,6 +188,16 @@ servejss --read-only ~/shared-files
 servejss ./mock-data
 ```
 
+### Static Site + Live App
+```bash
+# Serve a directory AND mount a JSS app plugin beside it
+servejss --plugin './chat/plugin.js@/chat' ./public
+```
+
+The plugin value is forwarded verbatim to JSS (`module[@prefix]`, repeatable —
+see the [App Plugins docs](https://github.com/JavaScriptSolidServer/JavaScriptSolidServer/blob/gh-pages/docs/configuration.md#app-plugins-plugins)).
+Quote it: a leading `@` in scoped packages trips up some shells.
+
 ### WebDAV Alternative
 ```bash
 # Lightweight file sync server — no auth, trusted networks only

bin/jsserve.js

@@ -72,7 +72,7 @@ function getNetworkAddress() {
  * Print the startup banner
  */
 function printBanner(options) {
-  const { port, host, directory, readOnly, live, solid, networkAddress } = options;
+  const { port, host, directory, readOnly, live, solid, plugins, networkAddress } = options;
 
   const local = `http://${host === '0.0.0.0' ? 'localhost' : host}:${port}`;
   const network = networkAddress ? `http://${networkAddress}:${port}` : null;
@@ -94,6 +94,9 @@ function printBanner(options) {
   }
   console.log();
   console.log(`  ${chalk.gray('Mode:')}       ${chalk.yellow(mode)}`);
+  if (plugins && plugins.length) {
+    console.log(`  ${chalk.gray('Plugins:')}    ${chalk.magenta(plugins.join(', '))}`);
+  }
   if (live) {
     console.log(`  ${chalk.gray('Live:')}       ${chalk.green('Watching for changes')}`);
   }
@@ -138,6 +141,7 @@ program
   .option('--no-live', 'Disable live reload')
   .option('--git', 'Enable git HTTP backend (default: true)')
   .option('--no-git', 'Disable git HTTP backend')
+  .option('--plugin <module[@prefix]>', 'Mount a JSS app plugin (repeatable; requires JSS >= 0.0.217)', (value, previous) => previous.concat([value]), [])
   .option('-q, --quiet', 'Suppress all output')
   .addHelpText('after', `
 Examples:
@@ -267,6 +271,11 @@ async function run(directory, options) {
     jssArgs.push('--git');
   }
 
+  // App plugins — forwarded verbatim; JSS owns parsing and loading (#594)
+  for (const plugin of options.plugin) {
+    jssArgs.push('--plugin', plugin);
+  }
+
   // Debug mode
   if (options.debug) {
     console.log(chalk.gray('  JSS args:'), jssArgs.join(' '));
@@ -281,6 +290,7 @@ async function run(directory, options) {
       readOnly: options.readOnly,
       live: options.live !== false,
       solid: options.solid,
+      plugins: options.plugin,
       networkAddress: getNetworkAddress(),
     });
   }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "servejss",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Static file server with REST write support - npx serve alternative",
   "keywords": [
     "serve",
@@ -27,7 +27,7 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
-    "javascript-solid-server": ">=0.0.211"
+    "javascript-solid-server": ">=0.0.217"
   },
   "repository": {
     "type": "git",