@honeybbq/teamspeak-client 0.3.1 → 1.0.0-beta.1

package/dist/client.d.ts

@@ -1,47 +1,180 @@
-import { type EventMap, type ClientOptions, type CommandMiddleware, type EventMiddleware, type Logger, ClientStatus } from "./types.js";
-import { Identity, Crypt } from "./crypto/index.js";
-import { PacketHandler } from "./transport/handler.js";
-import type { FileUploadInfo, FileDownloadInfo } from "./types.js";
+import { type EventMap, type ClientOptions, type Listener, type Unsubscribe, ClientStatus } from "./types.js";
+import { type ChannelID, type ClientID, type Codec, type CommandOptions, type UID } from "@honeybbq/teamspeak-core";
+import { Identity } from "./crypto/index.js";
+import type { CommandExecutor, CommandRequest } from "@honeybbq/teamspeak-core";
+import type { FileUploadInfo, FileDownloadInfo } from "@honeybbq/teamspeak-core";
 import type { Readable, Writable } from "node:stream";
+import { type ServerCapabilities } from "./capabilities.js";
 export { ClientStatus };
-export interface ClientState {
-    status: ClientStatus;
-    clid: number;
+/**
+ * What clientinit sends about the connection, with the passwords already in
+ * their wire form, `base64(sha1(password))`: hashed once, when the client is
+ * made, so the plain text is never held.
+ */
+export interface ClientInitOptions {
+    readonly serverPasswordHash: string;
+    readonly defaultChannel: string;
+    readonly defaultChannelPasswordHash: string;
 }
-export declare class Client {
+/**
+ * A TeamSpeak client over the voice protocol.
+ *
+ * Listeners run one at a time, in the order their events arrived, after the
+ * packet that carried them has been handled, so a listener may call the client
+ * and await an answer.
+ */
+export declare class Client implements CommandExecutor, AsyncDisposable {
     #private;
-    /** @internal */ crypt: Crypt;
-    /** @internal */ handler: PacketHandler;
-    /** @internal */ logger: Logger;
-    /** @internal */ nickname: string;
-    /** @internal */ clid: number;
     constructor(identity: Identity, addr: string, nickname: string, options?: ClientOptions);
+    /** Where the client is in its connection's life. */
     get status(): ClientStatus;
-    /** @internal */
-    getClientInitOptions(): Readonly<{
-        serverPassword: string;
-        defaultChannel: string;
-        defaultChannelPassword: string;
-    }>;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    waitConnected(signal?: AbortSignal): Promise<void>;
-    sendCommandNoWait(cmd: string): Promise<void>;
-    execCommand(cmd: string, timeoutMs?: number): Promise<void>;
-    execCommandWithResponse(cmd: string, timeoutMs?: number): Promise<Record<string, string>[]>;
-    on<K extends keyof EventMap>(event: K, handler: EventMap[K] extends void ? () => void : (payload: EventMap[K]) => void): this;
-    useCommandMiddleware(...mw: CommandMiddleware[]): this;
-    useEventMiddleware(...mw: EventMiddleware[]): this;
-    clientID(): number;
-    channelID(): bigint;
-    /** Send Opus voice directly to specific clients, bypassing channel routing. */
-    sendWhisper(data: Uint8Array, targetClientIds: number[], codec: number): void;
-    sendVoice(data: Uint8Array, codec: number): void;
-    fileTransferInitUpload(channelID: bigint, path: string, password: string, size: bigint, overwrite?: boolean): Promise<FileUploadInfo>;
-    fileTransferInitDownload(channelID: bigint, path: string, password: string): Promise<FileDownloadInfo>;
-    uploadFileData(host: string, info: FileUploadInfo, data: Readable): Promise<void>;
-    downloadFileData(host: string, info: FileDownloadInfo, dest: Writable): Promise<void>;
-    /** @internal */
-    _markConnected(): void;
+    /**
+     * Connect to the server. Resolves once the handshake completes.
+     *
+     * An address that cannot be one — no host, a port outside 1–65535 — rejects
+     * with an InvalidAddressError at once, before anything starts. A host name
+     * that does not resolve fails the attempt with a TeamspeakError whose
+     * `cause` is the lookup's error.
+     *
+     * A failed attempt rejects with its cause, such as the server's error for a
+     * rejected password. Aborting `signal` abandons the attempt and rejects with
+     * the signal's reason. The signal bounds only the connecting: once this
+     * resolves, the connection lasts until `disconnect()` or a drop.
+     * `connect()` does not retry; the `reconnect` option only retries a
+     * connection that drops after it was established.
+     *
+     * Called while a `disconnect()` is still saying goodbye, or while an earlier
+     * session's `disconnected` is still waiting to be delivered, this waits for
+     * that first, so the old session is closed, and its `disconnected`
+     * delivered, before the new one starts: no listener or `events()` iterator
+     * of the new session hears the old one end. A `disconnect()` called during
+     * that wait wins: this then rejects with a NotConnectedError.
+     *
+     * `connected` is delivered after this resolves, so a listener added right
+     * after `await client.connect()` still hears it.
+     */
+    connect(options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /**
+     * Leave the server and close the connection.
+     *
+     * Says goodbye first, waiting for the server's acknowledgement for a second
+     * at most, or less if `signal` aborts sooner. The connection is closed
+     * either way. A `connect()` still waiting for its handshake rejects with a
+     * NotConnectedError, and so do the commands still waiting for an answer.
+     * Resolves once `disconnected` has been delivered to the listeners, so one
+     * added after `await client.disconnect()` does not hear it. Does nothing on
+     * a client that is not connected; called again while an earlier call is
+     * still saying goodbye, it waits for that one.
+     */
+    disconnect(options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /** `await using client = …` disconnects when the scope ends. */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Send a raw command line and return the rows that answer it: the escape
+     * hatch for a command the typed functions do not cover. The line is sent as
+     * given, so its values must already be escaped and any channel password
+     * already hashed.
+     *
+     * Rejects with a NotConnectedError unless the client is connected: while it
+     * is still connecting, the session's keys may not exist yet.
+     */
+    exec(command: string, options?: CommandOptions): Promise<Record<string, string>[]>;
+    /**
+     * Send a raw command line without waiting for an answer, for the few
+     * commands the server answers with nothing at all.
+     *
+     * Commands are paced by a flood throttle; aborting `signal` while this waits
+     * for its turn rejects with the signal's reason and sends nothing. Rejects
+     * with a NotConnectedError unless the client is connected.
+     */
+    execNoWait(command: string, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /**
+     * Send a typed command; this is the CommandExecutor the typed commands run on.
+     *
+     * The request passes through the `commandMiddleware` first. Channel
+     * passwords are then hashed, because that is this protocol's rule: the voice
+     * protocol expects `base64(sha1(password))`, where ServerQuery takes the
+     * password itself.
+     */
+    send(request: CommandRequest, options?: CommandOptions): Promise<Record<string, string>[]>;
+    /**
+     * Listen for an event. Returns a function that removes the listener.
+     *
+     * A listener that throws does not stop the others: the rest of the event's
+     * listeners, and the events after it, are still delivered, and the exception
+     * is rethrown on its own, from a microtask, so it surfaces as an
+     * `uncaughtException` just as an EventEmitter listener's would. An async
+     * listener's rejection is not caught, and surfaces as an unhandled
+     * rejection.
+     */
+    on<K extends keyof EventMap>(event: K, listener: Listener<K>): Unsubscribe;
+    /** Listen for the next occurrence of an event only. */
+    once<K extends keyof EventMap>(event: K, listener: Listener<K>): Unsubscribe;
+    /**
+     * An event as an async iterator, for `for await`:
+     *
+     * ```ts
+     * for await (const message of client.events("textMessage", { signal })) { … }
+     * ```
+     *
+     * Events that arrive while the loop body runs are buffered, so none is
+     * missed — except voice, of which at most 256 frames are buffered; the rest
+     * are dropped, as for a listener that falls behind. Iteration ends when
+     * `signal` aborts, when the loop exits early (`break`, `return`, a throw),
+     * and — for every event but `disconnected` — when the client disconnects.
+     * An abort stops listening at once and discards whatever is buffered.
+     */
+    events<K extends keyof EventMap>(event: K, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): AsyncIterableIterator<EventMap[K]>;
+    /** This client's id on the server, assigned in the handshake; 0 before it. */
+    get clientID(): ClientID;
+    /**
+     * What the connected server is: version, generation, and the uid hash it
+     * uses. Read from `initserver`; before connecting the family is `unknown`
+     * and the uid hash SHA-1.
+     */
+    get serverCapabilities(): ServerCapabilities;
+    /**
+     * Our own `client_unique_identifier`, hashed with the algorithm the connected
+     * server uses.
+     *
+     * TS3 uses SHA-1 and TS6 SHA-256, so this reads the algorithm learned during
+     * initserver rather than assuming one. Comparing a hard-coded SHA-1 UID to a
+     * TS6 server silently never matches.
+     */
+    get uid(): UID;
+    /** The channel this client is in, as it last learned; 0 before connecting. */
+    get channelID(): ChannelID;
+    /**
+     * Send Opus voice directly to specific clients, bypassing channel routing.
+     * Throws a NotConnectedError unless the client is connected.
+     */
+    sendWhisper(data: Uint8Array, targetClientIDs: readonly ClientID[], codec: Codec): void;
+    /**
+     * Send one encoded audio frame to the channel this client is in. Throws a
+     * NotConnectedError unless the client is connected.
+     */
+    sendVoice(data: Uint8Array, codec: Codec): void;
+    /**
+     * Upload `data` over a negotiated transfer, through the client's
+     * `fileTransferSocketFactory` if it has one.
+     */
+    uploadFileData(host: string, info: FileUploadInfo, data: Readable, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    /**
+     * Download a negotiated transfer into `dest`, through the client's
+     * `fileTransferSocketFactory` if it has one.
+     */
+    downloadFileData(host: string, info: FileDownloadInfo, dest: Writable, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<void>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/commands.d.ts

@@ -1,48 +1,66 @@
+import type { ResponseSpec } from "@honeybbq/teamspeak-core/internal";
 export interface CommandResult {
     err: Error | null;
     data: Record<string, string>[];
 }
 /**
- * Tracks in-flight commands by return_code.
+ * Matches the server's answers to the commands that asked for them.
  *
- * The TS3/TS5 server sends a "welcome sequence" of unsolicited data immediately
- * after the connection handshake (channellist, channelclientlist, etc.). This
- * data arrives on the event loop AFTER we may have registered our first pending
- * RC, which would contaminate our command responses.
+ * The server handles one client's commands in order and closes each answer
+ * with `error … return_code=N`, so every row seen since the previous `error`
+ * belongs to command N. Rows are therefore held, tagged with where they came
+ * from, until that `error` says whose they are — attributing them on arrival
+ * would mean guessing which in-flight command the server is answering, and a
+ * command can be registered here well before it is sent (it first waits on the
+ * throttle and the middleware chain).
  *
- * Solution: gate all row buffering on a `#welcomeComplete` flag. The flag is
- * set when `notifycliententerview` for our own clid arrives — the last event
- * the TS3/TS5 server sends in its welcome sequence. Any data arriving before
- * that is silently discarded.
+ * A nameless row always belongs to the command. A notification row belongs to
+ * it only if the command declared that notification as its answer (see
+ * command/responses.ts): the same `notifyclientmoved` that answers nothing can
+ * arrive between any two commands.
+ *
+ * The welcome sequence is the exception. The server pushes channellist,
+ * channelgrouplist and the rest unprompted right after the handshake, before
+ * `channellistfinished`; without the gate they would land in the first
+ * command's answer as duplicate rows and a phantom cid=0.
  */
 export declare class CommandTracker {
     #private;
-    register(): [rc: number, promise: Promise<CommandResult>];
+    /** @param ownClientID the client's clid, for answers filtered by invoker. */
+    constructor(ownClientID?: () => number);
+    register(spec?: ResponseSpec, correlation?: string): [rc: number, promise: Promise<CommandResult>];
     unregister(rc: number): void;
-    /**
-     * Called when `notifycliententerview` for our own clid arrives.
-     * Marks the welcome sequence as complete and discards any accumulated data.
-     */
+    /** Marks the end of the welcome sequence and drops what it left behind. */
     signalWelcomeComplete(): void;
+    /** Whether some in-flight command declared `name` as its answer. */
+    expects(name: string): boolean;
+    /** Hold a row until the next `error` says which command it answered. */
+    buffer(params: Record<string, string>, source?: string): void;
     /**
-     * Buffer a data row from the server. Rows arriving before the welcome
-     * sequence is complete are silently discarded to prevent contamination.
+     * Offer a notification to commands answered after their `error`.
+     *
+     * Matching is on the echoed request field, so it does not matter whether the
+     * notification beats the `error` or follows it.
      */
-    buffer(params: Record<string, string>): void;
+    offerCorrelated(name: string, params: Record<string, string>): void;
     resolve(rc: number, err: Error | null): void;
     discardBuffer(): void;
-    reset(): void;
+    /**
+     * Forget every command and fail it with `err`.
+     *
+     * Dropping them silently would leave each caller waiting out its full
+     * timeout for an answer that can no longer come.
+     */
+    reset(err: Error): void;
 }
 /**
- * Parse and handle an `error` command from the server.
- * Returns the error (or null on success) and the resolved return_code.
- */
-export declare function parseServerError(params: Record<string, string>): {
-    err: Error | null;
-    rc: number | null;
-};
-/**
- * Append a return_code parameter to a command string if not already present.
+ * Append the tracker's return_code to a command.
+ *
+ * The return_code belongs to the tracker: it is how an answer finds its
+ * command, so a caller-supplied one would detach the command from its answer.
+ * Checked as a parameter rather than as text, because a message body that
+ * merely contains "return_code=" used to suppress the real one and time the
+ * command out.
  */
 export declare function appendReturnCode(cmd: string, rc: number): string;
 //# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;;IAWzB,QAAQ,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAOxD;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED;;;OAGG;IACH,qBAAqB,IAAI,IAAI,CAG5B;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI3C;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAU3C;IAED,aAAa,IAAI,IAAI,CAEpB;IAED,KAAK,IAAI,IAAI,CAKZ;CACF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAChE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB,CAiBA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGhE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAChC;AAoBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;;IAOzB,6EAA6E;IAC7E,YAAY,WAAW,GAAE,MAAM,MAAgB,EAE9C;IAED,QAAQ,CACN,IAAI,CAAC,EAAE,YAAY,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAO/C;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,2EAA2E;IAC3E,qBAAqB,IAAI,IAAI,CAG5B;IAED,oEAAoE;IACpE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM7B;IAED,wEAAwE;IACxE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,SAAK,GAAG,IAAI,CAIxD;IAED;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBlE;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAkB3C;IAED,aAAa,IAAI,IAAI,CAEpB;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAOtB;CAaF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMhE"}

package/dist/crypto/crypt.d.ts

@@ -1,17 +1,32 @@
 import type { Identity } from "./identity.js";
+/**
+ * The most squarings the Init1 puzzle may ask for. TS3 3.13 and TS6 6.0 both
+ * ask for 10000; a level far beyond that is a server trying to pin the event
+ * loop, since the squarings run synchronously.
+ */
+export declare const MAX_RSA_CHALLENGE_LEVEL: number;
 export interface KeyNonce {
     key: Uint8Array;
     nonce: Uint8Array;
     gen: number;
 }
+/**
+ * A connection's encryption state. The session material — the IV the keys
+ * derive from — lives in private fields, so it shows in no `util.inspect()`
+ * or `JSON.stringify()` of anything holding a Crypt.
+ */
 export declare class Crypt {
     #private;
     readonly identity: Identity;
-    ivStruct: Uint8Array;
-    fakeSignature: Uint8Array;
-    alphaTmp: Uint8Array;
-    cryptoInitComplete: boolean;
     constructor(identity: Identity);
+    /** Whether the session keys are set up; until then packets use the dummy key. */
+    get cryptoInitComplete(): boolean;
+    /** The signature unencrypted packets carry: zeros until crypto init completes. */
+    get fakeSignature(): Uint8Array;
+    /** The client's random contribution to the IV, sent in clientinitiv; empty before. */
+    get alpha(): Uint8Array;
+    /** Choose the client's random contribution to the IV, and return it. */
+    newAlpha(): Uint8Array;
     solveRsaChallenge(data: Uint8Array, offset: number, level: number): Uint8Array;
     initCrypto(alpha: string, beta: string, omega: string): void;
     setSharedSecret(alpha: Uint8Array, beta: Uint8Array, sharedKey: Uint8Array): void;

package/dist/crypto/crypt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypt.d.ts","sourceRoot":"","sources":["../../src/crypto/crypt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW9C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,qBAAa,KAAK;;IAChB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,QAAQ,EAAE,UAAU,CAAqB;IACzC,aAAa,EAAE,UAAU,CAAuC;IAChE,QAAQ,EAAE,UAAU,CAAqB;IACzC,kBAAkB,UAAS;IAI3B,YAAY,QAAQ,EAAE,QAAQ,EAE7B;IAED,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAgB7E;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS3D;IAED,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,CAiBhF;IAED,WAAW,CACT,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CA6BtC;IAED,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAW3C;IAED,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,UAAU,CAeZ;CAyBF"}
+{"version":3,"file":"crypt.d.ts","sourceRoot":"","sources":["../../src/crypto/crypt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW9C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAgB,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;;GAIG;AACH,qBAAa,KAAK;;IAChB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAS5B,YAAY,QAAQ,EAAE,QAAQ,EAE7B;IAED,iFAAiF;IACjF,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,kFAAkF;IAClF,IAAI,aAAa,IAAI,UAAU,CAE9B;IAED,sFAAsF;IACtF,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED,wEAAwE;IACxE,QAAQ,IAAI,UAAU,CAGrB;IAED,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAiB7E;IAED,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAa3D;IAED,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,CAqBhF;IAED,WAAW,CACT,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAkCtC;IAED,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAW3C;IAED,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,UAAU,CAeZ;CAyBF"}

package/dist/crypto/identity.d.ts

@@ -1,16 +1,95 @@
 import { type KeyObject } from "node:crypto";
+import { type UID } from "@honeybbq/teamspeak-core";
+/**
+ * A TeamSpeak client identity: a P-256 key pair plus a counter, the offset,
+ * whose hash with the public key sets the identity's security level.
+ *
+ * Immutable: raising the level returns a new identity. Opaque: the private
+ * key is never exposed, and `toString()`, `toJSON()` and `util.inspect()`
+ * describe the identity without it, so an identity that reaches a log or an
+ * error message does not leak; `export()` is the one way to get the secret
+ * form, for storing it. Make one with `generateIdentity()` or
+ * `parseIdentity()`.
+ */
 export declare class Identity {
-    readonly privateKey: KeyObject;
-    offset: bigint;
-    constructor(privateKey: KeyObject, offset: bigint);
-    publicKeyBase64(): string;
+    #private;
+    private constructor();
+    /** The counter whose hash with the public key sets the security level. */
+    get offset(): bigint;
+    /** The public key in TeamSpeak's encoding: base64 of its DER form. */
+    publicKey(): string;
+    /**
+     * The identity's unique identifier, hashed with `algorithm`: SHA-1 for a
+     * TeamSpeak 3 server, SHA-256 for TeamSpeak 6. A connected client's `uid`
+     * already uses the one its server does.
+     */
+    uid(algorithm: UIDAlgorithm): UID;
+    /**
+     * The identity in the form `parseIdentity()` reads, private key included.
+     * Store it as you would a password.
+     */
+    export(): string;
+    /** Describes the identity, by its SHA-1 unique identifier, without its private key. */
     toString(): string;
+    /** The same as `toString()`, so serialising an identity cannot leak its key. */
+    toJSON(): string;
+    /** The security level: trailing zero bits in SHA-1 of the public key and offset. */
     securityLevel(): number;
-    upgradeToLevel(targetLevel: number, signal?: AbortSignal): Promise<void>;
+    /**
+     * The same key at an offset whose security level reaches `targetLevel`, as
+     * a new identity; this one is unchanged, and returned as it is when it
+     * already reaches the level.
+     *
+     * Each level doubles the expected work, so a high level can take a long
+     * time; `signal` bounds it, and the event loop keeps running meanwhile. A
+     * level above 160, the width of SHA-1, can never be reached and is refused
+     * with a RangeError.
+     */
+    upgradeToLevel(targetLevel: number, options?: {
+        readonly signal?: AbortSignal | undefined;
+    }): Promise<Identity>;
 }
-export declare function identityFromString(s: string): Identity;
-export declare function generateIdentity(targetLevel: number): Identity;
-export declare function getUidFromPublicKey(publicKey: string): string;
+/**
+ * Read an identity from the form `Identity.export()` writes: the private key
+ * as canonical base64 of at most 32 bytes, a colon, and the offset as a
+ * decimal unsigned 64-bit integer. Anything else throws an
+ * InvalidIdentityError, with the underlying failure as its cause.
+ */
+export declare function parseIdentity(s: string): Identity;
+/**
+ * Create an identity at the given security level, at most 160. Each level
+ * doubles the expected work; `signal` bounds it, and the event loop keeps
+ * running meanwhile.
+ */
+export declare function generateIdentity(targetLevel: number, options?: {
+    readonly signal?: AbortSignal | undefined;
+}): Promise<Identity>;
+/**
+ * Create an identity at the given security level, at most 160, blocking until
+ * done. Fine for a low level; a high one can block the event loop for minutes,
+ * so prefer `generateIdentity()` there.
+ */
+export declare function generateIdentitySync(targetLevel: number): Identity;
+/**
+ * The hash a server uses for `client_unique_identifier`, keyed by the server's
+ * major version.
+ *
+ * TeamSpeak 3 hashes the canonical public key with SHA-1 (20 bytes); TeamSpeak
+ * 6 switched to SHA-256 (32 bytes). The algorithm is not negotiable on the
+ * wire, so a client that guesses wrong computes a UID that matches nothing the
+ * server ever sends — self-identification by UID silently fails.
+ *
+ * May gain members in a minor release, should a server generation change the
+ * hash again: a `switch` over it needs a default case.
+ */
+export type UIDAlgorithm = "sha1" | "sha256";
+/** Pick the UID hash from a `virtualserver_version` string, e.g. "6.0.0-beta13.1". */
+export declare function uidAlgorithmForVersion(version: string): UIDAlgorithm;
+/**
+ * The unique identifier of a public key in TeamSpeak's encoding, hashed with
+ * `algorithm`: SHA-1 for a TeamSpeak 3 server, SHA-256 for TeamSpeak 6.
+ */
+export declare function uidFromPublicKey(publicKey: string, algorithm: UIDAlgorithm): UID;
 export declare function hash512(data: Uint8Array): Uint8Array;
 /** Import a TS3 public key (canonical or legacy ASN.1 DER) and return the
  *  uncompressed 65-byte point [0x04 || x || y]. */

package/dist/crypto/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/crypto/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAOrB,qBAAa,QAAQ;IACnB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAGhD;IAED,eAAe,IAAI,MAAM,CAiBxB;IAED,QAAQ,IAAI,MAAM,CAQjB;IAED,aAAa,IAAI,MAAM,CAKtB;IAEK,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7E;CACF;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CA+BtD;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAc9D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEpD;AA+BD;mDACmD;AACnD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAS3D"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/crypto/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAS,KAAK,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAY3D;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ;;IAUnB,OAAO,eAGN;IAED,0EAA0E;IAC1E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sEAAsE;IACtE,SAAS,IAAI,MAAM,CAUlB;IAED;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,YAAY,GAAG,GAAG,CAEhC;IAED;;;OAGG;IACH,MAAM,IAAI,MAAM,CAKf;IAED,uFAAuF;IACvF,QAAQ,IAAI,MAAM,CAEjB;IAED,gFAAgF;IAChF,MAAM,IAAI,MAAM,CAEf;IAED,oFAAoF;IACpF,aAAa,IAAI,MAAM,CAEtB;IAED;;;;;;;;;OASG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAO,GAC1D,OAAO,CAAC,QAAQ,CAAC,CAgBnB;CACF;AAqCD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CA0CjD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAO,GAC1D,OAAO,CAAC,QAAQ,CAAC,CAGnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAOlE;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAGpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,GAAG,CAEhF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAEpD;AA+BD;mDACmD;AACnD,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAS3D"}

package/dist/crypto/index.d.ts

@@ -1,4 +1,5 @@
-export { Identity, identityFromString, generateIdentity, getUidFromPublicKey, hash512, importPublicKey, } from "./identity.js";
+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";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/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/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:packet` reports about a command arriving from the server. */
+export interface PacketTrace {
+    /** 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 packetChannel: Channel<PacketTrace>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/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,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,+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,aAAa,EAAE,OAAO,CAAC,WAAW,CAE9C,CAAC"}

package/dist/discovery/resolver.d.ts

@@ -1,8 +1,26 @@
-import type { Logger } from "../types.js";
 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 resolveNicknames?: boolean | undefined;
+}
 export declare class Resolver {
     #private;
-    constructor(_log?: Logger);
-    resolve(inputAddr: string, signal?: AbortSignal): Promise<ResolvedAddr[]>;
+    constructor(options?: ResolverOptions);
+    /**
+     * Resolve as the TeamSpeak application does: a server nickname (only with
+     * `resolveNicknames`), 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/discovery/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/discovery/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhD,qBAAa,QAAQ;;IAGnB,YAAY,IAAI,GAAE,MAAmB,EAAI;IAEnC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA+C9E;CAgEF"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/discovery/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiBhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAiB,CAAC;AAEvD,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjD;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"}