fix: refuse to start when --auth is passed instead of silently ignoring it

--auth <user:pass> was defined and documented but options.auth was
never read, and JSS has no basic-auth verification to forward to —
so 'servejss --auth user:pass ~/sync' served PUT/DELETE-enabled files
on 0.0.0.0 with no authentication while the user believed otherwise.

- error out with guidance (--read-only / --solid) when --auth is given
- say 'public, no auth' / 'Solid auth' in the banner Mode line, since
  jsserve's output filter swallows JSS's own PUBLIC MODE warning
- README: drop the --auth options row, replace the WebDAV example with
  honest unauthenticated + --solid variants
- drop stale '(requires #107)' comment; --public landed upstream

Author: melvincarvalho

README.md

@@ -101,7 +101,6 @@ Options:
   --ssl-key <path>         Path to SSL private key
   --no-port-switching      Do not open a different port if specified one is taken
   -r, --read-only          Disable PUT/DELETE methods (like npx serve)
-  --auth <credentials>     Enable basic auth (user:pass)
   --solid                  Enable full Solid protocol features
   -q, --quiet              Suppress all output
   -h, --help               Display help
@@ -180,10 +179,16 @@ servejss ./mock-data
 
 ### WebDAV Alternative
 ```bash
-# Lightweight file sync server
-servejss --auth user:pass ~/sync
+# Lightweight file sync server — no auth, trusted networks only
+servejss ~/sync
+
+# Authenticated sync (Solid-OIDC + Web Access Control)
+servejss --solid ~/sync
 ```
 
+> **Note:** basic auth (`--auth user:pass`) is not implemented yet; passing
+> `--auth` refuses to start rather than silently serving unauthenticated.
+
 ## License
 
 MIT

bin/jsserve.js

@@ -72,12 +72,16 @@ function getNetworkAddress() {
  * Print the startup banner
  */
 function printBanner(options) {
-  const { port, host, directory, readOnly, live, networkAddress } = options;
+  const { port, host, directory, readOnly, live, solid, networkAddress } = options;
 
   const local = `http://${host === '0.0.0.0' ? 'localhost' : host}:${port}`;
   const network = networkAddress ? `http://${networkAddress}:${port}` : null;
 
-  const mode = readOnly ? 'GET only (read-only)' : 'GET/PUT/DELETE enabled';
+  const mode = readOnly
+    ? 'GET only (read-only)'
+    : solid
+      ? 'GET/PUT/DELETE enabled (Solid auth)'
+      : 'GET/PUT/DELETE enabled (public, no auth)';
 
   console.log();
   console.log(chalk.bgCyan.black(' servejss '));
@@ -128,7 +132,7 @@ program
   // servejss-specific options
   .option('-r, --read-only', 'Disable PUT/DELETE methods (like npx serve)')
   .option('--write', 'Enable PUT/DELETE methods (default)')
-  .option('--auth <credentials>', 'Enable basic auth (user:pass)')
+  .option('--auth <credentials>', 'Basic auth (user:pass) — not implemented yet, refuses to start')
   .option('--solid', 'Enable full Solid protocol features')
   .option('--live', 'Enable live reload (default: true)')
   .option('--no-live', 'Disable live reload')
@@ -169,6 +173,15 @@ program.parse();
  * Main run function
  */
 async function run(directory, options) {
+  // Neither jsserve nor JSS verifies user:pass credentials yet, so honoring
+  // --auth would silently serve writable files with no auth at all
+  if (options.auth) {
+    throw new Error(
+      '--auth is not implemented yet — refusing to serve without authentication.\n' +
+      '  Use --read-only to disable writes, or --solid for Solid-OIDC/WAC authentication.'
+    );
+  }
+
   // Resolve directory
   const dir = resolve(directory || '.');
 
@@ -214,7 +227,7 @@ async function run(directory, options) {
     '--root', dir,
     '--port', String(port),
     '--host', options.host,
-    '--public',  // Enable open access (requires #107)
+    '--public',  // Open access — skip WAC, unauthenticated read/write
   ];
 
   // Read-only mode
@@ -267,6 +280,7 @@ async function run(directory, options) {
       directory: dir,
       readOnly: options.readOnly,
       live: options.live !== false,
+      solid: options.solid,
       networkAddress: getNetworkAddress(),
     });
   }