twd-relay 0.2.1 → 0.3.0

package/dist/browser.cjs.js

@@ -1 +1 @@
-"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;
+"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(n){return`${window.location.protocol==="https:"?"wss:":"ws:"}//${window.location.host}${n}`}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(n?.path??"/__twd/ws"),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

@@ -7,6 +7,8 @@ export declare interface BrowserClient {
 export declare interface BrowserClientOptions {
     /** WebSocket URL. Default: auto-detected from window.location */
     url?: string;
+    /** WebSocket path. Default: '/__twd/ws'. Ignored when `url` is set. */
+    path?: string;
     /** Auto-reconnect on disconnect. Default: true */
     reconnect?: boolean;
     /** Milliseconds between reconnect attempts. Default: 2000 */

package/dist/browser.es.js

@@ -1,21 +1,21 @@
-function O() {
-  return `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}/__twd/ws`;
+function O(s) {
+  return `${window.location.protocol === "https:" ? "wss:" : "ws:"}//${window.location.host}${s}`;
 }
-function l(s, d) {
+function d(s, u) {
   if (!s.parent) return "";
-  const f = d.get(s.parent);
+  const f = u.get(s.parent);
   return f ? f.name : "";
 }
 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) {
+  const u = s?.url ?? O(s?.path ?? "/__twd/ws"), f = s?.reconnect ?? !0, S = s?.reconnectInterval ?? 2e3, N = s?.log ?? !1, h = "[twd-relay]";
+  function l(...n) {
     N && console.info(h, ...n);
   }
   function g(...n) {
     console.warn(h, ...n);
   }
   let t = null, p = !1, m = null;
-  function r(n) {
+  function o(n) {
     t && t.readyState === WebSocket.OPEN && t.send(JSON.stringify(n));
   }
   function i() {
@@ -24,46 +24,46 @@ function A(s) {
   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" });
+      g("TWD not initialized — make sure twd-js is loaded before running tests"), o({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
       return;
     }
-    const o = n.handlers, w = Array.from(o.values()).filter((e) => e.type === "test").length;
-    r({ type: "run:start", testCount: w });
+    const r = n.handlers, w = Array.from(r.values()).filter((e) => e.type === "test").length;
+    o({ type: "run:start", testCount: w });
     let a = 0, T = 0, _ = 0;
     const y = performance.now(), v = {
       onStart(e) {
-        e.status = "running", i(), r({
+        e.status = "running", i(), o({
           type: "test:start",
           id: e.id,
           name: e.name,
-          suite: l(e, o)
+          suite: d(e, r)
         });
       },
       onPass(e) {
-        a++, e.status = "pass", i(), r({
+        a++, e.status = "pass", i(), o({
           type: "test:pass",
           id: e.id,
           name: e.name,
-          suite: l(e, o),
+          suite: d(e, r),
           duration: performance.now() - y
         });
       },
       onFail(e, c) {
-        T++, e.status = "fail", e.logs = [c.message], i(), r({
+        T++, e.status = "fail", e.logs = [c.message], i(), o({
           type: "test:fail",
           id: e.id,
           name: e.name,
-          suite: l(e, o),
+          suite: d(e, r),
           error: c.message,
           duration: performance.now() - y
         });
       },
       onSkip(e) {
-        _++, e.status = "skip", i(), r({
+        _++, e.status = "skip", i(), o({
           type: "test:skip",
           id: e.id,
           name: e.name,
-          suite: l(e, o)
+          suite: d(e, r)
         });
       },
       onSuiteStart(e) {
@@ -78,50 +78,50 @@ function A(s) {
       await new e(v).runAll();
     } catch (e) {
       const c = e instanceof Error ? e.message : String(e);
-      g("Runner error:", c), r({ type: "error", code: "RUNNER_ERROR", message: c });
+      g("Runner error:", c), o({ type: "error", code: "RUNNER_ERROR", message: c });
     }
     const D = performance.now() - y;
-    r({ type: "run:complete", passed: a, failed: T, skipped: _, duration: D }), i();
+    o({ type: "run:complete", passed: a, failed: T, skipped: _, duration: D }), i();
   }
   function R() {
     const n = window.__TWD_STATE__;
     if (!n) {
-      r({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
+      o({ type: "error", code: "NO_TWD", message: "TWD not initialized" });
       return;
     }
-    const o = n.handlers, w = [];
-    for (const [, a] of o)
+    const r = n.handlers, w = [];
+    for (const [, a] of r)
       a.type === "test" && w.push({
         id: a.id,
         name: a.name,
-        suite: l(a, o),
+        suite: d(a, r),
         status: a.status ?? "idle"
       });
-    r({ type: "status:result", tests: w });
+    o({ type: "status:result", tests: w });
   }
   function W(n) {
-    let o;
+    let r;
     try {
-      o = JSON.parse(n.data);
+      r = JSON.parse(n.data);
     } catch {
       return;
     }
-    o.type === "run" ? (u("Received run command — running tests..."), C()) : o.type === "status" && R();
+    r.type === "run" ? (l("Received run command — running tests..."), C()) : r.type === "status" && R();
   }
   function b() {
-    f && !p && (u(`Reconnecting in ${S}ms...`), m = setTimeout(() => {
+    f && !p && (l(`Reconnecting in ${S}ms...`), m = setTimeout(() => {
       E();
     }, S));
   }
   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 && (t.readyState === WebSocket.OPEN || t.readyState === WebSocket.CONNECTING) || (p = !1, l("Connecting to", u), t = new WebSocket(u), t.addEventListener("open", () => {
+      o({ type: "hello", role: "browser" }), l("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();
+      p || l("Disconnected", n.code ? `(code ${n.code})` : "", n.reason || ""), b();
     }), t.addEventListener("error", () => {
     }));
   }

package/dist/cli.js

@@ -167,8 +167,8 @@ function createTwdRelay(server, options) {
   };
 }
 function run(options) {
-  const { port, timeout } = options;
-  const url = `ws://localhost:${port}/__twd/ws`;
+  const { port, timeout, path, host } = options;
+  const url = `ws://${host}:${port}${path}`;
   console.log(`Connecting to ${url}...`);
   const ws = new WebSocket$1(url);
   let runSent = false;
@@ -261,15 +261,20 @@ Commands:
 
 Options for serve:
   --port <port>   Port to listen on (default: 9876)
+  --path <path>   WebSocket path (default: /__twd/ws)
 
 Options for run:
   --port <port>      Relay port to connect to (default: 5173)
+  --host <host>      Relay host to connect to (default: localhost)
+  --path <path>      WebSocket path (default: /__twd/ws)
   --timeout <ms>     Timeout in ms (default: 180000)
 
 Examples:
   twd-relay                     # start relay on port 9876
+  twd-relay serve --path /app/__twd/ws
   twd-relay run                 # trigger run via Vite dev server on 5173
   twd-relay run --port 9876     # trigger run on custom port
+  twd-relay run --host 192.168.1.10 --path /app/__twd/ws
   twd-relay run --timeout 30000 # custom timeout`);
 }
 if (args.includes("--help") || args.includes("-h")) {
@@ -279,6 +284,8 @@ if (args.includes("--help") || args.includes("-h")) {
 if (subcommand === "run") {
   const portStr = parseFlag("--port");
   const timeoutStr = parseFlag("--timeout");
+  const pathFlag = parseFlag("--path") ?? "/__twd/ws";
+  const hostFlag = parseFlag("--host") ?? "localhost";
   const port = portStr ? parseInt(portStr, 10) : 5173;
   if (isNaN(port)) {
     console.error("Invalid port number:", portStr);
@@ -289,7 +296,7 @@ if (subcommand === "run") {
     console.error("Invalid timeout value:", timeoutStr);
     process.exit(1);
   }
-  run({ port, timeout });
+  run({ port, timeout, path: pathFlag, host: hostFlag });
 } else if (!subcommand || subcommand === "serve") {
   let shutdown = function() {
     console.log("\nShutting down...");
@@ -299,6 +306,7 @@ if (subcommand === "run") {
     });
   };
   const portStr = parseFlag("--port");
+  const pathFlag = parseFlag("--path") ?? "/__twd/ws";
   let port = 9876;
   if (portStr) {
     port = parseInt(portStr, 10);
@@ -309,12 +317,13 @@ if (subcommand === "run") {
   }
   const server = createServer();
   const relay = createTwdRelay(server, {
+    path: pathFlag,
     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(`TWD Relay running on ws://localhost:${port}${pathFlag}`);
     console.log("Waiting for connections...");
   });
   process.on("SIGINT", shutdown);

package/dist/vite.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./createTwdRelay-VRmjHboP.cjs");function n(t){return{name:"twd-relay",configureServer(e){if(!e.httpServer)return;const r=o.c(e.httpServer,{path:t?.path??"/__twd/ws"});e.httpServer.on("close",()=>r.close())}}}exports.twdRemote=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./createTwdRelay-VRmjHboP.cjs");function a(r){let t="/";return{name:"twd-relay",configResolved(e){t=e.base},configureServer(e){if(!e.httpServer)return;const o=r?.path??t.replace(/\/$/,"")+"/__twd/ws",c=n.c(e.httpServer,{path:o});e.httpServer.on("close",()=>c.close())}}}exports.twdRemote=a;

package/dist/vite.d.ts

@@ -9,6 +9,9 @@ export declare interface TwdRemoteOptions {
 
 declare interface VitePlugin {
     name: string;
+    configResolved?: (config: {
+        base: string;
+    }) => void;
     configureServer?: (server: {
         httpServer: Server | null;
     }) => void;

package/dist/vite.es.js

@@ -1,16 +1,18 @@
-import { c as o } from "./createTwdRelay-22etCW_8.js";
-function n(e) {
+import { c } from "./createTwdRelay-22etCW_8.js";
+function l(r) {
+  let t = "/";
   return {
     name: "twd-relay",
-    configureServer(t) {
-      if (!t.httpServer) return;
-      const r = o(t.httpServer, {
-        path: e?.path ?? "/__twd/ws"
-      });
-      t.httpServer.on("close", () => r.close());
+    configResolved(e) {
+      t = e.base;
+    },
+    configureServer(e) {
+      if (!e.httpServer) return;
+      const o = r?.path ?? t.replace(/\/$/, "") + "/__twd/ws", a = c(e.httpServer, { path: o });
+      e.httpServer.on("close", () => a.close());
     }
   };
 }
 export {
-  n as twdRemote
+  l as twdRemote
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-relay",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "WebSocket relay for TWD — enables AI agents and external tools to run and observe in-browser tests",
   "license": "MIT",
   "author": "BRIKEV",