@honeybbq/teamspeak 0.0.1 → 1.0.0-beta.7

package/dist/client/handshake/license.js

@@ -0,0 +1,169 @@
+import { hash512 } from "../crypto/identity.js";
+import { clampScalar, scalarMultFull, bytesToBigIntLE } from "../crypto/primitives.js";
+import { ed25519 } from "@noble/curves/ed25519.js";
+// The root key is a 33-byte Ed25519 point
+const LICENSE_ROOT_KEY = new Uint8Array([
+    0xcd, 0x0d, 0xe2, 0xae, 0xd4, 0x63, 0x45, 0x50, 0x9a, 0x7e, 0x3c, 0xfd, 0x8f, 0x68, 0xb3, 0xdc,
+    0x75, 0x55, 0xb2, 0x9d, 0xcc, 0xec, 0x73, 0xcd, 0x18, 0x75, 0x0f, 0x99, 0x38, 0x12, 0x40, 0x8a,
+]);
+var LicenseBlockType;
+(function (LicenseBlockType) {
+    LicenseBlockType[LicenseBlockType["Intermediate"] = 0] = "Intermediate";
+    LicenseBlockType[LicenseBlockType["Server"] = 2] = "Server";
+    LicenseBlockType[LicenseBlockType["Ts5Server"] = 8] = "Ts5Server";
+    LicenseBlockType[LicenseBlockType["Ephemeral"] = 32] = "Ephemeral";
+})(LicenseBlockType || (LicenseBlockType = {}));
+export class LicenseChain {
+    blocks;
+    constructor(blocks) {
+        this.blocks = blocks;
+    }
+    /**
+     * Derive the session key by chaining Ed25519 point arithmetic starting from
+     * the root key through each license block.
+     */
+    deriveKey() {
+        let round = Uint8Array.from(LICENSE_ROOT_KEY);
+        for (const block of this.blocks) {
+            round = deriveKeyFromBlock(block, round);
+        }
+        return round;
+    }
+}
+/**
+ * The most blocks a license chain may have. Real chains have two or three —
+ * root-issued intermediate, server, ephemeral — and every block costs a
+ * point multiplication to derive, so a server's chain of thousands would hold
+ * the event loop for seconds.
+ */
+export const MAX_LICENSE_BLOCKS = 8;
+export function parseLicenses(data) {
+    if (data.length < 1)
+        throw new Error("license too short");
+    if (data[0] !== 1)
+        throw new Error("unsupported license version");
+    let remaining = data.slice(1);
+    const blocks = [];
+    while (remaining.length > 0) {
+        if (blocks.length === MAX_LICENSE_BLOCKS) {
+            throw new Error(`license chain longer than ${MAX_LICENSE_BLOCKS} blocks`);
+        }
+        const { block, consumed } = parseLicenseBlock(remaining);
+        blocks.push(block);
+        remaining = remaining.slice(consumed);
+    }
+    return new LicenseChain(blocks);
+}
+function parseLicenseBlock(data) {
+    const MIN_BLOCK_LEN = 42;
+    if (data.length < MIN_BLOCK_LEN)
+        throw new Error("license too short");
+    if (data[0] !== 0)
+        throw new Error(`wrong key kind in license: ${data[0]}`);
+    const blockType = data[33];
+    // Timestamps are seconds since Unix epoch offset by 0x50e22700
+    const UNIX_OFFSET = 0x50e22700;
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const notValidBefore = new Date((view.getUint32(34, false) + UNIX_OFFSET) * 1000);
+    const notValidAfter = new Date((view.getUint32(38, false) + UNIX_OFFSET) * 1000);
+    if (notValidAfter < notValidBefore) {
+        throw new Error("license times are invalid");
+    }
+    const key = Uint8Array.from(data.slice(1, 33));
+    const { payload, payloadRead } = parseBlockPayload(blockType, data, MIN_BLOCK_LEN);
+    const allLen = MIN_BLOCK_LEN + payloadRead;
+    if (allLen > data.length)
+        throw new Error("license block longer than the license");
+    const hashInput = data.slice(1, allLen);
+    const hashFull = hash512(Uint8Array.from(hashInput));
+    const hash = Uint8Array.from(hashFull.slice(0, 32));
+    return {
+        block: {
+            key,
+            hash,
+            properties: payload.properties,
+            issuer: payload.issuer,
+            notValidBefore,
+            notValidAfter,
+            blockType,
+            serverType: payload.serverType,
+        },
+        consumed: allLen,
+    };
+}
+function parseBlockPayload(blockType, data, minBlockLen) {
+    switch (blockType) {
+        case LicenseBlockType.Intermediate: {
+            const { str, read } = readNullString(data.slice(46));
+            return {
+                payload: { issuer: str, serverType: 0, properties: [], read: 5 + read },
+                payloadRead: 5 + read,
+            };
+        }
+        case LicenseBlockType.Server: {
+            const { str, read } = readNullString(data.slice(47));
+            return {
+                payload: { issuer: str, serverType: data[42] ?? 0, properties: [], read: 6 + read },
+                payloadRead: 6 + read,
+            };
+        }
+        case LicenseBlockType.Ts5Server: {
+            const propCount = data[43] !== undefined ? data[43] : 0;
+            let pos = 44;
+            const properties = [];
+            for (let i = 0; i < propCount; i++) {
+                if (pos >= data.length)
+                    throw new Error("license too short");
+                const propLen = data[pos++];
+                if (pos + propLen > data.length)
+                    throw new Error("license too short");
+                properties.push(Uint8Array.from(data.slice(pos, pos + propLen)));
+                pos += propLen;
+            }
+            return {
+                payload: { issuer: "", serverType: data[42] ?? 0, properties, read: pos - minBlockLen },
+                payloadRead: pos - minBlockLen,
+            };
+        }
+        case LicenseBlockType.Ephemeral:
+            return { payload: { issuer: "", serverType: 0, properties: [], read: 0 }, payloadRead: 0 };
+        default:
+            throw new Error(`invalid license block type: ${String(blockType)}`);
+    }
+}
+/**
+ * Scan for a null-terminated string and return its content and the index
+ * of the null byte (NOT including it in the count, matching Go behaviour).
+ * The parent formulas (`5 + read`, `6 + read`) already add 1 for the null.
+ */
+function readNullString(data) {
+    for (let i = 0; i < data.length; i++) {
+        if (data[i] === 0) {
+            return { str: new TextDecoder().decode(data.slice(0, i)), read: i };
+        }
+    }
+    throw new Error("non-null-terminated issuer string");
+}
+/**
+ * Derive the next key given a parent key and a license block.
+ * Mirrors Go's licenseBlock.deriveKey.
+ */
+function deriveKeyFromBlock(block, parent) {
+    const scalarBytes = Uint8Array.from(block.hash);
+    clampScalar(scalarBytes);
+    // Use raw scalar WITHOUT reducing mod n — NaCl's ge_scalarmult_vartime
+    // uses the raw 256-bit scalar. Reducing mod n changes the result when
+    // the point has a small-order component (Ed25519 cofactor = 8).
+    const scalar = bytesToBigIntLE(scalarBytes);
+    const pub = ed25519.Point.fromBytes(block.key);
+    const negPub = pub.negate();
+    const par = ed25519.Point.fromBytes(parent);
+    const negPar = par.negate();
+    const res = scalarMultFull(negPub, scalar).add(negPar);
+    const raw = res.toBytes();
+    const final = new Uint8Array(raw.length);
+    final.set(raw);
+    final[31] = (final[31] !== undefined ? final[31] : 0) ^ 0x80;
+    return final;
+}
+//# sourceMappingURL=license.js.map

package/dist/client/handshake/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../../src/client/handshake/license.ts"],"names":[],"mappings":"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"}

package/dist/client/handshake.d.ts

@@ -0,0 +1,27 @@
+import type { ClientVersion } from "@honeybbq/teamspeak";
+import type { ClientInternals } from "./client.js";
+/** Handle the `clientinitiv` message (P-256 based crypto path). */
+export declare function handleHandshakeInitIV(client: ClientInternals, params: Record<string, string>): void;
+/** Handle the `initivexpand2` message (Ed25519 / TS3 crypto path). */
+export declare function handleHandshakeExpand2(client: ClientInternals, params: Record<string, string>): void;
+/** Handle `initserver` — marks the client as connected. */
+export declare function handleInitServer(client: ClientInternals, params: Record<string, string>): void;
+/**
+ * Encode a password field for the command protocol.
+ *
+ * TeamSpeak expects password fields as base64(sha1(password)) — server and
+ * channel passwords during the handshake, the `clientmove` channel password,
+ * and the `cpw` field of the file transfer commands. Sending the plain text
+ * instead makes the server reject correct passwords with error 781.
+ */
+export declare function prepareClientPassword(password: string): string;
+/**
+ * The version `clientinit` sends unless the `version` option says otherwise.
+ *
+ * A literal on purpose: `@honeybbq/teamspeak/versions` holds over a thousand
+ * constants, and the client must not load them. A test holds this equal to the
+ * table's `Windows_3_X_X_5680278000`.
+ */
+export declare const defaultClientVersion: ClientVersion;
+export declare function sendClientInit(client: ClientInternals): void;
+//# sourceMappingURL=handshake.d.ts.map

package/dist/client/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../src/client/handshake.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,IAAI,CAUN;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,IAAI,CAaN;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA0B9F;AAwBD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAIlC,CAAC;AAEF,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAG5D"}

package/dist/client/handshake.js

@@ -0,0 +1,126 @@
+import { createHash } from "node:crypto";
+import { buildCommandOrdered, buildCommand } from "../core/internal.js";
+import { sign, generateTemporaryKey } from "./crypto/primitives.js";
+import { identityPrivateKey } from "./crypto/identity.js";
+import { parseServerCapabilities } from "./capabilities.js";
+import { cryptoInit2 } from "./handshake/crypt-init2.js";
+import { PacketType } from "./transport/packet.js";
+/** Handle the `clientinitiv` message (P-256 based crypto path). */
+export function handleHandshakeInitIV(client, params) {
+    const alpha = params["alpha"] ?? "";
+    const beta = params["beta"] ?? "";
+    const omega = params["omega"] ?? "";
+    client.handler.receivedFinalInitAck();
+    client.crypt.initCrypto(alpha, beta, omega);
+    client.markHandshakeDone(omega);
+    client.logger.info("crypto initialized (P-256 path), sending clientinit");
+    sendClientInit(client);
+}
+/** Handle the `initivexpand2` message (Ed25519 / TS3 crypto path). */
+export function handleHandshakeExpand2(client, params) {
+    client.logger.info("received initivexpand2");
+    client.handler.receivedFinalInitAck();
+    const license = params["l"] ?? "";
+    const omega = params["omega"] ?? "";
+    const proof = params["proof"] ?? "";
+    const beta = params["beta"] ?? "";
+    const privateKey = sendClientEkPacket(client, beta);
+    cryptoInit2(client.crypt, license, omega, proof, beta, privateKey);
+    client.markHandshakeDone(omega);
+    sendClientInit(client);
+}
+/** Handle `initserver` — marks the client as connected. */
+export function handleInitServer(client, params) {
+    const idStr = params["aclid"] ?? params["clid"] ?? "";
+    const clid = idStr ? parseInt(idStr, 10) : 0;
+    if (clid > 0) {
+        client.clid = clid;
+        client.handler.setClientID(clid);
+    }
+    // initserver is the only place the server names itself, and it determines how
+    // the server hashes our public key into client_unique_identifier: SHA-1 on
+    // TS3, SHA-256 on TS6. Recording the whole capability set here keeps callers
+    // from re-deriving it, or assuming one server generation.
+    client.capabilities = parseServerCapabilities(params);
+    client.logger.info("connected to server", { selfId: client.clid });
+    client.markConnected(params);
+    // Inform the server about mute state
+    setImmediate(() => {
+        const updateCmd = buildCommand("clientupdate", {
+            client_input_muted: "0",
+            client_output_muted: "0",
+        });
+        client.execNoWait(updateCmd).catch(() => { });
+    });
+}
+function sendClientEkPacket(client, beta) {
+    const [publicKey, privateKey] = generateTemporaryKey();
+    const ekBase64 = Buffer.from(publicKey).toString("base64");
+    const clientProof = buildClientEkProof(client, publicKey, beta);
+    const clientEk = buildCommandOrdered("clientek", [
+        ["ek", ekBase64],
+        ["proof", clientProof],
+    ]);
+    client.handler.sendPacket(PacketType.Command, Buffer.from(clientEk), 0);
+    return privateKey;
+}
+function buildClientEkProof(client, publicKey, beta) {
+    const betaBytes = Buffer.from(beta, "base64");
+    const toSign = new Uint8Array(86);
+    toSign.set(publicKey.subarray(0, 32));
+    toSign.set(betaBytes.subarray(0, Math.min(54, betaBytes.length)), 32);
+    const sig = sign(identityPrivateKey(client.crypt.identity), toSign);
+    return Buffer.from(sig).toString("base64");
+}
+/**
+ * Encode a password field for the command protocol.
+ *
+ * TeamSpeak expects password fields as base64(sha1(password)) — server and
+ * channel passwords during the handshake, the `clientmove` channel password,
+ * and the `cpw` field of the file transfer commands. Sending the plain text
+ * instead makes the server reject correct passwords with error 781.
+ */
+export function prepareClientPassword(password) {
+    if (password === "")
+        return "";
+    return createHash("sha1").update(password).digest().toString("base64");
+}
+/**
+ * The version `clientinit` sends unless the `version` option says otherwise.
+ *
+ * A literal on purpose: `@honeybbq/teamspeak/versions` holds over a thousand
+ * constants, and the client must not load them. A test holds this equal to the
+ * table's `Windows_3_X_X_5680278000`.
+ */
+export const defaultClientVersion = {
+    platform: "Windows",
+    version: "3.?.? [Build: 5680278000]",
+    sign: "DX5NIYLvfJEUjuIbCidnoeozxIDRRkpq3I9vVMBmE9L2qnekOoBzSenkzsg2lC9CMv8K5hkEzhr2TYUYSwUXCg==",
+};
+export function sendClientInit(client) {
+    const cmd = buildClientInitCommand(client);
+    client.handler.sendPacket(PacketType.Command, Buffer.from(cmd), 0);
+}
+function buildClientInitCommand(client) {
+    const pubKeyBase64 = client.crypt.identity.publicKey();
+    const initOptions = client.initOptions;
+    // HWID should match TS3 client UID format: base64(SHA1(publicKey()))
+    const hwid = createHash("sha1").update(pubKeyBase64).digest().toString("base64");
+    return buildCommandOrdered("clientinit", [
+        ["client_nickname", client.nickname],
+        ["client_version", initOptions.version.version],
+        ["client_platform", initOptions.version.platform],
+        ["client_input_hardware", "1"],
+        ["client_output_hardware", "1"],
+        ["client_default_channel", initOptions.defaultChannel],
+        ["client_default_channel_password", initOptions.defaultChannelPasswordHash],
+        ["client_server_password", initOptions.serverPasswordHash],
+        ["client_meta_data", ""],
+        ["client_version_sign", initOptions.version.sign],
+        ["client_key_offset", String(client.crypt.identity.offset)],
+        ["client_nickname_phonetic", ""],
+        ["client_default_token", ""],
+        ["hwid", hwid],
+    ]);
+}
+//# sourceMappingURL=handshake.js.map

package/dist/client/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/client/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CACnC,MAAuB,EACvB,MAA8B;IAE9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEpC,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAC1E,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CACpC,MAAuB,EACvB,MAA8B;IAE9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAElC,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChC,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,MAAuB,EAAE,MAA8B;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7C,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,2EAA2E;IAC3E,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,CAAC,YAAY,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAE7B,qCAAqC;IACrC,YAAY,CAAC,GAAG,EAAE;QAChB,MAAM,SAAS,GAAG,YAAY,CAAC,cAAc,EAAE;YAC7C,kBAAkB,EAAE,GAAG;YACvB,mBAAmB,EAAE,GAAG;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAuB,EAAE,IAAY;IAC/D,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,oBAAoB,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE;QAC/C,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChB,CAAC,OAAO,EAAE,WAAW,CAAC;KACvB,CAAC,CAAC;IACH,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAuB,EAAE,SAAqB,EAAE,IAAY;IACtF,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,2BAA2B;IACpC,IAAI,EAAE,0FAA0F;CACjG,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,GAAG,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAuB;IACrD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,qEAAqE;IACrE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEjF,OAAO,mBAAmB,CAAC,YAAY,EAAE;QACvC,CAAC,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC;QACpC,CAAC,gBAAgB,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/C,CAAC,iBAAiB,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;QACjD,CAAC,uBAAuB,EAAE,GAAG,CAAC;QAC9B,CAAC,wBAAwB,EAAE,GAAG,CAAC;QAC/B,CAAC,wBAAwB,EAAE,WAAW,CAAC,cAAc,CAAC;QACtD,CAAC,iCAAiC,EAAE,WAAW,CAAC,0BAA0B,CAAC;QAC3E,CAAC,wBAAwB,EAAE,WAAW,CAAC,kBAAkB,CAAC;QAC1D,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACxB,CAAC,qBAAqB,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;QACjD,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC,0BAA0B,EAAE,EAAE,CAAC;QAChC,CAAC,sBAAsB,EAAE,EAAE,CAAC;QAC5B,CAAC,MAAM,EAAE,IAAI,CAAC;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/client/helpers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reports whether `actual` equals `expected` or equals `expected` followed by
+ * only digits — the pattern TeamSpeak uses when a nickname is already taken.
+ */
+export declare function isAutoNicknameMatch(expected: string, actual: string): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/client/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK7E"}

package/dist/client/helpers.js

@@ -0,0 +1,13 @@
+/**
+ * Reports whether `actual` equals `expected` or equals `expected` followed by
+ * only digits — the pattern TeamSpeak uses when a nickname is already taken.
+ */
+export function isAutoNicknameMatch(expected, actual) {
+    if (actual === expected)
+        return true;
+    if (!actual.startsWith(expected))
+        return false;
+    const suffix = actual.slice(expected.length);
+    return /^\d+$/.test(suffix);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/client/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/client/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAClE,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/client/hooks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Call a trace hook, if there is one, and never let it touch what called it:
+ * a throw, or the rejection of a promise it returns, is reported as a
+ * throwing listener's is. The info is built only when there is a hook.
+ */
+export declare function callHook<I>(hook: ((info: I) => unknown) | undefined, owner: object | undefined, info: () => I): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/client/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,SAAS,EACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,CAAC,GACZ,IAAI,CAUN"}

package/dist/client/hooks.js

@@ -0,0 +1,28 @@
+/**
+ * Report an error from a trace hook the way a throwing event listener's is
+ * reported: rethrown on its own, as an uncaught exception.
+ */
+function reportHookError(error) {
+    queueMicrotask(() => {
+        throw error;
+    });
+}
+/**
+ * Call a trace hook, if there is one, and never let it touch what called it:
+ * a throw, or the rejection of a promise it returns, is reported as a
+ * throwing listener's is. The info is built only when there is a hook.
+ */
+export function callHook(hook, owner, info) {
+    if (hook === undefined)
+        return;
+    try {
+        const result = hook.call(owner, info());
+        if (result !== null && typeof result === "object" && "then" in result) {
+            Promise.resolve(result).then(undefined, reportHookError);
+        }
+    }
+    catch (error) {
+        reportHookError(error);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/client/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,cAAc,CAAC,GAAG,EAAE;QAClB,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAwC,EACxC,KAAyB,EACzB,IAAa;IAEb,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACtE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A clean-room TeamSpeak client: it connects over the voice protocol, the way
+ * the TeamSpeak application does.
+ *
+ * Only what belongs to the voice protocol is exported here. The typed commands,
+ * ids and errors every client shares come from `@honeybbq/teamspeak`.
+ *
+ * @module @honeybbq/teamspeak/client
+ */
+export { Client } from "./client.js";
+export { EventName } from "./types.js";
+export type { EventMap, EventMiddleware, ServerEvent, ServerEventName, VoiceOptions, WhisperTargets, AddrResolver, ClientOptions, ResolvedAddr, DatagramSocket, SocketFactory, FileTransferSocketFactory, } from "./types.js";
+export { FileTransferError, HandshakeError, InvalidAddressError, InvalidIdentityError, RemovedError, ConnectionTimeoutError, } from "./errors.js";
+export * from "./api/voice.js";
+export { dialFileTransfer, uploadFileData, downloadFileData } from "./transfer.js";
+export type { FileTransferOptions, FileTransferTrace, FileTransferStage, FileTransferDialStartInfo, FileTransferDialDoneInfo, FileTransferProgressInfo, FileTransferDoneInfo, FileTransferFailedInfo, } from "./transfer.js";
+export { ConnectPhase } from "./trace.js";
+export type { ClientTrace, ResolveStartInfo, ResolveDoneInfo, ConnectStartInfo, ConnectDoneInfo, HandshakeDoneInfo, SessionStartInfo, WelcomeDoneInfo, AttemptFailedInfo, ReconnectScheduledInfo, DisconnectStartInfo, DisconnectDoneInfo, SessionEndInfo, ReconnectStoppedInfo, } from "./trace.js";
+export { unknownServerCapabilities } from "./capabilities.js";
+export type { ServerCapabilities } from "./capabilities.js";
+export { commandChannel, incomingChannel } from "./diagnostics.js";
+export type { CommandTrace, IncomingTrace } from "./diagnostics.js";
+export { defaultShouldRetry } from "./reconnect.js";
+export { Identity, parseIdentity, generateIdentity, generateIdentitySync, uidFromPublicKey, } from "./crypto/index.js";
+export type { UIDAlgorithm } from "./crypto/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,YAAY,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnF,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,28 @@
+/**
+ * A clean-room TeamSpeak client: it connects over the voice protocol, the way
+ * the TeamSpeak application does.
+ *
+ * Only what belongs to the voice protocol is exported here. The typed commands,
+ * ids and errors every client shares come from `@honeybbq/teamspeak`.
+ *
+ * @module @honeybbq/teamspeak/client
+ */
+// The client
+export { Client } from "./client.js";
+export { EventName } from "./types.js";
+export { FileTransferError, HandshakeError, InvalidAddressError, InvalidIdentityError, RemovedError, ConnectionTimeoutError, } from "./errors.js";
+// Commands only the voice protocol has.
+export * from "./api/voice.js";
+// File transfer data
+export { dialFileTransfer, uploadFileData, downloadFileData } from "./transfer.js";
+// Tracing a connection attempt
+export { ConnectPhase } from "./trace.js";
+// Server capabilities, read from the handshake
+export { unknownServerCapabilities } from "./capabilities.js";
+// Tracing points for diagnostics_channel subscribers
+export { commandChannel, incomingChannel } from "./diagnostics.js";
+// Reconnection policy
+export { defaultShouldRetry } from "./reconnect.js";
+// Identity
+export { Identity, parseIdentity, generateIdentity, generateIdentitySync, uidFromPublicKey, } from "./crypto/index.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiBvC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,wCAAwC;AACxC,cAAc,gBAAgB,CAAC;AAE/B,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYnF,+BAA+B;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkB1C,+CAA+C;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnE,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,WAAW;AACX,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/client/reconnect.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether a failure is worth another attempt.
+ *
+ * Transport failures are retried; so is a server that stopped, and a server
+ * error other than the known refusals — a ban, flooding, a wrong server or
+ * channel password, missing permissions — since some, such as 521 "too many
+ * clones" right after a drop, clear by themselves. A kick or a ban is not:
+ * someone removed the client on purpose. Nor is an AlreadyConnectedError: the
+ * client was connected by other means; nor an InvalidAddressError.
+ */
+export declare function defaultShouldRetry(error: Error | undefined): boolean;
+//# sourceMappingURL=reconnect.d.ts.map

package/dist/client/reconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../../src/client/reconnect.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CASpE"}

package/dist/client/reconnect.js

@@ -0,0 +1,44 @@
+import { ErrorCode, Reason, ServerError, AlreadyConnectedError } from "@honeybbq/teamspeak";
+import { InvalidAddressError, RemovedError } from "./errors.js";
+/**
+ * Server errors where retrying cannot help.
+ *
+ * Deliberately a short list of codes known to be refusals, rather than "any
+ * ServerError". The server also answers transiently: after a dropped
+ * connection it still holds the old session, and a reconnect with the same
+ * identity is refused with 521 "too many clones already connected" until it
+ * reaps the zombie — a condition that clears itself and is worth retrying.
+ *
+ * The asymmetry is deliberate. Retrying a permanent failure costs a few bounded
+ * attempts; not retrying a transient one means never recovering.
+ */
+const PERMANENT_SERVER_ERRORS = new Set([
+    ErrorCode.ConnectFailedBanned,
+    ErrorCode.BanFlooding,
+    ErrorCode.ServerInvalidPassword,
+    ErrorCode.ChannelInvalidPassword,
+    ErrorCode.PermissionsClientInsufficient,
+]);
+/**
+ * Whether a failure is worth another attempt.
+ *
+ * Transport failures are retried; so is a server that stopped, and a server
+ * error other than the known refusals — a ban, flooding, a wrong server or
+ * channel password, missing permissions — since some, such as 521 "too many
+ * clones" right after a drop, clear by themselves. A kick or a ban is not:
+ * someone removed the client on purpose. Nor is an AlreadyConnectedError: the
+ * client was connected by other means; nor an InvalidAddressError.
+ */
+export function defaultShouldRetry(error) {
+    // The client is connected, or connecting, already: there is nothing to retry.
+    if (error instanceof AlreadyConnectedError)
+        return false;
+    // An address that cannot be one stays that way.
+    if (error instanceof InvalidAddressError)
+        return false;
+    if (error instanceof RemovedError) {
+        return error.reason !== Reason.KickServer && error.reason !== Reason.KickServerBan;
+    }
+    return !(error instanceof ServerError && PERMANENT_SERVER_ERRORS.has(error.code));
+}
+//# sourceMappingURL=reconnect.js.map

package/dist/client/reconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.js","sourceRoot":"","sources":["../../src/client/reconnect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAC3D,SAAS,CAAC,mBAAmB;IAC7B,SAAS,CAAC,WAAW;IACrB,SAAS,CAAC,qBAAqB;IAC/B,SAAS,CAAC,sBAAsB;IAChC,SAAS,CAAC,6BAA6B;CACxC,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,8EAA8E;IAC9E,IAAI,KAAK,YAAY,qBAAqB;QAAE,OAAO,KAAK,CAAC;IACzD,gDAAgD;IAChD,IAAI,KAAK,YAAY,mBAAmB;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa,CAAC;IACrF,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,YAAY,WAAW,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/client/throttle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Token-bucket limiter for outbound TS3 commands.
+ * Mirrors Go's commandThrottle.
+ *
+ * Waiters are released in the order they arrived: each used to poll for a
+ * token on its own timer, so a command that came later could take the turn of
+ * one that had waited longer, and the commands went out of order.
+ */
+export declare class CommandThrottle {
+    #private;
+    static readonly TOKEN_RATE = 4;
+    static readonly TOKEN_MAX = 8;
+    /**
+     * Wait for a token, behind every earlier waiter. Aborting `signal` rejects
+     * with its reason and gives the place in line up; the abort listener is
+     * removed however the wait ends.
+     */
+    wait(signal?: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/client/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/client/throttle.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,qBAAa,eAAe;;IAC1B,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAO;IACjC,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAO;IAOhC;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxC;CAyCF"}