@snowluma/sdk 0.1.0

package/dist/client/api-client.js

@@ -0,0 +1,331 @@
+import { createSnowLumaApiError } from '../errors';
+import { normalizeMessage } from '../messages/index';
+/**
+ * Base class for SnowLuma API clients.
+ *
+ * Concrete transports implement request(); this facade adds typed OneBot actions,
+ * message normalization, and failed-response error handling.
+ */
+export class SnowLumaApiClient {
+    /** Sends a OneBot action and returns data, throwing SnowLumaApiError on failed responses. */
+    async call(action, params, options) {
+        const response = await this.request(action, params, options);
+        if (response.status !== 'ok' || response.retcode !== 0) {
+            throw createSnowLumaApiError(response);
+        }
+        return response.data;
+    }
+    getLoginInfo(options) {
+        return this.call('get_login_info', {}, options);
+    }
+    getStatus(options) {
+        return this.call('get_status', {}, options);
+    }
+    getVersionInfo(options) {
+        return this.call('get_version_info', {}, options);
+    }
+    canSendImage(options) {
+        return this.call('can_send_image', {}, options);
+    }
+    canSendRecord(options) {
+        return this.call('can_send_record', {}, options);
+    }
+    sendMsg(params, options) {
+        return this.call('send_msg', { ...params, message: normalizeMessage(params.message) }, options);
+    }
+    sendPrivateMessage(userId, message, options) {
+        return this.call('send_private_msg', {
+            user_id: userId,
+            message: normalizeMessage(message),
+            auto_escape: options?.autoEscape,
+        }, options);
+    }
+    sendGroupMessage(groupId, message, options) {
+        return this.call('send_group_msg', {
+            group_id: groupId,
+            message: normalizeMessage(message),
+            auto_escape: options?.autoEscape,
+        }, options);
+    }
+    getMessage(messageId, options) {
+        return this.call('get_msg', { message_id: messageId }, options);
+    }
+    deleteMessage(messageId, options) {
+        return this.call('delete_msg', { message_id: messageId }, options);
+    }
+    getFriendList(options) {
+        return this.call('get_friend_list', {}, options);
+    }
+    getStrangerInfo(userId, options) {
+        return this.call('get_stranger_info', { user_id: userId }, options);
+    }
+    deleteFriend(userId, options) {
+        return this.call('delete_friend', { user_id: userId, block: options?.block }, options);
+    }
+    getGroupList(options) {
+        return this.call('get_group_list', { no_cache: options?.noCache }, options);
+    }
+    getGroupInfo(groupId, options) {
+        return this.call('get_group_info', { group_id: groupId, no_cache: options?.noCache }, options);
+    }
+    getGroupMemberList(groupId, options) {
+        return this.call('get_group_member_list', { group_id: groupId, no_cache: options?.noCache }, options);
+    }
+    getGroupMemberInfo(groupId, userId, options) {
+        return this.call('get_group_member_info', {
+            group_id: groupId,
+            user_id: userId,
+            no_cache: options?.noCache,
+        }, options);
+    }
+    getGroupHonorInfo(params, options) {
+        return this.call('get_group_honor_info', params, options);
+    }
+    getGroupSystemMessages(options) {
+        return this.call('get_group_system_msg', {}, options);
+    }
+    setGroupKick(groupId, userId, options) {
+        return this.call('set_group_kick', {
+            group_id: groupId,
+            user_id: userId,
+            reject_add_request: options?.rejectAddRequest,
+        }, options);
+    }
+    setGroupBan(groupId, userId, duration, options) {
+        return this.call('set_group_ban', { group_id: groupId, user_id: userId, duration }, options);
+    }
+    setGroupWholeBan(groupId, enable = true, options) {
+        return this.call('set_group_whole_ban', { group_id: groupId, enable }, options);
+    }
+    setGroupAdmin(groupId, userId, enable = true, options) {
+        return this.call('set_group_admin', { group_id: groupId, user_id: userId, enable }, options);
+    }
+    setGroupCard(groupId, userId, card = '', options) {
+        return this.call('set_group_card', { group_id: groupId, user_id: userId, card }, options);
+    }
+    setGroupName(groupId, name, options) {
+        return this.call('set_group_name', { group_id: groupId, group_name: name }, options);
+    }
+    setGroupLeave(groupId, options) {
+        return this.call('set_group_leave', { group_id: groupId }, options);
+    }
+    setGroupSpecialTitle(groupId, userId, title = '', options) {
+        return this.call('set_group_special_title', {
+            group_id: groupId,
+            user_id: userId,
+            special_title: title,
+        }, options);
+    }
+    uploadGroupFile(groupId, file, options = {}) {
+        return this.call('upload_group_file', {
+            group_id: groupId,
+            file,
+            name: options.name,
+            folder: options.folder,
+            folder_id: options.folderId,
+            upload_file: options.uploadFile,
+        }, options);
+    }
+    uploadPrivateFile(userId, file, options = {}) {
+        return this.call('upload_private_file', {
+            user_id: userId,
+            file,
+            name: options.name,
+            upload_file: options.uploadFile,
+        }, options);
+    }
+    getGroupFileUrl(groupId, fileId, options) {
+        return this.call('get_group_file_url', { group_id: groupId, file_id: fileId, busid: options?.busid }, options);
+    }
+    getGroupRootFiles(groupId, options) {
+        return this.call('get_group_root_files', { group_id: groupId }, options);
+    }
+    getGroupFilesByFolder(groupId, folderId = '/', options) {
+        return this.call('get_group_files_by_folder', { group_id: groupId, folder_id: folderId }, options);
+    }
+    deleteGroupFile(groupId, fileId, options) {
+        return this.call('delete_group_file', { group_id: groupId, file_id: fileId }, options);
+    }
+    moveGroupFile(groupId, fileId, parentDirectory, targetDirectory, options) {
+        return this.call('move_group_file', {
+            group_id: groupId,
+            file_id: fileId,
+            parent_directory: parentDirectory,
+            target_directory: targetDirectory,
+        }, options);
+    }
+    createGroupFileFolder(groupId, name, parentId = '/', options) {
+        return this.call('create_group_file_folder', { group_id: groupId, name, parent_id: parentId }, options);
+    }
+    deleteGroupFileFolder(groupId, folderId, options) {
+        return this.call('delete_group_file_folder', { group_id: groupId, folder_id: folderId }, options);
+    }
+    renameGroupFileFolder(groupId, folderId, newName, options) {
+        return this.call('rename_group_file_folder', {
+            group_id: groupId,
+            folder_id: folderId,
+            new_folder_name: newName,
+        }, options);
+    }
+    getPrivateFileUrl(userId, fileId, fileHash, options) {
+        return this.call('get_private_file_url', { user_id: userId, file_id: fileId, file_hash: fileHash }, options);
+    }
+    setFriendAddRequest(flag, approve = true, options) {
+        return this.call('set_friend_add_request', { flag, approve }, options);
+    }
+    setGroupAddRequest(flag, params = {}) {
+        return this.call('set_group_add_request', {
+            flag,
+            sub_type: params.subType,
+            type: params.type,
+            approve: params.approve,
+            reason: params.reason,
+        }, params);
+    }
+    sendLike(userId, times = 1, options) {
+        return this.call('send_like', { user_id: userId, times }, options);
+    }
+    friendPoke(userId, options) {
+        return this.call('friend_poke', { user_id: userId, target_id: options?.targetId }, options);
+    }
+    groupPoke(groupId, userId, options) {
+        return this.call('group_poke', { group_id: groupId, user_id: userId }, options);
+    }
+    sendPoke(userId, options) {
+        return this.call('send_poke', { user_id: userId, group_id: options?.groupId }, options);
+    }
+    setEssenceMessage(messageId, options) {
+        return this.call('set_essence_msg', { message_id: messageId }, options);
+    }
+    deleteEssenceMessage(messageId, options) {
+        return this.call('delete_essence_msg', { message_id: messageId }, options);
+    }
+    getEssenceMessageList(groupId, options) {
+        return this.call('get_essence_msg_list', { group_id: groupId }, options);
+    }
+    setGroupReaction(params, options) {
+        return this.call('set_group_reaction', params, options);
+    }
+    getGroupMessageHistory(params, options) {
+        return this.call('get_group_msg_history', params, options);
+    }
+    getFriendMessageHistory(params, options) {
+        return this.call('get_friend_msg_history', params, options);
+    }
+    markGroupMessageAsRead(messageId, groupId, options) {
+        return this.call('mark_group_msg_as_read', { message_id: messageId, group_id: groupId }, options);
+    }
+    markPrivateMessageAsRead(messageId, userId, options) {
+        return this.call('mark_private_msg_as_read', { message_id: messageId, user_id: userId }, options);
+    }
+    markMessageAsRead(messageId, targetId, options) {
+        return this.call('mark_msg_as_read', { message_id: messageId, target_id: targetId }, options);
+    }
+    getRKey(options) {
+        return this.call('get_rkey', {}, options);
+    }
+    sendGroupNotice(groupId, content, options = {}) {
+        return this.call('_send_group_notice', {
+            group_id: groupId,
+            content,
+            image: options.image,
+            pinned: options.pinned,
+            type: options.type,
+            confirm_required: options.confirmRequired,
+        }, options);
+    }
+    getGroupNotice(groupId, options) {
+        return this.call('_get_group_notice', { group_id: groupId }, options);
+    }
+    uploadForwardMessage(params, options) {
+        return this.call('upload_forward_msg', params, options);
+    }
+    sendForwardMessage(params, options) {
+        return this.call('send_forward_msg', params, options);
+    }
+    sendGroupForwardMessage(groupId, messages, options) {
+        return this.call('send_group_forward_msg', {
+            group_id: groupId,
+            messages: normalizeMessage(messages),
+        }, options);
+    }
+    sendPrivateForwardMessage(userId, messages, options) {
+        return this.call('send_private_forward_msg', {
+            user_id: userId,
+            messages: normalizeMessage(messages),
+        }, options);
+    }
+    getForwardMessage(params, options) {
+        return this.call('get_forward_msg', params, options);
+    }
+    getImage(params, options) {
+        return this.call('get_image', params, options);
+    }
+    getRecord(params, options) {
+        return this.call('get_record', params, options);
+    }
+    getCookies(params = {}, options) {
+        return this.call('get_cookies', params, options);
+    }
+    getCsrfToken(options) {
+        return this.call('get_csrf_token', {}, options);
+    }
+    getCredentials(params = {}, options) {
+        return this.call('get_credentials', params, options);
+    }
+    cleanCache(options) {
+        return this.call('clean_cache', {}, options);
+    }
+    setFriendRemark(userId, remark, options) {
+        return this.call('set_friend_remark', { user_id: userId, remark }, options);
+    }
+    setMsgEmojiLike(messageId, emojiId, set = true, options) {
+        return this.call('set_msg_emoji_like', { message_id: messageId, emoji_id: emojiId, set }, options);
+    }
+    markAllAsRead(options) {
+        return this.call('_mark_all_as_read', {}, options);
+    }
+    getGroupFileSystemInfo(groupId, options) {
+        return this.call('get_group_file_system_info', { group_id: groupId }, options);
+    }
+    checkUrlSafely(options) {
+        return this.call('check_url_safely', {}, options);
+    }
+    downloadFile(params, options) {
+        return this.call('download_file', params, options);
+    }
+    setQqProfile(params, options) {
+        return this.call('set_qq_profile', {
+            nickname: params.nickname,
+            personal_note: params.personalNote,
+        }, options);
+    }
+    setOnlineStatus(status, params = {}) {
+        return this.call('set_online_status', {
+            status,
+            ext_status: params.extStatus,
+            battery_status: params.batteryStatus,
+        }, params);
+    }
+    getClientKey(options) {
+        return this.call('get_clientkey', {}, options);
+    }
+    getGroupInfoEx(groupId, options) {
+        return this.call('get_group_info_ex', { group_id: groupId }, options);
+    }
+    getGroupDetailInfo(groupId, options) {
+        return this.call('get_group_detail_info', { group_id: groupId }, options);
+    }
+    /** Calls any registered SnowLuma action and returns the response data. */
+    raw(action, params, options) {
+        return this.call(action, params, options);
+    }
+    /** Calls any registered SnowLuma action and preserves the full OneBot response envelope. */
+    rawResponse(action, params, options) {
+        return this.request(action, params, options);
+    }
+}
+export function toJsonObject(value) {
+    return value ?? {};
+}
+//# sourceMappingURL=api-client.js.map

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

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

package/dist/client/http-client.d.ts

@@ -0,0 +1,25 @@
+import { SnowLumaApiClient } from './api-client';
+import type { ActionParams, ActionResult, ApiResponse, RequestOptions, SnowLumaAction, SnowLumaClientOptions } from '../types/index';
+/** Options for the HTTP transport client. */
+export interface SnowLumaHttpClientOptions extends SnowLumaClientOptions {
+    /** OneBot HTTP endpoint. Defaults to http://127.0.0.1:3000/. */
+    baseUrl?: string;
+    /** Custom fetch implementation for tests or non-standard runtimes. */
+    fetch?: typeof fetch;
+    /** Extra headers sent with every request. Authorization is managed by accessToken. */
+    headers?: Record<string, string>;
+}
+/** OneBot HTTP client for SnowLuma. */
+export declare class SnowLumaHttpClient extends SnowLumaApiClient {
+    readonly baseUrl: string;
+    readonly accessToken?: string;
+    readonly requestTimeoutMs: number;
+    private readonly fetchImpl;
+    private readonly headers;
+    constructor(options?: SnowLumaHttpClientOptions);
+    /** Sends one OneBot action over HTTP and returns the raw response envelope. */
+    request<TAction extends SnowLumaAction>(action: TAction, params?: ActionParams<TAction>, options?: RequestOptions): Promise<ApiResponse<ActionResult<TAction>>>;
+    private createHeaders;
+}
+export declare function createHttpClient(options?: SnowLumaHttpClientOptions): SnowLumaHttpClient;
+//# sourceMappingURL=http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/client/http-client.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAgB,MAAM,cAAc,CAAC;AAG/D,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,cAAc,EACd,cAAc,EACd,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,6CAA6C;AAC7C,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,uCAAuC;AACvC,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,GAAE,yBAA8B;IAanD,+EAA+E;IAChE,OAAO,CAAC,OAAO,SAAS,cAAc,EACnD,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IA0C9C,OAAO,CAAC,aAAa;CAWtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CAExF"}

package/dist/client/http-client.js

@@ -0,0 +1,81 @@
+import { SnowLumaAbortError, SnowLumaConnectionError, SnowLumaParseError, SnowLumaTimeoutError, SnowLumaTransportError, } from '../errors';
+import { SnowLumaApiClient, toJsonObject } from './api-client';
+import { createRequestAbortState, isAbortError } from '../internal/abort';
+import { assertApiResponse } from '../internal/json';
+/** OneBot HTTP client for SnowLuma. */
+export class SnowLumaHttpClient extends SnowLumaApiClient {
+    baseUrl;
+    accessToken;
+    requestTimeoutMs;
+    fetchImpl;
+    headers;
+    constructor(options = {}) {
+        super();
+        this.baseUrl = options.baseUrl ?? 'http://127.0.0.1:3000/';
+        this.accessToken = options.accessToken;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        this.headers = options.headers ?? {};
+        if (!this.fetchImpl) {
+            throw new SnowLumaConnectionError('No fetch implementation is available');
+        }
+    }
+    /** Sends one OneBot action over HTTP and returns the raw response envelope. */
+    async request(action, params, options) {
+        const timeoutMs = options?.timeoutMs ?? this.requestTimeoutMs;
+        const abort = createRequestAbortState(timeoutMs, options?.signal);
+        try {
+            const response = await this.fetchImpl(this.baseUrl, {
+                method: 'POST',
+                headers: this.createHeaders(),
+                body: JSON.stringify({
+                    action,
+                    params: toJsonObject(params),
+                    echo: options?.echo,
+                }),
+                signal: abort.signal,
+            });
+            const text = await response.text();
+            let parsed;
+            try {
+                parsed = text ? JSON.parse(text) : null;
+            }
+            catch (error) {
+                throw new SnowLumaParseError(`SnowLuma returned non-JSON HTTP ${response.status}`, { cause: error });
+            }
+            const apiResponse = assertApiResponse(parsed);
+            return apiResponse;
+        }
+        catch (error) {
+            if (error instanceof SnowLumaTransportError)
+                throw error;
+            if (isAbortError(error) || abort.signal.aborted) {
+                if (abort.isTimedOut()) {
+                    throw new SnowLumaTimeoutError(`SnowLuma request timed out after ${timeoutMs}ms`, timeoutMs, { cause: error });
+                }
+                if (abort.isExternallyAborted()) {
+                    throw new SnowLumaAbortError('SnowLuma request aborted', { cause: error });
+                }
+            }
+            throw new SnowLumaConnectionError('SnowLuma HTTP request failed', { cause: error });
+        }
+        finally {
+            abort.cleanup();
+        }
+    }
+    createHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            ...this.headers,
+        };
+        if (this.accessToken) {
+            headers.Authorization = `Bearer ${this.accessToken}`;
+        }
+        return headers;
+    }
+}
+export function createHttpClient(options) {
+    return new SnowLumaHttpClient(options);
+}
+//# sourceMappingURL=http-client.js.map

package/dist/client/http-client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+export { SnowLumaApiClient } from './api-client';
+export { SnowLumaHttpClient, createHttpClient } from './http-client';
+export { SnowLumaWebSocketClient, createWebSocketClient } from './websocket-client';
+export type { SnowLumaHttpClientOptions } from './http-client';
+export type { ReconnectOptions, SnowLumaWebSocketClientOptions, SnowLumaWebSocketEvents, WebSocketCloseInfo, WebSocketConstructor, } from './websocket-client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EACV,gBAAgB,EAChB,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,4 @@
+export { SnowLumaApiClient } from './api-client';
+export { SnowLumaHttpClient, createHttpClient } from './http-client';
+export { SnowLumaWebSocketClient, createWebSocketClient } from './websocket-client';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/client/websocket-client.d.ts

@@ -0,0 +1,65 @@
+import { type CommandHandler, type CommandOptions, type EventHandler, type EventMiddleware, type EventPredicate } from '../events/index';
+import { SnowLumaApiClient } from './api-client';
+import type { ActionParams, ActionResult, ApiResponse, OneBotMessageEvent, OneBotMetaEvent, OneBotNoticeEvent, OneBotRequestEvent, RequestOptions, SnowLumaAction, SnowLumaEvent, WsRole } from '../types/index';
+import type { SnowLumaWebSocketClientOptions, SnowLumaWebSocketEvents } from './websocket-types';
+export type { ReconnectOptions, SnowLumaWebSocketClientOptions, SnowLumaWebSocketEvents, WebSocketCloseInfo, WebSocketConstructor, } from './websocket-types';
+/** OneBot WebSocket client for SnowLuma APIs and realtime events. */
+export declare class SnowLumaWebSocketClient extends SnowLumaApiClient {
+    readonly url: string;
+    readonly accessToken?: string;
+    readonly requestTimeoutMs: number;
+    readonly role: WsRole;
+    private readonly protocols?;
+    private readonly WebSocketCtor;
+    private readonly reconnect;
+    private readonly emitter;
+    private readonly pending;
+    private readonly middlewares;
+    private socket;
+    private connectPromise;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private closedByUser;
+    constructor(options?: SnowLumaWebSocketClientOptions);
+    /** True when the underlying WebSocket is currently open. */
+    get isConnected(): boolean;
+    /** Subscribes to low-level client events. Returns an unsubscribe function. */
+    on<TKey extends keyof SnowLumaWebSocketEvents>(event: TKey, listener: (payload: SnowLumaWebSocketEvents[TKey]) => void): () => void;
+    /** Subscribes to one low-level client event, then automatically unsubscribes. */
+    once<TKey extends keyof SnowLumaWebSocketEvents>(event: TKey, listener: (payload: SnowLumaWebSocketEvents[TKey]) => void): () => void;
+    /** Removes a previously registered low-level client event listener. */
+    off<TKey extends keyof SnowLumaWebSocketEvents>(event: TKey, listener: (payload: SnowLumaWebSocketEvents[TKey]) => void): void;
+    /** Subscribes to every SnowLuma event packet. */
+    onEvent(listener: (event: SnowLumaEvent) => void): () => void;
+    /** Adds event middleware to the dispatch pipeline. */
+    use(middleware: EventMiddleware): () => void;
+    /** Runs a handler when a type guard or predicate matches an event. */
+    when<TEvent extends SnowLumaEvent>(predicate: EventPredicate<TEvent>, handler: EventHandler<TEvent>): () => void;
+    onMessage(handler: EventHandler<OneBotMessageEvent>): () => void;
+    onPrivateMessage(handler: EventHandler<Extract<OneBotMessageEvent, {
+        message_type: 'private';
+    }>>): () => void;
+    onGroupMessage(handler: EventHandler<Extract<OneBotMessageEvent, {
+        message_type: 'group';
+    }>>): () => void;
+    onNotice(handler: EventHandler<OneBotNoticeEvent>): () => void;
+    onNotice(type: string, handler: EventHandler<OneBotNoticeEvent>): () => void;
+    onRequest(handler: EventHandler<OneBotRequestEvent>): () => void;
+    onRequest(type: string, handler: EventHandler<OneBotRequestEvent>): () => void;
+    onMetaEvent(handler: EventHandler<OneBotMetaEvent>): () => void;
+    command(command: string | RegExp, handler: CommandHandler, options?: CommandOptions): () => void;
+    /** Connects to SnowLuma's OneBot WebSocket endpoint. */
+    connect(): Promise<void>;
+    /** Closes the socket and rejects all pending API requests. */
+    close(code?: number, reason?: string): void;
+    /** Sends one OneBot action over WebSocket and returns the raw response envelope. */
+    request<TAction extends SnowLumaAction>(action: TAction, params?: ActionParams<TAction>, options?: RequestOptions): Promise<ApiResponse<ActionResult<TAction>>>;
+    private bindSocket;
+    private handleMessage;
+    private dispatchEvent;
+    private handleClose;
+    private scheduleReconnect;
+    private rejectPending;
+}
+export declare function createWebSocketClient(options?: SnowLumaWebSocketClientOptions): SnowLumaWebSocketClient;
+//# sourceMappingURL=websocket-client.d.ts.map

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

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