feat: add TS3 command encoding/decoding with escape handling

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/ts-protocol/commands.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect } from "vitest";
+import {
+  encodeCommand,
+  decodeResponse,
+  escapeValue,
+  unescapeValue,
+} from "./commands.js";
+
+describe("TS3 Commands", () => {
+  it("encodes a simple command", () => {
+    const encoded = encodeCommand("login", {
+      client_login_name: "bot",
+      client_login_password: "pass",
+    });
+    expect(encoded).toBe(
+      "login client_login_name=bot client_login_password=pass\n"
+    );
+  });
+
+  it("escapes special characters in values", () => {
+    expect(escapeValue("hello world")).toBe("hello\\sworld");
+    expect(escapeValue("foo|bar")).toBe("foo\\pbar");
+    expect(escapeValue("a/b")).toBe("a\\/b");
+    expect(escapeValue("line\nnew")).toBe("line\\nnew");
+  });
+
+  it("unescapes special characters", () => {
+    expect(unescapeValue("hello\\sworld")).toBe("hello world");
+    expect(unescapeValue("foo\\pbar")).toBe("foo|bar");
+    expect(unescapeValue("a\\/b")).toBe("a/b");
+  });
+
+  it("decodes a single response", () => {
+    const response =
+      "virtualserver_name=My\\sServer virtualserver_port=9987";
+    const result = decodeResponse(response);
+    expect(result).toHaveLength(1);
+    expect(result[0].virtualserver_name).toBe("My Server");
+    expect(result[0].virtualserver_port).toBe("9987");
+  });
+
+  it("decodes a piped multi-entry response", () => {
+    const response =
+      "clid=1 client_nickname=User1|clid=2 client_nickname=User2";
+    const result = decodeResponse(response);
+    expect(result).toHaveLength(2);
+    expect(result[0].client_nickname).toBe("User1");
+    expect(result[1].client_nickname).toBe("User2");
+  });
+
+  it("handles command with no params", () => {
+    const encoded = encodeCommand("quit", {});
+    expect(encoded).toBe("quit\n");
+  });
+});