@honeybbq/teamspeak 0.0.1 → 1.0.0-beta.7

package/dist/core/api/moderation.js

@@ -0,0 +1,209 @@
+/**
+ * Bans, complaints, offline messages, text messages and the server log.
+ *
+ * All administrative: expect a permission error, not an empty list, when the
+ * client lacks the rights.
+ */
+import { nonZero, firstRow, exec, query, list, encodeFields, nonEmpty, toWireDuration, str, big, num, bool, date, durationMs, SECOND, } from "./command.js";
+import { asBanID, asClientDBID, asMessageID, asUID } from "../command/ids.js";
+import { TextMessageTarget } from "../enums.js";
+const parseBan = (row) => ({
+    id: asBanID(big(row, "banid")),
+    ip: str(row, "ip"),
+    name: str(row, "name"),
+    uid: asUID(str(row, "uid")),
+    lastNickname: str(row, "lastnickname"),
+    createdAt: date(row, "created"),
+    durationMs: durationMs(row, "duration", SECOND),
+    invokerDatabaseID: asClientDBID(big(row, "invokercldbid")),
+    invokerName: str(row, "invokername"),
+    invokerUID: asUID(str(row, "invokeruid")),
+    reason: str(row, "reason"),
+    enforcements: num(row, "enforcements"),
+});
+/** Every active ban. A server with none answers an empty list. */
+export async function listBans(client, options) {
+    return (await list(client, "banlist", [], options)).map(parseBan);
+}
+/**
+ * A ban's duration on the wire. A permanent ban (0) omits it: the server's
+ * default is permanent, which is also what `time=0` means. A positive duration
+ * never rounds down to 0, which would make it permanent.
+ */
+const banTime = (ms) => (ms === 0 ? undefined : toWireDuration(ms, SECOND));
+const banNames = {
+    ip: ["ip", nonEmpty],
+    name: ["name", nonEmpty],
+    uid: ["uid", nonEmpty],
+    reason: ["banreason", nonEmpty],
+    durationMs: ["time", banTime],
+};
+const banClientNames = {
+    durationMs: ["time", banTime],
+    reason: ["banreason", nonEmpty],
+};
+/**
+ * Add a ban and return its id — over ServerQuery. The voice protocol reports
+ * no id, so there this resolves to undefined.
+ *
+ * `ban` is what to ban; the command's `signal` and `timeoutMs` go in `options`,
+ * a separate last argument — set among the fields, they are not read.
+ */
+export async function addBan(client, ban, options) {
+    if (!ban.ip && !ban.name && !ban.uid) {
+        throw new TypeError("a ban needs an ip, a name or a uid to match");
+    }
+    const rows = await query(client, "banadd", encodeFields(ban, banNames), options);
+    return rows[0]?.["banid"] === undefined ? undefined : asBanID(big(rows[0], "banid"));
+}
+/**
+ * Ban a connected client by clid, and return the id of every ban that made.
+ *
+ * The server bans the client on several counts at once — its address, its
+ * uid, and on TS6 its myTeamSpeak id — and over ServerQuery answers one
+ * `banid` row for each; returning the first left the others to be found by
+ * hand. The voice protocol reports no ids, so there this resolves to `[]`.
+ */
+export async function banClient(client, clid, options = {}) {
+    const rows = await query(client, "banclient", [["clid", clid], ...encodeFields(options, banClientNames)], options);
+    return rows.flatMap((row) => (str(row, "banid") === "" ? [] : [asBanID(big(row, "banid"))]));
+}
+/** Remove a ban. */
+export async function deleteBan(client, banID, options) {
+    await exec(client, "bandel", [["banid", banID]], options);
+}
+/** Remove every ban. */
+export async function deleteAllBans(client, options) {
+    await exec(client, "bandelall", [], options);
+}
+const parseComplaint = (row) => ({
+    targetDatabaseID: asClientDBID(big(row, "tcldbid")),
+    targetName: str(row, "tname"),
+    fromDatabaseID: asClientDBID(big(row, "fcldbid")),
+    fromName: str(row, "fname"),
+    message: str(row, "message"),
+    createdAt: date(row, "timestamp"),
+});
+/** Complaints, optionally only those against one client. */
+export async function listComplaints(client, options = {}) {
+    // 0 names no client, so it lists every complaint, as unset does.
+    const target = options.targetDatabaseID;
+    const params = [["tcldbid", target === undefined ? undefined : nonZero(target)]];
+    return (await list(client, "complainlist", params, options)).map(parseComplaint);
+}
+/** File a complaint against a client. */
+export async function addComplaint(client, targetDatabaseID, message, options) {
+    await exec(client, "complainadd", [
+        ["tcldbid", targetDatabaseID],
+        ["message", message],
+    ], options);
+}
+/** Withdraw one complaint. */
+export async function deleteComplaint(client, targetDatabaseID, fromDatabaseID, options) {
+    await exec(client, "complaindel", [
+        ["tcldbid", targetDatabaseID],
+        ["fcldbid", fromDatabaseID],
+    ], options);
+}
+/** Withdraw every complaint against a client. */
+export async function deleteAllComplaints(client, targetDatabaseID, options) {
+    await exec(client, "complaindelall", [["tcldbid", targetDatabaseID]], options);
+}
+const parseMessage = (row) => ({
+    id: asMessageID(big(row, "msgid")),
+    uid: asUID(str(row, "cluid")),
+    subject: str(row, "subject"),
+    message: str(row, "message"),
+    sentAt: date(row, "timestamp"),
+    isRead: bool(row, "flag_read"),
+});
+/** Offline messages for this client. None is an empty list. */
+export async function listMessages(client, options) {
+    return (await list(client, "messagelist", [], options)).map(parseMessage);
+}
+/** One offline message, with its text. */
+export async function getMessage(client, messageID, options) {
+    const rows = await query(client, "messageget", [["msgid", messageID]], options);
+    return { ...parseMessage(firstRow(rows, "messageget")), id: messageID };
+}
+/** Delete an offline message. */
+export async function deleteMessage(client, messageID, options) {
+    await exec(client, "messagedel", [["msgid", messageID]], options);
+}
+/** Mark a message read or unread. */
+export async function updateMessageFlag(client, messageID, flags, options) {
+    await exec(client, "messageupdateflag", [
+        ["msgid", messageID],
+        ["flag", flags.read],
+    ], options);
+}
+// ---- Text messages ----------------------------------------------------------
+//
+// Three functions rather than one taking a mode and an id, because the id meant
+// a different thing in each mode — a clid, a cid, or nothing — and an untyped
+// one let a channel id reach an unrelated client.
+//
+// Each waits for the server's answer, so a refusal — no permission to message
+// that target — is thrown rather than lost.
+/** Send a text message to one client. */
+export async function sendPrivateMessage(client, clid, message, options) {
+    await exec(client, "sendtextmessage", [
+        ["targetmode", TextMessageTarget.Client],
+        ["target", clid],
+        ["msg", message],
+    ], options);
+}
+/**
+ * Send a text message to the channel this connection is in.
+ *
+ * It takes no channel because the server takes none: measured on TS3 and TS6,
+ * a channel message naming another channel still arrives in the sender's own.
+ * To write to another channel, move there first.
+ */
+export async function sendChannelMessage(client, message, options) {
+    await exec(client, "sendtextmessage", [
+        ["targetmode", TextMessageTarget.Channel],
+        ["msg", message],
+    ], options);
+}
+/** Send a text message to everyone on the virtual server. */
+export async function sendServerMessage(client, message, options) {
+    await exec(client, "sendtextmessage", [
+        ["targetmode", TextMessageTarget.Server],
+        ["msg", message],
+    ], options);
+}
+const logViewNames = {
+    lines: ["lines", (lines) => (lines === 0 ? undefined : lines)],
+    reverse: "reverse",
+    instance: "instance",
+    beginPosition: "begin_pos",
+};
+/** Read a page of the server log. */
+export async function viewLog(client, options = {}) {
+    const fields = {
+        ...options,
+        reverse: options.reverse ?? false,
+        instance: options.instance ?? false,
+    };
+    const rows = await query(client, "logview", encodeFields(fields, logViewNames), options);
+    const first = firstRow(rows, "logview");
+    // One line per row, under the key `l`. This used to read only a `log` field
+    // from the first row, which the server does not send; it is still read,
+    // should a server send the lines that way.
+    const lines = rows.flatMap((row) => (row["l"] === undefined ? [] : [row["l"]]));
+    const joined = str(first, "log");
+    return {
+        lines: lines.length === 0 && joined !== "" ? joined.split("\n") : lines,
+        lastPosition: num(first, "last_pos"),
+        fileSize: num(first, "file_size"),
+    };
+}
+/** Write an entry to the server log. */
+export async function addLog(client, level, message, options) {
+    await exec(client, "logadd", [
+        ["loglevel", level],
+        ["logmsg", message],
+    ], options);
+}
+//# sourceMappingURL=moderation.js.map

package/dist/core/api/moderation.js.map

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

package/dist/core/api/parse.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Row parsers shared with the client and query modules, kept out of the public index:
+ * they read wire rows, which is plumbing, not API. They reach them through
+ * `./internal`.
+ */
+import type { ServerGroupID } from "../command/ids.js";
+import type { ClientEntry } from "./clients.js";
+/** A comma-separated list of server group ids; anything that is not one is skipped. */
+export declare function parseServerGroups(raw: string): ServerGroupID[];
+/**
+ * Read a client from a `clientlist` row, or from a `notifycliententerview`,
+ * which names its channel `ctid` where the list says `cid`. Reached by the
+ * client module through `./internal`.
+ */
+export declare function parseClient(row: Record<string, string>): ClientEntry;
+//# sourceMappingURL=parse.d.ts.map

package/dist/core/api/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/core/api/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAO9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAmBpE"}

package/dist/core/api/parse.js

@@ -0,0 +1,40 @@
+/**
+ * Row parsers shared with the client and query modules, kept out of the public index:
+ * they read wire rows, which is plumbing, not API. They reach them through
+ * `./internal`.
+ */
+import { str, big, num, uint, U16, bool, date, durationMs, MILLISECOND } from "./command.js";
+import { asChannelID, asChannelGroupID, asClientID, asServerGroupID, asUID, } from "../command/ids.js";
+/** A comma-separated list of server group ids; anything that is not one is skipped. */
+export function parseServerGroups(raw) {
+    if (raw === "")
+        return [];
+    return raw
+        .split(",")
+        .flatMap((id) => /^\d{1,20}$/.test(id) && BigInt(id) < 1n << 64n ? [asServerGroupID(BigInt(id))] : []);
+}
+/**
+ * Read a client from a `clientlist` row, or from a `notifycliententerview`,
+ * which names its channel `ctid` where the list says `cid`. Reached by the
+ * client module through `./internal`.
+ */
+export function parseClient(row) {
+    return {
+        id: asClientID(uint(row, "clid", U16)),
+        nickname: str(row, "client_nickname"),
+        uid: asUID(str(row, "client_unique_identifier")),
+        channelID: asChannelID(big(row, row["cid"] === undefined ? "ctid" : "cid")),
+        type: num(row, "client_type"),
+        serverGroups: parseServerGroups(row["client_servergroups"] ?? ""),
+        isAway: bool(row, "client_away"),
+        isRecording: bool(row, "client_is_recording"),
+        isTalker: bool(row, "client_is_talker"),
+        channelGroupID: asChannelGroupID(big(row, "client_channel_group_id")),
+        createdAt: date(row, "client_created"),
+        lastConnectedAt: date(row, "client_lastconnected"),
+        idleTimeMs: row["client_idle_time"] === undefined
+            ? undefined
+            : durationMs(row, "client_idle_time", MILLISECOND),
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/api/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/api/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,KAAK,GACN,MAAM,mBAAmB,CAAC;AAG3B,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CACd,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACrF,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAA2B;IACrD,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACtC,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,iBAAiB,CAAC;QACrC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;QAChD,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC;QAC7B,YAAY,EAAE,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;QAChC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC;QAC7C,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACvC,cAAc,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;QACrE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC;QACtC,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC;QAClD,UAAU,EACR,GAAG,CAAC,kBAAkB,CAAC,KAAK,SAAS;YACnC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,kBAAkB,EAAE,WAAW,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/core/api/server.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Server and instance commands.
+ *
+ * "Server" here means the virtual server a client is connected to; "instance"
+ * means the process hosting it. The distinction matters because the setting
+ * names differ (`virtualserver_*` versus `serverinstance_*`) and the two are
+ * easy to mix up.
+ */
+import type { PermissionEntry } from "./command.js";
+import type { CommandExecutor, CommandOptions } from "../command/request.js";
+import type { ChannelID, ClientDBID, ClientID, IconID, ServerGroupID, ServerID, UID } from "../command/ids.js";
+import type { GroupType } from "../enums.js";
+import type { GroupDeleteOptions } from "./groups.js";
+import type { Permission } from "../permission.js";
+/** A server group as `servergrouplist` reports it. */
+export interface ServerGroup {
+    /** The group's id. */
+    readonly id: ServerGroupID;
+    /** The group's name. */
+    readonly name: string;
+    /** What kind of group this is, one of {@link GroupType}. */
+    readonly type: number;
+    /** The group's icon, or undefined for none. */
+    readonly iconID: IconID | undefined;
+    /** Whether membership is stored, rather than lost when the server restarts. */
+    readonly savedInDatabase: boolean;
+    /** Where the group sorts among the others; a 32-bit value. */
+    readonly sortID: number;
+    /** Where the group's name shows beside a member's nickname, one of {@link GroupNameMode}. */
+    readonly nameMode: number;
+    /** The power needed to modify the group. */
+    readonly modifyPower: number;
+    /** The power needed to add a member. */
+    readonly memberAddPower: number;
+    /** The power needed to remove a member. */
+    readonly memberRemovePower: number;
+}
+/** Every server group. */
+export declare function listServerGroups(client: CommandExecutor, options?: CommandOptions): Promise<ServerGroup[]>;
+/**
+ * The virtual server's settings, as `serverinfo` reports them.
+ *
+ * Raw rather than parsed: `serverinfo` carries well over a hundred
+ * `virtualserver_*` fields, which ones appear depends on the server version and
+ * on the caller's permissions, and a typed subset would drop the rest. The
+ * keys are named in `PropertyName`.
+ */
+export declare function getServerInfo(client: CommandExecutor, options?: CommandOptions): Promise<Readonly<Record<string, string>>>;
+/**
+ * Change the virtual server's settings. Only the properties you pass are sent.
+ *
+ * Unlike every other options object, these are the raw `virtualserver_*`
+ * wire properties from `serverinfo`, passed through as given rather than
+ * enumerated: there are well over a hundred, they are version-dependent, and a
+ * value read back from {@link getServerInfo} should be writable straight back.
+ * The values are strings, as `getServerInfo` returns them. The editable keys
+ * are marked in `PropertyName`.
+ */
+export declare function editServer(client: CommandExecutor, settings: Readonly<Record<string, string>>, options?: CommandOptions): Promise<void>;
+/**
+ * The host process's settings, as `hostinfo` reports them, raw.
+ *
+ * Needs an instance-level permission (`b_serverinstance_*`), which not even the
+ * Server Admin group holds by default — expect error 2568 until it is granted.
+ * Granted, it works over the voice protocol like any other query. The keys are
+ * named in `PropertyName`.
+ */
+export declare function getHostInfo(client: CommandExecutor, options?: CommandOptions): Promise<Readonly<Record<string, string>>>;
+/**
+ * The server instance's settings, as `instanceinfo` reports them, raw.
+ *
+ * Needs an instance-level permission (`b_serverinstance_*`), which not even the
+ * Server Admin group holds by default — expect error 2568 until it is granted.
+ * Granted, it works over the voice protocol like any other query. The keys are
+ * named in `PropertyName`.
+ */
+export declare function getInstanceInfo(client: CommandExecutor, options?: CommandOptions): Promise<Readonly<Record<string, string>>>;
+/**
+ * Change the server instance's settings: raw `serverinstance_*` properties,
+ * passed through as given, for the same reasons as {@link editServer}. The
+ * editable keys are marked in `PropertyName`.
+ */
+export declare function editInstance(client: CommandExecutor, settings: Readonly<Record<string, string>>, options?: CommandOptions): Promise<void>;
+/** An address the instance listens on. */
+export interface Binding {
+    /**
+     * What listens there: `voice`, `query` or `filetransfer`. The server does not
+     * name it in each row, so it is the subsystem asked for, or `voice` when none
+     * was.
+     */
+    readonly subsystem: string;
+    /** The address. */
+    readonly ip: string;
+    /** The port; undefined when the server does not report one. */
+    readonly port: number | undefined;
+}
+/** Which bindings {@link listBindings} reports. */
+export interface BindingListOptions extends CommandOptions {
+    /** Only this subsystem's: `voice`, `query` or `filetransfer`; unset for all (`subsystem`). */
+    readonly subsystem?: string | undefined;
+}
+/**
+ * Active IP bindings, when the instance is multi-homed.
+ *
+ * Needs an instance-level permission (`b_serverinstance_*`), which not even the
+ * Server Admin group holds by default — expect error 2568 until it is granted.
+ * Granted, it works over the voice protocol like any other query.
+ */
+export declare function listBindings(client: CommandExecutor, options?: BindingListOptions): Promise<Binding[]>;
+/** The server's build, as `version` reports it. */
+export interface ServerVersion {
+    /** The version, such as "3.13.7". */
+    readonly version: string;
+    /** The build number. */
+    readonly build: number;
+    /** The platform the server runs on, such as "Linux". */
+    readonly platform: string;
+}
+/** The server's build version. */
+export declare function getVersion(client: CommandExecutor, options?: CommandOptions): Promise<ServerVersion>;
+/** Which server and client a connection is, as `whoami` reports it. */
+export interface WhoAmI {
+    /** The virtual server's state, such as "online" (`virtualserver_status`). */
+    readonly serverStatus: string;
+    /** The virtual server's id, 0 when none is selected (`virtualserver_id`). */
+    readonly serverID: ServerID;
+    /** The virtual server's unique identifier (`virtualserver_unique_identifier`). */
+    readonly serverUID: string;
+    /** The virtual server's voice port (`virtualserver_port`). */
+    readonly serverPort: number;
+    /** This connection's client id (`client_id`). */
+    readonly clientID: ClientID;
+    /** The channel this connection is in (`client_channel_id`). */
+    readonly channelID: ChannelID;
+    /** This connection's nickname (`client_nickname`). */
+    readonly nickname: string;
+    /** This connection's database id (`client_database_id`). */
+    readonly databaseID: ClientDBID;
+    /** The ServerQuery login name, "" for a voice client (`client_login_name`). */
+    readonly loginName: string;
+    /**
+     * This connection's unique identifier (`client_unique_identifier`). The voice
+     * protocol sends the field empty; the voice client's `uid` has
+     * it.
+     */
+    readonly uid: UID;
+}
+/** Which server and client this connection is, as the server sees it. */
+export declare function whoAmI(client: CommandExecutor, options?: CommandOptions): Promise<WhoAmI>;
+/**
+ * The virtual server's traffic, as `serverrequestconnectioninfo` reports it.
+ * Byte counts are bytes; bandwidths are bytes per second.
+ */
+export interface ServerConnectionInfo {
+    /** File transfer bandwidth out (`connection_filetransfer_bandwidth_sent`). */
+    readonly fileTransferBandwidthSent: number;
+    /** File transfer bandwidth in (`connection_filetransfer_bandwidth_received`). */
+    readonly fileTransferBandwidthReceived: number;
+    /** File transfer bytes sent (`connection_filetransfer_bytes_sent_total`). */
+    readonly fileTransferBytesSent: number;
+    /** File transfer bytes received (`connection_filetransfer_bytes_received_total`). */
+    readonly fileTransferBytesReceived: number;
+    /** Packets sent (`connection_packets_sent_total`). */
+    readonly packetsSent: number;
+    /** Bytes sent (`connection_bytes_sent_total`). */
+    readonly bytesSent: number;
+    /** Packets received (`connection_packets_received_total`). */
+    readonly packetsReceived: number;
+    /** Bytes received (`connection_bytes_received_total`). */
+    readonly bytesReceived: number;
+    /** Bandwidth out over the last second (`connection_bandwidth_sent_last_second_total`). */
+    readonly bandwidthSentLastSecond: number;
+    /** Bandwidth out over the last minute (`connection_bandwidth_sent_last_minute_total`). */
+    readonly bandwidthSentLastMinute: number;
+    /** Bandwidth in over the last second (`connection_bandwidth_received_last_second_total`). */
+    readonly bandwidthReceivedLastSecond: number;
+    /** Bandwidth in over the last minute (`connection_bandwidth_received_last_minute_total`). */
+    readonly bandwidthReceivedLastMinute: number;
+    /**
+     * How long the virtual server has been running, in milliseconds
+     * (`connection_connected_time`). Sent in seconds here — unlike the field of
+     * the same name in `clientinfo`, which is in milliseconds.
+     */
+    readonly connectedTimeMs: number;
+    /** The share of packets lost, 0 to 1 (`connection_packetloss_total`). */
+    readonly packetLoss: number;
+    /** The average ping, in milliseconds (`connection_ping`). */
+    readonly pingMs: number;
+}
+/**
+ * The virtual server's traffic statistics — not this connection's, as the
+ * command's name suggests.
+ */
+export declare function getConnectionInfo(client: CommandExecutor, options?: CommandOptions): Promise<ServerConnectionInfo>;
+/**
+ * The numeric id of the virtual server listening on `port`.
+ *
+ * Needs an instance-level permission (`b_serverinstance_*`), which not even the
+ * Server Admin group holds by default — expect error 2568 until it is granted.
+ * Granted, it works over the voice protocol like any other query.
+ */
+export declare function getServerIDByPort(client: CommandExecutor, port: number, options?: CommandOptions): Promise<ServerID>;
+/**
+ * Create a server group.
+ *
+ * `type` is required, and always sent: the server's own default is
+ * `GroupType.Regular`, while the type's first value is `Template`, so leaving
+ * it to a default on either side is a trap.
+ */
+export declare function createServerGroup(client: CommandExecutor, name: string, type: GroupType, options?: CommandOptions): Promise<ServerGroupID>;
+/** Delete a server group. */
+export declare function deleteServerGroup(client: CommandExecutor, sgid: ServerGroupID, options?: GroupDeleteOptions): Promise<void>;
+/** Rename a server group. */
+export declare function renameServerGroup(client: CommandExecutor, sgid: ServerGroupID, name: string, options?: CommandOptions): Promise<void>;
+/**
+ * Copy a server group's permissions onto another; a `targetGroupID` of 0 makes
+ * the server create a new group named `name`, of `type`.
+ */
+export declare function copyServerGroup(client: CommandExecutor, sourceGroupID: ServerGroupID, targetGroupID: ServerGroupID, name: string, type: GroupType, options?: CommandOptions): Promise<ServerGroupID>;
+/** Add a client to a server group. */
+export declare function addClientToServerGroup(client: CommandExecutor, sgid: ServerGroupID, cldbid: ClientDBID, options?: CommandOptions): Promise<void>;
+/** Remove a client from a server group. */
+export declare function removeClientFromServerGroup(client: CommandExecutor, sgid: ServerGroupID, cldbid: ClientDBID, options?: CommandOptions): Promise<void>;
+/** Which optional fields `servergroupclientlist` should include. */
+export interface ServerGroupClientListOptions extends CommandOptions {
+    /** Each member's nickname (`-names`). */
+    readonly names?: boolean | undefined;
+    /** Each member's unique identifier (`-uid`). */
+    readonly uids?: boolean | undefined;
+}
+/** A member of a server group. */
+export interface ServerGroupMember {
+    /** The member's database id. */
+    readonly databaseID: ClientDBID;
+    /** The member's nickname, with `names`; "" otherwise. */
+    readonly nickname: string;
+    /** The member's unique identifier, with `uids`; "" otherwise. */
+    readonly uid: UID;
+}
+/** Members of a server group, optionally with their nicknames and uids. */
+export declare function listServerGroupClients(client: CommandExecutor, sgid: ServerGroupID, options?: ServerGroupClientListOptions): Promise<ServerGroupMember[]>;
+/** A server group a client belongs to. */
+export interface ServerGroupRef {
+    /** The group's id. */
+    readonly id: ServerGroupID;
+    /** The group's name. */
+    readonly name: string;
+}
+/** Server groups a client belongs to. */
+export declare function getServerGroupsByClient(client: CommandExecutor, cldbid: ClientDBID, options?: CommandOptions): Promise<ServerGroupRef[]>;
+/** Permissions set on a server group. */
+export declare function listServerGroupPermissions(client: CommandExecutor, sgid: ServerGroupID, options?: CommandOptions): Promise<PermissionEntry[]>;
+/** How {@link addServerGroupPermission} sets the permission. */
+export interface ServerGroupPermissionOptions extends CommandOptions {
+    /** Whether the value is negated, so the lowest wins; false by default (`permnegated`). */
+    readonly negated?: boolean | undefined;
+    /** Whether it skips channel and client overrides; false by default (`permskip`). */
+    readonly skip?: boolean | undefined;
+}
+/** Set a permission on a server group. */
+export declare function addServerGroupPermission(client: CommandExecutor, sgid: ServerGroupID, permission: Permission, value: number, options?: ServerGroupPermissionOptions): Promise<void>;
+/** Remove a permission from a server group. */
+export declare function deleteServerGroupPermission(client: CommandExecutor, sgid: ServerGroupID, permission: Permission, options?: CommandOptions): Promise<void>;
+/** A temporary server password. */
+export interface TempPassword {
+    /** The password itself (`pw_clear`). */
+    readonly password: string;
+    /** What it is for (`desc`). */
+    readonly description: string;
+    /** Who created it (`nickname`). */
+    readonly creatorNickname: string;
+    /** The creator's unique identifier (`uid`). */
+    readonly creatorUID: UID;
+    /** When it became valid (`start`). */
+    readonly startsAt: Date | undefined;
+    /** When it stops being valid (`end`). */
+    readonly endsAt: Date | undefined;
+    /** The channel a client joining with it lands in, or 0 for the default channel. */
+    readonly targetChannelID: ChannelID;
+}
+/** The server's temporary passwords. */
+export declare function listTempPasswords(client: CommandExecutor, options?: CommandOptions): Promise<TempPassword[]>;
+/** A temporary password to create. */
+export interface TempPasswordOptions {
+    /**
+     * The password (`pw`). The caller chooses it; the server does not generate
+     * one, and an empty one is refused here rather than created.
+     */
+    readonly password: string;
+    /** What it is for, shown in the list (`desc`). */
+    readonly description: string;
+    /**
+     * How long it stays valid, in milliseconds (`duration`). Sent in whole
+     * seconds; a positive duration under a second is sent as one.
+     */
+    readonly durationMs: number;
+    /** The channel a client joining with it lands in; unset or 0 is the default channel (`tcid`). */
+    readonly targetChannelID?: ChannelID | undefined;
+    /** That channel's password, in cleartext; unset or "" for none (`tcpw`). */
+    readonly targetChannelPassword?: string | undefined;
+}
+/**
+ * Create a temporary server password.
+ *
+ * The server reports nothing back — the password is the one passed in.
+ */
+export declare function addTempPassword(client: CommandExecutor, temp: TempPasswordOptions, options?: CommandOptions): Promise<void>;
+/** Delete a temporary password. */
+export declare function deleteTempPassword(client: CommandExecutor, password: string, options?: CommandOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/core/api/server.d.ts.map

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