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

package/dist/browser.es.js

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

package/dist/cli.js

@@ -1,259 +1,261 @@
 #!/usr/bin/env node
 import { createServer } from "http";
-import WebSocket$1, { WebSocketServer, WebSocket } from "ws";
-const DEFAULT_PATH = "/__twd/ws";
+import WebSocket, { WebSocket as WebSocket$1, WebSocketServer } from "ws";
+//#region src/relay/createTwdRelay.ts
+var DEFAULT_PATH = "/__twd/ws";
 function createTwdRelay(server, options) {
-  const path = options?.path ?? DEFAULT_PATH;
-  const onError = options?.onError;
-  const wss = new WebSocketServer({ noServer: true });
-  let browser = null;
-  const clients = /* @__PURE__ */ new Set();
-  let runInProgress = false;
-  function sendError(ws, code, message) {
-    const msg = { type: "error", code, message };
-    if (ws.readyState === WebSocket.OPEN) {
-      ws.send(JSON.stringify(msg));
-    }
-  }
-  function broadcastToClients(data) {
-    for (const client of clients) {
-      if (client.readyState === WebSocket.OPEN) {
-        client.send(data);
-      }
-    }
-  }
-  function sendConnectedStatus(ws) {
-    const msg = { type: "connected", browser: browser !== null && browser.readyState === WebSocket.OPEN };
-    if (ws.readyState === WebSocket.OPEN) {
-      ws.send(JSON.stringify(msg));
-    }
-  }
-  function notifyBrowserDisconnected() {
-    broadcastToClients(JSON.stringify({ type: "connected", browser: false }));
-  }
-  function handleBrowserMessage(data) {
-    let parsed;
-    try {
-      parsed = JSON.parse(data);
-    } catch {
-      return;
-    }
-    if (parsed.type === "run:complete") {
-      runInProgress = false;
-    }
-    broadcastToClients(data);
-  }
-  function handleClientMessage(ws, data) {
-    let parsed;
-    try {
-      parsed = JSON.parse(data);
-    } catch {
-      sendError(ws, "INVALID_MESSAGE", "Invalid JSON");
-      return;
-    }
-    if (!parsed.type) {
-      sendError(ws, "INVALID_MESSAGE", 'Missing "type" field');
-      return;
-    }
-    if (parsed.type === "run") {
-      if (!browser || browser.readyState !== WebSocket.OPEN) {
-        sendError(ws, "NO_BROWSER", "No browser connected");
-        return;
-      }
-      if (runInProgress) {
-        sendError(ws, "RUN_IN_PROGRESS", "A test run is already in progress");
-        return;
-      }
-      runInProgress = true;
-      browser.send(data);
-      return;
-    }
-    if (parsed.type === "status") {
-      if (!browser || browser.readyState !== WebSocket.OPEN) {
-        sendError(ws, "NO_BROWSER", "No browser connected");
-        return;
-      }
-      browser.send(data);
-      return;
-    }
-    sendError(ws, "UNKNOWN_COMMAND", `Unknown command: ${parsed.type}`);
-  }
-  function handleConnection(ws) {
-    let identified = false;
-    const identifyHandler = (raw) => {
-      const data = typeof raw === "string" ? raw : raw.toString();
-      if (!identified) {
-        let parsed;
-        try {
-          parsed = JSON.parse(data);
-        } catch {
-          sendError(ws, "INVALID_MESSAGE", "Invalid JSON");
-          return;
-        }
-        if (parsed.type !== "hello" || parsed.role !== "browser" && parsed.role !== "client") {
-          sendError(ws, "INVALID_MESSAGE", 'First message must be a hello with role "browser" or "client"');
-          return;
-        }
-        identified = true;
-        if (parsed.role === "browser") {
-          if (browser && browser.readyState === WebSocket.OPEN) {
-            browser.close(1e3, "Replaced by new browser");
-          }
-          browser = ws;
-          runInProgress = false;
-          ws.on("close", () => {
-            if (browser === ws) {
-              browser = null;
-              runInProgress = false;
-              notifyBrowserDisconnected();
-            }
-          });
-          broadcastToClients(JSON.stringify({ type: "connected", browser: true }));
-          ws.on("message", (raw2) => {
-            const msg = typeof raw2 === "string" ? raw2 : raw2.toString();
-            handleBrowserMessage(msg);
-          });
-        } else {
-          clients.add(ws);
-          ws.on("close", () => {
-            clients.delete(ws);
-          });
-          sendConnectedStatus(ws);
-          ws.on("message", (raw2) => {
-            const msg = typeof raw2 === "string" ? raw2 : raw2.toString();
-            handleClientMessage(ws, msg);
-          });
-        }
-        ws.removeListener("message", identifyHandler);
-      }
-    };
-    ws.on("message", identifyHandler);
-    ws.on("error", (err) => {
-      if (onError) onError(err);
-    });
-  }
-  const upgradeHandler = (request, socket, head) => {
-    const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`);
-    if (url.pathname === path) {
-      wss.handleUpgrade(request, socket, head, (ws) => {
-        handleConnection(ws);
-      });
-    }
-  };
-  server.on("upgrade", upgradeHandler);
-  wss.on("error", (err) => {
-    if (onError) onError(err);
-  });
-  return {
-    close() {
-      server.removeListener("upgrade", upgradeHandler);
-      for (const client of clients) {
-        client.close(1e3, "Relay shutting down");
-      }
-      clients.clear();
-      if (browser && browser.readyState === WebSocket.OPEN) {
-        browser.close(1e3, "Relay shutting down");
-      }
-      browser = null;
-      runInProgress = false;
-      wss.close();
-    },
-    get browserConnected() {
-      return browser !== null && browser.readyState === WebSocket.OPEN;
-    },
-    get clientCount() {
-      return clients.size;
-    }
-  };
+	const path = options?.path ?? DEFAULT_PATH;
+	const onError = options?.onError;
+	const wss = new WebSocketServer({ noServer: true });
+	let browser = null;
+	const clients = /* @__PURE__ */ new Set();
+	let runInProgress = false;
+	function sendError(ws, code, message) {
+		const msg = {
+			type: "error",
+			code,
+			message
+		};
+		if (ws.readyState === WebSocket$1.OPEN) ws.send(JSON.stringify(msg));
+	}
+	function broadcastToClients(data) {
+		for (const client of clients) if (client.readyState === WebSocket$1.OPEN) client.send(data);
+	}
+	function sendConnectedStatus(ws) {
+		const msg = {
+			type: "connected",
+			browser: browser !== null && browser.readyState === WebSocket$1.OPEN
+		};
+		if (ws.readyState === WebSocket$1.OPEN) ws.send(JSON.stringify(msg));
+	}
+	function notifyBrowserDisconnected() {
+		broadcastToClients(JSON.stringify({
+			type: "connected",
+			browser: false
+		}));
+	}
+	function handleBrowserMessage(data) {
+		let parsed;
+		try {
+			parsed = JSON.parse(data);
+		} catch {
+			return;
+		}
+		if (parsed.type === "run:complete") runInProgress = false;
+		broadcastToClients(data);
+	}
+	function handleClientMessage(ws, data) {
+		let parsed;
+		try {
+			parsed = JSON.parse(data);
+		} catch {
+			sendError(ws, "INVALID_MESSAGE", "Invalid JSON");
+			return;
+		}
+		if (!parsed.type) {
+			sendError(ws, "INVALID_MESSAGE", "Missing \"type\" field");
+			return;
+		}
+		if (parsed.type === "run") {
+			if (!browser || browser.readyState !== WebSocket$1.OPEN) {
+				sendError(ws, "NO_BROWSER", "No browser connected");
+				return;
+			}
+			if (runInProgress) {
+				sendError(ws, "RUN_IN_PROGRESS", "A test run is already in progress");
+				return;
+			}
+			runInProgress = true;
+			browser.send(data);
+			return;
+		}
+		if (parsed.type === "status") {
+			if (!browser || browser.readyState !== WebSocket$1.OPEN) {
+				sendError(ws, "NO_BROWSER", "No browser connected");
+				return;
+			}
+			browser.send(data);
+			return;
+		}
+		sendError(ws, "UNKNOWN_COMMAND", `Unknown command: ${parsed.type}`);
+	}
+	function handleConnection(ws) {
+		let identified = false;
+		const identifyHandler = (raw) => {
+			const data = typeof raw === "string" ? raw : raw.toString();
+			if (!identified) {
+				let parsed;
+				try {
+					parsed = JSON.parse(data);
+				} catch {
+					sendError(ws, "INVALID_MESSAGE", "Invalid JSON");
+					return;
+				}
+				if (parsed.type !== "hello" || parsed.role !== "browser" && parsed.role !== "client") {
+					sendError(ws, "INVALID_MESSAGE", "First message must be a hello with role \"browser\" or \"client\"");
+					return;
+				}
+				identified = true;
+				if (parsed.role === "browser") {
+					if (browser && browser.readyState === WebSocket$1.OPEN) browser.close(1e3, "Replaced by new browser");
+					browser = ws;
+					runInProgress = false;
+					ws.on("close", () => {
+						if (browser === ws) {
+							browser = null;
+							runInProgress = false;
+							notifyBrowserDisconnected();
+						}
+					});
+					broadcastToClients(JSON.stringify({
+						type: "connected",
+						browser: true
+					}));
+					ws.on("message", (raw) => {
+						handleBrowserMessage(typeof raw === "string" ? raw : raw.toString());
+					});
+				} else {
+					clients.add(ws);
+					ws.on("close", () => {
+						clients.delete(ws);
+					});
+					sendConnectedStatus(ws);
+					ws.on("message", (raw) => {
+						handleClientMessage(ws, typeof raw === "string" ? raw : raw.toString());
+					});
+				}
+				ws.removeListener("message", identifyHandler);
+			}
+		};
+		ws.on("message", identifyHandler);
+		ws.on("error", (err) => {
+			if (onError) onError(err);
+		});
+	}
+	const upgradeHandler = (request, socket, head) => {
+		if (new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`).pathname === path) wss.handleUpgrade(request, socket, head, (ws) => {
+			handleConnection(ws);
+		});
+	};
+	server.on("upgrade", upgradeHandler);
+	wss.on("error", (err) => {
+		if (onError) onError(err);
+	});
+	return {
+		close() {
+			server.removeListener("upgrade", upgradeHandler);
+			for (const client of clients) client.close(1e3, "Relay shutting down");
+			clients.clear();
+			if (browser && browser.readyState === WebSocket$1.OPEN) browser.close(1e3, "Relay shutting down");
+			browser = null;
+			runInProgress = false;
+			wss.close();
+		},
+		get browserConnected() {
+			return browser !== null && browser.readyState === WebSocket$1.OPEN;
+		},
+		get clientCount() {
+			return clients.size;
+		}
+	};
 }
+//#endregion
+//#region src/cli/run.ts
 function run(options) {
-  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;
-  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 { port, timeout, path, host, testNames } = options;
+	const url = `ws://${host}:${port}${path}`;
+	console.log(`Connecting to ${url}...`);
+	const ws = new WebSocket(url);
+	let runSent = false;
+	let runComplete = false;
+	let failed = false;
+	const timer = setTimeout(() => {
+		console.error(`\nTimeout: 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");
+					const runMsg = {
+						type: "run",
+						scope: "all"
+					};
+					if (testNames?.length) runMsg.testNames = testNames;
+					ws.send(JSON.stringify(runMsg));
+				} else if (!msg.browser) console.log("Waiting for browser to connect...");
+				break;
+			case "run:start":
+				console.log(`Running ${msg.testCount} test(s)...\n`);
+				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(`\n--- 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);
-const subcommand = args.find((a) => !a.startsWith("--"));
+//#endregion
+//#region src/cli/standalone.ts
+var args = process.argv.slice(2);
+var 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;
+	const idx = args.indexOf(name);
+	if (idx !== -1 && args[idx + 1]) return args[idx + 1];
+}
+function parseFlagAll(name) {
+	const values = [];
+	for (let i = 0; i < args.length; i++) if (args[i] === name && args[i + 1] && !args[i + 1].startsWith("--")) values.push(args[i + 1]);
+	return values;
 }
 function printHelp() {
-  console.log(`Usage: twd-relay [command] [options]
+	console.log(`Usage: twd-relay [command] [options]
 
 Commands:
   (none), serve   Start the standalone relay server (default)
@@ -268,6 +270,7 @@ Options for run:
   --host <host>      Relay host to connect to (default: localhost)
   --path <path>      WebSocket path (default: /__twd/ws)
   --timeout <ms>     Timeout in ms (default: 180000)
+  --test <name>      Filter tests by name substring (repeatable)
 
 Examples:
   twd-relay                     # start relay on port 9876
@@ -275,61 +278,71 @@ Examples:
   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`);
+  twd-relay run --timeout 30000 # custom timeout
+  twd-relay run --test "login"           # run tests matching "login"
+  twd-relay run --test "login" --test "signup"  # run multiple`);
 }
 if (args.includes("--help") || args.includes("-h")) {
-  printHelp();
-  process.exit(0);
+	printHelp();
+	process.exit(0);
 }
 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);
-    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, path: pathFlag, host: hostFlag });
+	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);
+		process.exit(1);
+	}
+	const timeout = timeoutStr ? parseInt(timeoutStr, 10) : 18e4;
+	if (isNaN(timeout)) {
+		console.error("Invalid timeout value:", timeoutStr);
+		process.exit(1);
+	}
+	const testNames = parseFlagAll("--test");
+	run({
+		port,
+		timeout,
+		path: pathFlag,
+		host: hostFlag,
+		testNames: testNames.length > 0 ? testNames : void 0
+	});
 } else if (!subcommand || subcommand === "serve") {
-  let shutdown = function() {
-    console.log("\nShutting down...");
-    relay.close();
-    server.close(() => {
-      process.exit(0);
-    });
-  };
-  const portStr = parseFlag("--port");
-  const pathFlag = parseFlag("--path") ?? "/__twd/ws";
-  let port = 9876;
-  if (portStr) {
-    port = parseInt(portStr, 10);
-    if (isNaN(port)) {
-      console.error("Invalid port number:", portStr);
-      process.exit(1);
-    }
-  }
-  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}${pathFlag}`);
-    console.log("Waiting for connections...");
-  });
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
+	const portStr = parseFlag("--port");
+	const pathFlag = parseFlag("--path") ?? "/__twd/ws";
+	let port = 9876;
+	if (portStr) {
+		port = parseInt(portStr, 10);
+		if (isNaN(port)) {
+			console.error("Invalid port number:", portStr);
+			process.exit(1);
+		}
+	}
+	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}${pathFlag}`);
+		console.log("Waiting for connections...");
+	});
+	function shutdown() {
+		console.log("\nShutting down...");
+		relay.close();
+		server.close(() => {
+			process.exit(0);
+		});
+	}
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
 } else {
-  console.error(`Unknown command: ${subcommand}`);
-  printHelp();
-  process.exit(1);
+	console.error(`Unknown command: ${subcommand}`);
+	printHelp();
+	process.exit(1);
 }
+//#endregion

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./createTwdRelay-VRmjHboP.cjs");exports.createTwdRelay=e.c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./relay-CpUORBd7.cjs");exports.createTwdRelay=e.createTwdRelay;

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export declare type InboundMessage = HelloMessage | Command | BrowserEvent;
 export declare interface RunCommand {
     type: 'run';
     scope: 'all';
+    testNames?: string[];
 }
 
 export declare interface RunCompleteEvent {
@@ -78,7 +79,7 @@ export declare interface TestStartEvent {
     suite: string;
 }
 
-export declare type TwdErrorCode = 'NO_BROWSER' | 'RUN_IN_PROGRESS' | 'UNKNOWN_COMMAND' | 'INVALID_MESSAGE';
+export declare type TwdErrorCode = 'NO_BROWSER' | 'RUN_IN_PROGRESS' | 'UNKNOWN_COMMAND' | 'INVALID_MESSAGE' | 'NO_MATCH';
 
 export declare interface TwdErrorMessage {
     type: 'error';

package/dist/index.es.js

@@ -1,4 +1,4 @@
-import { c as r } from "./createTwdRelay-22etCW_8.js";
+import { t as r } from "./relay-C8UTSEbG.js";
 export {
   r as createTwdRelay
 };

package/dist/relay-C8UTSEbG.js

@@ -0,0 +1,132 @@
+import { WebSocket as s, WebSocketServer as I } from "ws";
+var P = "/__twd/ws";
+function _(y, p) {
+  const g = p?.path ?? P, f = p?.onError, u = new I({ noServer: !0 });
+  let t = null;
+  const a = /* @__PURE__ */ new Set();
+  let c = !1;
+  function i(e, n, r) {
+    const o = {
+      type: "error",
+      code: n,
+      message: r
+    };
+    e.readyState === s.OPEN && e.send(JSON.stringify(o));
+  }
+  function S(e) {
+    for (const n of a) n.readyState === s.OPEN && n.send(e);
+  }
+  function O(e) {
+    const n = {
+      type: "connected",
+      browser: t !== null && t.readyState === s.OPEN
+    };
+    e.readyState === s.OPEN && e.send(JSON.stringify(n));
+  }
+  function E() {
+    S(JSON.stringify({
+      type: "connected",
+      browser: !1
+    }));
+  }
+  function h(e) {
+    let n;
+    try {
+      n = JSON.parse(e);
+    } catch {
+      return;
+    }
+    n.type === "run:complete" && (c = !1), S(e);
+  }
+  function b(e, n) {
+    let r;
+    try {
+      r = JSON.parse(n);
+    } catch {
+      i(e, "INVALID_MESSAGE", "Invalid JSON");
+      return;
+    }
+    if (!r.type) {
+      i(e, "INVALID_MESSAGE", 'Missing "type" field');
+      return;
+    }
+    if (r.type === "run") {
+      if (!t || t.readyState !== s.OPEN) {
+        i(e, "NO_BROWSER", "No browser connected");
+        return;
+      }
+      if (c) {
+        i(e, "RUN_IN_PROGRESS", "A test run is already in progress");
+        return;
+      }
+      c = !0, t.send(n);
+      return;
+    }
+    if (r.type === "status") {
+      if (!t || t.readyState !== s.OPEN) {
+        i(e, "NO_BROWSER", "No browser connected");
+        return;
+      }
+      t.send(n);
+      return;
+    }
+    i(e, "UNKNOWN_COMMAND", `Unknown command: ${r.type}`);
+  }
+  function m(e) {
+    let n = !1;
+    const r = (o) => {
+      const A = typeof o == "string" ? o : o.toString();
+      if (!n) {
+        let d;
+        try {
+          d = JSON.parse(A);
+        } catch {
+          i(e, "INVALID_MESSAGE", "Invalid JSON");
+          return;
+        }
+        if (d.type !== "hello" || d.role !== "browser" && d.role !== "client") {
+          i(e, "INVALID_MESSAGE", 'First message must be a hello with role "browser" or "client"');
+          return;
+        }
+        n = !0, d.role === "browser" ? (t && t.readyState === s.OPEN && t.close(1e3, "Replaced by new browser"), t = e, c = !1, e.on("close", () => {
+          t === e && (t = null, c = !1, E());
+        }), S(JSON.stringify({
+          type: "connected",
+          browser: !0
+        })), e.on("message", (l) => {
+          h(typeof l == "string" ? l : l.toString());
+        })) : (a.add(e), e.on("close", () => {
+          a.delete(e);
+        }), O(e), e.on("message", (l) => {
+          b(e, typeof l == "string" ? l : l.toString());
+        })), e.removeListener("message", r);
+      }
+    };
+    e.on("message", r), e.on("error", (o) => {
+      f && f(o);
+    });
+  }
+  const N = (e, n, r) => {
+    new URL(e.url ?? "/", `http://${e.headers.host ?? "localhost"}`).pathname === g && u.handleUpgrade(e, n, r, (o) => {
+      m(o);
+    });
+  };
+  return y.on("upgrade", N), u.on("error", (e) => {
+    f && f(e);
+  }), {
+    close() {
+      y.removeListener("upgrade", N);
+      for (const e of a) e.close(1e3, "Relay shutting down");
+      a.clear(), t && t.readyState === s.OPEN && t.close(1e3, "Relay shutting down"), t = null, c = !1, u.close();
+    },
+    get browserConnected() {
+      return t !== null && t.readyState === s.OPEN;
+    },
+    get clientCount() {
+      return a.size;
+    }
+  };
+}
+export {
+  _ as t
+};

package/dist/relay-CpUORBd7.cjs

@@ -0,0 +1 @@
+let o=require("ws");var R="/__twd/ws";function W(y,N){const p=N?.path??R,f=N?.onError,u=new o.WebSocketServer({noServer:!0});let t=null;const l=new Set;let a=!1;function c(e,n,r){const s={type:"error",code:n,message:r};e.readyState===o.WebSocket.OPEN&&e.send(JSON.stringify(s))}function S(e){for(const n of l)n.readyState===o.WebSocket.OPEN&&n.send(e)}function b(e){const n={type:"connected",browser:t!==null&&t.readyState===o.WebSocket.OPEN};e.readyState===o.WebSocket.OPEN&&e.send(JSON.stringify(n))}function O(){S(JSON.stringify({type:"connected",browser:!1}))}function E(e){let n;try{n=JSON.parse(e)}catch{return}n.type==="run:complete"&&(a=!1),S(e)}function h(e,n){let r;try{r=JSON.parse(n)}catch{c(e,"INVALID_MESSAGE","Invalid JSON");return}if(!r.type){c(e,"INVALID_MESSAGE",'Missing "type" field');return}if(r.type==="run"){if(!t||t.readyState!==o.WebSocket.OPEN){c(e,"NO_BROWSER","No browser connected");return}if(a){c(e,"RUN_IN_PROGRESS","A test run is already in progress");return}a=!0,t.send(n);return}if(r.type==="status"){if(!t||t.readyState!==o.WebSocket.OPEN){c(e,"NO_BROWSER","No browser connected");return}t.send(n);return}c(e,"UNKNOWN_COMMAND",`Unknown command: ${r.type}`)}function m(e){let n=!1;const r=s=>{const P=typeof s=="string"?s:s.toString();if(!n){let d;try{d=JSON.parse(P)}catch{c(e,"INVALID_MESSAGE","Invalid JSON");return}if(d.type!=="hello"||d.role!=="browser"&&d.role!=="client"){c(e,"INVALID_MESSAGE",'First message must be a hello with role "browser" or "client"');return}n=!0,d.role==="browser"?(t&&t.readyState===o.WebSocket.OPEN&&t.close(1e3,"Replaced by new browser"),t=e,a=!1,e.on("close",()=>{t===e&&(t=null,a=!1,O())}),S(JSON.stringify({type:"connected",browser:!0})),e.on("message",i=>{E(typeof i=="string"?i:i.toString())})):(l.add(e),e.on("close",()=>{l.delete(e)}),b(e),e.on("message",i=>{h(e,typeof i=="string"?i:i.toString())})),e.removeListener("message",r)}};e.on("message",r),e.on("error",s=>{f&&f(s)})}const g=(e,n,r)=>{new URL(e.url??"/",`http://${e.headers.host??"localhost"}`).pathname===p&&u.handleUpgrade(e,n,r,s=>{m(s)})};return y.on("upgrade",g),u.on("error",e=>{f&&f(e)}),{close(){y.removeListener("upgrade",g);for(const e of l)e.close(1e3,"Relay shutting down");l.clear(),t&&t.readyState===o.WebSocket.OPEN&&t.close(1e3,"Relay shutting down"),t=null,a=!1,u.close()},get browserConnected(){return t!==null&&t.readyState===o.WebSocket.OPEN},get clientCount(){return l.size}}}Object.defineProperty(exports,"createTwdRelay",{enumerable:!0,get:function(){return W}});

package/dist/vite.cjs.js

@@ -1 +1 @@
-"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;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./relay-CpUORBd7.cjs");function n(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",a=l.createTwdRelay(e.httpServer,{path:o});e.httpServer.on("close",()=>a.close())}}}exports.twdRemote=n;

package/dist/vite.es.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-relay",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "WebSocket relay for TWD — enables AI agents and external tools to run and observe in-browser tests",
   "license": "MIT",
   "author": "BRIKEV",
@@ -60,14 +60,15 @@
     }
   },
   "dependencies": {
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-v8": "^4.1.0",
+    "esbuild": "^0.27.4",
     "typescript": "^5.9.3",
-    "vite": "^7.3.1",
+    "vite": "^8.0.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   }
 }

package/dist/createTwdRelay-22etCW_8.js

@@ -1,123 +0,0 @@
-import { WebSocketServer as P, WebSocket as o } from "ws";
-const R = "/__twd/ws";
-function J(p, N) {
-  const E = N?.path ?? R, f = N?.onError, u = new P({ noServer: !0 });
-  let t = null;
-  const c = /* @__PURE__ */ new Set();
-  let a = !1;
-  function s(e, n, r) {
-    const i = { type: "error", code: n, message: r };
-    e.readyState === o.OPEN && e.send(JSON.stringify(i));
-  }
-  function S(e) {
-    for (const n of c)
-      n.readyState === o.OPEN && n.send(e);
-  }
-  function h(e) {
-    const n = { type: "connected", browser: t !== null && t.readyState === o.OPEN };
-    e.readyState === o.OPEN && e.send(JSON.stringify(n));
-  }
-  function m() {
-    S(JSON.stringify({ type: "connected", browser: !1 }));
-  }
-  function b(e) {
-    let n;
-    try {
-      n = JSON.parse(e);
-    } catch {
-      return;
-    }
-    n.type === "run:complete" && (a = !1), S(e);
-  }
-  function A(e, n) {
-    let r;
-    try {
-      r = JSON.parse(n);
-    } catch {
-      s(e, "INVALID_MESSAGE", "Invalid JSON");
-      return;
-    }
-    if (!r.type) {
-      s(e, "INVALID_MESSAGE", 'Missing "type" field');
-      return;
-    }
-    if (r.type === "run") {
-      if (!t || t.readyState !== o.OPEN) {
-        s(e, "NO_BROWSER", "No browser connected");
-        return;
-      }
-      if (a) {
-        s(e, "RUN_IN_PROGRESS", "A test run is already in progress");
-        return;
-      }
-      a = !0, t.send(n);
-      return;
-    }
-    if (r.type === "status") {
-      if (!t || t.readyState !== o.OPEN) {
-        s(e, "NO_BROWSER", "No browser connected");
-        return;
-      }
-      t.send(n);
-      return;
-    }
-    s(e, "UNKNOWN_COMMAND", `Unknown command: ${r.type}`);
-  }
-  function I(e) {
-    let n = !1;
-    const r = (i) => {
-      const y = typeof i == "string" ? i : i.toString();
-      if (!n) {
-        let d;
-        try {
-          d = JSON.parse(y);
-        } catch {
-          s(e, "INVALID_MESSAGE", "Invalid JSON");
-          return;
-        }
-        if (d.type !== "hello" || d.role !== "browser" && d.role !== "client") {
-          s(e, "INVALID_MESSAGE", 'First message must be a hello with role "browser" or "client"');
-          return;
-        }
-        n = !0, d.role === "browser" ? (t && t.readyState === o.OPEN && t.close(1e3, "Replaced by new browser"), t = e, a = !1, e.on("close", () => {
-          t === e && (t = null, a = !1, m());
-        }), S(JSON.stringify({ type: "connected", browser: !0 })), e.on("message", (l) => {
-          const g = typeof l == "string" ? l : l.toString();
-          b(g);
-        })) : (c.add(e), e.on("close", () => {
-          c.delete(e);
-        }), h(e), e.on("message", (l) => {
-          const g = typeof l == "string" ? l : l.toString();
-          A(e, g);
-        })), e.removeListener("message", r);
-      }
-    };
-    e.on("message", r), e.on("error", (i) => {
-      f && f(i);
-    });
-  }
-  const O = (e, n, r) => {
-    new URL(e.url ?? "/", `http://${e.headers.host ?? "localhost"}`).pathname === E && u.handleUpgrade(e, n, r, (y) => {
-      I(y);
-    });
-  };
-  return p.on("upgrade", O), u.on("error", (e) => {
-    f && f(e);
-  }), {
-    close() {
-      p.removeListener("upgrade", O);
-      for (const e of c)
-        e.close(1e3, "Relay shutting down");
-      c.clear(), t && t.readyState === o.OPEN && t.close(1e3, "Relay shutting down"), t = null, a = !1, u.close();
-    },
-    get browserConnected() {
-      return t !== null && t.readyState === o.OPEN;
-    },
-    get clientCount() {
-      return c.size;
-    }
-  };
-}
-export {
-  J as c
-};

package/dist/createTwdRelay-VRmjHboP.cjs

@@ -1 +0,0 @@
-"use strict";const o=require("ws"),I="/__twd/ws";function P(N,p){const b=p?.path??I,f=p?.onError,S=new o.WebSocketServer({noServer:!0});let t=null;const l=new Set;let a=!1;function s(e,n,r){const c={type:"error",code:n,message:r};e.readyState===o.WebSocket.OPEN&&e.send(JSON.stringify(c))}function u(e){for(const n of l)n.readyState===o.WebSocket.OPEN&&n.send(e)}function E(e){const n={type:"connected",browser:t!==null&&t.readyState===o.WebSocket.OPEN};e.readyState===o.WebSocket.OPEN&&e.send(JSON.stringify(n))}function h(){u(JSON.stringify({type:"connected",browser:!1}))}function m(e){let n;try{n=JSON.parse(e)}catch{return}n.type==="run:complete"&&(a=!1),u(e)}function W(e,n){let r;try{r=JSON.parse(n)}catch{s(e,"INVALID_MESSAGE","Invalid JSON");return}if(!r.type){s(e,"INVALID_MESSAGE",'Missing "type" field');return}if(r.type==="run"){if(!t||t.readyState!==o.WebSocket.OPEN){s(e,"NO_BROWSER","No browser connected");return}if(a){s(e,"RUN_IN_PROGRESS","A test run is already in progress");return}a=!0,t.send(n);return}if(r.type==="status"){if(!t||t.readyState!==o.WebSocket.OPEN){s(e,"NO_BROWSER","No browser connected");return}t.send(n);return}s(e,"UNKNOWN_COMMAND",`Unknown command: ${r.type}`)}function A(e){let n=!1;const r=c=>{const y=typeof c=="string"?c:c.toString();if(!n){let d;try{d=JSON.parse(y)}catch{s(e,"INVALID_MESSAGE","Invalid JSON");return}if(d.type!=="hello"||d.role!=="browser"&&d.role!=="client"){s(e,"INVALID_MESSAGE",'First message must be a hello with role "browser" or "client"');return}n=!0,d.role==="browser"?(t&&t.readyState===o.WebSocket.OPEN&&t.close(1e3,"Replaced by new browser"),t=e,a=!1,e.on("close",()=>{t===e&&(t=null,a=!1,h())}),u(JSON.stringify({type:"connected",browser:!0})),e.on("message",i=>{const g=typeof i=="string"?i:i.toString();m(g)})):(l.add(e),e.on("close",()=>{l.delete(e)}),E(e),e.on("message",i=>{const g=typeof i=="string"?i:i.toString();W(e,g)})),e.removeListener("message",r)}};e.on("message",r),e.on("error",c=>{f&&f(c)})}const O=(e,n,r)=>{new URL(e.url??"/",`http://${e.headers.host??"localhost"}`).pathname===b&&S.handleUpgrade(e,n,r,y=>{A(y)})};return N.on("upgrade",O),S.on("error",e=>{f&&f(e)}),{close(){N.removeListener("upgrade",O);for(const e of l)e.close(1e3,"Relay shutting down");l.clear(),t&&t.readyState===o.WebSocket.OPEN&&t.close(1e3,"Relay shutting down"),t=null,a=!1,S.close()},get browserConnected(){return t!==null&&t.readyState===o.WebSocket.OPEN},get clientCount(){return l.size}}}exports.c=P;