@honeybbq/teamspeak 0.0.1 → 1.0.0-beta.8

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

@@ -0,0 +1,7 @@
+export { Identity, parseIdentity, generateIdentity, generateIdentitySync, uidFromPublicKey, uidAlgorithmForVersion, hash512, importPublicKey, } from "./identity.js";
+export type { UIDAlgorithm } from "./identity.js";
+export { Crypt } from "./crypt.js";
+export type { KeyNonce } from "./crypt.js";
+export { EAX, aesCmac } from "./eax.js";
+export { generateTemporaryKey, sign, verifySign, getSharedSecret2, clampScalar, } from "./primitives.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/crypto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,OAAO,EACP,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/dist/client/crypto/index.js

@@ -0,0 +1,5 @@
+export { Identity, parseIdentity, generateIdentity, generateIdentitySync, uidFromPublicKey, uidAlgorithmForVersion, hash512, importPublicKey, } from "./identity.js";
+export { Crypt } from "./crypt.js";
+export { EAX, aesCmac } from "./eax.js";
+export { generateTemporaryKey, sign, verifySign, getSharedSecret2, clampScalar, } from "./primitives.js";
+//# sourceMappingURL=index.js.map

package/dist/client/crypto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/crypto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,OAAO,EACP,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC"}

package/dist/client/crypto/primitives.d.ts

@@ -0,0 +1,43 @@
+import { type KeyObject } from "node:crypto";
+import { ed25519 } from "@noble/curves/ed25519.js";
+/** Clamp a Curve25519 scalar in-place (required before scalar multiplication). */
+export declare function clampScalar(key: Uint8Array): void;
+/**
+ * Generate an ephemeral Ed25519 key pair for the TS3 handshake.
+ * Returns [publicKey (32 bytes, RFC-8032 encoded), privateKey (32 bytes)].
+ */
+export declare function generateTemporaryKey(): [Uint8Array, Uint8Array];
+/**
+ * Sign data with a P-256 private key (SHA-256 hash, ASN.1 DER encoded).
+ */
+export declare function sign(privateKey: KeyObject, data: Uint8Array): Uint8Array;
+/**
+ * Verify a P-256 ECDSA signature (SHA-256 hash, ASN.1 DER encoded).
+ */
+export declare function verifySign(publicKey: KeyObject, data: Uint8Array, sig: Uint8Array): boolean;
+/**
+ * TS3-specific shared secret derivation using Ed25519 point arithmetic.
+ * Mirrors NaCl's ge_scalarmult_vartime:
+ *   1. Negate the public point
+ *   2. Scalar-multiply by clamped private key bytes (NOT reduced mod n)
+ *   3. Flip sign bit of result
+ *   4. SHA-512 the resulting point bytes
+ *
+ * The scalar must NOT be reduced mod n: Ed25519 has cofactor 8, so the server's
+ * public key may have a small-order component, and P*s ≠ P*(s mod n) in that case.
+ * We use scalarMultFull to handle scalars >= n without losing the cofactor term.
+ */
+export declare function getSharedSecret2(publicKeyBytes: Uint8Array, privateKeyBytes: Uint8Array): Uint8Array;
+/**
+ * Multiply an Ed25519 point by a scalar that may be >= curve order n.
+ * Decomposes as: P*s = P*(s mod n) + (P*n)*q  where q = floor(s/n).
+ * This preserves the small-order component (cofactor 8) that would be
+ * lost by reducing mod n first.
+ *
+ * For a clamped 255-bit scalar, q is at most 7 (since maxScalar / n < 8),
+ * so the second term is computed with at most one extra scalar multiplication.
+ */
+export declare function scalarMultFull(point: InstanceType<typeof ed25519.Point>, scalar: bigint): InstanceType<typeof ed25519.Point>;
+/** Interpret a little-endian byte array as an unsigned BigInt. */
+export declare function bytesToBigIntLE(bytes: Uint8Array): bigint;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/client/crypto/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/client/crypto/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AASnD,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAKjD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAU/D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAIxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAQ3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,UAAU,EAC1B,eAAe,EAAE,UAAU,GAC1B,UAAU,CA4BZ;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,EACzC,MAAM,EAAE,MAAM,GACb,YAAY,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAgBpC;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMzD"}

package/dist/client/crypto/primitives.js

@@ -0,0 +1,116 @@
+import { createSign, createVerify, createHash, randomBytes } from "node:crypto";
+import { ed25519 } from "@noble/curves/ed25519.js";
+const CURVE25519_KEY_SIZE = 32;
+const CLAMP_MASK_LOW = 248;
+const CLAMP_MASK_HIGH = 127;
+const CLAMP_HIGH_BIT = 64;
+const SHARED_SIGN_BIT = 0x80;
+const PRIVATE_KEY_TOP_MASK = 0x7f;
+/** Clamp a Curve25519 scalar in-place (required before scalar multiplication). */
+export function clampScalar(key) {
+    if (key.length < CURVE25519_KEY_SIZE)
+        return;
+    key[0] = (key[0] ?? 0) & CLAMP_MASK_LOW;
+    key[CURVE25519_KEY_SIZE - 1] =
+        ((key[CURVE25519_KEY_SIZE - 1] ?? 0) & CLAMP_MASK_HIGH) | CLAMP_HIGH_BIT;
+}
+/**
+ * Generate an ephemeral Ed25519 key pair for the TS3 handshake.
+ * Returns [publicKey (32 bytes, RFC-8032 encoded), privateKey (32 bytes)].
+ */
+export function generateTemporaryKey() {
+    const privateKey = new Uint8Array(randomBytes(CURVE25519_KEY_SIZE));
+    clampScalar(privateKey);
+    // Base point G is in the prime-order subgroup, so G*s = G*(s mod n).
+    // Safe to reduce here since G has no small-order component.
+    const scalar = bytesToBigIntLE(privateKey) % ed25519.Point.CURVE().n;
+    const publicKey = ed25519.Point.BASE.multiply(scalar).toBytes();
+    return [publicKey, Uint8Array.from(privateKey)];
+}
+/**
+ * Sign data with a P-256 private key (SHA-256 hash, ASN.1 DER encoded).
+ */
+export function sign(privateKey, data) {
+    const signer = createSign("SHA256");
+    signer.update(data);
+    return signer.sign(privateKey);
+}
+/**
+ * Verify a P-256 ECDSA signature (SHA-256 hash, ASN.1 DER encoded).
+ */
+export function verifySign(publicKey, data, sig) {
+    try {
+        const verifier = createVerify("SHA256");
+        verifier.update(data);
+        return verifier.verify(publicKey, Buffer.from(sig));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * TS3-specific shared secret derivation using Ed25519 point arithmetic.
+ * Mirrors NaCl's ge_scalarmult_vartime:
+ *   1. Negate the public point
+ *   2. Scalar-multiply by clamped private key bytes (NOT reduced mod n)
+ *   3. Flip sign bit of result
+ *   4. SHA-512 the resulting point bytes
+ *
+ * The scalar must NOT be reduced mod n: Ed25519 has cofactor 8, so the server's
+ * public key may have a small-order component, and P*s ≠ P*(s mod n) in that case.
+ * We use scalarMultFull to handle scalars >= n without losing the cofactor term.
+ */
+export function getSharedSecret2(publicKeyBytes, privateKeyBytes) {
+    if (publicKeyBytes.length !== CURVE25519_KEY_SIZE ||
+        privateKeyBytes.length !== CURVE25519_KEY_SIZE) {
+        throw new Error("invalid key length");
+    }
+    const privCopy = Uint8Array.from(privateKeyBytes);
+    privCopy[CURVE25519_KEY_SIZE - 1] =
+        (privCopy[CURVE25519_KEY_SIZE - 1] ?? 0) & PRIVATE_KEY_TOP_MASK;
+    // Use raw scalar WITHOUT reducing mod n — matches NaCl's ge_scalarmult_vartime.
+    // Ed25519 has cofactor 8, so P*s ≠ P*(s mod n) when P has a small-order component.
+    // Since @noble/curves rejects scalars >= n, we decompose: P*s = P*(s%n) + (P*n)*q
+    const rawScalar = bytesToBigIntLE(privCopy);
+    const pub = ed25519.Point.fromBytes(publicKeyBytes);
+    const negPub = pub.negate();
+    const sharedPoint = scalarMultFull(negPub, rawScalar);
+    const sharedBytes = sharedPoint.toBytes();
+    // Flip sign bit (mirrors Go: shared[31] ^= 0x80)
+    sharedBytes[CURVE25519_KEY_SIZE - 1] =
+        (sharedBytes[CURVE25519_KEY_SIZE - 1] ?? 0) ^ SHARED_SIGN_BIT;
+    return createHash("sha512").update(sharedBytes).digest();
+}
+// ---- Internal ---------------------------------------------------------------
+/**
+ * Multiply an Ed25519 point by a scalar that may be >= curve order n.
+ * Decomposes as: P*s = P*(s mod n) + (P*n)*q  where q = floor(s/n).
+ * This preserves the small-order component (cofactor 8) that would be
+ * lost by reducing mod n first.
+ *
+ * For a clamped 255-bit scalar, q is at most 7 (since maxScalar / n < 8),
+ * so the second term is computed with at most one extra scalar multiplication.
+ */
+export function scalarMultFull(point, scalar) {
+    const n = ed25519.Point.CURVE().n;
+    if (scalar < n) {
+        return scalar === 0n ? ed25519.Point.ZERO : point.multiply(scalar);
+    }
+    const remainder = scalar % n;
+    const quotient = scalar / n; // integer division, 1 <= quotient <= 7 for clamped scalars
+    // P * (s mod n)
+    const mainPart = remainder === 0n ? ed25519.Point.ZERO : point.multiply(remainder);
+    // (P * n) * q — compute P*n via P*(n-1)+P since multiply() rejects scalar == n
+    const pointTimesN = point.multiply(n - 1n).add(point);
+    const cofactorPart = pointTimesN.multiply(quotient);
+    return mainPart.add(cofactorPart);
+}
+/** Interpret a little-endian byte array as an unsigned BigInt. */
+export function bytesToBigIntLE(bytes) {
+    let result = 0n;
+    for (let i = bytes.length - 1; i >= 0; i--) {
+        result = (result << 8n) | BigInt(bytes[i]);
+    }
+    return result;
+}
+//# sourceMappingURL=primitives.js.map

package/dist/client/crypto/primitives.js.map

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

package/dist/client/diagnostics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Diagnostics channels: the SDK's tracing points, for an application or an
+ * APM agent (OpenTelemetry instruments `diagnostics_channel` directly) to
+ * subscribe to.
+ *
+ * A library does not decide where its traces go, so the SDK publishes them
+ * here, and with no subscriber a channel costs a property read.
+ *
+ * Messages carry the command's name, never its parameters: those hold
+ * password hashes, which the server accepts as passwords, and privilege keys.
+ *
+ * ```ts
+ * import { tracingChannel } from "node:diagnostics_channel";
+ *
+ * tracingChannel("honeybbq:teamspeak:command").subscribe({
+ *   start: ({ command }) => console.time(command),
+ *   asyncEnd: ({ command }) => console.timeEnd(command),
+ *   error: ({ command, error }) => console.error(command, error),
+ * });
+ * ```
+ */
+import { type Channel, type TracingChannel } from "node:diagnostics_channel";
+import type { Client } from "./client.js";
+/** What `honeybbq:teamspeak:command` reports about a command. */
+export interface CommandTrace {
+    /** The command's name, such as `clientlist`. */
+    readonly command: string;
+    /** The client sending it. Its fields are private, so it carries no secret. */
+    readonly client: Client;
+}
+/** What `honeybbq:teamspeak:incoming` reports about a command arriving from the server. */
+export interface IncomingTrace {
+    /** The command's name, such as `notifytextmessage`, or `""` for a data row. */
+    readonly command: string;
+    /** The client receiving it. */
+    readonly client: Client;
+}
+/**
+ * Traces every command with an answer: `start` when it is sent, `asyncEnd`
+ * when its answer arrives, `error` when it fails.
+ */
+export declare const commandChannel: TracingChannel<CommandTrace>;
+/** Publishes every command the server sends. */
+export declare const incomingChannel: Channel<IncomingTrace>;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/client/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,YAAY,CAEvD,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,eAAe,EAAE,OAAO,CAAC,aAAa,CAElD,CAAC"}

package/dist/client/diagnostics.js

@@ -0,0 +1,30 @@
+/**
+ * Diagnostics channels: the SDK's tracing points, for an application or an
+ * APM agent (OpenTelemetry instruments `diagnostics_channel` directly) to
+ * subscribe to.
+ *
+ * A library does not decide where its traces go, so the SDK publishes them
+ * here, and with no subscriber a channel costs a property read.
+ *
+ * Messages carry the command's name, never its parameters: those hold
+ * password hashes, which the server accepts as passwords, and privilege keys.
+ *
+ * ```ts
+ * import { tracingChannel } from "node:diagnostics_channel";
+ *
+ * tracingChannel("honeybbq:teamspeak:command").subscribe({
+ *   start: ({ command }) => console.time(command),
+ *   asyncEnd: ({ command }) => console.timeEnd(command),
+ *   error: ({ command, error }) => console.error(command, error),
+ * });
+ * ```
+ */
+import { channel, tracingChannel, } from "node:diagnostics_channel";
+/**
+ * Traces every command with an answer: `start` when it is sent, `asyncEnd`
+ * when its answer arrives, `error` when it fails.
+ */
+export const commandChannel = tracingChannel("honeybbq:teamspeak:command");
+/** Publishes every command the server sends. */
+export const incomingChannel = channel("honeybbq:teamspeak:incoming");
+//# sourceMappingURL=diagnostics.js.map

package/dist/client/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/client/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,OAAO,EACP,cAAc,GAGf,MAAM,0BAA0B,CAAC;AAmBlC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiC,cAAc,CACxE,4BAA4B,CAC7B,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAA2B,OAAO,CAC5D,6BAA6B,CAC9B,CAAC"}

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

@@ -0,0 +1,2 @@
+export { Resolver } from "./resolver.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/discovery/index.js

@@ -0,0 +1,2 @@
+export { Resolver } from "./resolver.js";
+//# sourceMappingURL=index.js.map

package/dist/client/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/client/discovery/resolver.d.ts

@@ -0,0 +1,26 @@
+import type { ResolvedAddr } from "../types.js";
+/**
+ * The most a TSDNS server or the nickname service is read for. Either answers
+ * with one short line; without a bound, one that kept sending would be held in
+ * memory until the resolution budget ran out.
+ */
+export declare const MAX_DISCOVERY_RESPONSE: number;
+/** How the default resolver resolves. */
+export interface ResolverOptions {
+    /** Look dot-less names up at named.myteamspeak.com; off by default. */
+    readonly nicknameLookup?: boolean | undefined;
+}
+export declare class Resolver {
+    #private;
+    constructor(options?: ResolverOptions);
+    /**
+     * Resolve as the TeamSpeak application does: a server nickname (only with
+     * `nicknameLookup`), then SRV, then TSDNS, then the address as given. The
+     * whole resolution is bounded: past the budget, or when a step fails, the
+     * address as given is the answer.
+     */
+    resolve(inputAddr: string, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<ResolvedAddr[]>;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/client/discovery/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/client/discovery/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkBhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAiB,CAAC;AAEvD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,qBAAa,QAAQ;;IAInB,YAAY,OAAO,GAAE,eAAoB,EAExC;IAED;;;;;OAKG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAO,GAC1D,OAAO,CAAC,YAAY,EAAE,CAAC,CAYzB;CAgHF"}

package/dist/client/discovery/resolver.js

@@ -0,0 +1,275 @@
+import { resolveSrv } from "node:dns/promises";
+import { createConnection } from "node:net";
+import { isIpAddress, joinHostPort, splitHostPort } from "../address.js";
+import { abortable } from "../abort.js";
+import { InvalidAddressError } from "../errors.js";
+const TS_DNS_DEFAULT_PORT = 41144;
+const NICKNAME_LOOKUP_URL = "https://named.myteamspeak.com/lookup";
+const CACHE_TTL_MS = 10 * 60 * 1000;
+/**
+ * How long resolution may take in all; past it, the address is used as given.
+ * A Client holds any resolver, its own or a custom one, to the same budget.
+ *
+ * @internal
+ */
+export const RESOLVE_BUDGET_MS = 10_000;
+/** How long one TSDNS server may take to answer. */
+const TSDNS_TIMEOUT_MS = 3_000;
+/**
+ * The most a TSDNS server or the nickname service is read for. Either answers
+ * with one short line; without a bound, one that kept sending would be held in
+ * memory until the resolution budget ran out.
+ */
+export const MAX_DISCOVERY_RESPONSE = 8 * 1024;
+export class Resolver {
+    #cache = new Map();
+    #nicknameLookup;
+    constructor(options = {}) {
+        this.#nicknameLookup = options.nicknameLookup ?? false;
+    }
+    /**
+     * Resolve as the TeamSpeak application does: a server nickname (only with
+     * `nicknameLookup`), then SRV, then TSDNS, then the address as given. The
+     * whole resolution is bounded: past the budget, or when a step fails, the
+     * address as given is the answer.
+     */
+    async resolve(inputAddr, options = {}) {
+        if (!inputAddr)
+            throw new InvalidAddressError(inputAddr, "empty address");
+        const budget = AbortSignal.timeout(RESOLVE_BUDGET_MS);
+        const signal = options.signal ? AbortSignal.any([options.signal, budget]) : budget;
+        try {
+            return await this.#resolve(inputAddr, signal, true);
+        }
+        catch (error) {
+            options.signal?.throwIfAborted();
+            if (!budget.aborted)
+                throw error;
+            const { host, port } = splitHostPort(inputAddr);
+            return [{ addr: joinHostPort(host, port), source: "Direct" }];
+        }
+    }
+    async #resolve(inputAddr, signal, nicknames) {
+        const cached = this.#getValidCache(inputAddr);
+        if (cached)
+            return cached;
+        const { host, port } = splitHostPort(inputAddr);
+        if (isIpAddress(host)) {
+            return [{ addr: joinHostPort(host, port), source: "Direct" }];
+        }
+        // A dot-less name may be a server nickname, which only the TeamSpeak
+        // service can answer: asking it sends the name to a third party, so it is
+        // opt-in. Otherwise the name is resolved like any host.
+        if (nicknames && this.#nicknameLookup && !host.includes(".") && host !== "localhost") {
+            const nickAddr = await resolveNickname(host, signal);
+            signal.throwIfAborted();
+            if (nickAddr)
+                return this.#resolve(nickAddr, signal, false);
+        }
+        // SRV _ts3._udp.<host>
+        const srvResults = await this.#resolveSRV(host, signal);
+        if (srvResults)
+            return this.#setCache(inputAddr, srvResults);
+        const domainList = getDomainList(host);
+        // TSDNS via SRV _tsdns._tcp.<domain>
+        const tsdnsSrv = await this.#resolveTSDNSSRV(domainList, host, signal);
+        if (tsdnsSrv) {
+            return this.#setCache(inputAddr, [{ addr: tsdnsSrv, source: "TSDNS-SRV" }]);
+        }
+        // TSDNS direct :41144
+        const tsdnsDirect = await this.#resolveTSDNSDirect(domainList, host, signal);
+        if (tsdnsDirect) {
+            return this.#setCache(inputAddr, [{ addr: tsdnsDirect, source: "TSDNS-Direct" }]);
+        }
+        signal.throwIfAborted();
+        // Plain DNS fallback
+        const fallback = [{ addr: joinHostPort(host, port), source: "Direct" }];
+        return this.#setCache(inputAddr, fallback);
+    }
+    #getValidCache(inputAddr) {
+        const cached = this.#cache.get(inputAddr);
+        if (!cached || cached.length === 0)
+            return null;
+        const first = cached[0];
+        if (first.expiry !== undefined && Date.now() > first.expiry.getTime())
+            return null;
+        return cached;
+    }
+    #setCache(key, results) {
+        const expiry = new Date(Date.now() + CACHE_TTL_MS);
+        const withExpiry = results.map((r) => ({ ...r, expiry }));
+        this.#cache.set(key, withExpiry);
+        return withExpiry;
+    }
+    async #resolveSRV(host, signal) {
+        try {
+            const srvs = await abortable(resolveSrv(`_ts3._udp.${host}`), signal);
+            if (!srvs || srvs.length === 0)
+                return null;
+            return orderSrvRecords(srvs).map((srv) => ({
+                addr: joinHostPort(srv.name.replace(/\.$/, ""), String(srv.port)),
+                source: "SRV",
+            }));
+        }
+        catch {
+            return null;
+        }
+    }
+    async #resolveTSDNSSRV(domains, queryHost, signal) {
+        for (const domain of domains) {
+            try {
+                const srvs = await abortable(resolveSrv(`_tsdns._tcp.${domain}`), signal);
+                if (!srvs || srvs.length === 0)
+                    continue;
+                for (const srv of orderSrvRecords(srvs)) {
+                    const tsdnsAddr = joinHostPort(srv.name.replace(/\.$/, ""), String(srv.port));
+                    const result = await queryTSDNS(tsdnsAddr, queryHost, signal);
+                    if (result)
+                        return result;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    async #resolveTSDNSDirect(domains, queryHost, signal) {
+        // Asked at once rather than in turn, so the probes cost one timeout in
+        // all; the most specific domain's answer wins.
+        const answers = await Promise.all(domains.map((domain) => queryTSDNS(joinHostPort(domain, String(TS_DNS_DEFAULT_PORT)), queryHost, signal)));
+        return answers.find((answer) => answer !== null) ?? null;
+    }
+}
+/**
+ * Put SRV records in the order RFC 2782 has a client try them: by priority,
+ * lowest first, and within a priority by weighted random selection, so a
+ * record of weight 2 is first twice as often as one of weight 1. Records of
+ * weight 0 follow the others of their priority, in the order given. Node's
+ * `resolveSrv` returns the records unsorted.
+ *
+ * @param random Returns a number in [0, 1); injected to make the order testable.
+ * @internal
+ */
+export function orderSrvRecords(records, random = Math.random) {
+    const byPriority = new Map();
+    for (const record of records) {
+        const group = byPriority.get(record.priority);
+        if (group)
+            group.push(record);
+        else
+            byPriority.set(record.priority, [record]);
+    }
+    const ordered = [];
+    for (const priority of [...byPriority.keys()].sort((a, b) => a - b)) {
+        const group = byPriority.get(priority);
+        const weighted = group.filter((r) => r.weight > 0);
+        const unweighted = group.filter((r) => r.weight <= 0);
+        let sum = weighted.reduce((total, r) => total + r.weight, 0);
+        while (weighted.length > 0) {
+            const target = random() * sum;
+            let running = 0;
+            let pick = weighted.length - 1;
+            for (let i = 0; i < weighted.length; i++) {
+                running += weighted[i].weight;
+                if (running > target) {
+                    pick = i;
+                    break;
+                }
+            }
+            const [chosen] = weighted.splice(pick, 1);
+            ordered.push(chosen);
+            sum -= chosen.weight;
+        }
+        ordered.push(...unweighted);
+    }
+    return ordered;
+}
+/** @internal Ask the nickname service for `nickname`'s address. */
+export async function resolveNickname(nickname, signal) {
+    try {
+        const url = new URL(NICKNAME_LOOKUP_URL);
+        url.searchParams.set("name", nickname);
+        const init = signal ? { signal } : {};
+        const resp = await fetch(url.toString(), init);
+        if (!resp.ok)
+            return null;
+        const text = await readLimited(resp, MAX_DISCOVERY_RESPONSE);
+        const line = text.split("\n")[0]?.trim();
+        return line || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A response body's first `limit` bytes, as text; the rest is not read. */
+async function readLimited(resp, limit) {
+    if (resp.body === null)
+        return "";
+    const reader = resp.body.getReader();
+    const chunks = [];
+    let size = 0;
+    try {
+        while (size < limit) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const part = value.subarray(0, limit - size);
+            chunks.push(part);
+            size += part.length;
+        }
+    }
+    finally {
+        reader.cancel().catch(() => { });
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+/** @internal Ask the TSDNS server at `tsdnsAddr` for `queryHost`'s address. */
+export function queryTSDNS(tsdnsAddr, queryHost, signal) {
+    const [host, portStr] = splitHostPortParts(tsdnsAddr);
+    const port = parseInt(portStr, 10);
+    return new Promise((resolve) => {
+        if (signal?.aborted)
+            return resolve(null);
+        const finish = (answer) => {
+            clearTimeout(timeout);
+            signal?.removeEventListener("abort", onAbort);
+            socket.destroy();
+            resolve(answer);
+        };
+        const onAbort = () => finish(null);
+        const timeout = setTimeout(() => finish(null), TSDNS_TIMEOUT_MS);
+        const socket = createConnection({ host, port, timeout: 2_000 }, () => {
+            socket.write(`${queryHost}\n`);
+        });
+        let buf = "";
+        socket.on("data", (chunk) => {
+            buf += chunk.toString("latin1");
+            const idx = buf.indexOf("\n");
+            if (idx >= 0 && idx < MAX_DISCOVERY_RESPONSE) {
+                const line = Buffer.from(buf.slice(0, idx), "latin1").toString("utf8").trim();
+                finish(!line || line === "404" || line === "errors" ? null : line);
+            }
+            else if (buf.length >= MAX_DISCOVERY_RESPONSE) {
+                // No answer is that long.
+                finish(null);
+            }
+        });
+        socket.on("error", () => finish(null));
+        socket.on("timeout", () => finish(null));
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function splitHostPortParts(addr) {
+    const { host, port } = splitHostPort(addr);
+    return [host, port];
+}
+function getDomainList(host) {
+    const parts = host.split(".");
+    const list = [];
+    for (let i = 0; i < parts.length - 1; i++) {
+        list.push(parts.slice(i).join("."));
+    }
+    return list.slice(0, 3);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/client/discovery/resolver.js.map

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