@honeybbq/teamspeak 1.0.0-beta.13 → 1.0.0-beta.15

package/README.md

@@ -2,7 +2,7 @@
 
 # @honeybbq/teamspeak
 
-**A clean-room TeamSpeak client protocol library written in pure TypeScript.**
+**An independent TeamSpeak client protocol library written in pure TypeScript.**
 
 Works with TeamSpeak 3 and TeamSpeak 6 servers. No proprietary SDK, no copied code.
 
@@ -32,6 +32,7 @@ Upgrading from 0.x? The package was renamed; see the [migration guide](https://g
 - **Identity management** — Generate, import/export, and upgrade security level of identities
 - **Full command set** — 111 typed functions covering every command the voice protocol answers
 - **Reconnection** — Opt-in retry with backoff, tuned for TeamSpeak's antiflood ban
+- **Streams** — TeamSpeak 6 screen share signalling: find, publish and watch streams, with SDP and ICE as strings for any WebRTC stack (experimental)
 - **Server capabilities** — Reports the server version and the uid hash it uses (SHA-1 on TS3, SHA-256 on TS6), and the server's name, icon, banner and welcome message
 - **Custom transports** — Supply your own socket, for proxies, tunnels or tests
 - **ESM with types** — Ships ES modules with full TypeScript declarations
@@ -296,7 +297,25 @@ sends a raw command line and resolves to the rows that answer it.
 
 ### File Transfers
 
-Negotiate with the `files` module, then move the bytes over TCP:
+`uploadFile` and `downloadFile` (from `@honeybbq/teamspeak/client`) negotiate the
+transfer and move the bytes in one call, and `listFilesRecursive` (from the
+package) lists a directory and everything under it, each entry with its full path:
+
+```typescript
+import { downloadFile, uploadFile } from "@honeybbq/teamspeak/client";
+import { listFilesRecursive } from "@honeybbq/teamspeak";
+
+await uploadFile(client, cid, "/docs/notes.txt", data);
+const bytes = await downloadFile(client, cid, "/docs/notes.txt");
+const tree = await listFilesRecursive(client, cid, "/", { maxDepth: 4 });
+```
+
+They work over a voice `Client`, and over a `QueryClient` on raw TCP or SSH when
+passed the file transfer host as `{ host }`; WebQuery refuses every file command.
+`downloadFile` takes `{ dest }` to stream into a `Writable` instead of holding
+the file, and refuses a file over `maxSize` (256 MiB) in memory.
+
+To control the two halves, negotiate with the `files` module, then move the bytes over TCP:
 
 ```typescript
 import { Readable } from "node:stream";
@@ -530,6 +549,297 @@ The uid hash matters because TS3 hashes a client's public key with SHA-1 and TS6
 with SHA-256 — a client that assumes either one computes an identifier the other
 server never sends.
 
+### Streams (experimental)
+
+TeamSpeak 6 clients can share a screen, a window or a camera. `@honeybbq/teamspeak/stream`
+does the signalling of that: it finds the streams of the clients in view, publishes one,
+and watches one. The video itself travels between the publisher and each viewer over
+WebRTC, which is yours: `Streams` hands you the SDP and the ICE candidates as strings and
+takes them back, so any WebRTC stack plugs in, in a browser, in Electron or in Node. The
+package has no WebRTC dependency.
+
+TeamSpeak does not document this protocol. It was measured on TeamSpeak 6 6.0.0-beta13.1,
+and has not been tried against the native TeamSpeak 6 client yet, so every export is
+`@beta` and may change in a minor release. A TeamSpeak 3 server does not answer the stream
+commands at all, so `publish` and `watch` throw a `StreamsUnsupportedError` before sending
+anything.
+
+Watching: find a stream in `streams.list()` or wait for `started`, ask to watch it, and
+give the publisher's offer to a peer connection. The viewer's connection is receive-only.
+
+```ts
+import { Streams } from "@honeybbq/teamspeak/stream";
+
+const streams = new Streams(client);
+streams.on("started", (info) => console.log(`${info.name} is streaming`));
+
+const view = await streams.watch(info, { message: "may I watch?" });
+
+const pc = new RTCPeerConnection({ iceServers: [{ urls: "stun:stun.l.google.com:19302" }] });
+pc.ontrack = (event) => (video.srcObject = event.streams[0]);
+pc.onicecandidate = (event) => {
+  if (event.candidate) void view.sendCandidate(event.candidate.toJSON());
+};
+// Candidates that arrived with the offer are delivered to the first listener.
+view.on("candidate", (candidate) => void pc.addIceCandidate(candidate));
+view.on("closed", () => pc.close());
+
+await pc.setRemoteDescription({ type: "offer", sdp: view.offer });
+const answer = await pc.createAnswer();
+await pc.setLocalDescription(answer);
+await view.answer(answer.sdp!);
+```
+
+Publishing: the publisher makes the offer, one peer connection for each viewer. The server
+relays every request to watch, from any channel, and enforces neither `viewerLimit` nor
+`accessibility`: deciding who is let in is the publisher's job, and `request` is emitted
+for each one, with nothing accepted for you.
+
+```ts
+const stream = await streams.publish({ name: "My screen", source: "screen" });
+
+stream.on("request", async (request) => {
+  if (!allowed(request.viewer)) return request.deny("Not today");
+
+  const pc = new RTCPeerConnection({ iceServers });
+  for (const track of capture.getTracks()) pc.addTrack(track, capture);
+  await pc.setLocalDescription(await pc.createOffer());
+
+  const viewer = await request.accept(pc.localDescription!.sdp);
+  pc.onicecandidate = (event) => {
+    if (event.candidate) void viewer.sendCandidate(event.candidate.toJSON());
+  };
+  viewer.on("answer", (sdp) => pc.setRemoteDescription({ type: "answer", sdp }));
+  viewer.on("candidate", (candidate) => void pc.addIceCandidate(candidate));
+  viewer.on("closed", () => pc.close());
+});
+
+await stream.stop();
+```
+
+Things to know:
+
+- A client may run several streams, so every stream is known by its id. `list()` is what
+  this client has heard of. A stream that ends while its publisher is out of the channel is
+  reported to nobody there, and stays listed until the connection ends.
+- A stream survives its publisher changing channel, with no event. It ends when the
+  publisher stops it or disconnects.
+- The server drops a command line longer than about 9.2 KB without an answer. Streams
+  commands are checked first and throw a `StreamPayloadTooLargeError`; an SDP offer or an
+  ICE candidate is a few kilobytes at most.
+- The server lets anyone stop any stream. `Streams` sends `stopstream` only for streams it
+  published, and treats a `notifystreamstopped` for any stream as final.
+- The server remembers no decision, so a client can ask again, and every ask is relayed.
+  To refuse for good, pass `rememberDenied: true` (the 1024 most recent uids, in memory
+  only; a requester out of view is looked up with `clientgetuidfromclid`), or leave the
+  request unanswered. The server has no way to remove a viewer: closing a viewer's peer
+  ends your side of it, and stopping the stream ends it for everyone.
+- `dispose()` stops the streams published through that `Streams` and leaves the ones it
+  watched, while the client is connected. A stream whose `publish` gave up after the command
+  went out is stopped when its announcement arrives, so none is left running unseen.
+- A client whose `client_is_streaming` clears, or that comes into view not streaming, has
+  its streams dropped, after a grace of two seconds: `stopped` with the cause `"gone"`. The
+  server clears the flag right before it reports the stop, so a stop that arrives in that time
+  ends the stream with its own cause and reason instead, and a flag set again cancels the drop.
+- The bitrate the server reports for a stream is not the one requested.
+- A client announces that it streams only with `client_is_streaming`, and a stream that was
+  running before you came is not announced at all. `Streams` asks for the streams of each
+  client that sets the flag, once, on a TeamSpeak 6 server.
+
+## Design
+
+The conventions below hold across the whole package. Each is stated once here.
+
+### Errors
+
+An error is one of two kinds:
+
+- **A refusal the server reports.** It is a `ServerError` carrying the server's
+  numeric `code`, its text as `serverMessage`, and `extraMessage` and
+  `failedPermissionID` when the server names them.
+- **A condition the SDK detects itself**: not connected, no data, a timeout, a
+  failed handshake, a failed file transfer. Each has its own class.
+
+Every error the SDK throws on purpose extends `TeamspeakError`, so
+`instanceof TeamspeakError` tells its failures from anything else. A failure
+that wraps another keeps it in `cause`. Match a refusal by `error.code` against
+`ErrorCode`, and everything else by class:
+
+```typescript
+import {
+  ErrorCode,
+  NotConnectedError,
+  ServerError,
+  TeamspeakError,
+  asChannelID,
+  moveClient,
+} from "@honeybbq/teamspeak";
+
+try {
+  await moveClient(client, client.clientID, asChannelID(5), { password: "wrong" });
+} catch (err) {
+  if (err instanceof ServerError && err.code === ErrorCode.ChannelInvalidPassword) {
+    // ask for the password again
+  } else if (err instanceof NotConnectedError) {
+    // the connection is gone
+  } else if (err instanceof ServerError) {
+    console.log(err.code, err.serverMessage, err.extraMessage, err.failedPermissionID);
+  } else if (err instanceof TeamspeakError) {
+    console.log(err.name, err.message, err.cause);
+  } else {
+    throw err;
+  }
+}
+```
+
+`ErrorCode` names the server's codes as constants. It is the table `errcode`
+is in the Go SDK, with the same numbers. A server may send a code it does not
+name, so `code` is a plain `number`. `instanceof` also works between two
+installed copies of the package.
+
+Errors live with the code that produces them, so each entry point exports only
+the errors its own code throws:
+
+| Entry point                                        | Errors                                                                                                                                                                                 |
+| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@honeybbq/teamspeak` (shared by every connection) | `TeamspeakError`, `ServerError`, `CommandTimeoutError`, `NotConnectedError`, `AlreadyConnectedError`, `NoDataError`                                                                    |
+| `@honeybbq/teamspeak/client` (voice only)          | `ConnectionTimeoutError`, `HandshakeError` and its `PuzzleTooHardError`, `InvalidAddressError`, `InvalidIdentityError`, `FileTransferError`, `RemovedError` (kick, ban or server stop) |
+| `@honeybbq/teamspeak/stream` (streams only)        | `StreamsUnsupportedError`, `StreamJoinDeniedError`, `StreamEndedError`, `StreamPayloadTooLargeError`                                                                                   |
+| `@honeybbq/teamspeak/query` (query only)           | `QueryAuthError`, `GuestAccessError`, `SshHostKeyError`, `MissingDependencyError`, `WebQueryHttpError`                                                                                 |
+
+A call that is given a value it cannot use, such as an out-of-range id or an
+option that contradicts another, throws the language's own `TypeError` or
+`RangeError` before anything is sent. Those are not `TeamspeakError`s: they are
+a bug in the caller, not a condition to handle. `WebQueryHttpError` carries the
+HTTP `status`; a refusal the server itself reports is a `ServerError` over every
+transport.
+
+**Cancellation.** An aborted `signal` is the caller's own cancellation, not an
+SDK error. `connect()`, the typed commands, `exec`, file transfers and `events()`
+reject with the signal's `reason` itself, unwrapped: a `DOMException` named
+`AbortError` after a bare `abort()`, a `TimeoutError` after
+`AbortSignal.timeout()`, or whatever value was passed to `abort(reason)`. A
+signal that is already aborted rejects before anything is sent. Aborting a
+`connect()` abandons the attempt and leaves the client disconnected; a command
+that was given up on may still have taken effect on the server. The signal and
+the command's own `timeoutMs` are separate: when `timeoutMs` (ten seconds by
+default) passes first, the command rejects with a `CommandTimeoutError`.
+
+**No data.** `NoDataError` means the command succeeded but its answer lacked the
+data it exists to return, such as the id of a channel just created. Treat the
+command as having taken effect and do not retry it blindly, or it creates a
+second object or is refused as a duplicate. `createChannel` and the group
+commands look the new object up themselves and throw it only when nothing
+matches. A list that comes back empty is `[]`, not this error.
+
+### Ids
+
+Every kind of id is a branded type: `ChannelID`, `ClientID`, `ClientDBID`,
+`ServerGroupID`, `ChannelGroupID`, `PermissionID`, `IconID`, `ServerID`,
+`BanID` and the rest, with `UID` and `ChannelUID` as branded strings. The
+brand costs nothing at runtime, and passing the wrong kind is a compile error.
+Make one with its constructor, which throws a `RangeError` for a value outside
+the id's wire range:
+
+```typescript
+import { asChannelID, asClientID, moveClient } from "@honeybbq/teamspeak";
+
+const cid = asChannelID(5); // or asChannelID(5n)
+await moveClient(client, client.clientID, cid);
+// moveClient(client, cid, client.clientID) does not compile.
+const clid = asClientID(3);
+```
+
+A `ClientID`, `PermissionID`, `IconID` and the file transfer ids are `number`s.
+The ones the protocol makes 64 bits wide are `bigint`s: `ChannelID`,
+`ClientDBID`, `ServerGroupID`, `ChannelGroupID`, `ServerID`, `BanID`,
+`MessageID` and `APIKeyID`. Their constructors take a `number` or a `bigint`.
+
+### Options and absent values
+
+**Options.** Required arguments are positional. Everything optional is one
+options object, the last argument. A field that is not set is not sent:
+`undefined` leaves the setting alone and `""` sends it empty.
+
+```typescript
+import { editChannel } from "@honeybbq/teamspeak";
+
+await editChannel(client, cid, {
+  name: "Lounge",
+  topic: "", // sent empty: clears the topic
+  // password is not set: not sent, so the password stays as it is.
+});
+```
+
+**Records.** In a record the server's answer fills in, an optional field is
+`undefined` when the server did not send it. That is not the same as `0` or
+`false`: `totalClients` is `undefined` in a `getChannelInfo` result, which does
+not carry it, and `0` in a `listChannels` result of an empty channel.
+
+```typescript
+import { getChannelInfo } from "@honeybbq/teamspeak";
+
+const info = await getChannelInfo(client, cid);
+if (info.totalClients !== undefined) console.log(info.totalClients, "clients");
+```
+
+**Durations and times** are numbers of milliseconds with an `Ms` suffix
+(`idleTimeMs`, `timeoutMs`) and `Date`. A `Date` field is `undefined` where the
+server sends 0 for "never". The Go SDK uses `time.Duration` and `time.Time`.
+
+### Events
+
+Each server event has a typed name (`"textMessage"`, `"clientEnter"`, ...;
+`EventName` has a constant for each), and `"notification"` delivers every
+notification as the server sent it, including those no typed event models. The
+notification arrives after the typed event it produced. `on()` returns a
+function that removes the listener; `events(name, { signal })` is the same as an
+async iterator.
+
+```typescript
+const off = client.on("textMessage", (message) => {
+  console.log(message.invokerName, message.message);
+});
+off();
+
+client.on("notification", (n) => console.log(n.name, n.params));
+```
+
+- **Order.** Listeners run one at a time, in the order the events arrived, so a
+  listener may call the client and await an answer.
+- **State.** The client updates its state, such as `client.view`, before it
+  queues the event that reports the change, so a listener sees state at least as
+  new as its event.
+- **A throw** in a listener does not stop the others. The exception is rethrown
+  from a microtask, as an uncaught exception, as an EventEmitter listener's
+  would be. The Go SDK recovers a panicking handler and logs it instead.
+- **Middleware.** `eventMiddleware` sees each server event before the listeners
+  and may pass it on, replace it or drop it; `connected`, `disconnected`,
+  `kicked` and the view events bypass it. `commandMiddleware` wraps the typed commands. Both are
+  described above.
+
+### Stability
+
+From 1.0 the package follows semver, as described under
+[Compatibility](#compatibility): a breaking change to `@honeybbq/teamspeak`,
+`/client` and `/versions` waits for 2.0. The enumerations, `ErrorCode` and the
+event map may gain members in a minor release; give a `switch` over them a
+default case.
+
+An API that may still change in a minor release is marked `@experimental` (or, for
+`@honeybbq/teamspeak/stream`, `@beta`) in its TSDoc, which editors and the API reference
+show. Today that is the whole `@honeybbq/teamspeak/stream` entry point, and the whole
+`@honeybbq/teamspeak/query` entry point, the server view (`client.view` and the
+view events), the `previous` field of the client-left and channel-deleted
+events, and `getServerVariables`.
+
+### Server behaviour the SDK works around
+
+The servers answer some commands in ways that differ between TeamSpeak 3 and 6
+and between transports, and the SDK evens those out. The measured tables are in
+[voice-protocol-responses.md](https://github.com/HoneyBBQ/teamspeak-js/blob/main/docs/voice-protocol-responses.md)
+and [serverquery-responses.md](https://github.com/HoneyBBQ/teamspeak-js/blob/main/docs/serverquery-responses.md).
+
 ## ServerQuery
 
 The `@experimental` subpath `@honeybbq/teamspeak/query` administers a server
@@ -733,6 +1043,7 @@ with the same semantics, apart from what the languages make differ:
 | `@honeybbq/teamspeak`          | What every TeamSpeak connection shares: the command language, ids, errors, the typed commands, the event types and the status and reconnection types |
 | `@honeybbq/teamspeak/client`   | The voice client, identities, file transfers, diagnostics and its retry policy                                                                       |
 | `@honeybbq/teamspeak/versions` | Client versions a server accepts, for the client's `version` option; data only, one export each                                                      |
+| `@honeybbq/teamspeak/stream`   | TeamSpeak 6 streams, the screen share: finding, publishing and watching them; signalling only, no WebRTC code; `@beta`                               |
 | `@honeybbq/teamspeak/query`    | The ServerQuery client, running the same typed commands over raw TCP, SSH or WebQuery; `@experimental`                                               |
 
 Each entry exports only its own symbols. The client entry does not re-export
@@ -751,7 +1062,8 @@ get no further releases. Coming from 0.x? The
 
 ```
 src/
-├── core/              # Shared: command language, ids, errors, typed commands
+├── core/              # Shared (@honeybbq/teamspeak): command language, ids, errors, typed commands
+├── versions/          # Client versions (@honeybbq/teamspeak/versions)
 ├── client/            # The voice client (@honeybbq/teamspeak/client)
 │   ├── client.ts          # Client lifecycle, connection management
 │   ├── commands.ts        # Command sending and response tracking
@@ -767,7 +1079,8 @@ src/
 │   ├── handshake/         # Crypto handshake and license verification
 │   ├── transport/         # UDP packet framing, ACK, compression
 │   └── discovery/         # SRV / TSDNS / direct address resolution
-└── query/             # ServerQuery client (not exported yet)
+├── stream/            # TeamSpeak 6 streams (@honeybbq/teamspeak/stream)
+└── query/             # The ServerQuery client (@honeybbq/teamspeak/query)
 examples/
 └── connect.ts  # Minimal connection example
 ```
@@ -782,9 +1095,11 @@ Protocol knowledge was primarily informed by the [TSLib](https://github.com/Spla
 
 ## Disclaimer
 
-TeamSpeak is a registered trademark of [TeamSpeak Systems GmbH](https://teamspeak.com/). This project is not affiliated with, endorsed by, or associated with TeamSpeak Systems GmbH in any way.
+TeamSpeak is a registered trademark of [TeamSpeak Systems, Inc.](https://teamspeak.com/). This project is not affiliated with, endorsed by, or associated with TeamSpeak Systems, Inc. in any way.
+
+This library is an **independent implementation** built from public documentation, observation of network traffic, and independent research. It contains no TeamSpeak proprietary code, headers, libraries, or binaries.
 
-This library is a **clean-room implementation** developed from publicly available documentation, protocol analysis of network traffic, and independent research. No proprietary TeamSpeak SDK code, headers, or libraries were used in its creation.
+The project implements the client side only and does not implement a TeamSpeak server.
 
 ## Contributing
 

package/dist/client/api/files.d.ts

@@ -0,0 +1,89 @@
+/**
+ * One-call file transfers: negotiate the transfer, move the bytes, and return.
+ *
+ * `initFileUpload` and `uploadFileData` (and the download twins) are the two
+ * halves of a transfer; these run both, over the connection that sends the
+ * commands. That is a voice `Client`, or a `QueryClient` over raw TCP or SSH:
+ * measured on TeamSpeak 3 3.13.8 (raw TCP, SSH, voice) and TeamSpeak 6
+ * beta13.1 (SSH, voice), the key a query connection negotiates opens the same
+ * file transfer port a voice client's does. WebQuery refuses every file command
+ * (error 5120), on both servers.
+ */
+import { Readable, Writable } from "node:stream";
+import type { ChannelID, CommandExecutor, FileDownloadOptions, FileUploadOptions } from "@honeybbq/teamspeak";
+import type { FileTransferOptions } from "../transfer.js";
+/**
+ * How {@link uploadFile} negotiates and moves the file: the options of
+ * `initFileUpload`, without `resume` (the whole file is sent), and those of
+ * `uploadFileData`. `signal` and `timeoutMs` apply to the negotiation, and the
+ * signal to the transfer too.
+ */
+export interface UploadFileOptions extends Omit<FileUploadOptions, "resume">, FileTransferOptions {
+    /**
+     * The host of the file transfer port. A voice client sends to the host it
+     * connected to, so it needs none; any other connection must name it. A host
+     * given here wins over the client's own, and so does `socketFactory`.
+     */
+    readonly host?: string | undefined;
+    /**
+     * The size in bytes of a stream passed as the data, which the server needs
+     * before it takes the file. Required for a `Readable`; for bytes it is their
+     * length, and a different value here is refused.
+     */
+    readonly size?: bigint | number | undefined;
+}
+/** How {@link downloadFile} negotiates and moves the file. */
+export interface DownloadFileOptions extends Omit<FileDownloadOptions, "seekPosition">, FileTransferOptions {
+    /** The host of the file transfer port, as for {@link UploadFileOptions}. */
+    readonly host?: string | undefined;
+    /**
+     * Write the file into this stream instead of returning its bytes. The stream
+     * is not ended, as for `downloadFileData`.
+     */
+    readonly dest?: Writable | undefined;
+    /**
+     * The largest file, in bytes, to hold in memory when no `dest` is given;
+     * 268435456 (256 MiB) by default. A larger file is refused with a
+     * {@link FileTransferError} before any byte is read; the transfer the server
+     * negotiated is left unused.
+     */
+    readonly maxSize?: number | undefined;
+}
+/**
+ * Upload a file into a channel's file area: negotiate the transfer
+ * (`initFileUpload`) and send the bytes (`uploadFileData`), in one call.
+ *
+ * `data` is the bytes, or a `Readable` with `options.size` the number of bytes
+ * it will give. An existing file is not replaced unless `overwrite` is set, and
+ * the directory the file goes in must exist (a missing one is refused with
+ * 2054, invalid file path): make it with `createDirectory` first. A refusal of
+ * the negotiation is thrown as the ServerError it is, before anything is sent;
+ * a failure of the connection to the file transfer port is a
+ * {@link FileTransferError}.
+ *
+ * Over a voice `Client` the bytes go through its own transfer sockets and to the
+ * host it connected to. Over any other connection, such as a `QueryClient`,
+ * name the host of the file transfer port in `options.host`.
+ */
+export declare function uploadFile(client: CommandExecutor, channelID: ChannelID, path: string, data: Uint8Array | Readable, options?: UploadFileOptions): Promise<void>;
+/**
+ * Download a file from a channel's file area into memory: negotiate the
+ * transfer (`initFileDownload`) and read the bytes (`downloadFileData`), in one
+ * call. With `options.dest` the bytes go into that stream instead and nothing
+ * is held, which is the way to fetch a large file.
+ *
+ * A file over `maxSize` (256 MiB unless set) is refused when no `dest` is given.
+ * A file that is not there is the ServerError of the negotiation: 2051 on TS3
+ * 3.13.8 and TS6 beta13.1. A path that names a directory is not refused by the
+ * server: it announces a size and sends nothing, so the call rejects with a
+ * {@link FileTransferError} for the bytes that never came.
+ *
+ * Over a voice `Client` the bytes come through its own transfer sockets from
+ * the host it connected to. Over any other connection, name the host of the
+ * file transfer port in `options.host`.
+ */
+export declare function downloadFile(client: CommandExecutor, channelID: ChannelID, path: string, options: DownloadFileOptions & {
+    readonly dest: Writable;
+}): Promise<void>;
+export declare function downloadFile(client: CommandExecutor, channelID: ChannelID, path: string, options?: DownloadFileOptions): Promise<Uint8Array>;
+//# sourceMappingURL=files.d.ts.map

package/dist/client/api/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/client/api/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EAEf,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,mBAAmB;IAC/F;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,EAAE,mBAAmB;IACtE,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAqFD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,QAAQ,EAC3B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GACzD,OAAO,CAAC,IAAI,CAAC,CAAC;AACjB,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC"}

package/dist/client/api/files.js

@@ -0,0 +1,125 @@
+/**
+ * One-call file transfers: negotiate the transfer, move the bytes, and return.
+ *
+ * `initFileUpload` and `uploadFileData` (and the download twins) are the two
+ * halves of a transfer; these run both, over the connection that sends the
+ * commands. That is a voice `Client`, or a `QueryClient` over raw TCP or SSH:
+ * measured on TeamSpeak 3 3.13.8 (raw TCP, SSH, voice) and TeamSpeak 6
+ * beta13.1 (SSH, voice), the key a query connection negotiates opens the same
+ * file transfer port a voice client's does. WebQuery refuses every file command
+ * (error 5120), on both servers.
+ */
+import { Readable, Writable } from "node:stream";
+import { initFileDownload, initFileUpload } from "@honeybbq/teamspeak";
+import { FileTransferError } from "../errors.js";
+import { downloadFileData, uploadFileData } from "../transfer.js";
+function isTransferCapable(client) {
+    const candidate = client;
+    return (typeof candidate.host === "string" &&
+        typeof candidate.uploadFileData === "function" &&
+        typeof candidate.downloadFileData === "function");
+}
+/**
+ * How to move the bytes over this connection: through the client's own
+ * transfer sockets when it has them and the caller named neither a host nor a
+ * socket factory, else by dialling `options.host`.
+ */
+function routeFor(client, options) {
+    if (isTransferCapable(client) && options.host === undefined && !options.socketFactory) {
+        return {
+            upload: (info, data, o) => client.uploadFileData(client.host, info, data, o),
+            download: (info, dest, o) => client.downloadFileData(client.host, info, dest, o),
+        };
+    }
+    const host = options.host ?? (isTransferCapable(client) ? client.host : undefined);
+    if (host === undefined || host === "") {
+        throw new TypeError("the file transfer port is on a host this connection does not name: pass it as options.host");
+    }
+    return {
+        upload: (info, data, o) => uploadFileData(host, info, data, o),
+        download: (info, dest, o) => downloadFileData(host, info, dest, o),
+    };
+}
+/** The part of the options a transfer's data phase reads. */
+function transferOptions(options) {
+    return {
+        signal: options.signal,
+        socketFactory: options.socketFactory,
+        trace: options.trace,
+        idleTimeoutMs: options.idleTimeoutMs,
+    };
+}
+function sizeOf(data, declared) {
+    const size = declared === undefined ? undefined : BigInt(declared);
+    if (size !== undefined && (size < 0n || !Number.isInteger(Number(declared)))) {
+        throw new RangeError(`size is a non-negative whole number of bytes, not ${String(declared)}`);
+    }
+    if (data instanceof Uint8Array) {
+        if (size !== undefined && size !== BigInt(data.length)) {
+            throw new TypeError(`size says ${size} bytes and the data is ${data.length}`);
+        }
+        return BigInt(data.length);
+    }
+    if (size === undefined) {
+        throw new TypeError("a stream has no known length: pass options.size, in bytes");
+    }
+    return size;
+}
+/**
+ * Upload a file into a channel's file area: negotiate the transfer
+ * (`initFileUpload`) and send the bytes (`uploadFileData`), in one call.
+ *
+ * `data` is the bytes, or a `Readable` with `options.size` the number of bytes
+ * it will give. An existing file is not replaced unless `overwrite` is set, and
+ * the directory the file goes in must exist (a missing one is refused with
+ * 2054, invalid file path): make it with `createDirectory` first. A refusal of
+ * the negotiation is thrown as the ServerError it is, before anything is sent;
+ * a failure of the connection to the file transfer port is a
+ * {@link FileTransferError}.
+ *
+ * Over a voice `Client` the bytes go through its own transfer sockets and to the
+ * host it connected to. Over any other connection, such as a `QueryClient`,
+ * name the host of the file transfer port in `options.host`.
+ */
+export async function uploadFile(client, channelID, path, data, options = {}) {
+    const size = sizeOf(data, options.size);
+    const route = routeFor(client, options);
+    const info = await initFileUpload(client, channelID, path, size, {
+        password: options.password,
+        overwrite: options.overwrite,
+        signal: options.signal,
+        timeoutMs: options.timeoutMs,
+    });
+    const source = data instanceof Uint8Array ? Readable.from([data]) : data;
+    await route.upload(info, source, transferOptions(options));
+}
+export async function downloadFile(client, channelID, path, options = {}) {
+    const maxSize = options.maxSize ?? DEFAULT_MAX_SIZE;
+    if (!Number.isFinite(maxSize) || maxSize < 0) {
+        throw new RangeError(`maxSize is a non-negative number of bytes, not ${String(maxSize)}`);
+    }
+    const route = routeFor(client, options);
+    const info = await initFileDownload(client, channelID, path, {
+        password: options.password,
+        signal: options.signal,
+        timeoutMs: options.timeoutMs,
+    });
+    if (options.dest !== undefined) {
+        await route.download(info, options.dest, transferOptions(options));
+        return;
+    }
+    if (info.size > BigInt(maxSize)) {
+        throw new FileTransferError(`the file is ${info.size} bytes, over the ${maxSize} bytes maxSize allows in memory`);
+    }
+    const chunks = [];
+    const sink = new Writable({
+        write(chunk, _encoding, done) {
+            chunks.push(chunk);
+            done();
+        },
+    });
+    await route.download(info, sink, transferOptions(options));
+    return Buffer.concat(chunks);
+}
+const DEFAULT_MAX_SIZE = 256 * 1024 * 1024;
+//# sourceMappingURL=files.js.map

package/dist/client/api/files.js.map

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

package/dist/client/client.d.ts

@@ -225,11 +225,11 @@ export declare class Client implements CommandExecutor, AsyncDisposable {
      * Upload `data` over a negotiated transfer, through the client's
      * `fileTransferSocketFactory` if it has one.
      */
-    uploadFileData(host: string, info: FileUploadInfo, data: Readable, options?: Pick<FileTransferOptions, "signal" | "trace">): Promise<void>;
+    uploadFileData(host: string, info: FileUploadInfo, data: Readable, options?: Pick<FileTransferOptions, "signal" | "trace" | "idleTimeoutMs">): 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?: Pick<FileTransferOptions, "signal" | "trace">): Promise<void>;
+    downloadFileData(host: string, info: FileDownloadInfo, dest: Writable, options?: Pick<FileTransferOptions, "signal" | "trace" | "idleTimeoutMs">): Promise<void>;
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAOnB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,QAAQ,EACb,KAAK,KAAK,EAGV,KAAK,cAAc,EACnB,KAAK,GAAG,EAGR,KAAK,QAAQ,EAGb,KAAK,WAAW,EAGhB,YAAY,EAKb,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAclD,OAAO,EAAoC,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAW3F,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAa1F,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIvF,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAmPD;;;;;;GAMG;AACH,qBAAa,MAAO,YAAW,eAAe,EAAE,eAAe;;IA2F7D,YAAY,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,EAyE1F;IAED;;;;;;OAMG;IACH,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,oDAAoD;IACpD,IAAI,MAAM,IAAI,YAAY,CAEzB;IAID;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,OAAO,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;IA8GD;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,CACd,OAAO,GAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GACL,OAAO,CAAC,IAAI,CAAC,CA4Bf;IA+CD,gEAAgE;IAChE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAErC;IAID;;;;;;;;OAQG;IAEH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAErF;IAED;;;;;;;;OAQG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAO,GAC1D,OAAO,CAAC,IAAI,CAAC,CAEf;IAwBD;;;;;;;OAOG;IAEH,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAE7F;IAuED;;;;;;;;;;;;;;;;OAgBG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,WAAW,CAmBnF;IAED,uDAAuD;IACvD,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,WAAW,CAMrF;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,QAAQ,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAO,GAC1D,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CA2EpC;IAID,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED;;;;;;;OAOG;IACH,IAAI,GAAG,IAAI,GAAG,CAEb;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8EAA8E;IAC9E,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAKzE;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAIjF;IAED;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAKtE;IAID;;;OAGG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAM,GAC5E,OAAO,CAAC,IAAI,CAAC,CAKf;IAED;;;OAGG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAM,GAC5E,OAAO,CAAC,IAAI,CAAC,CAKf;CA63BF"}