serverless-ircd 0.4.0 → 0.6.0

package/tools/tcp-ws-forwarder/tests/framing.test.ts

@@ -1,6 +1,12 @@
 import { describe, expect, it } from 'vitest';
 import type { RawData } from 'ws';
-import { splitFrameLines, toBuffer } from '../src/forwarder';
+import {
+  FORWARDER_WS_SUBPROTOCOLS,
+  splitFrameLines,
+  toBuffer,
+  toTcpWire,
+  toWsMessagePayload,
+} from '../src/forwarder';
 
 /**
  * Pure-function unit tests for the WS-side framing helpers. These edges
@@ -49,3 +55,61 @@ describe('toBuffer', () => {
     expect(toBuffer(src as RawData).toString('utf8')).toBe('ABC');
   });
 });
+
+describe('FORWARDER_WS_SUBPROTOCOLS', () => {
+  it('offers binary.ircv3.net first (preferred)', () => {
+    expect(FORWARDER_WS_SUBPROTOCOLS[0]).toBe('binary.ircv3.net');
+  });
+
+  it('offers text.ircv3.net as the fallback', () => {
+    expect(FORWARDER_WS_SUBPROTOCOLS).toContain('text.ircv3.net');
+  });
+
+  it('offers exactly the two IRCv3 subprotocols', () => {
+    expect([...FORWARDER_WS_SUBPROTOCOLS].sort()).toEqual(['binary.ircv3.net', 'text.ircv3.net']);
+  });
+});
+
+describe('toWsMessagePayload — TCP line → WS message (CRLF stripped)', () => {
+  it('strips a trailing CRLF from a TCP IRC line', () => {
+    expect(toWsMessagePayload('PING :tok\r\n')).toBe('PING :tok');
+  });
+
+  it('strips a trailing bare LF', () => {
+    expect(toWsMessagePayload('PING :bare\n')).toBe('PING :bare');
+  });
+
+  it('leaves an already-bare line unchanged (idempotent on LineScanner output)', () => {
+    expect(toWsMessagePayload('NICK alice')).toBe('NICK alice');
+  });
+
+  it('strips only one trailing terminator, keeping embedded content', () => {
+    expect(toWsMessagePayload('PRIVMSG #foo :a\r\nb\r\n')).toBe('PRIVMSG #foo :a\r\nb');
+  });
+
+  it('returns the empty string unchanged', () => {
+    expect(toWsMessagePayload('')).toBe('');
+  });
+});
+
+describe('toTcpWire — WS message → TCP bytes (CRLF re-appended)', () => {
+  it('appends CRLF to a bare spec-mode WS message', () => {
+    expect(toTcpWire(':srv 001 nick :Welcome')).toEqual([':srv 001 nick :Welcome\r\n']);
+  });
+
+  it('collapses a single trailing CRLF instead of doubling it', () => {
+    expect(toTcpWire(':srv 001 nick :Hi\r\n')).toEqual([':srv 001 nick :Hi\r\n']);
+  });
+
+  it('emits no bytes for an empty WS message', () => {
+    expect(toTcpWire('')).toEqual([]);
+  });
+
+  it('emits no bytes for a message that is only a terminator', () => {
+    expect(toTcpWire('\r\n')).toEqual([]);
+  });
+
+  it('re-appends CRLF to each line of a legacy joined multi-message frame', () => {
+    expect(toTcpWire(':srv 001\r\n:srv 376')).toEqual([':srv 001\r\n', ':srv 376\r\n']);
+  });
+});