coderail-watch 0.1.1 → 0.1.3

package/README.md

@@ -15,3 +15,15 @@ cd tools/coderail-watch
 npm login
 npm run publish:public
 ```
+
+If you are fixing a published bug, bump the version before publishing:
+
+```bash
+cd tools/coderail-watch
+npm version patch
+npm run publish:public
+```
+
+2FA note:
+
+- npm no longer allows adding new TOTP 2FA from the CLI. Enable 2FA with a security key at https://npmjs.com/settings/<your-username>/tfa before publishing.

package/bin/coderail-watch.js

@@ -2,10 +2,13 @@
 "use strict";
 
 const readline = require("readline");
-const WebSocket = require("ws");
 
 const DEFAULT_BASE_URL = "http://localhost:8000";
 const DEFAULT_RETRY_WAIT_MS = 2000;
+const ALERT_PREFIX = "[[CODERAIL_ERROR]] ";
+const ERROR_PATTERN = /(^|[\s:])(?:error|exception|traceback|panic|fatal)(?=[\s:])/i;
+
+const isErrorLine = (line) => ERROR_PATTERN.test(line);
 
 const parseArgs = (argv) => {
   const args = {};
@@ -28,6 +31,19 @@ const log = (message) => {
   process.stderr.write(`[coderail-watch] ${message}\n`);
 };
 
+let WebSocketImpl = globalThis.WebSocket;
+if (!WebSocketImpl) {
+  try {
+    WebSocketImpl = require("ws");
+  } catch (error) {
+    log(
+      "Missing dependency 'ws'. Run `cd tools/coderail-watch && npm install` or use the published package via `npx coderail-watch@latest ...`.",
+    );
+    process.exit(1);
+  }
+}
+const WebSocket = WebSocketImpl;
+
 const buildWsUrl = (baseUrl, sessionId, projectKey, token) => {
   let normalized = baseUrl.trim();
   if (!normalized.startsWith("http://") && !normalized.startsWith("https://")) {
@@ -62,27 +78,84 @@ const wsUrl = buildWsUrl(baseUrl, sessionId, projectKey, token);
 let socket = null;
 let isOpen = false;
 const queue = [];
+let retryCount = 0;
+let lastErrorMessage = "";
+
+const attachHandler = (target, event, handler) => {
+  if (typeof target.on === "function") {
+    target.on(event, handler);
+    return;
+  }
+  if (typeof target.addEventListener === "function") {
+    target.addEventListener(event, handler);
+  }
+};
+
+const isSocketOpen = () => {
+  if (!socket) return false;
+  if (typeof WebSocket.OPEN === "number") {
+    return socket.readyState === WebSocket.OPEN;
+  }
+  return isOpen;
+};
 
 const connect = () => {
-  socket = new WebSocket(wsUrl);
+  retryCount += 1;
+  log(`connecting (#${retryCount})...`);
+  try {
+    socket = new WebSocket(wsUrl);
+  } catch (error) {
+    lastErrorMessage = String(error);
+    log(`connect failed: ${lastErrorMessage}`);
+    setTimeout(connect, retryWaitMs);
+    return;
+  }
 
-  socket.on("open", () => {
+  attachHandler(socket, "open", () => {
     isOpen = true;
+    retryCount = 0;
     log(`connected: ${wsUrl}`);
     while (queue.length) {
       const payload = queue.shift();
-      socket.send(payload);
+      if (!isSocketOpen()) {
+        queue.unshift(payload);
+        break;
+      }
+      try {
+        socket.send(payload);
+      } catch (error) {
+        queue.unshift(payload);
+        break;
+      }
     }
   });
 
-  socket.on("close", () => {
+  attachHandler(socket, "close", (event) => {
     isOpen = false;
-    log("disconnected; retrying...");
+    const code =
+      event && typeof event === "object" && "code" in event ? event.code : null;
+    const reason =
+      event && typeof event === "object" && "reason" in event
+        ? event.reason
+        : "";
+    const detail = [code ? `code=${code}` : null, reason || null]
+      .filter(Boolean)
+      .join(" ");
+    log(
+      `disconnected; retrying in ${retryWaitMs}ms${
+        detail ? ` (${detail})` : ""
+      }`,
+    );
     setTimeout(connect, retryWaitMs);
   });
 
-  socket.on("error", (error) => {
-    log(`error: ${error.message}`);
+  attachHandler(socket, "error", (error) => {
+    const message =
+      error && typeof error === "object" && "message" in error
+        ? error.message
+        : String(error);
+    lastErrorMessage = message;
+    log(`error: ${message}`);
   });
 };
 
@@ -93,16 +166,33 @@ const rl = readline.createInterface({
   crlfDelay: Infinity,
 });
 
+const enqueueOrSend = (payload) => {
+  if (isSocketOpen()) {
+    try {
+      socket.send(payload);
+      return;
+    } catch (error) {
+      queue.push(payload);
+      return;
+    }
+  }
+  queue.push(payload);
+};
+
 rl.on("line", (line) => {
   const payload = JSON.stringify({
     type: "log",
     content: line,
     timestamp: new Date().toISOString(),
   });
-  if (isOpen && socket) {
-    socket.send(payload);
-  } else {
-    queue.push(payload);
+  enqueueOrSend(payload);
+  if (isErrorLine(line)) {
+    const alertPayload = JSON.stringify({
+      type: "alert",
+      content: `${ALERT_PREFIX}${line}`,
+      timestamp: new Date().toISOString(),
+    });
+    enqueueOrSend(alertPayload);
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coderail-watch",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Stream terminal output to CodeRail backend over WebSocket.",
   "bin": {
     "coderail-watch": "bin/coderail-watch.js"