twd-relay 0.1.0 → 0.2.1

package/dist/browser.cjs.js

@@ -1 +1 @@
-"use strict";var k=Object.create;var T=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var P=Object.getPrototypeOf,A=Object.prototype.hasOwnProperty;var L=(n,o,c,d)=>{if(o&&typeof o=="object"||typeof o=="function")for(let a of D(o))!A.call(n,a)&&a!==c&&T(n,a,{get:()=>o[a],enumerable:!(d=b(o,a))||d.enumerable});return n};var $=(n,o,c)=>(c=n!=null?k(P(n)):{},L(o||!n||!n.__esModule?T(c,"default",{value:n,enumerable:!0}):c,n));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function I(){return`${window.location.protocol==="https:"?"wss:":"ws:"}//${window.location.host}/__twd/ws`}function p(n,o){if(!n.parent)return"";const c=o.get(n.parent);return c?c.name:""}function M(n){const o=n?.url??I(),c=n?.reconnect??!0,d=n?.reconnectInterval??2e3,a="[twd-relay]";let t=null,m=!1,w=null;function i(r){t&&t.readyState===WebSocket.OPEN&&t.send(JSON.stringify(r))}function u(){window.dispatchEvent(new CustomEvent("twd:state-change"))}async function _(){const r=window.__TWD_STATE__;if(!r){i({type:"error",code:"NO_TWD",message:"TWD not initialized"});return}const s=r.handlers,y=Array.from(s.values()).filter(e=>e.type==="test").length;i({type:"run:start",testCount:y});let l=0,h=0,E=0;const g=performance.now(),O={onStart(e){e.status="running",u(),i({type:"test:start",id:e.id,name:e.name,suite:p(e,s)})},onPass(e){l++,e.status="pass",u(),i({type:"test:pass",id:e.id,name:e.name,suite:p(e,s),duration:performance.now()-g})},onFail(e,f){h++,e.status="fail",e.logs=[f.message],u(),i({type:"test:fail",id:e.id,name:e.name,suite:p(e,s),error:f.message,duration:performance.now()-g})},onSkip(e){E++,e.status="skip",u(),i({type:"test:skip",id:e.id,name:e.name,suite:p(e,s)})},onSuiteStart(e){e.status="running",u()},onSuiteEnd(e){e.status="idle",u()}};try{const{TestRunner:e}=await import("twd-js/runner");await new e(O).runAll()}catch(e){const f=e instanceof Error?e.message:String(e);i({type:"error",code:"RUNNER_ERROR",message:f})}const R=performance.now()-g;i({type:"run:complete",passed:l,failed:h,skipped:E,duration:R}),u()}function C(){const r=window.__TWD_STATE__;if(!r){i({type:"error",code:"NO_TWD",message:"TWD not initialized"});return}const s=r.handlers,y=[];for(const[,l]of s)l.type==="test"&&y.push({id:l.id,name:l.name,suite:p(l,s),status:l.status??"idle"});i({type:"status:result",tests:y})}function N(r){let s;try{s=JSON.parse(r.data)}catch{return}s.type==="run"?(console.info(a,"Received run command — running tests..."),_()):s.type==="status"&&C()}function v(){c&&!m&&(console.info(a,`Reconnecting in ${d}ms...`),w=setTimeout(()=>{S()},d))}function S(){t&&(t.readyState===WebSocket.OPEN||t.readyState===WebSocket.CONNECTING)||(m=!1,console.info(a,"Connecting to",o),t=new WebSocket(o),t.addEventListener("open",()=>{i({type:"hello",role:"browser"}),console.info(a,"Connected to relay — ready to receive run/status commands")}),t.addEventListener("message",N),t.addEventListener("close",r=>{t=null,m||console.info(a,"Disconnected",r.code?`(code ${r.code})`:"",r.reason||""),v()}),t.addEventListener("error",()=>{}))}function W(){m=!0,w&&(clearTimeout(w),w=null),t&&(t.close(1e3,"Client disconnecting"),t=null)}return{connect:S,disconnect:W,get connected(){return t!==null&&t.readyState===WebSocket.OPEN}}}exports.createBrowserClient=M;
+"use strict";var P=Object.create;var C=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,z=Object.prototype.hasOwnProperty;var I=(n,o,i,f)=>{if(o&&typeof o=="object"||typeof o=="function")for(let l of L(o))!z.call(n,l)&&l!==i&&C(n,l,{get:()=>o[l],enumerable:!(f=A(o,l))||f.enumerable});return n};var M=(n,o,i)=>(i=n!=null?P($(n)):{},I(o||!n||!n.__esModule?C(i,"default",{value:n,enumerable:!0}):i,n));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function j(){return`${window.location.protocol==="https:"?"wss:":"ws:"}//${window.location.host}/__twd/ws`}function p(n,o){if(!n.parent)return"";const i=o.get(n.parent);return i?i.name:""}function B(n){const o=n?.url??j(),i=n?.reconnect??!0,f=n?.reconnectInterval??2e3,l=n?.log??!1,T="[twd-relay]";function m(...t){l&&console.info(T,...t)}function S(...t){console.warn(T,...t)}let r=null,w=!1,g=null;function a(t){r&&r.readyState===WebSocket.OPEN&&r.send(JSON.stringify(t))}function u(){window.dispatchEvent(new CustomEvent("twd:state-change"))}async function N(){const t=window.__TWD_STATE__;if(!t){S("TWD not initialized — make sure twd-js is loaded before running tests"),a({type:"error",code:"NO_TWD",message:"TWD not initialized"});return}const s=t.handlers,y=Array.from(s.values()).filter(e=>e.type==="test").length;a({type:"run:start",testCount:y});let c=0,_=0,b=0;const h=performance.now(),O={onStart(e){e.status="running",u(),a({type:"test:start",id:e.id,name:e.name,suite:p(e,s)})},onPass(e){c++,e.status="pass",u(),a({type:"test:pass",id:e.id,name:e.name,suite:p(e,s),duration:performance.now()-h})},onFail(e,d){_++,e.status="fail",e.logs=[d.message],u(),a({type:"test:fail",id:e.id,name:e.name,suite:p(e,s),error:d.message,duration:performance.now()-h})},onSkip(e){b++,e.status="skip",u(),a({type:"test:skip",id:e.id,name:e.name,suite:p(e,s)})},onSuiteStart(e){e.status="running",u()},onSuiteEnd(e){e.status="idle",u()}};try{const{TestRunner:e}=await import("twd-js/runner");await new e(O).runAll()}catch(e){const d=e instanceof Error?e.message:String(e);S("Runner error:",d),a({type:"error",code:"RUNNER_ERROR",message:d})}const D=performance.now()-h;a({type:"run:complete",passed:c,failed:_,skipped:b,duration:D}),u()}function R(){const t=window.__TWD_STATE__;if(!t){a({type:"error",code:"NO_TWD",message:"TWD not initialized"});return}const s=t.handlers,y=[];for(const[,c]of s)c.type==="test"&&y.push({id:c.id,name:c.name,suite:p(c,s),status:c.status??"idle"});a({type:"status:result",tests:y})}function W(t){let s;try{s=JSON.parse(t.data)}catch{return}s.type==="run"?(m("Received run command — running tests..."),N()):s.type==="status"&&R()}function k(){i&&!w&&(m(`Reconnecting in ${f}ms...`),g=setTimeout(()=>{E()},f))}function E(){r&&(r.readyState===WebSocket.OPEN||r.readyState===WebSocket.CONNECTING)||(w=!1,m("Connecting to",o),r=new WebSocket(o),r.addEventListener("open",()=>{a({type:"hello",role:"browser"}),m("Connected to relay — ready to receive run/status commands")}),r.addEventListener("message",W),r.addEventListener("close",t=>{if(r=null,t.reason==="Replaced by new browser"){S("Another browser instance connected — this instance will not reconnect");return}w||m("Disconnected",t.code?`(code ${t.code})`:"",t.reason||""),k()}),r.addEventListener("error",()=>{}))}function v(){w=!0,g&&(clearTimeout(g),g=null),r&&(r.close(1e3,"Client disconnecting"),r=null)}return{connect:E,disconnect:v,get connected(){return r!==null&&r.readyState===WebSocket.OPEN}}}exports.createBrowserClient=B;

package/dist/browser.d.ts

@@ -11,6 +11,8 @@ export declare interface BrowserClientOptions {
     reconnect?: boolean;
     /** Milliseconds between reconnect attempts. Default: 2000 */
     reconnectInterval?: number;
+    /** Enable console logging. Default: false */
+    log?: boolean;
 }
 
 export declare function createBrowserClient(options?: BrowserClientOptions): BrowserClient;

package/dist/browser.es.js

@@ -1,29 +1,35 @@
-function k() {
+function O() {
   return `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/__twd/ws`;
 }
-function l(a, d) {
-  if (!a.parent) return "";
-  const f = d.get(a.parent);
+function l(s, d) {
+  if (!s.parent) return "";
+  const f = d.get(s.parent);
   return f ? f.name : "";
 }
-function O(a) {
-  const d = a?.url ?? k(), f = a?.reconnect ?? !0, g = a?.reconnectInterval ?? 2e3, c = "[twd-relay]";
-  let n = null, p = !1, m = null;
-  function r(t) {
-    n && n.readyState === WebSocket.OPEN && n.send(JSON.stringify(t));
+function A(s) {
+  const d = s?.url ?? O(), f = s?.reconnect ?? !0, S = s?.reconnectInterval ?? 2e3, N = s?.log ?? !1, h = "[twd-relay]";
+  function u(...n) {
+    N && console.info(h, ...n);
+  }
+  function g(...n) {
+    console.warn(h, ...n);
+  }
+  let t = null, p = !1, m = null;
+  function r(n) {
+    t && t.readyState === WebSocket.OPEN && t.send(JSON.stringify(n));
   }
   function i() {
     window.dispatchEvent(new CustomEvent("twd:state-change"));
   }
-  async function T() {
-    const t = window.__TWD_STATE__;
-    if (!t) {
-      r({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
+  async function C() {
+    const n = window.__TWD_STATE__;
+    if (!n) {
+      g("TWD not initialized — make sure twd-js is loaded before running tests"), r({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
       return;
     }
-    const o = t.handlers, w = Array.from(o.values()).filter((e) => e.type === "test").length;
+    const o = n.handlers, w = Array.from(o.values()).filter((e) => e.type === "test").length;
     r({ type: "run:start", testCount: w });
-    let s = 0, h = 0, E = 0;
+    let a = 0, T = 0, _ = 0;
     const y = performance.now(), v = {
       onStart(e) {
         e.status = "running", i(), r({
@@ -34,7 +40,7 @@ function O(a) {
         });
       },
       onPass(e) {
-        s++, e.status = "pass", i(), r({
+        a++, e.status = "pass", i(), r({
           type: "test:pass",
           id: e.id,
           name: e.name,
@@ -42,18 +48,18 @@ function O(a) {
           duration: performance.now() - y
         });
       },
-      onFail(e, u) {
-        h++, e.status = "fail", e.logs = [u.message], i(), r({
+      onFail(e, c) {
+        T++, e.status = "fail", e.logs = [c.message], i(), r({
           type: "test:fail",
           id: e.id,
           name: e.name,
           suite: l(e, o),
-          error: u.message,
+          error: c.message,
           duration: performance.now() - y
         });
       },
       onSkip(e) {
-        E++, e.status = "skip", i(), r({
+        _++, e.status = "skip", i(), r({
           type: "test:skip",
           id: e.id,
           name: e.name,
@@ -71,61 +77,65 @@ function O(a) {
       const { TestRunner: e } = await import("twd-js/runner");
       await new e(v).runAll();
     } catch (e) {
-      const u = e instanceof Error ? e.message : String(e);
-      r({ type: "error", code: "RUNNER_ERROR", message: u });
+      const c = e instanceof Error ? e.message : String(e);
+      g("Runner error:", c), r({ type: "error", code: "RUNNER_ERROR", message: c });
     }
-    const R = performance.now() - y;
-    r({ type: "run:complete", passed: s, failed: h, skipped: E, duration: R }), i();
+    const D = performance.now() - y;
+    r({ type: "run:complete", passed: a, failed: T, skipped: _, duration: D }), i();
   }
-  function _() {
-    const t = window.__TWD_STATE__;
-    if (!t) {
+  function R() {
+    const n = window.__TWD_STATE__;
+    if (!n) {
       r({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
       return;
     }
-    const o = t.handlers, w = [];
-    for (const [, s] of o)
-      s.type === "test" && w.push({
-        id: s.id,
-        name: s.name,
-        suite: l(s, o),
-        status: s.status ?? "idle"
+    const o = n.handlers, w = [];
+    for (const [, a] of o)
+      a.type === "test" && w.push({
+        id: a.id,
+        name: a.name,
+        suite: l(a, o),
+        status: a.status ?? "idle"
       });
     r({ type: "status:result", tests: w });
   }
-  function N(t) {
+  function W(n) {
     let o;
     try {
-      o = JSON.parse(t.data);
+      o = JSON.parse(n.data);
     } catch {
       return;
     }
-    o.type === "run" ? (console.info(c, "Received run command — running tests..."), T()) : o.type === "status" && _();
+    o.type === "run" ? (u("Received run command — running tests..."), C()) : o.type === "status" && R();
   }
-  function C() {
-    f && !p && (console.info(c, `Reconnecting in ${g}ms...`), m = setTimeout(() => {
-      S();
-    }, g));
+  function b() {
+    f && !p && (u(`Reconnecting in ${S}ms...`), m = setTimeout(() => {
+      E();
+    }, S));
   }
-  function S() {
-    n && (n.readyState === WebSocket.OPEN || n.readyState === WebSocket.CONNECTING) || (p = !1, console.info(c, "Connecting to", d), n = new WebSocket(d), n.addEventListener("open", () => {
-      r({ type: "hello", role: "browser" }), console.info(c, "Connected to relay — ready to receive run/status commands");
-    }), n.addEventListener("message", N), n.addEventListener("close", (t) => {
-      n = null, p || console.info(c, "Disconnected", t.code ? `(code ${t.code})` : "", t.reason || ""), C();
-    }), n.addEventListener("error", () => {
+  function E() {
+    t && (t.readyState === WebSocket.OPEN || t.readyState === WebSocket.CONNECTING) || (p = !1, u("Connecting to", d), t = new WebSocket(d), t.addEventListener("open", () => {
+      r({ type: "hello", role: "browser" }), u("Connected to relay — ready to receive run/status commands");
+    }), t.addEventListener("message", W), t.addEventListener("close", (n) => {
+      if (t = null, n.reason === "Replaced by new browser") {
+        g("Another browser instance connected — this instance will not reconnect");
+        return;
+      }
+      p || u("Disconnected", n.code ? `(code ${n.code})` : "", n.reason || ""), b();
+    }), t.addEventListener("error", () => {
     }));
   }
-  function W() {
-    p = !0, m && (clearTimeout(m), m = null), n && (n.close(1e3, "Client disconnecting"), n = null);
+  function k() {
+    p = !0, m && (clearTimeout(m), m = null), t && (t.close(1e3, "Client disconnecting"), t = null);
   }
   return {
-    connect: S,
-    disconnect: W,
+    connect: E,
+    disconnect: k,
     get connected() {
-      return n !== null && n.readyState === WebSocket.OPEN;
+      return t !== null && t.readyState === WebSocket.OPEN;
     }
   };
 }
 export {
-  O as createBrowserClient
+  A as createBrowserClient
 };

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { createServer } from "http";
-import { WebSocketServer, WebSocket } from "ws";
+import WebSocket$1, { WebSocketServer, WebSocket } from "ws";
 const DEFAULT_PATH = "/__twd/ws";
-function createTwdRelay(server2, options) {
+function createTwdRelay(server, options) {
   const path = options?.path ?? DEFAULT_PATH;
   const onError = options?.onError;
   const wss = new WebSocketServer({ noServer: true });
@@ -140,13 +140,13 @@ function createTwdRelay(server2, options) {
       });
     }
   };
-  server2.on("upgrade", upgradeHandler);
+  server.on("upgrade", upgradeHandler);
   wss.on("error", (err) => {
     if (onError) onError(err);
   });
   return {
     close() {
-      server2.removeListener("upgrade", upgradeHandler);
+      server.removeListener("upgrade", upgradeHandler);
       for (const client of clients) {
         client.close(1e3, "Relay shutting down");
       }
@@ -166,34 +166,161 @@ function createTwdRelay(server2, options) {
     }
   };
 }
+function run(options) {
+  const { port, timeout } = options;
+  const url = `ws://localhost:${port}/__twd/ws`;
+  console.log(`Connecting to ${url}...`);
+  const ws = new WebSocket$1(url);
+  let runSent = false;
+  let runComplete = false;
+  let failed = false;
+  const timer = setTimeout(() => {
+    console.error(`
+Timeout: no run:complete received within ${timeout / 1e3}s`);
+    ws.close();
+    process.exit(1);
+  }, timeout);
+  ws.on("open", () => {
+    ws.send(JSON.stringify({ type: "hello", role: "client" }));
+  });
+  ws.on("message", (data) => {
+    const msg = JSON.parse(data.toString());
+    switch (msg.type) {
+      case "connected":
+        if (msg.browser && !runSent) {
+          runSent = true;
+          console.log("Browser connected, triggering test run...\n");
+          ws.send(JSON.stringify({ type: "run", scope: "all" }));
+        } else if (!msg.browser) {
+          console.log("Waiting for browser to connect...");
+        }
+        break;
+      case "run:start":
+        console.log(`Running ${msg.testCount} test(s)...
+`);
+        break;
+      case "test:start":
+        console.log(`  RUN:  ${msg.suite} > ${msg.name}`);
+        break;
+      case "test:pass":
+        console.log(`  PASS: ${msg.suite} > ${msg.name} (${msg.duration}ms)`);
+        break;
+      case "test:fail":
+        failed = true;
+        console.log(`  FAIL: ${msg.suite} > ${msg.name} (${msg.duration}ms)`);
+        if (msg.error) {
+          console.log(`    Error: ${msg.error}`);
+        }
+        break;
+      case "test:skip":
+        console.log(`  SKIP: ${msg.suite} > ${msg.name}`);
+        break;
+      case "run:complete": {
+        const duration = (msg.duration / 1e3).toFixed(1);
+        console.log(`
+--- Run complete ---`);
+        console.log(`Passed: ${msg.passed} | Failed: ${msg.failed} | Skipped: ${msg.skipped}`);
+        console.log(`Duration: ${duration}s`);
+        runComplete = true;
+        clearTimeout(timer);
+        ws.close();
+        process.exit(failed || msg.failed > 0 ? 1 : 0);
+        break;
+      }
+      case "error":
+        console.error(`Error [${msg.code}]: ${msg.message}`);
+        break;
+    }
+  });
+  ws.on("close", () => {
+    clearTimeout(timer);
+    if (!runComplete) {
+      console.error("Connection closed before run completed");
+      process.exit(1);
+    }
+  });
+  ws.on("error", (err) => {
+    clearTimeout(timer);
+    console.error(`Connection error: ${err.message}`);
+    process.exit(1);
+  });
+}
 const args = process.argv.slice(2);
-let port = 9876;
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === "--port" && args[i + 1]) {
-    port = parseInt(args[i + 1], 10);
+const subcommand = args.find((a) => !a.startsWith("--"));
+function parseFlag(name) {
+  const idx = args.indexOf(name);
+  if (idx !== -1 && args[idx + 1]) return args[idx + 1];
+  return void 0;
+}
+function printHelp() {
+  console.log(`Usage: twd-relay [command] [options]
+
+Commands:
+  (none), serve   Start the standalone relay server (default)
+  run             Connect to a relay and trigger a test run
+
+Options for serve:
+  --port <port>   Port to listen on (default: 9876)
+
+Options for run:
+  --port <port>      Relay port to connect to (default: 5173)
+  --timeout <ms>     Timeout in ms (default: 180000)
+
+Examples:
+  twd-relay                     # start relay on port 9876
+  twd-relay run                 # trigger run via Vite dev server on 5173
+  twd-relay run --port 9876     # trigger run on custom port
+  twd-relay run --timeout 30000 # custom timeout`);
+}
+if (args.includes("--help") || args.includes("-h")) {
+  printHelp();
+  process.exit(0);
+}
+if (subcommand === "run") {
+  const portStr = parseFlag("--port");
+  const timeoutStr = parseFlag("--timeout");
+  const port = portStr ? parseInt(portStr, 10) : 5173;
+  if (isNaN(port)) {
+    console.error("Invalid port number:", portStr);
+    process.exit(1);
+  }
+  const timeout = timeoutStr ? parseInt(timeoutStr, 10) : 18e4;
+  if (isNaN(timeout)) {
+    console.error("Invalid timeout value:", timeoutStr);
+    process.exit(1);
+  }
+  run({ port, timeout });
+} else if (!subcommand || subcommand === "serve") {
+  let shutdown = function() {
+    console.log("\nShutting down...");
+    relay.close();
+    server.close(() => {
+      process.exit(0);
+    });
+  };
+  const portStr = parseFlag("--port");
+  let port = 9876;
+  if (portStr) {
+    port = parseInt(portStr, 10);
     if (isNaN(port)) {
-      console.error("Invalid port number:", args[i + 1]);
+      console.error("Invalid port number:", portStr);
       process.exit(1);
     }
-    i++;
-  }
-}
-const server = createServer();
-const relay = createTwdRelay(server, {
-  onError(err) {
-    console.error("[twd-relay] Error:", err.message);
   }
-});
-server.listen(port, () => {
-  console.log(`TWD Relay running on ws://localhost:${port}/__twd/ws`);
-  console.log("Waiting for connections...");
-});
-function shutdown() {
-  console.log("\nShutting down...");
-  relay.close();
-  server.close(() => {
-    process.exit(0);
+  const server = createServer();
+  const relay = createTwdRelay(server, {
+    onError(err) {
+      console.error("[twd-relay] Error:", err.message);
+    }
+  });
+  server.listen(port, () => {
+    console.log(`TWD Relay running on ws://localhost:${port}/__twd/ws`);
+    console.log("Waiting for connections...");
   });
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+} else {
+  console.error(`Unknown command: ${subcommand}`);
+  printHelp();
+  process.exit(1);
 }
-process.on("SIGINT", shutdown);
-process.on("SIGTERM", shutdown);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-relay",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "WebSocket relay for TWD — enables AI agents and external tools to run and observe in-browser tests",
   "license": "MIT",
   "author": "BRIKEV",
@@ -44,7 +44,7 @@
     "build": "vite build && vite build -c vite.cli.config.ts && node -e \"const fs=require('fs');const f='dist/cli.js';fs.writeFileSync(f,'#!/usr/bin/env node\\n'+fs.readFileSync(f,'utf8'))\" && chmod +x dist/cli.js",
     "dev": "node dist/cli.js",
     "relay": "npm run build && node dist/cli.js",
-    "send-run": "node scripts/send-run.js",
+    "send-run": "node dist/cli.js run",
     "test": "vitest",
     "test:ci": "vitest --run --coverage"
   },