serchat.ts 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,2090 @@
+// Generated by dts-bundle-generator v9.5.1
+
+import { EventEmitter } from 'events';
+import WebSocket$1 from 'ws';
+
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+export interface JsonObject {
+	[key: string]: JsonValue | undefined;
+}
+export type JsonArray = JsonValue[];
+/** Base class for all errors thrown by the Serchat SDK. */
+export declare class SerchatError extends Error {
+	constructor(message: string);
+}
+/** Represents an HTTP error response from the Serchat API.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.sendMessage(serverId, channelId, 'Hello!');
+ * } catch (err) {
+ *   if (err instanceof APIError) {
+ *     console.error(`API returned ${err.status}:`, err.data);
+ *   }
+ * }
+ * ```
+ */
+export declare class APIError extends SerchatError {
+	/** HTTP status code. */
+	status: number;
+	/** Raw response body. */
+	data: JsonValue;
+	/** Response headers. */
+	headers: Record<string, string>;
+	/** Full fetch response object. */
+	response?: Response;
+	constructor(status: number, data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **400 Bad Request**. */
+export declare class BadRequestError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **401 Unauthorized** (invalid or missing token). */
+export declare class UnauthorizedError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **403 Forbidden** (insufficient permissions). */
+export declare class ForbiddenError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **404 Not Found**. */
+export declare class NotFoundError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **429 Too Many Requests**. Back off and retry later. */
+export declare class RateLimitError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **500 Internal Server Error**. */
+export declare class InternalServerError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **502 Bad Gateway**. */
+export declare class BadGatewayError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **503 Service Unavailable**. */
+export declare class ServiceUnavailableError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+/** Thrown when the API returns HTTP **504 Gateway Timeout**. */
+export declare class GatewayTimeoutError extends APIError {
+	constructor(data: JsonValue, response?: Response);
+}
+export type Primitive = string | number | boolean | null | undefined;
+export type SerializableParamValue = Primitive | SerializableParamValue[] | {
+	[key: string]: SerializableParamValue;
+};
+export interface Interceptors {
+	request: Array<(config: RequestInit & {
+		url: string;
+	}) => RequestInit & {
+		url: string;
+	}>;
+	response: Array<(response: Response) => Response | Promise<Response>>;
+	/**
+	 * Interceptors called when a request fails.
+	 *
+	 * NOTE: Error interceptors can transform or replace the error, or throw a new one.
+	 * They cannot "recover" from an error to return a successful response data.
+	 */
+	error: Array<(error: APIError) => APIError | Promise<never>>;
+}
+export type APIResponse<T> = {
+	data: T;
+};
+export type EmptyResponse = {
+	data: null;
+};
+/**
+ * Utility to unwrap an API response, throwing if the data is null (e.g. 204 No Content).
+ */
+export declare function unwrap<T>({ data }: APIResponse<T> | EmptyResponse): T;
+/**
+ * Options for initializing a {@link RESTClient}.
+ */
+export interface RESTOptions {
+	/** The base URL for all API requests. */
+	baseURL: string;
+	/** Default headers to include in every request. */
+	headers?: Record<string, string | undefined>;
+	/** Credentials mode for fetch requests. */
+	credentials?: RequestCredentials;
+	/** Default timeout in milliseconds for requests. */
+	timeout?: number;
+	/** Optional hook to transform response data. */
+	transformResponse?: (data: JsonValue, response: Response) => JsonValue;
+	/** Cookie name to read CSRF token from. */
+	csrfCookieName?: string;
+	/** Header name to use for CSRF token. */
+	csrfHeaderName?: string;
+	/** Controls redirect behaviour. Defaults to 'error' to prevent
+	 *  credential leakage to unexpected origins. */
+	redirect?: RequestRedirect;
+	/** If set, responses whose body exceeds this value (in bytes) are rejected
+	 *  mid-stream regardless of whether a Content-Length header is present. */
+	maxResponseBytes?: number;
+	/** Retry configuration for transient failures. */
+	retry?: {
+		/** Total number of attempts including the first. Defaults to 1 (no retry). */
+		maxAttempts: number;
+		retryOn?: number[];
+		backoff?: (attempt: number) => number;
+	};
+}
+/**
+ * A wrapper around the Fetch API for interacting with the Serchat REST API.
+ *
+ * Handles JSON serialization, error mapping, and authentication headers.
+ * Supports standard HTTP methods (GET, POST, PUT, PATCH, DELETE).
+ */
+export declare class RESTClient {
+	private options;
+	/**
+	 * Default headers applied to every request sent by this client.
+	 */
+	private _headers;
+	private _pending;
+	readonly interceptors: Interceptors;
+	constructor(options: RESTOptions, pending?: Set<AbortController>);
+	/**
+	 * Gets the current default headers.
+	 */
+	get headers(): Readonly<Record<string, string>>;
+	/**
+	 * Sets a default header to be included in every request.
+	 * @param key - The header name.
+	 * @param value - The header value, or undefined to remove it.
+	 */
+	setDefaultHeader(key: string, value: string | undefined): void;
+	/**
+	 * Creates a new scoped client that inherits configuration, headers, and interceptors
+	 * but adds a path prefix.
+	 *
+	 * NOTE: Both request tracking (_pending) AND interceptors are shared
+	 * between the parent and scoped instances. Mutations to either propagate
+	 * in both directions. If you need an independent interceptor chain, call
+	 * `.interceptors.request = [...parent.interceptors.request]` on the child
+	 * after scoping.
+	 */
+	scoped(pathPrefix: string): RESTClient;
+	/**
+	 * Aborts all in-flight requests initiated by this client instance (and shared scoped instances).
+	 */
+	abortAll(): void;
+	private buildURL;
+	private combineSignals;
+	private escapeRegExp;
+	private limitResponseBody;
+	private request;
+	private getCookie;
+	private serializeParams;
+	private mapError;
+	/**
+	 * Performs a GET request.
+	 *
+	 * @param path - The API endpoint path.
+	 * @param config - Optional query parameters and additional headers.
+	 * @returns The parsed response data.
+	 */
+	get<T = JsonValue>(path: string, config?: {
+		params?: Record<string, SerializableParamValue>;
+		headers?: Record<string, string | undefined>;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<APIResponse<T> | EmptyResponse>;
+	private mutate;
+	/**
+	 * Performs a POST request.
+	 *
+	 * @param path - The API endpoint path.
+	 * @param body - The request body (JSON, FormData, Blob, ArrayBuffer, or ReadableStream).
+	 * @param config - Additional headers.
+	 * @returns The parsed response data.
+	 */
+	post<T = JsonValue>(path: string, body?: JsonValue | FormData | Blob | ArrayBuffer | ReadableStream, config?: {
+		headers?: Record<string, string | undefined>;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<APIResponse<T> | EmptyResponse>;
+	/**
+	 * Performs a PUT request.
+	 *
+	 * @param path - The API endpoint path.
+	 * @param body - The request body (JSON, FormData, Blob, ArrayBuffer, or ReadableStream).
+	 * @param config - Additional headers.
+	 * @returns The parsed response data.
+	 */
+	put<T = JsonValue>(path: string, body?: JsonValue | FormData | Blob | ArrayBuffer | ReadableStream, config?: {
+		headers?: Record<string, string | undefined>;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<APIResponse<T> | EmptyResponse>;
+	/**
+	 * Performs a PATCH request.
+	 *
+	 * @param path - The API endpoint path.
+	 * @param body - The request body (JSON, FormData, Blob, ArrayBuffer, or ReadableStream).
+	 * @param config - Additional headers.
+	 * @returns The parsed response data.
+	 */
+	patch<T = JsonValue>(path: string, body?: JsonValue | FormData | Blob | ArrayBuffer | ReadableStream, config?: {
+		headers?: Record<string, string | undefined>;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<APIResponse<T> | EmptyResponse>;
+	/**
+	 * Performs a DELETE request.
+	 *
+	 * @param path - The API endpoint path.
+	 * @param body - Optional body (JSON, FormData, Blob, ArrayBuffer, or ReadableStream).
+	 * @param config - Additional headers.
+	 * @returns The parsed response data.
+	 */
+	delete<T = JsonValue>(path: string, body?: JsonValue | FormData | Blob | ArrayBuffer | ReadableStream, config?: {
+		headers?: Record<string, string | undefined>;
+		signal?: AbortSignal;
+		timeout?: number;
+	}): Promise<APIResponse<T> | EmptyResponse>;
+}
+/** Manages the bot's WebSocket connection to the Serchat gateway. */
+export declare class WebSocketManager {
+	/** The underlying `ws` WebSocket instance, or `null` when disconnected. */
+	ws: WebSocket$1 | null;
+	private client;
+	/** Correlates request IDs with their resolve/reject handlers. */
+	private pendingRequests;
+	/**
+	 * @param client - The owning {@link Client} instance.
+	 */
+	constructor(client: Client);
+	private reconnectAttempts;
+	private reconnectTimeout;
+	private connectionPromise;
+	private connectionResolve;
+	private connectionReject;
+	private heartbeatInterval;
+	private heartbeatTimeout;
+	private heartbeatRequestId;
+	private readonly heartbeatIntervalMs;
+	private readonly heartbeatTimeoutMs;
+	/** Establishes the WebSocket connection. */
+	connect(): Promise<void>;
+	/**
+	 * Internal method that creates and configures the raw WebSocket instance.
+	 * Called by {@link connect} and by the reconnect scheduler.
+	 */
+	private _connect;
+	private startHeartbeat;
+	private stopHeartbeat;
+	private sendHeartbeat;
+	private handleHeartbeatPong;
+	/** Reconnects with exponential backoff. */
+	private scheduleReconnect;
+	/** Sends a join_server event and waits for confirmation. */
+	joinServer(serverId: string): Promise<void>;
+}
+export interface InteractionResolvedUser {
+	_id: string;
+	id: string;
+	username: string;
+	displayName?: string;
+	profilePicture?: string;
+	isBot?: boolean;
+}
+export interface InteractionResolvedChannel {
+	_id: string;
+	id: string;
+	name: string;
+	type: string;
+}
+export interface InteractionResolvedRole {
+	_id: string;
+	id: string;
+	name: string;
+	color?: string;
+}
+export type InteractionValue = string | number | boolean | InteractionResolvedUser | InteractionResolvedChannel | InteractionResolvedRole;
+export declare enum SlashCommandOptionType {
+	SUB_COMMAND = 1,
+	STRING = 3,
+	INTEGER = 4,
+	BOOLEAN = 5,
+	USER = 6,
+	CHANNEL = 7,
+	ROLE = 8
+}
+export interface SlashCommandOption extends JsonObject {
+	type: SlashCommandOptionType;
+	name: string;
+	description: string;
+	required?: boolean;
+}
+export interface SlashCommandData extends JsonObject {
+	id?: string;
+	name: string;
+	description: string;
+	options?: SlashCommandOption[];
+	shouldReply?: boolean;
+}
+export interface InteractionOption {
+	name: string;
+	value: InteractionValue;
+	type?: SlashCommandOptionType;
+}
+export type EmbedType = "rich" | "image" | "video" | "gifv" | "article" | "link";
+export interface IEmbedField {
+	name: string;
+	value: string;
+	inline?: boolean;
+}
+export interface IEmbedAuthor {
+	name: string;
+	url?: string;
+	icon_url?: string;
+}
+export interface IEmbedFooter {
+	text: string;
+	icon_url?: string;
+}
+export interface IEmbedMedia {
+	url: string;
+	width?: number;
+	height?: number;
+}
+export interface IEmbedProvider {
+	name?: string;
+	url?: string;
+}
+export interface IEmbed {
+	type?: EmbedType;
+	color?: number;
+	title?: string;
+	url?: string;
+	description?: string;
+	timestamp?: string;
+	author?: IEmbedAuthor;
+	footer?: IEmbedFooter;
+	thumbnail?: IEmbedMedia;
+	image?: IEmbedMedia;
+	video?: IEmbedMedia;
+	provider?: IEmbedProvider;
+	fields?: IEmbedField[];
+}
+export interface IPollOption {
+	id: string;
+	text: string;
+	emoji?: string;
+	emojiType?: "unicode" | "custom";
+	emojiId?: string;
+	votes: string[];
+}
+export interface IPoll {
+	title: string;
+	options: IPollOption[];
+	multiSelect: boolean;
+	expiresAt?: string;
+}
+export type MessageAttachmentType = "image" | "video" | "audio" | "text" | "file";
+export interface IMessageAttachment {
+	attachmentId: string;
+	type: MessageAttachmentType;
+	mimeType: string;
+	name: string;
+	size: number;
+	width?: number;
+	height?: number;
+	spoiler?: boolean;
+}
+export interface IMessageServer {
+	messageId: string;
+	_id?: string;
+	serverId: string;
+	channelId: string;
+	senderId: string;
+	senderUsername: string;
+	text: string;
+	createdAt: string;
+	replyToId?: string;
+	repliedTo?: {
+		messageId: string;
+		senderId: string;
+		senderUsername: string;
+		text: string;
+	};
+	isEdited: boolean;
+	isPinned: boolean;
+	isSticky: boolean;
+	isWebhook: boolean;
+	webhookUsername?: string;
+	webhookAvatarUrl?: string;
+	embeds?: IEmbed[];
+	attachments?: IMessageAttachment[];
+	interaction?: {
+		command: string;
+		options: {
+			name: string;
+			value: InteractionValue;
+		}[];
+		user: {
+			id: string;
+			username: string;
+		};
+	};
+	poll?: IPoll;
+	stickerId?: string;
+	senderIsBot?: boolean;
+}
+export interface IPollInput {
+	title: string;
+	options: {
+		text: string;
+		emoji?: string;
+		emojiType?: "unicode" | "custom";
+		emojiId?: string;
+	}[];
+	multiSelect?: boolean;
+	expiresAt?: string;
+}
+export interface ISendMessageRequest {
+	content?: string;
+	text?: string;
+	replyToId?: string;
+	noEmbedsUrls?: string[];
+	embeds?: IEmbed[];
+	attachments?: IMessageAttachment[];
+	interaction?: {
+		command: string;
+		options: {
+			name: string;
+			value: InteractionValue;
+		}[];
+		user: {
+			id: string;
+			username: string;
+		};
+	};
+	poll?: IPollInput | {
+		toJSON(): IPollInput;
+	};
+}
+export interface IMessageWithEmbeds {
+	embeds?: (IEmbed | {
+		toJSON(): IEmbed;
+	})[];
+}
+export interface IBulkDeleteMessagesRequest {
+	messageIds: string[];
+}
+export declare const PERMISSION_KEYS: readonly [
+	"viewChannels",
+	"sendMessages",
+	"addReactions",
+	"connect",
+	"manageMessages",
+	"deleteMessagesOfOthers",
+	"manageChannels",
+	"manageRoles",
+	"banMembers",
+	"kickMembers",
+	"manageInvites",
+	"manageServer",
+	"administrator",
+	"manageWebhooks",
+	"pingRolesAndEveryone",
+	"manageReactions",
+	"exportChannelMessages",
+	"bypassSlowmode",
+	"pinMessages",
+	"seeDeletedMessages",
+	"moderateMembers",
+	"manageStickers"
+];
+export type PermissionKey = (typeof PERMISSION_KEYS)[number];
+export type ServerPermissions = Partial<Record<PermissionKey, boolean>>;
+export interface PollVoteUpdatePayload {
+	messageId: string;
+	poll: IPoll;
+	serverId?: string;
+	channelId?: string;
+}
+export interface Server {
+	_id: string;
+	id: string;
+	name: string;
+	ownerId: string;
+	icon?: string;
+	banner?: string;
+}
+export interface Channel {
+	_id: string;
+	id: string;
+	name: string;
+	type: string;
+	serverId: string;
+	categoryId?: string;
+	position: number;
+}
+export interface Category {
+	_id: string;
+	id: string;
+	name: string;
+	serverId: string;
+	position: number;
+}
+export interface Role {
+	_id: string;
+	id: string;
+	name: string;
+	color?: string;
+	position: number;
+	permissions: string;
+}
+export interface ServerMember {
+	_id: string;
+	userId: string;
+	serverId: string;
+	nickname?: string;
+	roles: string[];
+}
+export interface MessageUpdatePayload {
+	messageId: string;
+	serverId: string;
+	channelId: string;
+	text: string;
+	isEdited: boolean;
+	editedAt: string;
+}
+export interface MessageDeletePayload {
+	messageId: string;
+	serverId: string;
+	channelId: string;
+	hard?: boolean;
+}
+export interface MessageBulkDeletePayload {
+	messageIds: string[];
+	serverId: string;
+	channelId: string;
+	hard?: boolean;
+}
+export interface ReactionPayload {
+	messageId: string;
+	userId: string;
+	username: string;
+	emoji: string;
+	emojiType: "unicode" | "custom";
+	emojiId?: string;
+	messageType: "dm" | "server";
+	serverId?: string;
+	channelId?: string;
+}
+export interface MemberAddedPayload {
+	serverId: string;
+	userId: string;
+	username: string;
+}
+export interface MemberRemovedPayload {
+	serverId: string;
+	userId: string;
+}
+export interface MemberUpdatedPayload {
+	serverId: string;
+	userId: string;
+	member: ServerMember;
+}
+export interface ChannelCreatedPayload {
+	serverId: string;
+	channel: Channel;
+}
+export interface ChannelUpdatedPayload {
+	serverId: string;
+	channel: Channel;
+}
+export interface ChannelDeletedPayload {
+	serverId: string;
+	channelId: string;
+}
+export interface CategoryCreatedPayload {
+	serverId: string;
+	category: Category;
+}
+export interface CategoryUpdatedPayload {
+	serverId: string;
+	category: Category;
+}
+export interface CategoryDeletedPayload {
+	serverId: string;
+	categoryId: string;
+}
+export interface ServerUpdatedPayload {
+	serverId: string;
+	server: Partial<Server>;
+	senderId: string;
+}
+export interface ServerDeletedPayload {
+	serverId: string;
+	senderId: string;
+}
+export interface RoleCreatedPayload {
+	serverId: string;
+	role: Role;
+}
+export interface RoleUpdatedPayload {
+	serverId: string;
+	role: Role;
+}
+export interface RoleDeletedPayload {
+	serverId: string;
+	roleId: string;
+}
+export interface InviteCreatedPayload {
+	serverId: string;
+	code: string;
+	maxUses: number | null;
+	expiresAt: string | null;
+	senderId: string;
+}
+export interface InviteDeletedPayload {
+	serverId: string;
+	code: string;
+	senderId: string;
+}
+export interface InteractionCreatePayload {
+	command: string;
+	options: InteractionOption[];
+	serverId: string;
+	channelId: string;
+	senderId: string;
+	senderUsername: string;
+	senderPermissions?: ServerPermissions;
+	user?: {
+		id: string;
+		username: string;
+	};
+	invocationId?: string;
+	commandId?: string;
+}
+export interface ServerJoinedPayload {
+	serverId: string;
+	voiceStates?: Record<string, string[]>;
+}
+export interface PresenceSyncPayload {
+	online: Array<{
+		userId: string;
+		username: string;
+		status?: {
+			text: string;
+			emoji: string | null;
+			expiresAt: string | null;
+			updatedAt: string;
+		} | null;
+	}>;
+}
+export interface UserPresencePayload {
+	userId: string;
+	username: string;
+	status?: {
+		text: string;
+		emoji: string | null;
+		expiresAt: string | null;
+		updatedAt: string;
+	} | null;
+}
+export interface UserOfflinePayload {
+	userId: string;
+	username: string;
+}
+export interface UserUpdatedPayload {
+	userId: string;
+	username?: string;
+	displayName?: string | null;
+	profilePicture?: string | null;
+	bio?: string | null;
+	pronouns?: string | null;
+	badges?: string[];
+	oldUsername?: string;
+	newUsername?: string;
+	usernameFont?: string;
+	usernameGradient?: {
+		enabled: boolean;
+		colors: string[];
+		angle: number;
+	};
+	usernameGlow?: {
+		enabled: boolean;
+		color: string;
+		intensity: number;
+	};
+	settings?: {
+		muteNotifications?: boolean;
+		useDiscordStyleMessages?: boolean;
+		ownMessagesAlign?: "left" | "right";
+		otherMessagesAlign?: "left" | "right";
+		showYouLabel?: boolean;
+		ownMessageColor?: string;
+		otherMessageColor?: string;
+		disableCustomUsernameFonts?: boolean;
+		disableCustomUsernameColors?: boolean;
+		disableCustomUsernameGlow?: boolean;
+	};
+	senderId?: string;
+}
+export interface MemberBannedPayload {
+	serverId: string;
+	userId: string;
+}
+export interface MemberUnbannedPayload {
+	serverId: string;
+	userId: string;
+}
+export interface OwnershipTransferredPayload {
+	serverId: string;
+	oldOwnerId: string;
+	newOwnerId: string;
+	senderId?: string;
+}
+export interface ChannelsReorderedPayload {
+	serverId: string;
+	channelPositions: {
+		channelId: string;
+		position: number;
+	}[];
+	senderId?: string;
+}
+export interface CategoriesReorderedPayload {
+	serverId: string;
+	categoryPositions: {
+		categoryId: string;
+		position: number;
+	}[];
+	senderId?: string;
+}
+export interface RolesReorderedPayload {
+	serverId: string;
+	rolePositions: {
+		roleId: string;
+		position: number;
+	}[];
+	senderId?: string;
+}
+export interface ChannelPermissionsUpdatedPayload {
+	serverId: string;
+	channelId: string;
+	permissions: Record<string, Record<string, boolean>>;
+	senderId?: string;
+}
+export interface CategoryPermissionsUpdatedPayload {
+	serverId: string;
+	categoryId: string;
+	permissions: Record<string, Record<string, boolean>>;
+	senderId?: string;
+}
+/**
+ * Builder for constructing rich embed objects.
+ *
+ * @example
+ * ```ts
+ * const embed = new EmbedBuilder()
+ *   .setTitle('Hello!')
+ *   .setDescription('This is a rich embed.')
+ *   .setColor(0x5865f2);
+ *
+ * await client.sendMessage(serverId, channelId, embed);
+ * ```
+ */
+export declare class EmbedBuilder {
+	private data;
+	/**
+	 * @param data - Optional seed data to pre-populate the embed.
+	 *   Useful when editing an existing embed returned from the API.
+	 */
+	constructor(data?: IEmbed);
+	/** Sets the embed title. */
+	setTitle(title: string): this;
+	/** Sets the embed description (supports markdown). */
+	setDescription(description: string): this;
+	/** Sets the URL the title links to. */
+	setURL(url: string): this;
+	/** Sets the sidebar accent colour. */
+	setColor(color: number): this;
+	/** Sets the embed timestamp. Defaults to now. */
+	setTimestamp(timestamp?: string | number | Date): this;
+	/** Sets the embed author. */
+	setAuthor(author: IEmbedAuthor | null): this;
+	/** Sets the embed footer. */
+	setFooter(footer: IEmbedFooter | null): this;
+	/** Sets the embed thumbnail. */
+	setThumbnail(url: string | null, width?: number, height?: number): this;
+	/** Sets the main embed image. */
+	setImage(url: string | null, width?: number, height?: number): this;
+	/** Appends fields to the embed. */
+	addFields(...fields: IEmbedField[]): this;
+	/** Replaces all fields. */
+	setFields(...fields: IEmbedField[]): this;
+	/** Serialises the embed to a plain JSON object. */
+	toJSON(): IEmbed;
+}
+/**
+ * Represents a message received from the Serchat server.
+ *
+ * Wraps the raw API payload and exposes helper methods for common actions
+ * like replying, reacting, and deleting.
+ */
+export declare class Message implements IMessageServer {
+	/** Primary message identifier. Normalised from either `messageId` or `_id`. */
+	messageId: string;
+	/** Legacy MongoDB `_id` field, present on older messages. */
+	_id?: string;
+	/** ID of the server this message belongs to. */
+	serverId: string;
+	/** ID of the channel this message was posted in. */
+	channelId: string;
+	/** ID of the user who sent the message. */
+	senderId: string;
+	/** Display name of the user who sent the message. */
+	senderUsername: string;
+	/** Plain text content of the message. */
+	text: string;
+	/** ISO 8601 timestamp of when the message was created. */
+	createdAt: string;
+	/** ID of the message this message is replying to, if any. */
+	replyToId?: string;
+	/** Partial snapshot of the message being replied to, if any. */
+	repliedTo?: {
+		messageId: string;
+		senderId: string;
+		senderUsername: string;
+		text: string;
+	};
+	/** Whether the message has been edited since it was first sent. */
+	isEdited: boolean;
+	/** Whether the message is pinned in its channel. */
+	isPinned: boolean;
+	/** Whether the message is stickied at the top of the channel. */
+	isSticky: boolean;
+	/** Whether the message was sent via a webhook integration. */
+	isWebhook: boolean;
+	/** Display name override for webhook messages. */
+	webhookUsername?: string;
+	/** Avatar URL override for webhook messages. */
+	webhookAvatarUrl?: string;
+	/** Rich embed objects attached to this message. */
+	embeds?: IEmbed[];
+	/** Structured file attachments on this message. */
+	attachments?: IMessageAttachment[];
+	/** Interaction metadata if this message was sent in response to a slash command. */
+	interaction?: {
+		command: string;
+		options: {
+			name: string;
+			value: InteractionValue;
+		}[];
+		user: {
+			id: string;
+			username: string;
+		};
+	};
+	/** Poll attached to this message, if any. */
+	poll?: IPoll;
+	/** Sticker attached to this message, if any. */
+	stickerId?: string;
+	/** Whether the message sender is a bot account. */
+	senderIsBot: boolean;
+	private client;
+	constructor(client: Client, data: IMessageServer);
+	/** Sends a reply to this message. */
+	reply(content: string | ISendMessageRequest | EmbedBuilder): Promise<Message>;
+	/** Adds a reaction to this message. */
+	react(emoji: string): Promise<void>;
+	/** Deletes this message. */
+	delete(): Promise<void>;
+	/** Votes on a poll option in this message. */
+	vote(optionId: string): Promise<void>;
+	/** Checks if this message has any attachments. */
+	hasAttachments(): boolean;
+	/** Resolves the full public download URL of the given attachment. */
+	getAttachmentUrl(attachment: IMessageAttachment): string;
+	/** Filters and returns attachments belonging to a specific file/media type. */
+	getAttachmentsByType(type: MessageAttachmentType): IMessageAttachment[];
+	/** Returns whether the message plain text is empty or consists only of whitespace. */
+	get isEmpty(): boolean;
+	/** Checks if this message was sent by the currently authenticated client user. */
+	get isOwnMessage(): boolean;
+	/** Checks if this message was sent by any bot account (including this client). */
+	get isFromBot(): boolean;
+}
+/** Callback used by {@link MermaidBuilder.subgraph} to build nested content. */
+export type MermaidCallback = (b: MermaidBuilder) => MermaidBuilder;
+/**
+ * Builder for constructing Mermaid diagrams.
+ *
+ * @example
+ * ```ts
+ * const diagram = new MermaidBuilder('graph TD')
+ *   .node('A', 'Start')
+ *   .node('B', 'Stop')
+ *   .edge('A', 'B', 'Go to')
+ *   .build();
+ * ```
+ */
+export declare class MermaidBuilder {
+	private content;
+	private indentation;
+	/**
+	 * @param header - The diagram type header (e.g., 'graph TD', 'sequenceDiagram').
+	 */
+	constructor(header?: string);
+	private get indent();
+	/**
+	 * Adds a raw line to the diagram.
+	 */
+	add(line: string): this;
+	/**
+	 * Adds a node to the diagram.
+	 *
+	 * @param id - The node ID.
+	 * @param text - Optional display text.
+	 * @param shape - Optional shape: 'box', 'round', 'stadium', 'subroutine', 'cylindrical', 'circle', 'asymmetric', 'rhombus', 'hexagon'.
+	 */
+	node(id: string, text?: string, shape?: "box" | "round" | "stadium" | "subroutine" | "cylindrical" | "circle" | "asymmetric" | "rhombus" | "hexagon"): this;
+	/**
+	 * Adds an edge between two nodes.
+	 *
+	 * @param from - Starting node ID.
+	 * @param to - Ending node ID.
+	 * @param text - Optional label text.
+	 * @param type - Edge style: 'arrow' (-->), 'line' (---), 'dotted' (-.->), 'thick' (==>).
+	 */
+	edge(from: string, to: string, text?: string, type?: "arrow" | "line" | "dotted" | "thick"): this;
+	/**
+	 * Adds a subgraph.
+	 *
+	 * @param name - Subgraph display name.
+	 * @param callback - Function to build subgraph content.
+	 */
+	subgraph(name: string, callback: MermaidCallback): this;
+	/**
+	 * Sets a style for a node or class.
+	 */
+	style(id: string, style: string): this;
+	/**
+	 * Adds a comment.
+	 */
+	comment(text: string): this;
+	/**
+	 * Returns the final Mermaid string.
+	 */
+	build(): string;
+	/**
+	 * Alias of {@link build}.
+	 */
+	toString(): string;
+}
+/** Callback used by {@link MessageBuilder.p} to build inline content. */
+export type InlineCallback = (t: InlineBuilder) => InlineBuilder;
+/**
+ * Builder for constructing inline Serchat markdown.
+ *
+ * Methods append text to a buffer and return `this` for chaining.
+ * Call {@link build} to get the final string.
+ *
+ * @example
+ * ```ts
+ * const text = new InlineBuilder()
+ *   .text('Hello, ')
+ *   .bold('world')
+ *   .text('!')
+ *   .build();
+ * // => 'Hello, **world**!'
+ * ```
+ */
+export declare class InlineBuilder {
+	protected content: string;
+	/**
+	 * @param initialContent - Optional string to seed the builder with.
+	 */
+	constructor(initialContent?: string);
+	protected wrap(start: string, end: string, text: string): this;
+	/** Appends plain text. */
+	text(text: string): this;
+	/** Appends italic text. */
+	italic(text: string): this;
+	/** Appends bold text. */
+	bold(text: string): this;
+	/** Appends bold-italic text. */
+	boldItalic(text: string): this;
+	/** Appends strikethrough text. */
+	strikethrough(text: string): this;
+	/** Appends underlined text. */
+	underline(text: string): this;
+	/** Appends double-underlined text (`___text___`). */
+	doubleUnderline(text: string): this;
+	/** Appends curly-underlined text (`_~text~_`). */
+	curlyUnderline(text: string): this;
+	/** Appends jagged-underlined text (`_^text^_`). */
+	jaggedUnderline(text: string): this;
+	/** Appends doubly curly-underlined text (`_~~text~~_`). */
+	doubleCurlyUnderline(text: string): this;
+	/** Appends dashed-underlined text (`_-text-_`). */
+	dashedUnderline(text: string): this;
+	/** Appends dotted-underlined text (`_.text._`). */
+	dottedUnderline(text: string): this;
+	/** Appends rhythm-underlined text (`_-.text.-_`). */
+	rhythmUnderline(text: string): this;
+	/** Appends spoiler text. */
+	spoiler(text: string): this;
+	/** Appends inline code. */
+	inlineCode(text: string): this;
+	/** Appends inline LaTeX. */
+	inlineLatex(text: string): this;
+	/**
+	 * Appends superscript text (`^text^`).
+	 *
+	 * @example `.superscript('2')` → `^2^`
+	 */
+	superscript(text: string): this;
+	/**
+	 * Appends subscript text (`~text~`).
+	 *
+	 * @example `.subscript('2')` → `~2~`
+	 */
+	subscript(text: string): this;
+	/**
+	 * Appends stacked superscript/subscript (`^sup|sub^`).
+	 *
+	 * @param sup - The text displayed above (superscript position).
+	 * @param sub - The text displayed below (subscript position).
+	 *
+	 * @example `.stackedScript('top', 'bottom')` → `^top|bottom^`
+	 */
+	stackedScript(sup: string, sub: string): this;
+	/** Appends a hyperlink. */
+	link(text: string, url: string): this;
+	/** Appends a user mention. */
+	userMention(userId: string): this;
+	/** Appends a role mention. */
+	roleMention(roleId: string): this;
+	/** Appends a channel mention. */
+	channelMention(serverId: string, channelId: string): this;
+	/** Appends an \@everyone mention. */
+	everyoneMention(): this;
+	/** Appends a server emoji. */
+	customEmoji(id: string): this;
+	/**
+	 * Returns the accumulated markdown string.
+	 *
+	 * @returns The final formatted string.
+	 */
+	build(): string;
+	/**
+	 * Alias of {@link build} - allows the builder to be used directly in
+	 * template literals.
+	 *
+	 * @returns The final formatted string.
+	 */
+	toString(): string;
+}
+/** Builder for constructing full chat messages with block elements.
+ *
+ * @example
+ * ```ts
+ * const msg = new MessageBuilder()
+ *   .h1('Release Notes')
+ *   .p('Version 1.0 is here!')
+ *   .codeBlock('ts', 'console.log("hello")')
+ *   .build();
+ *
+ * await client.sendMessage(serverId, channelId, msg);
+ * ```
+ */
+export declare class MessageBuilder extends InlineBuilder {
+	/** Appends a paragraph or inline content. */
+	p(content: string | InlineCallback): this;
+	/** Appends an H1 heading. */
+	h1(text: string): this;
+	/** Appends an H2 heading. */
+	h2(text: string): this;
+	/** Appends an H3 heading. */
+	h3(text: string): this;
+	/** Appends a horizontal rule. */
+	hr(): this;
+	/** Appends a code block. */
+	codeBlock(language: string, text: string, options?: {
+		label?: string;
+	}): this;
+	/** Appends a blockquote. */
+	blockquote(text: string, options?: {
+		label?: string;
+	}): this;
+	/** Appends an admonition block. */
+	admonition(type: string, text: string, options?: {
+		label?: string;
+		title?: string;
+	}): this;
+	/** Appends subtext. */
+	subtext(text: string): this;
+	/** Appends a LaTeX block. */
+	latexBlock(text: string, options?: {
+		label?: string;
+	}): this;
+	/** Appends a heading at the given level. */
+	heading(level: 1 | 2 | 3, text: string): this;
+	/** Alias of {@link hr}. */
+	thematicBreak(): this;
+	/** Appends raw text. */
+	append(text: string): this;
+	/** Appends text with a newline. */
+	appendLine(text?: string): this;
+	/** Appends an unordered list. */
+	unorderedList(items: string[], depth?: number): this;
+	/** Appends an ordered list. */
+	orderedList(items: string[], depth?: number): this;
+	/** Appends a checklist. */
+	checklist(items: {
+		text: string;
+		checked: boolean;
+	}[], depth?: number): this;
+	/** Appends a table. */
+	table(headers: string[], rows: string[][]): this;
+	/** Appends a mermaid diagram. */
+	mermaid(content: string | MermaidBuilder | MermaidCallback): this;
+	/** Appends a file. */
+	file(url: string): this;
+}
+/**
+ * Represents a slash-command interaction received from the Serchat gateway.
+ *
+ * Provides typed accessors for each option type and a {@link reply} method
+ * for responding to the interaction in the originating channel.
+ */
+export declare class Interaction {
+	/** Name of the slash command that was invoked (e.g. `"ping"`). */
+	command: string;
+	/** Unique ID of the slash command, if provided. */
+	commandId?: string;
+	/** Raw list of option values provided by the user. */
+	options: InteractionOption[];
+	/** ID of the server where the interaction occurred. */
+	serverId: string;
+	/** ID of the channel where the interaction occurred. */
+	channelId: string;
+	/** ID of the user who triggered the interaction. */
+	senderId: string;
+	/** Display name of the user who triggered the interaction. */
+	senderUsername: string;
+	/** Permission set of the invoking user at the time of the interaction. */
+	permissions: ServerPermissions;
+	/** Unique ID for correlating this invocation across events, if provided. */
+	invocationId?: string;
+	private client;
+	constructor(client: Client, data: InteractionCreatePayload);
+	/** Retrieves a raw option by name. */
+	getOption(name: string): InteractionOption | undefined;
+	private getTypedOption;
+	/** Returns the string value of a named option. */
+	getString(name: string): string | undefined;
+	/** Returns the integer value of a named option. */
+	getInteger(name: string): number | undefined;
+	/** Returns the boolean value of a named option. */
+	getBoolean(name: string): boolean | undefined;
+	/** Returns the user ID value of a named user option. */
+	getUser(name: string): string | undefined;
+	/** Returns the channel ID value of a named channel option. */
+	getChannel(name: string): string | undefined;
+	/** Returns the role ID value of a named role option. */
+	getRole(name: string): string | undefined;
+	/** Checks if the user has a specific permission. */
+	hasPermission(permission: PermissionKey): boolean;
+	/** Sends a reply to this interaction. */
+	reply(content: string | ISendMessageRequest | EmbedBuilder | IMessageWithEmbeds | MessageBuilder): Promise<Message>;
+}
+/** Union of supported slash-command option value types. */
+export type CommandOptionType = "string" | "integer" | "boolean" | "user" | "channel" | "role";
+/** Descriptor for a single slash-command option. */
+export interface CommandOption {
+	/** The type of value this option accepts. */
+	type: CommandOptionType;
+	/** Short description shown in the command picker UI. */
+	description: string;
+	/** Whether the user must provide this option. Defaults to `false`. */
+	required?: boolean;
+}
+/**
+ * Abstract base class for all bot slash commands.
+ *
+ * @example
+ * ```ts
+ * class PingCommand extends BotCommand {
+ *   name = 'ping';
+ *   description = 'Replies with Pong!';
+ *
+ *   async execute(interaction: Interaction) {
+ *     await interaction.reply('Pong!');
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BotCommand {
+	/** The unique command ID populated after registration sync. */
+	id?: string;
+	/** The command name as it appears in the slash-command picker (lowercase, no spaces). */
+	abstract name: string;
+	/** Short description displayed in the command picker UI. */
+	abstract description: string;
+	/** Optional map of option names to their descriptors. */
+	options?: Record<string, CommandOption>;
+	/** Called when a user invokes this command. */
+	abstract execute(interaction: Interaction): Promise<void>;
+	/** Serialises the command to the API payload format. */
+	toJSON(): SlashCommandData;
+	private mapType;
+}
+/**
+ * Manages slash-command registration, deduplication, and dispatching for a bot.
+ *
+ * Accessed via {@link Client.commands} or {@link Client.application}.
+ *
+ * @example
+ * ```ts
+ * client.commands.register(new PingCommand());
+ * await client.commands.sync(); // push commands to the API
+ * ```
+ */
+export declare class ApplicationCommandManager {
+	private rest;
+	/** Map of command name → {@link BotCommand} instance. */
+	private registeredCommands;
+	/** Map of command ID → {@link BotCommand} instance. */
+	private registeredCommandsById;
+	/**
+	 * @param rest - Authenticated REST client used to push commands to the API.
+	 */
+	constructor(rest: RESTClient);
+	/**
+	 * Registers a {@link BotCommand} locally so it can be dispatched when an
+	 * interaction arrives.
+	 *
+	 * @param command - The command to register.
+	 * @throws {Error} If a command with the same name is already registered.
+	 */
+	register(command: BotCommand): void;
+	/**
+	 * Handles an incoming interaction by looking up the matching registered
+	 * command and calling its `execute` method.
+	 *
+	 * @param interaction - The interaction to dispatch.
+	 */
+	handleInteraction(interaction: Interaction): Promise<void>;
+	/**
+	 * Returns the JSON representation of all locally registered commands,
+	 * suitable for passing to {@link set}.
+	 *
+	 * @returns Array of {@link SlashCommandData} objects.
+	 */
+	getCommandsData(): SlashCommandData[];
+	/**
+	 * Pushes all locally registered commands to the API, replacing the
+	 * current command list. Equivalent to calling
+	 * `set(this.getCommandsData())`.
+	 */
+	sync(): Promise<void>;
+	/**
+	 * Replaces the bot's command list on the API with the provided commands.
+	 *
+	 * @param commands - Array of command definitions to upload.
+	 * @returns The updated list of commands as confirmed by the API.
+	 * @throws {Error} If `commands` contains duplicate command names.
+	 */
+	set(commands: SlashCommandData[]): Promise<SlashCommandData[]>;
+}
+export interface ISticker {
+	id: string;
+	name: string;
+	imageUrl: string;
+	serverId: string;
+	createdBy: string;
+	createdAt?: string;
+}
+export declare class StickerManager {
+	private rest;
+	constructor(rest: RESTClient);
+	/**
+	 * Gets all globally accessible stickers for the authenticated user.
+	 */
+	getStickers(): Promise<ISticker[]>;
+	/**
+	 * Gets all stickers for a specific server.
+	 */
+	getServerStickers(serverId: string): Promise<ISticker[]>;
+	/**
+	 * Creates a new sticker in a server.
+	 */
+	createSticker(serverId: string, formData: FormData): Promise<ISticker>;
+	/**
+	 * Deletes a sticker from a server.
+	 */
+	deleteSticker(serverId: string, stickerId: string): Promise<void>;
+}
+export interface IWebhook {
+	_id: string;
+	serverId?: string;
+	channelId?: string;
+	name: string;
+	token: string;
+	avatarUrl?: string;
+	createdBy: string;
+	createdAt?: string;
+}
+export interface ICreateWebhookRequest {
+	name: string;
+	avatarUrl?: string;
+}
+export interface IExecuteWebhookRequest {
+	content?: string;
+	username?: string;
+	avatarUrl?: string;
+	noEmbedsUrls?: string[];
+	embeds?: IEmbed[];
+}
+export interface IExecuteWebhookResponse {
+	id: string;
+	timestamp: string;
+}
+export interface IWebhookAvatarResponse {
+	avatarUrl: string;
+}
+export declare class WebhookManager {
+	private rest;
+	constructor(rest: RESTClient);
+	private embedToJSON;
+	/**
+	 * Gets webhooks for a channel.
+	 */
+	getWebhooks(serverId: string, channelId: string): Promise<IWebhook[]>;
+	/**
+	 * Creates a webhook for a channel.
+	 */
+	createWebhook(serverId: string, channelId: string, data: ICreateWebhookRequest): Promise<IWebhook>;
+	/**
+	 * Deletes a webhook from a channel.
+	 */
+	deleteWebhook(serverId: string, channelId: string, webhookId: string): Promise<void>;
+	/**
+	 * Uploads or replaces a webhook avatar.
+	 */
+	uploadWebhookAvatar(serverId: string, channelId: string, webhookId: string, avatar: Blob): Promise<IWebhookAvatarResponse>;
+	/**
+	 * Executes a webhook using its public token.
+	 */
+	executeWebhook(token: string, data: IExecuteWebhookRequest): Promise<IExecuteWebhookResponse>;
+	/**
+	 * Edits a previously sent webhook message.
+	 */
+	editWebhookMessage(token: string, messageId: string, data: IExecuteWebhookRequest): Promise<void>;
+	/**
+	 * Deletes a previously sent webhook message.
+	 */
+	deleteWebhookMessage(token: string, messageId: string): Promise<void>;
+}
+export type CallbackNames<K extends string> = K extends "messageCreate" ? "onMessage" | "onMessageCreate" : K extends "interactionCreate" ? "onInteraction" | "onInteractionCreate" : `on${Capitalize<K>}`;
+export type AnyArray = readonly (string | number | boolean | symbol | bigint | object | null | undefined)[];
+export type EventSubscriber<Events extends Record<keyof Events, AnyArray>> = {
+	[K in keyof Events & string as CallbackNames<K>]?: (...args: Events[K]) => void | Promise<void>;
+};
+export interface EventBusOptions<Events extends Record<keyof Events, AnyArray>> {
+	logger?: {
+		error(message: string): void;
+	};
+	errorEvent?: keyof Events;
+}
+/**
+ * Event dispatcher to fan gateway events out.
+ */
+export declare class EventBus<Events extends Record<keyof Events, AnyArray>> {
+	private listeners;
+	private logger?;
+	private errorEvent?;
+	private subscriberListeners;
+	constructor(options?: EventBusOptions<Events>);
+	/**
+	 * Registers all event handler methods on an object.
+	 */
+	register(subscriber: EventSubscriber<Events>): void;
+	/**
+	 * Unregisters all event handler methods previously registered for the given subscriber.
+	 */
+	unregister(subscriber: EventSubscriber<Events>): void;
+	private getEventNamesForCallback;
+	private getMethods;
+	on<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void | Promise<void>): this;
+	once<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void | Promise<void>): this;
+	off<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void | Promise<void>): this;
+	emit<K extends keyof Events>(event: K, ...args: Events[K]): boolean;
+	private handleListenerError;
+	private emitError;
+}
+export interface ClientUser {
+	id: string;
+	username: string;
+	displayName: string | null;
+	profilePicture: string | null;
+	status?: string;
+}
+export interface ClientModule {
+	name: string;
+	register?(client: Client): void | Promise<void>;
+	onReady?(user: ClientUser): void | Promise<void>;
+	onMessage?(message: Message): void | Promise<void>;
+	onMessageCreate?(message: Message): void | Promise<void>;
+	onMessageUpdate?(payload: MessageUpdatePayload): void | Promise<void>;
+	onMessageDelete?(payload: MessageDeletePayload): void | Promise<void>;
+	onMessageBulkDelete?(payload: MessageBulkDeletePayload): void | Promise<void>;
+	onInteraction?(interaction: Interaction): void | Promise<void>;
+	onInteractionCreate?(interaction: Interaction): void | Promise<void>;
+	onMessageReactionAdd?(payload: ReactionPayload): void | Promise<void>;
+	onMessageReactionRemove?(payload: ReactionPayload): void | Promise<void>;
+	onPollVoteUpdate?(payload: PollVoteUpdatePayload): void | Promise<void>;
+	onServerMemberAdd?(payload: MemberAddedPayload): void | Promise<void>;
+	onServerMemberRemove?(payload: MemberRemovedPayload): void | Promise<void>;
+	onServerMemberUpdate?(payload: MemberUpdatedPayload): void | Promise<void>;
+	onChannelCreate?(payload: ChannelCreatedPayload): void | Promise<void>;
+	onChannelUpdate?(payload: ChannelUpdatedPayload): void | Promise<void>;
+	onChannelDelete?(payload: ChannelDeletedPayload): void | Promise<void>;
+	onChannelsReordered?(payload: ChannelsReorderedPayload): void | Promise<void>;
+	onCategoryCreate?(payload: CategoryCreatedPayload): void | Promise<void>;
+	onCategoryUpdate?(payload: CategoryUpdatedPayload): void | Promise<void>;
+	onCategoryDelete?(payload: CategoryDeletedPayload): void | Promise<void>;
+	onCategoriesReordered?(payload: CategoriesReorderedPayload): void | Promise<void>;
+	onChannelPermissionsUpdate?(payload: ChannelPermissionsUpdatedPayload): void | Promise<void>;
+	onCategoryPermissionsUpdate?(payload: CategoryPermissionsUpdatedPayload): void | Promise<void>;
+	onServerUpdate?(payload: ServerUpdatedPayload): void | Promise<void>;
+	onServerDelete?(payload: ServerDeletedPayload): void | Promise<void>;
+	onServerIconUpdate?(payload: {
+		serverId: string;
+		icon: string;
+	}): void | Promise<void>;
+	onServerBannerUpdate?(payload: {
+		serverId: string;
+		banner: {
+			type: "image";
+			value: string;
+		};
+	}): void | Promise<void>;
+	onRoleCreate?(payload: RoleCreatedPayload): void | Promise<void>;
+	onRoleUpdate?(payload: RoleUpdatedPayload): void | Promise<void>;
+	onRoleDelete?(payload: RoleDeletedPayload): void | Promise<void>;
+	onRolesReordered?(payload: RolesReorderedPayload): void | Promise<void>;
+	onInviteCreate?(payload: InviteCreatedPayload): void | Promise<void>;
+	onInviteDelete?(payload: InviteDeletedPayload): void | Promise<void>;
+	onServerMemberBan?(payload: MemberBannedPayload): void | Promise<void>;
+	onServerMemberUnban?(payload: MemberUnbannedPayload): void | Promise<void>;
+	onOwnershipTransfer?(payload: OwnershipTransferredPayload): void | Promise<void>;
+	onPresenceSync?(payload: PresenceSyncPayload): void | Promise<void>;
+	onUserOnline?(payload: UserPresencePayload): void | Promise<void>;
+	onUserOffline?(payload: UserOfflinePayload): void | Promise<void>;
+	onUserUpdate?(payload: UserUpdatedPayload): void | Promise<void>;
+	onError?(error: Error): void | Promise<void>;
+	onDisconnect?(): void | Promise<void>;
+	onReconnected?(): void | Promise<void>;
+}
+export declare class ModuleManager {
+	private client;
+	private registeredModules;
+	constructor(client: Client);
+	register(module: ClientModule): Promise<void>;
+}
+export interface PollOptionBuilderData {
+	text: string;
+	emoji?: string;
+	emojiType?: "unicode" | "custom";
+	emojiId?: string;
+}
+/**
+ * Builder for constructing Serchat polls.
+ *
+ * Use this to define poll questions, options, and settings.
+ *
+ * @example
+ * ```ts
+ * const poll = new PollBuilder()
+ *   .setTitle('What is your favorite food?')
+ *   .addOption('Pizza', '🍕')
+ *   .addOption('Sushi', '🍣')
+ *   .setMultiSelect(true);
+ * ```
+ */
+export declare class PollBuilder {
+	private title;
+	private options;
+	private multiSelect;
+	private expiresAt?;
+	/**
+	 * Sets the title of the poll.
+	 * @param title - The question or title to display.
+	 */
+	setTitle(title: string): this;
+	/**
+	 * Adds an option to the poll.
+	 * @param text - The text of the option.
+	 * @param emoji - Optional emoji to display next to the option.
+	 */
+	addOption(text: string, emoji?: string): this;
+	/**
+	 * Adds a custom emoji option to the poll.
+	 * @param text - The text of the option.
+	 * @param emojiId - The ID of the custom emoji.
+	 */
+	addCustomEmojiOption(text: string, emojiId: string): this;
+	/**
+	 * Sets whether the poll allows multiple selections.
+	 * @param multiSelect - True if multiple options can be selected.
+	 */
+	setMultiSelect(multiSelect: boolean): this;
+	/**
+	 * Sets the expiration date of the poll.
+	 * @param date - The date when the poll expires.
+	 */
+	setExpiresAt(date: Date | string): this;
+	/**
+	 * Converts the builder to a plain object for API transmission.
+	 * @internal
+	 */
+	toJSON(): IPollInput;
+}
+/**
+ * Numeric log level thresholds. A logger will emit messages at or above its
+ * configured level, and drop everything below it.
+ *
+ * @example
+ * ```ts
+ * const client = new Client({ logLevel: LogLevel.DEBUG });
+ * ```
+ */
+export declare enum LogLevel {
+	/** Verbose diagnostic information. */
+	DEBUG = 0,
+	/** General operational messages. */
+	INFO = 1,
+	/** Potentially harmful situations that are not yet errors. */
+	WARN = 2,
+	/** Runtime errors that are recoverable. */
+	ERROR = 3,
+	/** Severe errors that may cause the process to abort. */
+	CRITICAL = 4,
+	/** Suppress all output. */
+	NONE = 5
+}
+/**
+ * Colorised, tagged logger used internally by the SDK.
+ *
+ * Each emitted line is prefixed with the SDK tag, the source file region, the
+ * severity, and the current ISO timestamp.
+ */
+export declare class Logger {
+	/** The minimum {@link LogLevel} at which this logger will emit output. */
+	level: LogLevel;
+	/**
+	 * @param level - Minimum severity to output. Defaults to {@link LogLevel.INFO}.
+	 */
+	constructor(level?: LogLevel);
+	/**
+	 * Introspects the call stack to determine the file name of the caller.
+	 * Used to tag log lines with their origin for easier debugging.
+	 */
+	private getRegion;
+	/**
+	 * Formats a log message with ANSI colours, severity tag, region tag, and
+	 * timestamp.
+	 *
+	 * @param severity - Human-readable severity label (e.g. `"info"`).
+	 * @param message  - The message body to format.
+	 * @returns The fully formatted, colour-coded log string.
+	 */
+	private format;
+	/** Emits a debug message. */
+	debug(message: string): void;
+	/** Emits an info message. */
+	info(message: string): void;
+	/** Emits a warning message. */
+	warn(message: string): void;
+	/** Emits an error message. */
+	error(message: string): void;
+	/** Emits a critical message. */
+	critical(message: string): void;
+}
+/**
+ * Configuration options passed to the {@link Client} constructor.
+ */
+export interface ClientOptions {
+	/**
+	 * Base URL of the Serchat REST API.
+	 * @defaultValue `'https://ser.chat/api/v1'`
+	 */
+	apiBaseUrl?: string;
+	/**
+	 * Minimum log severity to emit. Defaults to {@link LogLevel.INFO}.
+	 */
+	logLevel?: LogLevel;
+}
+/**
+ * Map of all events the {@link Client} can emit, keyed by event name with
+ * a tuple of the listener argument types as the value.
+ *
+ * Use these with `client.on(event, listener)`.
+ */
+export interface ClientEvents {
+	/** Fired once the bot has authenticated and is ready to receive events. */
+	ready: [
+		ClientUser
+	];
+	/** A new message was posted in a channel the bot can see. */
+	messageCreate: [
+		Message
+	];
+	/** An existing message was edited. */
+	messageUpdate: [
+		MessageUpdatePayload
+	];
+	/** A message was deleted. */
+	messageDelete: [
+		MessageDeletePayload
+	];
+	/** Multiple messages were deleted in bulk. */
+	messageBulkDelete: [
+		MessageBulkDeletePayload
+	];
+	/** A user invoked a slash command. */
+	interactionCreate: [
+		Interaction
+	];
+	/** A reaction was added to a message. */
+	messageReactionAdd: [
+		ReactionPayload
+	];
+	/** A reaction was removed from a message. */
+	messageReactionRemove: [
+		ReactionPayload
+	];
+	/** A poll vote was updated. */
+	pollVoteUpdate: [
+		PollVoteUpdatePayload
+	];
+	/** A member joined a server. */
+	serverMemberAdd: [
+		MemberAddedPayload
+	];
+	/** A member left or was removed from a server. */
+	serverMemberRemove: [
+		MemberRemovedPayload
+	];
+	/** A server member's profile (e.g. nickname, roles) was updated. */
+	serverMemberUpdate: [
+		MemberUpdatedPayload
+	];
+	/** A new channel was created. */
+	channelCreate: [
+		ChannelCreatedPayload
+	];
+	/** A channel's settings were updated. */
+	channelUpdate: [
+		ChannelUpdatedPayload
+	];
+	/** A channel was deleted. */
+	channelDelete: [
+		ChannelDeletedPayload
+	];
+	/** The channel order within a server was changed. */
+	channelsReordered: [
+		ChannelsReorderedPayload
+	];
+	/** A new category was created. */
+	categoryCreate: [
+		CategoryCreatedPayload
+	];
+	/** A category's settings were updated. */
+	categoryUpdate: [
+		CategoryUpdatedPayload
+	];
+	/** A category was deleted. */
+	categoryDelete: [
+		CategoryDeletedPayload
+	];
+	/** The category order within a server was changed. */
+	categoriesReordered: [
+		CategoriesReorderedPayload
+	];
+	/** Permission overrides for a channel were updated. */
+	channelPermissionsUpdate: [
+		ChannelPermissionsUpdatedPayload
+	];
+	/** Permission overrides for a category were updated. */
+	categoryPermissionsUpdate: [
+		CategoryPermissionsUpdatedPayload
+	];
+	/** Server-level settings were updated. */
+	serverUpdate: [
+		ServerUpdatedPayload
+	];
+	/** A server was deleted. */
+	serverDelete: [
+		ServerDeletedPayload
+	];
+	/** The server icon was changed. */
+	serverIconUpdate: [
+		{
+			serverId: string;
+			icon: string;
+		}
+	];
+	/** The server banner was changed. */
+	serverBannerUpdate: [
+		{
+			serverId: string;
+			banner: {
+				type: "image";
+				value: string;
+			};
+		}
+	];
+	/** A new role was created. */
+	roleCreate: [
+		RoleCreatedPayload
+	];
+	/** An existing role was updated. */
+	roleUpdate: [
+		RoleUpdatedPayload
+	];
+	/** A role was deleted. */
+	roleDelete: [
+		RoleDeletedPayload
+	];
+	/** The role order within a server was changed. */
+	rolesReordered: [
+		RolesReorderedPayload
+	];
+	/** A new server invite was created. */
+	inviteCreate: [
+		InviteCreatedPayload
+	];
+	/** A server invite was deleted or expired. */
+	inviteDelete: [
+		InviteDeletedPayload
+	];
+	/** A member was banned from a server. */
+	serverMemberBan: [
+		MemberBannedPayload
+	];
+	/** A banned member was unbanned. */
+	serverMemberUnban: [
+		MemberUnbannedPayload
+	];
+	/** Server ownership was transferred to another member. */
+	ownershipTransfer: [
+		OwnershipTransferredPayload
+	];
+	/** A batch of online-presence data was received from the gateway. */
+	presenceSync: [
+		PresenceSyncPayload
+	];
+	/** A user came online. */
+	userOnline: [
+		UserPresencePayload
+	];
+	/** A user went offline. */
+	userOffline: [
+		UserOfflinePayload
+	];
+	/** A user's profile was updated. */
+	userUpdate: [
+		UserUpdatedPayload
+	];
+	/** An unhandled error occurred (mirrors Node's `EventEmitter` convention). */
+	error: [
+		Error
+	];
+	/** The WebSocket connection was closed. */
+	disconnect: [
+	];
+	/** The WebSocket connection successfully reconnected. */
+	reconnected: [
+	];
+}
+/**
+ * Typed augmentation of `EventEmitter` that constrains `on`, `once`, and
+ * `emit` to the keys and argument tuples defined in {@link ClientEvents}.
+ */
+export interface Client extends EventEmitter {
+	on<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
+	once<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
+	off<K extends keyof ClientEvents>(event: K, listener: (...args: ClientEvents[K]) => void): this;
+	emit<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): boolean;
+}
+/**
+ * Main entry point for the Serchat bot SDK.
+ *
+ * Extends Node's `EventEmitter` with typed events (see {@link ClientEvents}).
+ * Manages a REST client, a WebSocket gateway connection, and an
+ * {@link ApplicationCommandManager} for slash commands.
+ *
+ * @example
+ * ```ts
+ * import { Client, LogLevel } from 'serchat.ts';
+ *
+ * const client = new Client({ logLevel: LogLevel.DEBUG });
+ *
+ * client.on('ready', (user) => console.log(`Logged in as ${user.username}`));
+ * client.on('messageCreate', (msg) => {
+ *   if (msg.text === '!ping') msg.reply('Pong!');
+ * });
+ *
+ * await client.login(process.env.BOT_TOKEN!);
+ * ```
+ */
+export declare class Client extends EventEmitter {
+	/** The {@link WebSocketManager} handling the gateway connection. */
+	ws: WebSocketManager;
+	/** Slash-command registry and dispatcher. */
+	commands: ApplicationCommandManager;
+	/** Manager for sticker endpoints. */
+	stickers: StickerManager;
+	/** Manager for webhook endpoints. */
+	webhooks: WebhookManager;
+	/** Typed event bus used for SDK internals, modules, and public listeners. */
+	events: EventBus<ClientEvents>;
+	/** Module registry for self-contained bot features. */
+	modules: ModuleManager;
+	/** The authenticated bot user, populated after the `ready` event fires. */
+	user: ClientUser | null;
+	/** Whether the client has emitted the ready event at least once. */
+	isReady: boolean;
+	/** Resolved options for this client instance. */
+	options: ClientOptions;
+	/** Logger instance used throughout the SDK. */
+	logger: Logger;
+	private rest;
+	private token;
+	constructor(options?: ClientOptions);
+	/** Accessor for the application command manager. */
+	get application(): {
+		commands: ApplicationCommandManager;
+	};
+	/** Returns the bot token currently in use. */
+	getToken(): string | null;
+	/** Returns the internal REST client. */
+	getRest(): RESTClient;
+	/** Returns the origin of the API base URL (e.g. https://ser.chat). */
+	getApiOrigin(): string;
+	/** Authenticates the client and connects to the gateway. */
+	login(token: string, callback?: () => Promise<void>): Promise<void>;
+	/** Exchanges client ID/secret for a token and logs in. */
+	loginWithSecret(clientId: string, clientSecret: string): Promise<string>;
+	/** Connects to the WebSocket gateway. */
+	connectWS(): Promise<void>;
+	/** Sends a message to a channel. */
+	sendMessage(serverId: string, channelId: string, content: string | ISendMessageRequest | EmbedBuilder | IMessageWithEmbeds | MessageBuilder | PollBuilder): Promise<Message>;
+	/** Votes on a poll option. */
+	votePoll(serverId: string, channelId: string, messageId: string, optionId: string): Promise<void>;
+	/** Fetches recent messages from a channel. */
+	getMessages(serverId: string, channelId: string, limit?: number): Promise<Message[]>;
+	/** Deletes multiple messages in a single request. */
+	bulkDeleteMessages(serverId: string, channelId: string, messageIds: string[]): Promise<number>;
+	/** Adds a reaction to a message. */
+	reactToMessage(serverId: string, channelId: string, messageId: string, emoji: string): Promise<void>;
+	/** Deletes a single message. */
+	deleteMessage(serverId: string, channelId: string, messageId: string): Promise<void>;
+	/** Bans a member from a server. */
+	banMember(serverId: string, userId: string, reason?: string, deleteMessageDays?: number): Promise<void>;
+	/** Lifts a ban from a user. */
+	unbanMember(serverId: string, userId: string, reason?: string): Promise<void>;
+	/** Kicks a member from a server. */
+	kickMember(serverId: string, userId: string, reason?: string): Promise<void>;
+	/** Times out a member. */
+	timeoutMember(serverId: string, userId: string, duration: number, reason?: string): Promise<void>;
+	/** Updates a channel's properties. */
+	updateChannel(serverId: string, channelId: string, data: Record<string, JsonValue>): Promise<void>;
+	/** Retrieves a server's details. */
+	getServer(serverId: string): Promise<Record<string, JsonValue>>;
+	/** Retrieves channel statistics. */
+	getChannelStats(serverId: string, channelId: string): Promise<{
+		messageCount: number;
+		channelName: string;
+	}>;
+	/** Retrieves server statistics. */
+	getServerStats(serverId: string): Promise<{
+		totalCount: number;
+		onlineCount: number;
+	}>;
+	/** Fetches all roles in a server. */
+	getRoles(serverId: string): Promise<Role[]>;
+	/** Checks if a user has a specific permission in a server. */
+	hasPermission(serverId: string, userId: string, permission: string): Promise<boolean>;
+}
+export type WsErrorCode = "AUTHENTICATION_FAILED" | "INTERNAL_ERROR" | "MALFORMED_MESSAGE" | "UNAUTHORIZED" | "DUPLICATE_MESSAGE" | "RATE_LIMIT" | "TIMEOUT" | "FORBIDDEN" | "BAD_REQUEST" | "NOT_FOUND" | "CONFLICT";
+export type WsEvent = {
+	type: "authenticated";
+	payload: {
+		user: ClientUser;
+		instanceId: string;
+	};
+} | {
+	type: "error";
+	payload: {
+		code: WsErrorCode;
+		details?: string | Record<string, string>;
+	};
+} | {
+	type: "message_server";
+	payload: IMessageServer;
+} | {
+	type: "interaction_create_server";
+	payload: InteractionCreatePayload;
+} | {
+	type: "message_server_edited";
+	payload: MessageUpdatePayload;
+} | {
+	type: "message_server_deleted";
+	payload: MessageDeletePayload;
+} | {
+	type: "messages_server_bulk_deleted";
+	payload: {
+		messageIds: string[];
+		serverId: string;
+		channelId: string;
+		hard?: boolean;
+	};
+} | {
+	type: "reaction_added";
+	payload: ReactionPayload;
+} | {
+	type: "reaction_removed";
+	payload: ReactionPayload;
+} | {
+	type: "poll_vote_updated_server";
+	payload: PollVoteUpdatePayload;
+} | {
+	type: "poll_vote_updated_dm";
+	payload: PollVoteUpdatePayload;
+} | {
+	type: "member_added";
+	payload: MemberAddedPayload;
+} | {
+	type: "member_removed";
+	payload: MemberRemovedPayload;
+} | {
+	type: "member_updated";
+	payload: MemberUpdatedPayload;
+} | {
+	type: "channel_created";
+	payload: ChannelCreatedPayload;
+} | {
+	type: "channel_updated";
+	payload: ChannelUpdatedPayload;
+} | {
+	type: "channel_deleted";
+	payload: ChannelDeletedPayload;
+} | {
+	type: "channels_reordered";
+	payload: ChannelsReorderedPayload;
+} | {
+	type: "category_created";
+	payload: CategoryCreatedPayload;
+} | {
+	type: "category_updated";
+	payload: CategoryUpdatedPayload;
+} | {
+	type: "category_deleted";
+	payload: CategoryDeletedPayload;
+} | {
+	type: "categories_reordered";
+	payload: CategoriesReorderedPayload;
+} | {
+	type: "channel_permissions_updated";
+	payload: ChannelPermissionsUpdatedPayload;
+} | {
+	type: "category_permissions_updated";
+	payload: CategoryPermissionsUpdatedPayload;
+} | {
+	type: "server_updated";
+	payload: ServerUpdatedPayload;
+} | {
+	type: "server_deleted";
+	payload: ServerDeletedPayload;
+} | {
+	type: "server_icon_updated";
+	payload: {
+		serverId: string;
+		icon: string;
+	};
+} | {
+	type: "server_banner_updated";
+	payload: {
+		serverId: string;
+		banner: {
+			type: "image";
+			value: string;
+		};
+	};
+} | {
+	type: "role_created";
+	payload: RoleCreatedPayload;
+} | {
+	type: "role_updated";
+	payload: RoleUpdatedPayload;
+} | {
+	type: "role_deleted";
+	payload: RoleDeletedPayload;
+} | {
+	type: "roles_reordered";
+	payload: RolesReorderedPayload;
+} | {
+	type: "server_invite_created";
+	payload: InviteCreatedPayload;
+} | {
+	type: "server_invite_deleted";
+	payload: InviteDeletedPayload;
+} | {
+	type: "member_banned";
+	payload: MemberBannedPayload;
+} | {
+	type: "member_unbanned";
+	payload: MemberUnbannedPayload;
+} | {
+	type: "ownership_transferred";
+	payload: OwnershipTransferredPayload;
+} | {
+	type: "server_joined";
+	payload: ServerJoinedPayload;
+} | {
+	type: "presence_sync";
+	payload: PresenceSyncPayload;
+} | {
+	type: "user_online";
+	payload: UserPresencePayload;
+} | {
+	type: "user_offline";
+	payload: UserOfflinePayload;
+} | {
+	type: "user_updated";
+	payload: UserUpdatedPayload;
+} | {
+	type: "ping";
+	payload: Record<string, never>;
+} | {
+	type: "pong";
+	payload: Record<string, never>;
+};
+export interface IWsIncomingMessage {
+	id?: string;
+	event?: WsEvent;
+	meta?: {
+		replyTo?: string;
+	};
+}
+
+export {
+	Interaction as CommandInteraction,
+};
+
+export {};