javascript-solid-server 0.0.84 → 0.0.85

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "javascript-solid-server",
-  "version": "0.0.84",
+  "version": "0.0.85",
   "description": "A minimal, fast Solid server",
   "main": "src/index.js",
   "type": "module",

package/src/notifications/events.js

@@ -6,6 +6,8 @@
  */
 
 import { EventEmitter } from 'events';
+import { watch } from 'fs';
+import { join, relative } from 'path';
 
 // Singleton event emitter for resource changes
 export const resourceEvents = new EventEmitter();
@@ -20,3 +22,56 @@ resourceEvents.setMaxListeners(1000);
 export function emitChange(resourceUrl) {
   resourceEvents.emit('change', resourceUrl);
 }
+
+/**
+ * Start watching filesystem for changes and emit notifications
+ * @param {string} rootDir - Directory to watch
+ * @param {string} baseUrl - Base URL for constructing resource URLs (e.g., http://localhost:3000)
+ */
+export function startFileWatcher(rootDir, baseUrl) {
+  // Debounce map to avoid duplicate events (editors often save multiple times)
+  const debounceMap = new Map();
+  const DEBOUNCE_MS = 100;
+
+  try {
+    const watcher = watch(rootDir, { recursive: true }, (eventType, filename) => {
+      if (!filename) return;
+
+      // Skip hidden files and common temp files
+      if (filename.startsWith('.') || filename.endsWith('~') || filename.endsWith('.swp')) {
+        return;
+      }
+
+      // Debounce: skip if we just emitted for this file
+      const now = Date.now();
+      const lastEmit = debounceMap.get(filename);
+      if (lastEmit && now - lastEmit < DEBOUNCE_MS) {
+        return;
+      }
+      debounceMap.set(filename, now);
+
+      // Clean up old debounce entries periodically
+      if (debounceMap.size > 1000) {
+        for (const [key, time] of debounceMap) {
+          if (now - time > 5000) debounceMap.delete(key);
+        }
+      }
+
+      // Construct resource URL
+      const resourcePath = '/' + filename.replace(/\\/g, '/');
+      const resourceUrl = baseUrl.replace(/\/$/, '') + resourcePath;
+
+      emitChange(resourceUrl);
+    });
+
+    // Handle watcher errors gracefully
+    watcher.on('error', (err) => {
+      console.error('File watcher error:', err.message);
+    });
+
+    return watcher;
+  } catch (err) {
+    console.error('Failed to start file watcher:', err.message);
+    return null;
+  }
+}

package/src/server.js

@@ -9,6 +9,7 @@ import * as storage from './storage/filesystem.js';
 import { getCorsHeaders } from './ldp/headers.js';
 import { authorize, handleUnauthorized } from './auth/middleware.js';
 import { notificationsPlugin } from './notifications/index.js';
+import { startFileWatcher } from './notifications/events.js';
 import { idpPlugin } from './idp/index.js';
 import { isGitRequest, isGitWriteOperation, handleGit } from './handlers/git.js';
 import { AccessMode } from './wac/parser.js';
@@ -542,6 +543,16 @@ export function createServer(options = {}) {
     // Note: Quota not initialized for root-level pods (no user directory)
   }
 
+  // Start file watcher for live reload (watches filesystem for external changes)
+  if (liveReloadEnabled) {
+    const dataRoot = options.root || process.env.DATA_ROOT || './data';
+    const protocol = options.ssl ? 'https' : 'http';
+    // Use configured port, or default; actual URL will be localhost
+    const port = options.port || 3000;
+    const baseUrl = `${protocol}://localhost:${port}`;
+    startFileWatcher(dataRoot, baseUrl);
+  }
+
   return fastify;
 }