@nuraly/lumenjs 0.5.0 → 0.6.0

package/dist/build/build-server.js

@@ -9,17 +9,24 @@ export async function buildServer(opts) {
     // Include all pages in server build (enables SSR for .md endpoints)
     for (const entry of pageEntries) {
         serverEntries[`pages/${entry.name}`] = entry.filePath;
-        // Co-located _loader.ts for folder index pages
+        // Co-located _loader.ts / _socket.ts for folder index pages
         if (path.basename(entry.filePath).replace(/\.(ts|js)$/, '') === 'index') {
             const dir = path.dirname(entry.filePath);
+            const entryDir = path.dirname(entry.name);
             for (const ext of ['.ts', '.js']) {
                 const loaderFile = path.join(dir, `_loader${ext}`);
                 if (fs.existsSync(loaderFile)) {
-                    const entryDir = path.dirname(entry.name);
                     serverEntries[`pages/${entryDir}/_loader`] = loaderFile;
                     break;
                 }
             }
+            for (const ext of ['.ts', '.js']) {
+                const socketFile = path.join(dir, `_socket${ext}`);
+                if (fs.existsSync(socketFile)) {
+                    serverEntries[`pages/${entryDir}/_socket`] = socketFile;
+                    break;
+                }
+            }
         }
     }
     for (const entry of layoutEntries) {

package/dist/build/scan.js

@@ -14,13 +14,16 @@ function analyzePageFile(filePath) {
                 return false;
             return true;
         };
-        const hasColocatedLoader = path.basename(filePath).replace(/\.(ts|js)$/, '') === 'index' &&
-            (fs.existsSync(path.join(path.dirname(filePath), '_loader.ts')) ||
-                fs.existsSync(path.join(path.dirname(filePath), '_loader.js')));
+        const isIndex = path.basename(filePath).replace(/\.(ts|js)$/, '') === 'index';
+        const dir = path.dirname(filePath);
+        const hasColocatedLoader = isIndex &&
+            (fs.existsSync(path.join(dir, '_loader.ts')) || fs.existsSync(path.join(dir, '_loader.js')));
+        const hasColocatedSocket = isIndex &&
+            (fs.existsSync(path.join(dir, '_socket.ts')) || fs.existsSync(path.join(dir, '_socket.js')));
         return {
             hasLoader: hasExportBefore(/export\s+(async\s+)?function\s+loader\s*\(/) || hasColocatedLoader,
             hasSubscribe: hasExportBefore(/export\s+(async\s+)?function\s+subscribe\s*\(/),
-            hasSocket: /export\s+(function|const)\s+socket[\s(=]/.test(content),
+            hasSocket: /export\s+(function|const)\s+socket[\s(=]/.test(content) || hasColocatedSocket,
             hasAuth: hasExportBefore(/export\s+const\s+auth\s*=/),
             hasMeta: hasExportBefore(/export\s+(const\s+meta\s*=|(async\s+)?function\s+meta\s*\()/),
             hasStandalone: hasExportBefore(/export\s+const\s+standalone\s*=/),

package/dist/shared/socket-io-setup.js

@@ -1,5 +1,7 @@
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
+import fs from 'fs';
+import path from 'path';
 export async function setupSocketIO(options) {
     // Resolve socket.io from the project's node_modules (not from lumenjs's own node_modules)
     let SocketIOServer;
@@ -23,7 +25,20 @@ export async function setupSocketIO(options) {
         io.of(ns).on('connection', async (socket) => {
             try {
                 const mod = await options.loadModule(route.filePath);
-                if (!mod.socket)
+                let socketFn = mod?.socket;
+                // Co-located _socket.ts fallback (folder route convention)
+                if (!socketFn && path.basename(route.filePath).replace(/\.(ts|js)$/, '') === 'index') {
+                    const dir = path.dirname(route.filePath);
+                    for (const ext of ['.ts', '.js']) {
+                        const colocated = path.join(dir, `_socket${ext}`);
+                        if (fs.existsSync(colocated)) {
+                            const socketMod = await options.loadModule(colocated);
+                            socketFn = socketMod?.socket;
+                            break;
+                        }
+                    }
+                }
+                if (!socketFn)
                     return;
                 const push = (data) => socket.emit('nk:data', data);
                 const on = (event, handler) => {
@@ -38,7 +53,7 @@ export async function setupSocketIO(options) {
                 const params = socket.handshake.query.__params
                     ? JSON.parse(socket.handshake.query.__params) : {};
                 const locale = socket.handshake.query.__locale;
-                const cleanup = mod.socket({ on, push, room, params, headers: socket.handshake.headers, locale, socket });
+                const cleanup = socketFn({ on, push, room, params, headers: socket.handshake.headers, locale, socket });
                 socket.on('disconnect', () => { if (typeof cleanup === 'function')
                     cleanup(); });
             }

package/dist/shared/utils.js

@@ -228,6 +228,13 @@ export function fileHasMeta(filePath) {
  */
 export function fileHasSocket(filePath) {
     try {
+        // Check for co-located _socket.ts (folder route convention: index.ts + _socket.ts)
+        if (path.basename(filePath).replace(/\.(ts|js)$/, '') === 'index') {
+            const dir = path.dirname(filePath);
+            if (fs.existsSync(path.join(dir, '_socket.ts')) || fs.existsSync(path.join(dir, '_socket.js'))) {
+                return true;
+            }
+        }
         const content = fs.readFileSync(filePath, 'utf-8');
         return /export\s+(function|const)\s+socket[\s(=]/.test(content);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuraly/lumenjs",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Full-stack Lit web component framework with file-based routing, server loaders, SSR, and API routes",
   "type": "module",
   "main": "dist/cli.js",