serverless-ircd 0.5.0 → 0.7.0

package/apps/local-cli/tests/e2e.test.ts

@@ -80,7 +80,12 @@ describe('local-cli e2e', () => {
   let server: LocalServer;
 
   beforeAll(async () => {
-    server = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    server = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
   });
 
   afterAll(async () => {
@@ -103,15 +108,15 @@ describe('local-cli e2e', () => {
 
     await alice.send('NICK alice');
     await alice.send('USER alice 0 * :Alice');
-    await alice.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await alice.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await bob.send('NICK bob');
     await bob.send('USER bob 0 * :Bob');
-    await bob.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await bob.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await alice.send('JOIN #e2e');
     await alice.waitFor((l) => l.includes('JOIN #e2e'));
-    await alice.waitFor((l) => l.startsWith(':irc.example.com 353 '));
+    await alice.waitFor((l) => l.startsWith(':irc.local.example.com 353 '));
 
     await bob.send('JOIN #e2e');
     // Bob sees his own JOIN + NAMES.
@@ -130,7 +135,7 @@ describe('local-cli e2e', () => {
     await client.opened();
     await client.send('NICK charlie');
     await client.send('USER charlie 0 * :Charlie');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await client.send('PING :tok-12345');
     await client.waitFor((l) => l === 'PONG :tok-12345');
@@ -143,7 +148,7 @@ describe('local-cli e2e', () => {
     await client.opened();
     await client.send('NICK dave');
     await client.send('USER dave 0 * :Dave');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await client.send('BOGUSCMD');
     await client.waitFor((l) => l.includes('421') && l.includes('BOGUSCMD'));
@@ -156,7 +161,7 @@ describe('local-cli e2e', () => {
     await client.opened();
     await client.send('NICK eve');
     await client.send('USER eve 0 * :Eve');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await client.send('QUIT :bye');
     // The disconnect effect should close the socket.
@@ -166,18 +171,42 @@ describe('local-cli e2e', () => {
     await next.opened();
     await next.send('NICK eve');
     await next.send('USER eve 0 * :Eve2');
-    await next.waitFor((l) => l.startsWith(':irc.example.com 001 '), 2000);
+    await next.waitFor((l) => l.startsWith(':irc.local.example.com 001 '), 2000);
     await next.close();
   });
 });
 
 describe('local-cli error paths', () => {
   it('rejects startLocalServer when the port is already in use', async () => {
-    const first = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
-    await expect(startLocalServer({ port: first.port, hostname: '127.0.0.1' })).rejects.toThrow();
+    const first = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
+    await expect(
+      startLocalServer({
+        port: first.port,
+        hostname: '127.0.0.1',
+        serverName: 'irc.local.example.com',
+        networkName: 'LocalNet',
+      }),
+    ).rejects.toThrow();
     await first.close();
   });
 
+  it('rejects when serverName is omitted so the placeholder never leaks', async () => {
+    await expect(startLocalServer({ port: 0, hostname: '127.0.0.1' })).rejects.toThrowError(
+      /serverName/u,
+    );
+  });
+
+  it('rejects when networkName is omitted', async () => {
+    await expect(
+      startLocalServer({ port: 0, hostname: '127.0.0.1', serverName: 'irc.local.example.com' }),
+    ).rejects.toThrowError(/networkName/u);
+  });
+
   it('validates the supplied config through the shared ServerConfigSchema at boot', async () => {
     // nickLen=0 is rejected by the schema (must be a positive integer).
     await expect(
@@ -192,7 +221,12 @@ describe('local-cli error paths', () => {
   });
 
   it('logs and recovers from a per-socket error without crashing the server', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
     await client.opened();
     // Synthesize a socket-level error on the SERVER-side ws via the
@@ -218,20 +252,22 @@ describe('local-cli error paths', () => {
     const srv = await startLocalServer({
       port: 0,
       hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
       motdLines: ['first line of motd', 'second line of motd'],
     });
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
     await client.opened();
     await client.send('NICK karl');
     await client.send('USER karl 0 * :Karl');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     // Drain registration burst so the explicit MOTD responses below aren't
     // confused with the placeholder MOTD emitted at registration.
     client.received.length = 0;
     await client.send('MOTD');
     // Wait for end-of-MOTD so all 372 lines are buffered in `received`.
-    await client.waitFor((l) => l.startsWith(':irc.example.com 376 karl'));
-    const motdBody = client.received.filter((l) => l.startsWith(':irc.example.com 372 karl'));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 376 karl'));
+    const motdBody = client.received.filter((l) => l.startsWith(':irc.local.example.com 372 karl'));
     expect(motdBody.some((l) => l.includes('first line of motd'))).toBe(true);
     expect(motdBody.some((l) => l.includes('second line of motd'))).toBe(true);
     await client.close();
@@ -239,7 +275,11 @@ describe('local-cli error paths', () => {
   });
 
   it('defaults hostname to 127.0.0.1 when omitted', async () => {
-    const srv = await startLocalServer({ port: 0 });
+    const srv = await startLocalServer({
+      port: 0,
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     expect(srv.hostname).toBe('127.0.0.1');
     // Sanity-check that the server is actually reachable on the default.
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
@@ -249,7 +289,12 @@ describe('local-cli error paths', () => {
   });
 
   it('close() forcibly closes any still-open client sockets', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
     await client.opened();
     // Close the server WITHOUT first closing the client — exercises the
@@ -260,14 +305,24 @@ describe('local-cli error paths', () => {
   });
 
   it('close() is a no-op when no connections are live', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     await srv.close();
     // Closing again should not throw (idempotent).
     await expect(srv.close()).resolves.toBeUndefined();
   });
 
   it('logs an actor failure without crashing the server (Error path)', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     // Force the runtime's `send` to throw a real Error so the actor's
     // reducer pipeline rejects with an Error instance — exercises
     // `stringifyErr`'s `instanceof Error` branch and `logError`.
@@ -291,14 +346,19 @@ describe('local-cli error paths', () => {
     await next.opened();
     await next.send('NICK grace');
     await next.send('USER grace 0 * :Grace');
-    await next.waitFor((l) => l.startsWith(':irc.example.com 001 '), 2000);
+    await next.waitFor((l) => l.startsWith(':irc.local.example.com 001 '), 2000);
     await next.close();
     await client.close();
     await srv.close();
   });
 
   it('logs a non-Error throw from the actor pipeline (defensive path)', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const original = srv.runtime.send.bind(srv.runtime);
     srv.runtime.send = async () => {
       // Throw a non-Error value to exercise stringifyErr's else branch.
@@ -316,12 +376,17 @@ describe('local-cli error paths', () => {
   });
 
   it('cleans up when a client terminates abruptly (server-side error path)', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
     await client.opened();
     await client.send('NICK ivan');
     await client.send('USER ivan 0 * :Ivan');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     const connId = await srv.runtime.lookupNick('ivan');
     expect(connId).not.toBeNull();
     expect(srv.runtime.hasConnection(connId as string)).toBe(true);
@@ -338,12 +403,17 @@ describe('local-cli error paths', () => {
   });
 
   it('delivers an ERROR notice when a reducer supplies a disconnect reason', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TestClient(`ws://127.0.0.1:${srv.port}/`);
     await client.opened();
     await client.send('NICK heidi');
     await client.send('USER heidi 0 * :Heidi');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     // Call the runtime's disconnect directly with a reason (simulates a
     // future flood-control / oper-kill effect). The runtime takes a ConnId;
@@ -370,12 +440,17 @@ describe('local-cli chathistory end-to-end', () => {
     client.send(`NICK ${nick}\r\n`);
     client.send(`USER ${nick} 0 * :${nick}\r\n`);
     client.send('CAP END\r\n');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     return client;
   }
 
   it('records a PRIVMSG and replays it via CHATHISTORY LATEST in a BATCH', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const alice = await registerWithCaps(srv, 'ch-alice');
 
     alice.send('JOIN #chathist-e2e\r\n');
@@ -395,7 +470,12 @@ describe('local-cli chathistory end-to-end', () => {
   });
 
   it('prepends a chathistory BATCH on rejoin after messages were sent', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
 
     // Seed history as alice: join + send a message that bob has missed.
     const alice = await registerWithCaps(srv, 'ch-seed');
@@ -429,6 +509,8 @@ describe('local-cli SASL PLAIN end-to-end', () => {
     const srv = await startLocalServer({
       port: 0,
       hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
       saslAccounts: [{ username: 'sasl-alice', password: 's3cret' }],
     });
 
@@ -445,7 +527,7 @@ describe('local-cli SASL PLAIN end-to-end', () => {
     client.send('NICK sasl-alice\r\n');
     client.send('USER sasl-alice 0 * :Sasl Alice\r\n');
     client.send('CAP END\r\n');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     await client.close();
     await srv.close();
   });
@@ -454,6 +536,8 @@ describe('local-cli SASL PLAIN end-to-end', () => {
     const srv = await startLocalServer({
       port: 0,
       hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
       saslAccounts: [{ username: 'sasl-bob', password: 'right' }],
     });
 

package/apps/local-cli/tests/tcp.test.ts

@@ -92,7 +92,13 @@ class TcpTestClient extends EventEmitter {
 
 describe('local-cli TCP transport — startLocalServer tcpPort option', () => {
   it('exposes tcpPort and testTcpSockets when tcpPort is provided', async () => {
-    const srv = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     expect(srv.tcpPort).toBeGreaterThan(0);
     expect(srv.testTcpSockets).toBeDefined();
     expect(srv.testTcpSockets?.size).toBe(0);
@@ -100,16 +106,33 @@ describe('local-cli TCP transport — startLocalServer tcpPort option', () => {
   });
 
   it('omits tcpPort / testTcpSockets when tcpPort is not provided', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     expect(srv.tcpPort).toBeUndefined();
     expect(srv.testTcpSockets).toBeUndefined();
     await srv.close();
   });
 
   it('rejects when the TCP port is already in use', async () => {
-    const first = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    const first = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     await expect(
-      startLocalServer({ port: 0, tcpPort: first.tcpPort, hostname: '127.0.0.1' }),
+      startLocalServer({
+        port: 0,
+        tcpPort: first.tcpPort,
+        hostname: '127.0.0.1',
+        serverName: 'irc.local.example.com',
+        networkName: 'LocalNet',
+      }),
     ).rejects.toThrow();
     await first.close();
   });
@@ -119,7 +142,13 @@ describe('local-cli TCP transport — IRC flows', () => {
   let server: LocalServer;
 
   beforeAll(async () => {
-    server = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    server = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
   });
 
   afterAll(async () => {
@@ -141,11 +170,11 @@ describe('local-cli TCP transport — IRC flows', () => {
 
     await alice.send('NICK alice');
     await alice.send('USER alice 0 * :Alice');
-    await alice.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await alice.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await bob.send('NICK bob');
     await bob.send('USER bob 0 * :Bob');
-    await bob.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await bob.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await alice.send('JOIN #tcp-e2e');
     await alice.waitFor((l) => l.includes('JOIN #tcp-e2e'));
@@ -164,7 +193,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await client.opened();
     await client.send('NICK pingUser');
     await client.send('USER pingUser 0 * :Ping');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await client.send('PING :tcp-tok');
     await client.waitFor((l) => l === 'PONG :tcp-tok');
@@ -176,7 +205,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await client.opened();
     await client.send('NICK splitter');
     await client.send('USER splitter 0 * :Splitter');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     // Split a PING line mid-token across two writes. The server's LineScanner
     // must buffer the partial line and emit one PONG when the terminator lands.
@@ -191,7 +220,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await client.opened();
     // NICK and USER bundled into one write, CRLF-separated.
     await client.writeRaw('NICK bundler\r\nUSER bundler 0 * :Bundler\r\n');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 bundler'));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 bundler'));
     await client.close();
   });
 
@@ -200,7 +229,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await client.opened();
     await client.send('NICK termUser');
     await client.send('USER termUser 0 * :Term');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     const connId = await server.runtime.lookupNick('termUser');
     expect(connId).not.toBeNull();
@@ -217,7 +246,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await client.opened();
     await client.send('NICK reasonUser');
     await client.send('USER reasonUser 0 * :Reason');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     // Synthesize a flood-control / oper-kill style disconnect with a reason.
     const connId = await server.runtime.lookupNick('reasonUser');
@@ -247,7 +276,7 @@ describe('local-cli TCP transport — IRC flows', () => {
     await next.opened();
     await next.send('NICK tcpRecover');
     await next.send('USER tcpRecover 0 * :TcpRecover');
-    await next.waitFor((l) => l.startsWith(':irc.example.com 001 '), 2000);
+    await next.waitFor((l) => l.startsWith(':irc.local.example.com 001 '), 2000);
     await next.close();
     await client.close();
   });
@@ -255,7 +284,13 @@ describe('local-cli TCP transport — IRC flows', () => {
 
 describe('local-cli TCP × WS cross-transport interop', () => {
   it('delivers a TCP PRIVMSG to a WS client in the same channel', async () => {
-    const srv = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
 
     // WS side.
     const wsClient = new WebSocket(`ws://127.0.0.1:${srv.port}/`);
@@ -288,7 +323,7 @@ describe('local-cli TCP × WS cross-transport interop', () => {
 
     wsSend('NICK wsUser');
     wsSend('USER wsUser 0 * :WS');
-    await wsWaitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await wsWaitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     wsSend('JOIN #interop');
     await wsWaitFor((l) => l.includes('JOIN #interop'));
 
@@ -297,7 +332,7 @@ describe('local-cli TCP × WS cross-transport interop', () => {
     await tcp.opened();
     await tcp.send('NICK tcpUser');
     await tcp.send('USER tcpUser 0 * :TCP');
-    await tcp.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await tcp.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     await tcp.send('JOIN #interop');
     await tcp.waitFor((l) => l.includes('JOIN #interop'));
 
@@ -315,7 +350,13 @@ describe('local-cli TCP × WS cross-transport interop', () => {
 
 describe('local-cli TCP transport — shutdown', () => {
   it('close() tears down the TCP server and live TCP sockets', async () => {
-    const srv = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TcpTestClient('127.0.0.1', srv.tcpPort as number);
     await client.opened();
     // Closing the server destroys the server-side socket; the client side
@@ -327,12 +368,23 @@ describe('local-cli TCP transport — shutdown', () => {
   });
 
   it('close() is a no-op for TCP when tcpPort was never enabled', async () => {
-    const srv = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     await expect(srv.close()).resolves.toBeUndefined();
   });
 
   it('logs and recovers from a per-TCP-socket error without crashing the server', async () => {
-    const srv = await startLocalServer({ port: 0, tcpPort: 0, hostname: '127.0.0.1' });
+    const srv = await startLocalServer({
+      port: 0,
+      tcpPort: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
     const client = new TcpTestClient('127.0.0.1', srv.tcpPort as number);
     await client.opened();
     // Wait for the server-side 'connection' handler to register the socket

package/apps/local-cli/tests/ws-subprotocol.test.ts

@@ -92,7 +92,12 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
   let server: LocalServer;
 
   beforeAll(async () => {
-    server = await startLocalServer({ port: 0, hostname: '127.0.0.1' });
+    server = await startLocalServer({
+      port: 0,
+      hostname: '127.0.0.1',
+      serverName: 'irc.local.example.com',
+      networkName: 'LocalNet',
+    });
   });
 
   afterAll(async () => {
@@ -121,7 +126,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
     await client.opened();
     await client.send('NICK spec-bin');
     await client.send('USER spec-bin 0 * :Spec Bin');
-    const welcome = await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    const welcome = await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     expect(welcome).toContain('spec-bin');
 
     await client.send('PING :bin-tok');
@@ -172,7 +177,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
     // One bare line per WS message (no trailing CRLF).
     await client.send('NICK spec-alice');
     await client.send('USER spec-alice 0 * :Spec Alice');
-    const welcome = await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    const welcome = await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
     expect(welcome).toContain('spec-alice');
 
     // Every received message must be a single IRC line with no trailing CRLF
@@ -189,7 +194,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
     await client.opened();
     await client.send('NICK spec-bob');
     await client.send('USER spec-bob 0 * :Spec Bob');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     // The welcome sequence is many numerics (001..005, 375/372/376). In spec
     // mode each arrives as its own WS message; a legacy batch would have
@@ -204,7 +209,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
     await client.opened();
     await client.send('NICK spec-ping');
     await client.send('USER spec-ping 0 * :Spec Ping');
-    await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
     await client.send('PING :spec-tok');
     const pong = await client.waitFor((l) => l === 'PONG :spec-tok');
@@ -219,7 +224,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
     await client.send('USER spec-budget 0 * :Spec Budget');
     // Drain the entire registration burst (001..376) so delayed numerics
     // don't pollute the post-overlong-message assertion below.
-    await client.waitFor((l) => l.startsWith(':irc.example.com 376 '));
+    await client.waitFor((l) => l.startsWith(':irc.local.example.com 376 '));
 
     client.received.length = 0;
     // 511-byte payload: `PRIVMSG #x :` (12 bytes) + 499 chars = 511 total.
@@ -244,7 +249,7 @@ describe('local-cli IRCv3 WebSocket subprotocol', () => {
       await client.opened();
       await client.send(`NICK ${nick}`);
       await client.send(`USER ${nick} 0 * :Spec Disc`);
-      await client.waitFor((l) => l.startsWith(':irc.example.com 001 '));
+      await client.waitFor((l) => l.startsWith(':irc.local.example.com 001 '));
 
       const connId = await server.runtime.lookupNick(nick);
       expect(connId).not.toBeNull();