@honeybbq/teamspeak 1.0.0-beta.21 → 1.0.0-beta.22

package/dist/stream/types.js

@@ -1,2 +1,236 @@
-export {};
+// ---- Values -----------------------------------------------------------------
+/** The values of the table below, before freezing. */
+const streamSourceValues = {
+    /** `0` on the wire: no source named. */
+    None: "none",
+    /** `1` on the wire: a camera. */
+    Camera: "camera",
+    /** `2` on the wire: a screen. */
+    Screen: "screen",
+    /** `3` on the wire: a window. */
+    Window: "window",
+    /** `4` on the wire. */
+    Session: "session",
+};
+/**
+ * What a stream shows. The server stores any number, so a stream from a client
+ * that sends another value reports it as the number.
+ */
+export const StreamSource = 
+/* @__PURE__ */ Object.freeze(streamSourceValues);
+/** The values of the table below, before freezing. */
+const streamAccessibilityValues = {
+    /** `0` on the wire. */
+    None: "none",
+    /** `1` on the wire: anyone. What `publish` sends unless told otherwise. */
+    Public: "public",
+    /** `2` on the wire: the publisher's contacts. */
+    Contacts: "contacts",
+    /** `3` on the wire. */
+    Private: "private",
+};
+/**
+ * Who a stream says may watch it. Only the publisher enforces it: the server
+ * relays every request. A value outside the four is reported as the number.
+ */
+export const StreamAccessibility = 
+/* @__PURE__ */ Object.freeze(streamAccessibilityValues);
+/** The values of the table below, before freezing. */
+const streamTransportValues = {
+    /** From the publisher to each viewer directly. */
+    P2P: "p2p",
+};
+/**
+ * How a stream's media travels: `"p2p"`, from the publisher to each viewer
+ * directly, is the one mode this SDK publishes and watches. A server may
+ * announce a stream in another mode; it is reported as the number, and
+ * `watch` refuses it.
+ */
+export const StreamTransport = 
+/* @__PURE__ */ Object.freeze(streamTransportValues);
+// ---- Peers ------------------------------------------------------------------
+/** The values of the table below, before freezing. */
+const peerCloseCauseValues = {
+    /** Its own `close()`. */
+    Closed: "closed",
+    /** The other end leaving. */
+    Left: "left",
+    /** The stream ending. */
+    Stopped: "stopped",
+    /** The client's connection ending. */
+    Disconnected: "disconnected",
+    /** `Streams.dispose()`. */
+    Disposed: "disposed",
+};
+/**
+ * Why a peer closed.
+ */
+export const PeerCloseCause = 
+/* @__PURE__ */ Object.freeze(peerCloseCauseValues);
+/** The values of the table below, before freezing. */
+const peerEventNameValues = {
+    /** A renegotiation offer from the publisher: an SDP. */
+    Offer: "offer",
+    /** The viewer's SDP answer. */
+    Answer: "answer",
+    /** An ICE candidate from the other end. */
+    Candidate: "candidate",
+    /** A signalling message that is none of the above. */
+    Signal: "signal",
+    /** The peer closing. */
+    Closed: "closed",
+};
+/**
+ * The names of the events `Peer.on()` takes, as constants.
+ * `on(PeerEventName.Offer, ...)` and `on("offer", ...)` are the same call,
+ * and both give the listener the same payload type.
+ */
+export const PeerEventName = 
+/* @__PURE__ */ Object.freeze(peerEventNameValues);
+// Each direction fails to compile when `PeerEvents` and `PeerEventName`
+// drift: an event without a name, and a name that is not an event.
+const peerEventNameCoverEvents = true;
+const peerEventNameNamesAreEvents = true;
+void peerEventNameCoverEvents;
+void peerEventNameNamesAreEvents;
+/** The values of the table below, before freezing. */
+const joinRequestStateValues = {
+    /** Not yet accepted or denied. */
+    Pending: "pending",
+    /** Accepted. */
+    Accepted: "accepted",
+    /** Denied. */
+    Denied: "denied",
+    /** The answer did not reach the server. */
+    Failed: "failed",
+    /** The viewer left first. */
+    Withdrawn: "withdrawn",
+    /** The stream stopped. */
+    Ended: "ended",
+};
+/**
+ * Where a join request stands.
+ */
+export const JoinRequestState = 
+/* @__PURE__ */ Object.freeze(joinRequestStateValues);
+/** The values of the table below, before freezing. */
+const joinRequestCloseCauseValues = {
+    /** The viewer took it back or left view. */
+    Withdrawn: "withdrawn",
+    /** The stream ended first. */
+    Ended: "ended",
+};
+/**
+ * Why a request stopped waiting for an answer.
+ */
+export const JoinRequestCloseCause = 
+/* @__PURE__ */ Object.freeze(joinRequestCloseCauseValues);
+/** The values of the table below, before freezing. */
+const joinRequestEventNameValues = {
+    /**
+     * A request nobody had answered closing: the viewer withdrew it or left
+     * view, or the stream ended.
+     */
+    Closed: "closed",
+};
+/**
+ * The names of the events `JoinRequest.on()` takes, as constants.
+ * `on(JoinRequestEventName.Closed, ...)` and `on("closed", ...)` are the same call,
+ * and both give the listener the same payload type.
+ */
+export const JoinRequestEventName = 
+/* @__PURE__ */ Object.freeze(joinRequestEventNameValues);
+// Each direction fails to compile when `JoinRequestEvents` and `JoinRequestEventName`
+// drift: an event without a name, and a name that is not an event.
+const joinRequestEventNameCoverEvents = true;
+const joinRequestEventNameNamesAreEvents = true;
+void joinRequestEventNameCoverEvents;
+void joinRequestEventNameNamesAreEvents;
+/** The values of the table below, before freezing. */
+const streamEndCauseValues = {
+    /** `stop()`. */
+    Stopped: "stopped",
+    /** The server's `notifystreamstopped`. */
+    Server: "server",
+    /**
+     * The server said its publisher no longer streams (`client_is_streaming`
+     * cleared) and no stop followed within two seconds.
+     */
+    Gone: "gone",
+    /** The client's connection ending. */
+    Disconnected: "disconnected",
+    /** `Streams.dispose()`. */
+    Disposed: "disposed",
+};
+/**
+ * Why a published stream ended.
+ */
+export const StreamEndCause = 
+/* @__PURE__ */ Object.freeze(streamEndCauseValues);
+/** The values of the table below, before freezing. */
+const publishedStreamEventNameValues = {
+    /** A client asking to watch. */
+    Request: "request",
+    /** The stream ending. */
+    Ended: "ended",
+};
+/**
+ * The names of the events `PublishedStream.on()` takes, as constants.
+ * `on(PublishedStreamEventName.Request, ...)` and `on("request", ...)` are the same call,
+ * and both give the listener the same payload type.
+ */
+export const PublishedStreamEventName = 
+/* @__PURE__ */ Object.freeze(publishedStreamEventNameValues);
+// Each direction fails to compile when `PublishedStreamEvents` and `PublishedStreamEventName`
+// drift: an event without a name, and a name that is not an event.
+const publishedStreamEventNameCoverEvents = true;
+const publishedStreamEventNameNamesAreEvents = true;
+void publishedStreamEventNameCoverEvents;
+void publishedStreamEventNameNamesAreEvents;
+/** The values of the table below, before freezing. */
+const streamWarningCodeValues = {
+    /** An SDP offer with no `m=audio` section. */
+    OfferWithoutAudio: "offer-without-audio",
+};
+/**
+ * Why `Streams` warns.
+ */
+export const StreamWarningCode = 
+/* @__PURE__ */ Object.freeze(streamWarningCodeValues);
+/** The values of the table below, before freezing. */
+const streamsEventNameValues = {
+    /**
+     * A stream becoming known: it started while this client could see it, or
+     * discovery found it.
+     */
+    Started: "started",
+    /** What is known of a stream changing. */
+    Updated: "updated",
+    /** A stream ending. */
+    Stopped: "stopped",
+    /** A viewer being accepted into a stream. */
+    ViewerJoined: "viewerJoined",
+    /** A viewer leaving a stream. */
+    ViewerLeft: "viewerLeft",
+    /** A failure nobody awaits, such as a discovery request the server refused. */
+    Error: "error",
+    /**
+     * Something the SDK noticed and let through, such as an offer the
+     * TeamSpeak 6 client will not answer.
+     */
+    Warning: "warning",
+};
+/**
+ * The names of the events `Streams.on()` takes, as constants.
+ * `on(StreamsEventName.Started, ...)` and `on("started", ...)` are the same call,
+ * and both give the listener the same payload type.
+ */
+export const StreamsEventName = 
+/* @__PURE__ */ Object.freeze(streamsEventNameValues);
+// Each direction fails to compile when `StreamsEventMap` and `StreamsEventName`
+// drift: an event without a name, and a name that is not an event.
+const streamsEventNameCoverEvents = true;
+const streamsEventNameNamesAreEvents = true;
+void streamsEventNameCoverEvents;
+void streamsEventNameNamesAreEvents;
 //# sourceMappingURL=types.js.map

package/dist/stream/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honeybbq/teamspeak",
-  "version": "1.0.0-beta.21",
+  "version": "1.0.0-beta.22",
   "description": "TeamSpeak SDK for TypeScript: an independent voice client for Node.js, and the typed commands, ids and errors every connection shares",
   "keywords": [
     "client",
@@ -71,23 +71,24 @@
     "@changesets/changelog-github": "^1.0.1",
     "@changesets/cli": "^3.0.3",
     "@honeybbq/teamspeak": "link:.",
-    "@microsoft/api-extractor": "7.59.4",
-    "@types/node": "^26.6.5",
+    "@microsoft/api-extractor": "7.60.1",
+    "@types/node": "^26.6.6",
     "@types/ssh2": "^1.15.6",
+    "@vitest/coverage-v8": "5.0.5",
     "fast-check": "^4.10.2",
-    "oxfmt": "^0.73.0",
-    "oxlint": "^1.88.0",
-    "oxlint-tsgolint": "^7.0.2004",
+    "oxfmt": "^0.75.0",
+    "oxlint": "^1.90.0",
+    "oxlint-tsgolint": "^7.0.2005",
     "publint": "^0.3.25",
     "ssh2": "^1.17.0",
-    "tsx": "^4.21.0",
+    "tsx": "^4.23.15",
     "typedoc": "0.28.20",
     "typedoc-material-theme": "^1.4.1",
     "typescript": "^7.0.2",
-    "typescript-api": "npm:typescript@^5.9.3",
-    "vite": "^8.3.4",
+    "typescript-api": "npm:typescript@^6.0.3",
+    "vite": "^8.3.5",
     "vitest": "^5.0.5",
-    "werift": "^0.25.1"
+    "werift": "^0.25.2"
   },
   "peerDependencies": {
     "ssh2": "^1.17.0"
@@ -103,6 +104,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest run --project @honeybbq/teamspeak --project scripts",
+    "test:coverage": "vitest run --coverage --project @honeybbq/teamspeak --project scripts",
     "test:watch": "vitest",
     "lint": "oxlint --deny-warnings .",
     "fmt": "oxfmt .",

package/src/client/crypto/identity.ts

@@ -246,6 +246,13 @@ function generateKey(): KeyObject {
   return generateKeyPairSync("ec", { namedCurve: "prime256v1" }).privateKey;
 }
 
+/** The values of the table below, before freezing. */
+const uidAlgorithmValues = {
+  /** SHA-1, 20 bytes: a TeamSpeak 3 server. */
+  SHA1: "sha1",
+  /** SHA-256, 32 bytes: a TeamSpeak 6 server. */
+  SHA256: "sha256",
+} as const;
 /**
  * The hash a server uses for `client_unique_identifier`, keyed by the server's
  * major version.
@@ -254,16 +261,20 @@ function generateKey(): KeyObject {
  * 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";
+export const UIDAlgorithm: typeof uidAlgorithmValues =
+  /* @__PURE__ */ Object.freeze(uidAlgorithmValues);
+/**
+ * One of {@link UIDAlgorithm}. 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 = (typeof UIDAlgorithm)[keyof typeof UIDAlgorithm];
 
 /** Pick the UID hash from a `virtualserver_version` string, e.g. "6.0.0-beta13.1". */
 export function uidAlgorithmForVersion(version: string): UIDAlgorithm {
   const major = Number.parseInt(version, 10);
-  return Number.isNaN(major) || major < 6 ? "sha1" : "sha256";
+  return Number.isNaN(major) || major < 6 ? UIDAlgorithm.SHA1 : UIDAlgorithm.SHA256;
 }
 
 /**

package/src/client/crypto/index.ts

@@ -9,7 +9,7 @@ export {
   hash512,
   importPublicKey,
 } from "./identity.js";
-export type { UIDAlgorithm } from "./identity.js";
+export { UIDAlgorithm } from "./identity.js";
 export { Crypt } from "./crypt.js";
 export type { KeyNonce } from "./crypt.js";
 export { EAX, aesCmac } from "./eax.js";

package/src/client/discovery/resolver.ts

@@ -1,5 +1,6 @@
 import { resolveSrv } from "node:dns/promises";
 import { createConnection } from "node:net";
+import { ResolveSource } from "../types.js";
 import type { ResolvedAddr } from "../types.js";
 import { isIpAddress, joinHostPort, splitHostPort } from "../address.js";
 import { abortable } from "../abort.js";
@@ -58,7 +59,7 @@ export class Resolver {
       options.signal?.throwIfAborted();
       if (!budget.aborted) throw error;
       const { host, port } = splitHostPort(inputAddr);
-      return [{ addr: joinHostPort(host, port), source: "Direct" }];
+      return [{ addr: joinHostPort(host, port), source: ResolveSource.Direct }];
     }
   }
 
@@ -73,7 +74,7 @@ export class Resolver {
     const { host, port } = splitHostPort(inputAddr);
 
     if (isIpAddress(host)) {
-      return [{ addr: joinHostPort(host, port), source: "Direct" }];
+      return [{ addr: joinHostPort(host, port), source: ResolveSource.Direct }];
     }
 
     // A dot-less name may be a server nickname, which only the TeamSpeak
@@ -94,18 +95,20 @@ export class Resolver {
     // 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" }]);
+      return this.#setCache(inputAddr, [{ addr: tsdnsSrv, source: ResolveSource.TSDNSSRV }]);
     }
 
     // TSDNS direct :41144
     const tsdnsDirect = await this.#resolveTSDNSDirect(domainList, host, signal);
     if (tsdnsDirect) {
-      return this.#setCache(inputAddr, [{ addr: tsdnsDirect, source: "TSDNS-Direct" }]);
+      return this.#setCache(inputAddr, [{ addr: tsdnsDirect, source: ResolveSource.TSDNSDirect }]);
     }
 
     signal.throwIfAborted();
     // Plain DNS fallback
-    const fallback: ResolvedAddr[] = [{ addr: joinHostPort(host, port), source: "Direct" }];
+    const fallback: ResolvedAddr[] = [
+      { addr: joinHostPort(host, port), source: ResolveSource.Direct },
+    ];
     return this.#setCache(inputAddr, fallback);
   }
 
@@ -130,7 +133,7 @@ export class Resolver {
       if (!srvs || srvs.length === 0) return null;
       return orderSrvRecords(srvs).map((srv) => ({
         addr: joinHostPort(srv.name.replace(/\.$/, ""), String(srv.port)),
-        source: "SRV",
+        source: ResolveSource.SRV,
       }));
     } catch {
       return null;

package/src/client/handshake/license.ts

@@ -78,6 +78,7 @@ function parseLicenseBlock(data: Uint8Array): { block: LicenseBlock; consumed: n
   if (data.length < MIN_BLOCK_LEN) throw new Error("license too short");
   if (data[0] !== 0) throw new Error(`wrong key kind in license: ${data[0]}`);
 
+  // oxlint-disable-next-line typescript/no-unsafe-enum-assignment -- read off the wire; parseBlockPayload refuses a value no member names
   const blockType = data[33] as LicenseBlockType;
 
   // Timestamps are seconds since Unix epoch offset by 0x50e22700

package/src/client/index.ts

@@ -10,9 +10,10 @@
 
 // The client
 export { Client } from "./client.js";
-export { EventName, GroupWhisperType, GroupWhisperScope } from "./types.js";
+export { EventName, GroupWhisperType, GroupWhisperScope, ResolveSource } from "./types.js";
 
-export type { ServerView, ViewChangedEvent, ViewReadyEvent, ViewStatus } from "./view.js";
+export { ViewStatus } from "./view.js";
+export type { ServerView, ViewChangedEvent, ViewReadyEvent } from "./view.js";
 
 export type {
   EventMap,
@@ -47,11 +48,15 @@ export * from "./api/avatars.js";
 export * from "./api/files.js";
 
 // File transfer data
-export { dialFileTransfer, uploadFileData, downloadFileData } from "./transfer.js";
+export {
+  dialFileTransfer,
+  uploadFileData,
+  downloadFileData,
+  FileTransferStage,
+} from "./transfer.js";
 export type {
   FileTransferOptions,
   FileTransferTrace,
-  FileTransferStage,
   FileTransferDialStartInfo,
   FileTransferDialDoneInfo,
   FileTransferProgressInfo,
@@ -99,4 +104,4 @@ export {
   uidAlgorithmForVersion,
   MAX_SECURITY_LEVEL,
 } from "./crypto/index.js";
-export type { UIDAlgorithm } from "./crypto/index.js";
+export { UIDAlgorithm } from "./crypto/index.js";

package/src/client/trace.ts

@@ -44,7 +44,10 @@ export interface ResolveDoneInfo extends AttemptInfo {
   readonly addr: string;
   /** The `host:port` that will be dialled. */
   readonly target: string;
-  /** What the resolver reports as the source of the answer dialled; may be empty. */
+  /**
+   * What the resolver reports as the source of the answer dialled: one of
+   * `ResolveSource` for the built-in resolver. May be empty.
+   */
   readonly source: string;
   /** Every answer the resolver gave, in order; empty when the address is used as given. */
   readonly candidates: readonly ResolvedAddr[];

package/src/client/transfer.ts

@@ -44,8 +44,18 @@ export function failedToConnect(error: unknown): boolean {
   return typeof error === "object" && error !== null && failedBeforeConnect.has(error);
 }
 
+/** The values of the table below, before freezing. */
+const fileTransferStageValues = {
+  /** Reaching the transfer port, before the key is written. */
+  Dial: "dial",
+  /** After the connection opened, while the key or the file moved. */
+  Transfer: "transfer",
+} as const;
 /** Where a failed transfer failed. */
-export type FileTransferStage = "dial" | "transfer";
+export const FileTransferStage: typeof fileTransferStageValues =
+  /* @__PURE__ */ Object.freeze(fileTransferStageValues);
+/** One of {@link FileTransferStage}. */
+export type FileTransferStage = (typeof FileTransferStage)[keyof typeof FileTransferStage];
 
 /** The file transfer port is about to be dialled. */
 export interface FileTransferDialStartInfo {

package/src/client/transport/handler.ts

@@ -10,6 +10,7 @@ import {
   PacketType,
   PacketFlags,
   packetType,
+  packetTypeOfByte,
   packetFlags,
   buildC2SHeader,
   parseS2CHeader,
@@ -563,7 +564,7 @@ export class PacketHandler {
     if (!this.#conn) return;
     if (data.length > TAG_SIZE + HEADER_SIZE - 1) {
       this.#traffic.recordSent(
-        data[TAG_SIZE + HEADER_SIZE - 1]! & 0x0f,
+        packetTypeOfByte(data[TAG_SIZE + HEADER_SIZE - 1]!),
         data.length,
         performance.now(),
       );
@@ -597,7 +598,7 @@ export class PacketHandler {
     const parsed = parseS2CHeader(header);
     // Init1 belongs to the start of the handshake; once crypto init has
     // completed, another one can only restart a session that is already set up.
-    const parsedType: PacketType = parsed.typeFlagged & 0x0f;
+    const parsedType = packetTypeOfByte(parsed.typeFlagged);
     if (parsedType === PacketType.Init1 && this.#crypt.cryptoInitComplete) return;
 
     const p: Packet = {

package/src/client/transport/packet.ts

@@ -27,8 +27,17 @@ export interface Packet {
   receivedAt: number; // performance.now(), a monotonic clock
 }
 
+/**
+ * The packet type in the low nibble of a type byte, as it came off the wire:
+ * the nibble can also hold 9 to 15, which name no type.
+ */
+export function packetTypeOfByte(typeByte: number): PacketType {
+  // oxlint-disable-next-line typescript/no-unsafe-enum-assignment -- read off the wire, where the nibble can be any value
+  return typeByte & 0x0f;
+}
+
 export function packetType(p: Packet): PacketType {
-  return p.typeFlagged & 0x0f;
+  return packetTypeOfByte(p.typeFlagged);
 }
 
 export function packetFlags(p: Packet): number {

package/src/client/types.ts

@@ -385,6 +385,32 @@ export type EventMiddleware = (next: (event: ServerEvent) => void) => (event: Se
 
 // ---- Resolved address (from discovery) --------------------------------------
 
+/** The values of the table below, before freezing. */
+const resolveSourceValues = {
+  /** A `_ts3._udp` SRV record of the host named the address. */
+  SRV: "SRV",
+  /**
+   * A TSDNS server, found through a `_tsdns._tcp` SRV record of the host's
+   * domain, named the address.
+   */
+  TSDNSSRV: "TSDNS-SRV",
+  /** A TSDNS server on the host's domain, at its default port, named the address. */
+  TSDNSDirect: "TSDNS-Direct",
+  /**
+   * The address as given: an IP address, a name nothing else answered for, or
+   * any name once resolution ran out of time.
+   */
+  Direct: "Direct",
+} as const;
+/** How the built-in resolver found an address, as `ResolvedAddr` records it. */
+export const ResolveSource: typeof resolveSourceValues =
+  /* @__PURE__ */ Object.freeze(resolveSourceValues);
+/**
+ * One of {@link ResolveSource}. May gain members in a minor release: a
+ * `switch` over it needs a default case.
+ */
+export type ResolveSource = (typeof ResolveSource)[keyof typeof ResolveSource];
+
 /**
  * An address a server's name resolved to. Only `addr` is needed to connect;
  * the rest describes the answer.
@@ -392,7 +418,10 @@ export type EventMiddleware = (next: (event: ServerEvent) => void) => (event: Se
 export interface ResolvedAddr {
   /** The endpoint, as `host:port`. */
   readonly addr: string;
-  /** How it was found, such as `SRV`, `TSDNS-SRV`, `TSDNS-Direct` or `Direct`. */
+  /**
+   * How it was found. The built-in resolver sets one of `ResolveSource`; a
+   * plain string, since an `AddrResolver` of your own may set any.
+   */
   readonly source?: string | undefined;
   /** When the answer stops being valid; unset for no stated lifetime. */
   readonly expiry?: Date | undefined;

package/src/client/view.ts

@@ -21,20 +21,35 @@ import {
 import { parseIconID } from "../core/internal.js";
 import { abortReason } from "./abort.js";
 
+/** The values of the table below, before freezing. */
+const viewStatusValues = {
+  /** This client has not tried to connect. */
+  Empty: "empty",
+  /**
+   * A connection is being made and the server has not finished its welcome.
+   * The view holds what has arrived, which is not yet the tree.
+   */
+  Loading: "loading",
+  /** The welcome is complete and the connection is up. The view follows the server's notifications. */
+  Live: "live",
+  /**
+   * The connection ended. The view still holds what it last knew, which no
+   * longer changes; the next `connect()` clears it.
+   */
+  Stale: "stale",
+} as const;
 /**
  * Where a {@link ServerView} is in a connection's life.
  *
- * - `"empty"`: this client has not tried to connect.
- * - `"loading"`: a connection is being made and the server has not finished
- *   its welcome. The view holds what has arrived, which is not yet the tree.
- * - `"live"`: the welcome is complete and the connection is up. The view
- *   follows the server's notifications.
- * - `"stale"`: the connection ended. The view still holds what it last knew,
- *   which no longer changes; the next `connect()` clears it.
+ * @experimental New in 1.x and may change in a minor release.
+ */
+export const ViewStatus: typeof viewStatusValues = /* @__PURE__ */ Object.freeze(viewStatusValues);
+/**
+ * One of {@link ViewStatus}.
  *
  * @experimental New in 1.x and may change in a minor release.
  */
-export type ViewStatus = "empty" | "loading" | "live" | "stale";
+export type ViewStatus = (typeof ViewStatus)[keyof typeof ViewStatus];
 
 /**
  * What `viewReady` delivers.
@@ -322,7 +337,7 @@ export class ViewStore {
 
   #logger: Logger;
   #selfID: () => number;
-  #status: ViewStatus = "empty";
+  #status: ViewStatus = ViewStatus.Empty;
   #revision = 0;
   #tree = ChannelTree.from([]);
   /** The `channellist` rows of the welcome in progress, in arrival order. */

package/src/core/api/channels.ts

@@ -36,7 +36,7 @@ import type { ChannelID, ClientDBID } from "../command/ids.js";
 import { asChannelID } from "../command/ids.js";
 import { NoDataError } from "../errors.js";
 import { ErrorCode } from "../errorcode.js";
-import type { Codec } from "../enums.js";
+import type { BannerMode, Codec } from "../enums.js";
 import type { Permission } from "../permission.js";
 
 /**
@@ -111,8 +111,8 @@ export interface ChannelSettings {
   readonly namePhonetic?: string | undefined;
   /** The URL of the channel's banner image (`channel_banner_gfx_url`); needs `b_channel_modify_banner`. */
   readonly bannerURL?: string | undefined;
-  /** How the banner is scaled (`channel_banner_mode`); needs `b_channel_modify_banner`. */
-  readonly bannerMode?: number | undefined;
+  /** How the banner is fitted to the channel (`channel_banner_mode`); needs `b_channel_modify_banner`. */
+  readonly bannerMode?: BannerMode | undefined;
 }
 
 const settingNames: WireNames<ChannelSettings> = {