coderail-watch 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# coderail-watch
+
+Stream terminal output to CodeRail backend over WebSocket.
+
+Usage:
+
+```bash
+npx coderail-watch --session-id <session_id> --project-key <project_public_id> --base-url http://localhost:8000
+```
+
+Publish (npm):
+
+```bash
+cd tools/coderail-watch
+npm login
+npm run publish:public
+```

package/bin/coderail-watch.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+"use strict";
+
+const readline = require("readline");
+const WebSocket = require("ws");
+
+const DEFAULT_BASE_URL = "http://localhost:8000";
+const DEFAULT_RETRY_WAIT_MS = 2000;
+
+const parseArgs = (argv) => {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) continue;
+    const key = token.slice(2);
+    const next = argv[index + 1];
+    if (next && !next.startsWith("--")) {
+      args[key] = next;
+      index += 1;
+    } else {
+      args[key] = "true";
+    }
+  }
+  return args;
+};
+
+const log = (message) => {
+  process.stderr.write(`[coderail-watch] ${message}\n`);
+};
+
+const buildWsUrl = (baseUrl, sessionId, projectKey, token) => {
+  let normalized = baseUrl.trim();
+  if (!normalized.startsWith("http://") && !normalized.startsWith("https://")) {
+    normalized = `http://${normalized}`;
+  }
+  const url = new URL(normalized);
+  const wsProtocol = url.protocol === "https:" ? "wss:" : "ws:";
+  url.protocol = wsProtocol;
+  url.pathname = `${url.pathname.replace(/\\/$/, "")}/api/v1/terminal_watch/ws`;
+  url.searchParams.set("session_id", sessionId);
+  url.searchParams.set("project_key", projectKey);
+  url.searchParams.set("role", "producer");
+  if (token) {
+    url.searchParams.set("token", token);
+  }
+  return url.toString();
+};
+
+const args = parseArgs(process.argv.slice(2));
+const sessionId = args["session-id"];
+const projectKey = args["project-key"];
+const baseUrl = args["base-url"] || DEFAULT_BASE_URL;
+const token = args["token"];
+const retryWaitMs = Number(args["retry-wait"] || DEFAULT_RETRY_WAIT_MS);
+
+if (!sessionId || !projectKey) {
+  log("Missing required args: --session-id and --project-key");
+  process.exit(1);
+}
+
+const wsUrl = buildWsUrl(baseUrl, sessionId, projectKey, token);
+let socket = null;
+let isOpen = false;
+const queue = [];
+
+const connect = () => {
+  socket = new WebSocket(wsUrl);
+
+  socket.on("open", () => {
+    isOpen = true;
+    log(`connected: ${wsUrl}`);
+    while (queue.length) {
+      const payload = queue.shift();
+      socket.send(payload);
+    }
+  });
+
+  socket.on("close", () => {
+    isOpen = false;
+    log("disconnected; retrying...");
+    setTimeout(connect, retryWaitMs);
+  });
+
+  socket.on("error", (error) => {
+    log(`error: ${error.message}`);
+  });
+};
+
+connect();
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  crlfDelay: Infinity,
+});
+
+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);
+  }
+});
+
+rl.on("close", () => {
+  if (socket) {
+    socket.close();
+  }
+});

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "coderail-watch",
+  "version": "0.1.0",
+  "description": "Stream terminal output to CodeRail backend over WebSocket.",
+  "bin": {
+    "coderail-watch": "bin/coderail-watch.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "publish:public": "npm publish --access public"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}