svelte-realtime 0.1.8 → 0.1.9

package/README.md

@@ -75,6 +75,8 @@ export function upgrade({ cookies }) {
 
 `message` is a ready-made hook that routes incoming WebSocket messages to your live functions. `upgrade` decides who can connect and attaches user data to the connection.
 
+> **This file is required.** The Vite plugin will warn at startup if it finds live modules in `src/live/` but no `src/hooks.ws.js` (or `.ts`). Without it, WebSocket messages have nothing on the server side to route them, and all RPC calls will silently time out.
+
 ### Step 5: Write a server function
 
 Create the `src/live/` directory. Every `.js` file in this directory becomes a module of callable server functions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-realtime",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Realtime RPC and reactive subscriptions for SvelteKit, built on svelte-adapter-uws",
   "author": "Kevin Radziszewski",
   "license": "MIT",

package/vite.js

@@ -76,8 +76,11 @@ export default function svelteRealtime(options) {
 				console.warn(
 					`[svelte-realtime] Plugin loaded but no live modules found in ${dir}/`
 				);
-			} else if (typedImports) {
-				_writeTypeDeclarations(liveDir, dir);
+			} else {
+				if (typedImports) {
+					_writeTypeDeclarations(liveDir, dir);
+				}
+				_checkHooksFile(root, liveDir, dir);
 			}
 		},
 
@@ -940,6 +943,49 @@ function _findLiveFiles(dir) {
 	return results;
 }
 
+/**
+ * Check that src/hooks.ws.{js,ts} exists and exports the `message` handler.
+ * Warns at build/dev startup if the file is missing or misconfigured.
+ * @param {string} root
+ * @param {string} liveDir
+ * @param {string} dir
+ */
+function _checkHooksFile(root, liveDir, dir) {
+	const files = _findLiveFiles(liveDir);
+	if (files.length === 0) return;
+
+	const hooksPath = resolve(root, 'src/hooks.ws');
+	const hooksJs = hooksPath + '.js';
+	const hooksTs = hooksPath + '.ts';
+	const found = existsSync(hooksJs) ? hooksJs : existsSync(hooksTs) ? hooksTs : null;
+
+	if (!found) {
+		console.warn(
+			`[svelte-realtime] Found live modules in ${dir}/ but no src/hooks.ws.js -- ` +
+			`WebSocket RPC will not work without it.\n` +
+			`  Create src/hooks.ws.js with at minimum:\n` +
+			`    export { message } from 'svelte-realtime/server';\n` +
+			`    export function upgrade() { return {}; }`
+		);
+		return;
+	}
+
+	let source;
+	try { source = readFileSync(found, 'utf-8'); } catch { return; }
+
+	const hasMessage = /export\s*\{[^}]*\bmessage\b[^}]*\}\s*from\s+['"]svelte-realtime\/server['"]/.test(source)
+		|| /export\s+(?:const|function|async\s+function)\s+message\b/.test(source);
+
+	if (!hasMessage) {
+		const name = found.endsWith('.ts') ? 'src/hooks.ws.ts' : 'src/hooks.ws.js';
+		console.warn(
+			`[svelte-realtime] ${name} exists but does not export a \`message\` handler -- ` +
+			`WebSocket RPC calls from ${dir}/ will go unhandled.\n` +
+			`  Add: export { message } from 'svelte-realtime/server';`
+		);
+	}
+}
+
 /**
  * Generate and write type declarations for all $live/ modules.
  * Creates `$types.d.ts` in the live directory with ambient module declarations.