napcon 0.0.9

package/README.md

@@ -0,0 +1,16 @@
+# NapCon
+
+A lightweight TypeScript library for [NapCat](https://github.com/NapNeko/NapCatQQ) and [OneBot v11](https://11.onebot.dev).
+
+> **Note**: This library is currently in active development. APIs are subject to change.
+
+## Features
+
+- **Ultra-lightweight**: Zero dependencies, ~1.7KB gzipped.
+- **Simple API**: Connect to the server with a single `open(...)` method.
+- **TypeScript First**: Comprehensive type definitions for events and methods.
+- **Rich Utilities**: Built-in message builders, guards, and helper functions.
+
+## Example
+
+Check out [examples/main.ts](https://github.com/suisanka/napcon/blob/main/examples/main.ts) for usage examples.

package/dist/connection-CBr_CAbl.d.mts

@@ -0,0 +1,669 @@
+//#region src/types/common.d.ts
+type Dispose = {} & (() => void);
+type MaybePromiseLike<T> = T | PromiseLike<T>;
+type MaybeArray<T> = T | T[];
+//#endregion
+//#region src/types/message.d.ts
+type ProtocolMessageSegment = ProtocolMessageRecvSegment | ProtocolMessageSendSegment;
+type ProtocolMessageRecvSegment = ProtocolMessageTextSegment | ProtocolMessageAtSegment | ProtocolMessageReplySegment | ProtocolMessageFaceSegment | ProtocolMessageDiceRecvSegment | ProtocolMessageRpsRecvSegment | ProtocolMessagePokeRecvSegment | ProtocolMessageImageRecvSegment | ProtocolMessageRecordRecvSegment | ProtocolMessageVideoRecvSegment | ProtocolMessageFileRecvSegment | ProtocolMessageJsonRecvSegment | ProtocolMessageMusicRecvSegment | ProtocolMessageForwardRecvSegment | ProtocolMessageMarkdownSegment | ProtocolMessageMiniAppSegment | ProtocolMessageLocationSegment | ProtocolMessageXmlSegment | ProtocolMessageOnlineFileSegment | ProtocolMessageFlashTransferSegment;
+type ProtocolMessageSendSegment = ProtocolMessageTextSegment | ProtocolMessageAtSegment | ProtocolMessageReplySegment | ProtocolMessageFaceSegment | ProtocolMessageMfaceSendSegment | ProtocolMessageDiceSendSegment | ProtocolMessageRpsSendSegment | ProtocolMessagePokeSendSegment | ProtocolMessageImageSendSegment | ProtocolMessageRecordSendSegment | ProtocolMessageVideoSendSegment | ProtocolMessageFileSendSegment | ProtocolMessageJsonSendSegment | ProtocolMessageMusicSendSegment | ProtocolMessageContactSendSegment | ProtocolMessageMarkdownSegment | ProtocolMessageMiniAppSegment | ProtocolMessageLocationSegment | ProtocolMessageXmlSegment | ProtocolMessageOnlineFileSegment | ProtocolMessageFlashTransferSegment;
+interface ProtocolMessageTextSegment {
+  type: 'text';
+  data: {
+    text: string;
+  };
+}
+interface ProtocolMessageMarkdownSegment {
+  type: 'markdown';
+  data: {
+    content: string;
+  };
+}
+interface ProtocolMessageAtSegment {
+  type: 'at';
+  data: {
+    qq: string;
+    name?: string;
+  };
+}
+interface ProtocolMessageReplySegment {
+  type: 'reply';
+  data: {
+    id: string;
+  };
+}
+interface ProtocolMessageFaceSegment {
+  type: 'face';
+  data: {
+    id: string;
+  };
+}
+interface ProtocolMessageMfaceSendSegment {
+  type: 'mface';
+  data: {
+    emoji_id: string;
+    emoji_package_id: string;
+    key: string;
+    summary?: string;
+  };
+}
+interface ProtocolMessageDiceRecvSegment {
+  type: 'dice';
+  data: {
+    result: '1' | '2' | '3' | '4' | '5' | '6';
+  };
+}
+interface ProtocolMessageDiceSendSegment {
+  type: 'dice';
+  data: Record<string, never>;
+}
+interface ProtocolMessageRpsRecvSegment {
+  type: 'rps';
+  data: {
+    result: '1' | '2' | '3';
+  };
+}
+interface ProtocolMessageRpsSendSegment {
+  type: 'rps';
+  data: Record<string, never>;
+}
+interface ProtocolMessagePokeRecvSegment {
+  type: 'poke';
+  data: {
+    type: string;
+    id: string;
+  };
+}
+interface ProtocolMessagePokeSendSegment {
+  type: 'poke';
+  data: {
+    type: string;
+    id: string;
+  };
+}
+interface ProtocolMessageImageRecvSegment {
+  type: 'image';
+  data: {
+    file: string;
+    name?: string;
+    summary?: string;
+    sub_type?: number;
+    file_id?: string;
+    url?: string;
+    path?: string;
+    file_size?: number;
+    file_unique?: string;
+  };
+}
+interface ProtocolMessageImageSendSegment {
+  type: 'image';
+  data: {
+    file: string;
+    name?: string;
+    summary?: string;
+    sub_type?: number;
+  };
+}
+interface ProtocolMessageContactSendSegment {
+  type: 'contact';
+  data: {
+    type: 'qq' | 'group';
+    id: string;
+  };
+}
+interface ProtocolMessageRecordRecvSegment {
+  type: 'record';
+  data: {
+    file: string;
+    url?: string;
+    path?: string;
+    file_id?: string;
+    file_size?: number;
+    file_unique?: string;
+  };
+}
+interface ProtocolMessageRecordSendSegment {
+  type: 'record';
+  data: {
+    file: string;
+    name?: string;
+  };
+}
+interface ProtocolMessageVideoRecvSegment {
+  type: 'video';
+  data: {
+    file: string;
+    url?: string;
+    path?: string;
+    file_id?: string;
+    file_size?: number;
+    file_unique?: string;
+  };
+}
+interface ProtocolMessageVideoSendSegment {
+  type: 'video';
+  data: {
+    file: string;
+    name?: string;
+    thumb?: string;
+  };
+}
+interface ProtocolMessageFileRecvSegment {
+  type: 'file';
+  data: {
+    file: string;
+    path?: string;
+    url?: string;
+    file_id?: string;
+    file_size?: number;
+    file_unique?: string;
+  };
+}
+interface ProtocolMessageFileSendSegment {
+  type: 'file';
+  data: {
+    file: string;
+    name?: string;
+  };
+}
+interface ProtocolMessageJsonRecvSegment {
+  type: 'json';
+  data: {
+    data: string | object;
+  };
+}
+interface ProtocolMessageJsonSendSegment {
+  type: 'json';
+  data: {
+    data: string | object;
+  };
+}
+interface ProtocolMessageMusicRecvSegment {
+  type: 'music';
+  data: {
+    type?: 'qq' | '163' | 'kugou' | 'kuwo' | 'migu' | 'custom';
+    id?: string;
+    url?: string;
+    audio?: string;
+    title?: string;
+    image?: string;
+    singer?: string;
+  };
+}
+interface ProtocolMessageMusicSendSegment {
+  type: 'music';
+  data: {
+    type: 'qq' | '163' | 'kugou' | 'kuwo' | 'migu' | 'custom';
+    id?: string;
+    url?: string;
+    audio?: string;
+    title?: string;
+    image?: string;
+    singer?: string;
+  };
+}
+interface ProtocolMessageForwardRecvSegment {
+  type: 'forward';
+  data: {
+    id: string;
+    content?: ProtocolMessageEvent;
+  };
+}
+type ProtocolMessageNode = ProtocolMessageRefNode | ProtocolMessageContentNode;
+interface ProtocolMessageRefNode {
+  type: 'node';
+  data: {
+    id: string;
+    content?: ProtocolMessageRecvSegment[];
+  };
+}
+interface ProtocolMessageContentNode {
+  type: 'node';
+  data: {
+    user_id: string;
+    nickname: string;
+    id?: string;
+    content: ProtocolMessageSegment[];
+  };
+}
+interface ProtocolMessageMiniAppSegment {
+  type: 'miniapp';
+  data: {
+    data: string;
+  };
+}
+interface ProtocolMessageLocationSegment {
+  type: 'location';
+  data: {
+    lat: string | number;
+    lon: string | number;
+    title?: string;
+    content?: string;
+  };
+}
+interface ProtocolMessageXmlSegment {
+  type: 'xml';
+  data: {
+    data: string;
+  };
+}
+interface ProtocolMessageOnlineFileSegment {
+  type: 'onlinefile';
+  data: {
+    msgId: string;
+    elementId: string;
+    fileName: string;
+    fileSize: string;
+    isDir: boolean;
+  };
+}
+interface ProtocolMessageFlashTransferSegment {
+  type: 'flashtransfer';
+  data: {
+    fileSetId: string;
+  };
+}
+//#endregion
+//#region src/types/event.d.ts
+type ProtocolEventPostTypes = 'meta_event' | 'notice' | 'request' | 'message' | 'message_sent';
+interface ProtocolEventCommon {
+  time: number;
+  self_id: number;
+  post_type?: string;
+  sub_type?: string;
+  [x: string]: unknown;
+}
+interface ProtocolMetaEventCommon extends ProtocolEventCommon {
+  post_type: 'meta_event';
+}
+interface ProtocolMetaHeartbeatEvent extends ProtocolMetaEventCommon {
+  meta_event_type: 'heartbeat';
+  status: {
+    online?: boolean;
+    good: boolean;
+  };
+  interval: number;
+}
+type ProtocolMetaLifecycleEventSubTypes = 'enable' | 'disable' | 'connect';
+interface ProtocolMetaLifecycleEvent extends ProtocolMetaEventCommon {
+  meta_event_type: 'lifecycle';
+  sub_type: ProtocolMetaLifecycleEventSubTypes;
+}
+type ProtocolMetaEvent = ProtocolMetaHeartbeatEvent | ProtocolMetaLifecycleEvent;
+interface ProtocolNoticeEventCommon extends ProtocolEventCommon {
+  post_type: 'notice';
+}
+interface ProtocolNoticeGroupEventCommon extends ProtocolNoticeEventCommon {
+  group_id: number;
+  user_id: number;
+}
+interface ProtocolNoticeFriendAddEvent extends ProtocolNoticeEventCommon {
+  notice_type: 'friend_add';
+  user_id: number;
+}
+interface ProtocolNoticeFriendRecallEvent extends ProtocolNoticeEventCommon {
+  notice_type: 'friend_recall';
+  user_id: number;
+  message_id: number;
+}
+type ProtocolNoticeGroupIncreaseEventSubTypes = 'approve' | 'invite';
+interface ProtocolNoticeGroupIncreaseEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_increase';
+  operator_id: number;
+  sub_type: ProtocolNoticeGroupIncreaseEventSubTypes;
+}
+type ProtocolNoticeGroupDecreaseEventSubTypes = 'leave' | 'kick' | 'kick_me' | 'disband';
+interface ProtocolNoticeGroupDecreaseEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_decrease';
+  operator_id: number;
+  sub_type: ProtocolNoticeGroupDecreaseEventSubTypes;
+}
+type ProtocolNoticeGroupAdminEventSubTypes = 'set' | 'unset';
+interface ProtocolNoticeGroupAdminEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_admin';
+  sub_type: ProtocolNoticeGroupAdminEventSubTypes;
+}
+type ProtocolNoticeGroupBanEventSubTypes = 'ban' | 'lift_ban';
+interface ProtocolNoticeGroupBanEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_ban';
+  operator_id: number;
+  sub_type: ProtocolNoticeGroupBanEventSubTypes;
+  duration: number;
+}
+interface ProtocolNoticeGroupUploadFile {
+  id: string;
+  name: string;
+  size: number;
+  busid: number;
+}
+interface ProtocolNoticeGroupUploadEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_upload';
+  file: ProtocolNoticeGroupUploadFile;
+}
+interface ProtocolNoticeGroupRecallEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_recall';
+  operator_id: number;
+  message_id: number;
+}
+interface ProtocolNoticeGroupCardEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_card';
+  card_new: string;
+  card_old: string;
+}
+interface ProtocolNoticeNotifyGroupNameEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'notify';
+  sub_type: 'group_name';
+  name_new: string;
+}
+interface ProtocolNoticeNotifyGroupTitleEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'notify';
+  sub_type: 'title';
+  title: string;
+}
+type ProtocolNoticeGroupEssenceEventSubTypes = 'add' | 'delete';
+interface ProtocolNoticeGroupEssenceEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'essence';
+  message_id: number;
+  sender_id: number;
+  operator_id: number;
+  sub_type: ProtocolNoticeGroupEssenceEventSubTypes;
+}
+interface ProtocolMessageEmojiLike {
+  emoji_id: string;
+  count: number;
+}
+interface ProtocolNoticeGroupMessageEmojiLikeEvent extends ProtocolNoticeGroupEventCommon {
+  notice_type: 'group_msg_emoji_like';
+  message_id: number;
+  likes: ProtocolMessageEmojiLike[];
+}
+interface ProtocolNoticeNotifyPokeEventCommon extends ProtocolNoticeEventCommon {
+  notice_type: 'notify';
+  sub_type: 'poke';
+  target_id: number;
+  user_id: number;
+  [x: string]: any;
+}
+interface ProtocolNoticeNotifyGroupPokeEvent extends ProtocolNoticeNotifyPokeEventCommon {
+  group_id: number;
+  raw_info: any;
+}
+interface ProtocolNoticeNotifyFriendPokeEvent extends ProtocolNoticeNotifyPokeEventCommon {
+  sender_id: number;
+  raw_info: any;
+}
+type ProtocolNoticeNotifyPokeEvent = ProtocolNoticeNotifyGroupPokeEvent | ProtocolNoticeNotifyFriendPokeEvent;
+interface ProtocolNoticeNotifyProfileLikeEvent extends ProtocolNoticeEventCommon {
+  notice_type: 'notify';
+  sub_type: 'profile_like';
+  operator_id: number;
+  operator_nick: string;
+  times: number;
+  time: number;
+}
+interface ProtocolNoticeNotifyInputStatusEvent extends ProtocolNoticeEventCommon {
+  notice_type: 'notify';
+  sub_type: 'input_status';
+  status_text: string;
+  event_type: number;
+  user_id: number;
+  group_id?: number;
+}
+interface ProtocolNoticeBotOfflineEvent extends ProtocolNoticeEventCommon {
+  notice_type: 'bot_offline';
+  user_id: number;
+  tag: string;
+  message: string;
+}
+type ProtocolNoticeNotifyEvent = ProtocolNoticeNotifyGroupNameEvent | ProtocolNoticeNotifyGroupTitleEvent | ProtocolNoticeNotifyProfileLikeEvent | ProtocolNoticeNotifyInputStatusEvent | ProtocolNoticeNotifyPokeEvent;
+type ProtocolNoticeGroupEvent = ProtocolNoticeGroupIncreaseEvent | ProtocolNoticeGroupDecreaseEvent | ProtocolNoticeGroupAdminEvent | ProtocolNoticeGroupBanEvent | ProtocolNoticeGroupUploadEvent | ProtocolNoticeGroupCardEvent | ProtocolNoticeGroupEssenceEvent | ProtocolNoticeGroupMessageEmojiLikeEvent | ProtocolNoticeGroupRecallEvent;
+type ProtocolNoticeFriendEvent = ProtocolNoticeFriendAddEvent | ProtocolNoticeFriendRecallEvent;
+type ProtocolNoticeEvent = ProtocolNoticeNotifyEvent | ProtocolNoticeGroupEvent | ProtocolNoticeFriendEvent;
+interface ProtocolRequestEventCommon {
+  post_type: 'request';
+  request_type: 'friend' | 'group';
+}
+interface ProtocolFriendRequestEvent extends ProtocolRequestEventCommon {
+  request_type: 'friend';
+  user_id: number;
+  comment: string;
+  flag: string;
+}
+interface ProtocolGroupRequestEvent extends ProtocolRequestEventCommon {
+  request_type: 'group';
+  user_id: number;
+  comment: string;
+  flag: string;
+  sub_type: string;
+}
+type ProtocolRequestEvent = ProtocolFriendRequestEvent | ProtocolGroupRequestEvent;
+interface ProtocolMessageEventCommon extends ProtocolEventCommon {
+  post_type: 'message';
+  message_id: number;
+  message_type: 'private' | 'group';
+  user_id: number;
+  message: string | ProtocolMessageRecvSegment[];
+  message_format: 'string' | 'array';
+  font: string;
+  raw_message: string;
+}
+type ProtocolMessagePrivateEventSubTypes = 'friend' | 'group' | 'other';
+interface ProtocolMessagePrivateEvent extends ProtocolMessageEventCommon {
+  message_type: 'private';
+  user_id: number;
+  sub_type: ProtocolMessagePrivateEventSubTypes;
+  sender: {
+    user_id: number;
+    nickname: string;
+    sex: 'male' | 'female' | 'unknown';
+    age: number;
+    area?: string;
+  };
+}
+interface ProtocolMessageGroupEvent extends ProtocolMessageEventCommon {
+  message_type: 'group';
+  group_id: number;
+  anonymous?: any;
+  sender: {
+    user_id: number;
+    nickname: string;
+    card: string;
+    role: 'owner' | 'admin' | 'member';
+    title: string;
+    level: string;
+    sex: 'male' | 'female' | 'unknown';
+    age: number;
+    area: string;
+  };
+}
+type ProtocolMessageEvent = ProtocolMessagePrivateEvent | ProtocolMessageGroupEvent;
+interface ProtocolMessageSentEvent extends Omit<ProtocolMessageEventCommon, 'post_type'> {
+  post_type: 'message_sent';
+  target_id: number;
+}
+type ProtocolEvent = ProtocolMetaEvent | ProtocolNoticeEvent | ProtocolRequestEvent | ProtocolMessageEvent | ProtocolMessageSentEvent;
+type _GenerateProtocolEventNames<T extends Record<string | number, any>, O extends string = ''> = { [K in Exclude<keyof T, '_'>]: K extends string | number ? T[K] extends Record<'_', any> ? `${O}${K}` | _GenerateProtocolEventNames<T[K], `${O}${K}.`> : `${O}${K}` : never }[Exclude<keyof T, '_'>];
+interface ProtocolEventNamePaths {
+  meta: {
+    _: ProtocolMetaEvent;
+    heartbeat: ProtocolMetaHeartbeatEvent;
+    lifecycle: {
+      _: ProtocolMetaLifecycleEvent;
+      enable: ProtocolMetaLifecycleEvent;
+      disable: ProtocolMetaLifecycleEvent;
+      connect: ProtocolMetaLifecycleEvent;
+    };
+  };
+  notice: {
+    _: ProtocolNoticeEvent;
+    group: {
+      _: ProtocolNoticeGroupEvent;
+      recall: ProtocolNoticeGroupRecallEvent;
+      increase: ProtocolNoticeGroupIncreaseEvent;
+      decrease: ProtocolNoticeGroupDecreaseEvent;
+      admin: {
+        _: ProtocolNoticeGroupAdminEvent;
+        set: ProtocolNoticeGroupAdminEvent;
+        unset: ProtocolNoticeGroupAdminEvent;
+      };
+      ban: ProtocolNoticeGroupBanEvent;
+      upload: ProtocolNoticeGroupUploadEvent;
+      card: ProtocolNoticeGroupCardEvent;
+      essence: {
+        _: ProtocolNoticeGroupEssenceEvent;
+        add: ProtocolNoticeGroupEssenceEvent;
+        delete: ProtocolNoticeGroupEssenceEvent;
+      };
+      reaction: ProtocolNoticeGroupMessageEmojiLikeEvent;
+    };
+    bot: {
+      _: ProtocolNoticeBotOfflineEvent;
+      offline: ProtocolNoticeBotOfflineEvent;
+    };
+    notify: {
+      _: ProtocolNoticeNotifyEvent;
+      group_name: ProtocolNoticeNotifyGroupNameEvent;
+      group_title: ProtocolNoticeNotifyGroupTitleEvent;
+      poke: ProtocolNoticeNotifyPokeEvent;
+      profile_like: ProtocolNoticeNotifyProfileLikeEvent;
+      input_status: ProtocolNoticeNotifyInputStatusEvent;
+    };
+    friend: {
+      _: ProtocolNoticeFriendEvent;
+      add: ProtocolNoticeFriendAddEvent;
+      recall: ProtocolNoticeFriendRecallEvent;
+    };
+  };
+  request: {
+    _: ProtocolRequestEvent;
+    friend: ProtocolFriendRequestEvent;
+    group: ProtocolGroupRequestEvent;
+  };
+  message: {
+    _: ProtocolMessageEvent;
+    private: {
+      _: ProtocolMessagePrivateEvent;
+      friend: ProtocolMessagePrivateEvent;
+      group: ProtocolMessagePrivateEvent;
+      other: ProtocolMessagePrivateEvent;
+    };
+    group: ProtocolMessageGroupEvent;
+    sent: ProtocolMessageSentEvent;
+  };
+}
+type _GetProtocolEventByName<K extends string, T extends Record<string | number, any>> = K extends `${infer O}.${infer R}` ? _GetProtocolEventByName<R, T[O]> : K extends keyof T ? T[K] extends Record<'_', any> ? T[K]['_'] : T[K] : never;
+type ProtocolEventHandlers = { [T in ProtocolEventNames]: [event: _GetProtocolEventByName<T, ProtocolEventNamePaths>, connection: Connection] };
+type ProtocolEventNames = _GenerateProtocolEventNames<ProtocolEventNamePaths>;
+//#endregion
+//#region src/types/protocol.d.ts
+interface ProtocolRequest<T = any> {
+  action: string;
+  params: T;
+  echo?: string;
+  stream?: 'normal-action' | 'stream-action';
+}
+interface ProtocolStreamDataMessage {
+  type: 'stream';
+  data_type: 'data_chunk';
+  data: string;
+}
+interface ProtocolStreamCompleteMessage<T> {
+  type: 'response';
+  data_type: 'data_complete';
+  data: T;
+}
+interface ProtocolStreamErrorMessage {
+  type: 'error';
+  data_type: 'error';
+}
+type ProtocolStreamMessage<T = any> = ProtocolStreamDataMessage | ProtocolStreamCompleteMessage<T> | ProtocolStreamErrorMessage;
+type ProtocolReplyStream<T = any> = ProtocolReply<ProtocolStreamMessage<T>>;
+type ProtocolReplyStreamResponse<T = any> = ProtocolReplyOk<ProtocolStreamCompleteMessage<T>>;
+type ProtocolReadableStream = ReadableStream<ProtocolStreamDataMessage>;
+interface ProtocolReplyOk<T = any> {
+  status: 'ok';
+  retcode: number;
+  data: T;
+  echo?: string;
+  message: string;
+  wording: string;
+  stream: 'normal-action' | 'stream-action';
+}
+interface ProtocolReplyFailed {
+  status: 'failed';
+  retcode: number;
+  data?: null;
+  message: string;
+  wording: string;
+  echo?: string;
+  stream: 'normal-action' | 'stream-action';
+}
+type ProtocolReply<T = any> = ProtocolReplyOk<T> | ProtocolReplyFailed;
+//#endregion
+//#region src/types/pubsub.d.ts
+interface SubHalf<T extends Record<string, any[]>> {
+  on<const K extends keyof T>(type: K, ...listeners: Array<(...args: T[K]) => void>): Dispose;
+}
+interface OffHalf<T extends Record<string, any> = Record<string, any>> {
+  off: (type: keyof T, ...listeners: Array<(...args: any[]) => any>) => void;
+}
+interface PubHalf<T extends Record<string, any> = Record<string, any>> {
+  emit: <const K extends keyof T>(type: K, ...args: any[]) => void;
+}
+type SubOff<T extends Record<string, any[]> = Record<string, any[]>> = SubHalf<T> & OffHalf<T>;
+type PubSub<T extends Record<string, any[]> = Record<string, any[]>> = PubHalf<T> & SubHalf<T>;
+type PubSubOff<T extends Record<string, any[]> = Record<string, any[]>> = PubSub<T> & OffHalf<T>;
+//#endregion
+//#region src/types/transport.d.ts
+interface TransportEventHandlers {
+  message: (data: any) => void;
+  open: () => void;
+  error: (error: any) => void;
+  close: () => void;
+}
+type ReadyState = 0 | 1 | 2 | 3;
+interface TransportCommon {
+  readonly readyState: ReadyState;
+  send: (data: string | ArrayBuffer) => void;
+  close: () => void;
+}
+interface Transport extends TransportCommon {
+  addEventListener: ((type: 'message', listener: (event: {
+    data: any;
+  }) => void) => void) & ((type: 'open', listener: () => void) => void) & ((type: 'error', listener: (error: any) => void) => void) & ((type: 'close', listener: () => void) => void);
+  removeEventListener: (type: string, listener: (...args: any[]) => any) => void;
+}
+//#endregion
+//#region src/types/connection.d.ts
+interface ConnectionBasicEventHandlers {
+  'connection.connected': [transport: Transport, connection: Connection];
+  'connection.disconnected': [transport: Transport, connection: Connection];
+  'connection.reconnect': [transport: Transport, connection: Connection];
+  'connection.request': [event: ProtocolRequest, connection: Connection];
+  'connection.reply': [event: ProtocolReply, connection: Connection];
+  'connection.event': [event: ProtocolEvent, connection: Connection];
+  'connection.error': [error: any, connection: Connection];
+  'connection.reply.stream': [data: ProtocolReply, connection: Connection];
+}
+type ConnectionEventHandlers = Omit<ConnectionBasicEventHandlers, never>;
+type ConnectionPubSub = PubSubOff<ConnectionEventHandlers>;
+type ConnectionStreamResult<R = any> = [stream: ProtocolReadableStream, result: Promise<ProtocolStreamCompleteMessage<R>>];
+interface Connection extends ConnectionPubSub {
+  readonly transport: Transport;
+  connect: () => Promise<void>;
+  close: () => void;
+  request: (<const P, const R = any>(method: string, args: P, stream?: false) => Promise<R>) & (<const P, const R = any>(method: string, args: P, stream: true) => Promise<ConnectionStreamResult<R>>);
+}
+interface OpenConnectionOptions {
+  transport: (token: string) => MaybePromiseLike<Transport>;
+  token?: string;
+  timeout?: number;
+  reconnect: false | {
+    interval: number;
+    attempts: 'always' | number;
+  };
+}
+type OpenConnection = (options: OpenConnectionOptions) => Connection;
+//#endregion
+export { ProtocolNoticeFriendEvent as $, ProtocolMessageRecordRecvSegment as $t, ProtocolEventCommon as A, ProtocolMessageContactSendSegment as At, ProtocolMessageGroupEvent as B, ProtocolMessageImageSendSegment as Bt, ProtocolReplyStreamResponse as C, ProtocolNoticeNotifyInputStatusEvent as Ct, ProtocolStreamErrorMessage as D, ProtocolRequestEvent as Dt, ProtocolStreamDataMessage as E, ProtocolNoticeNotifyProfileLikeEvent as Et, ProtocolFriendRequestEvent as F, ProtocolMessageFileRecvSegment as Ft, ProtocolMetaEventCommon as G, ProtocolMessageMfaceSendSegment as Gt, ProtocolMessagePrivateEventSubTypes as H, ProtocolMessageJsonSendSegment as Ht, ProtocolGroupRequestEvent as I, ProtocolMessageFileSendSegment as It, ProtocolMetaLifecycleEventSubTypes as J, ProtocolMessageMusicSendSegment as Jt, ProtocolMetaHeartbeatEvent as K, ProtocolMessageMiniAppSegment as Kt, ProtocolMessageEmojiLike as L, ProtocolMessageFlashTransferSegment as Lt, ProtocolEventNamePaths as M, ProtocolMessageDiceRecvSegment as Mt, ProtocolEventNames as N, ProtocolMessageDiceSendSegment as Nt, ProtocolStreamMessage as O, ProtocolRequestEventCommon as Ot, ProtocolEventPostTypes as P, ProtocolMessageFaceSegment as Pt, ProtocolNoticeFriendAddEvent as Q, ProtocolMessagePokeSendSegment as Qt, ProtocolMessageEvent as R, ProtocolMessageForwardRecvSegment as Rt, ProtocolReplyStream as S, ProtocolNoticeNotifyGroupTitleEvent as St, ProtocolStreamCompleteMessage as T, ProtocolNoticeNotifyPokeEventCommon as Tt, ProtocolMessageSentEvent as U, ProtocolMessageLocationSegment as Ut, ProtocolMessagePrivateEvent as V, ProtocolMessageJsonRecvSegment as Vt, ProtocolMetaEvent as W, ProtocolMessageMarkdownSegment as Wt, ProtocolNoticeEvent as X, ProtocolMessageOnlineFileSegment as Xt, ProtocolNoticeBotOfflineEvent as Y, ProtocolMessageNode as Yt, ProtocolNoticeEventCommon as Z, ProtocolMessagePokeRecvSegment as Zt, SubOff as _, ProtocolNoticeGroupUploadFile as _t, ConnectionStreamResult as a, ProtocolMessageRpsSendSegment as an, ProtocolNoticeGroupCardEvent as at, ProtocolReplyFailed as b, ProtocolNoticeNotifyGroupNameEvent as bt, ReadyState as c, ProtocolMessageTextSegment as cn, ProtocolNoticeGroupEssenceEvent as ct, TransportEventHandlers as d, ProtocolMessageXmlSegment as dn, ProtocolNoticeGroupEventCommon as dt, ProtocolMessageRecordSendSegment as en, ProtocolNoticeFriendRecallEvent as et, OffHalf as f, Dispose as fn, ProtocolNoticeGroupIncreaseEvent as ft, SubHalf as g, ProtocolNoticeGroupUploadEvent as gt, PubSubOff as h, ProtocolNoticeGroupRecallEvent as ht, ConnectionPubSub as i, ProtocolMessageRpsRecvSegment as in, ProtocolNoticeGroupBanEventSubTypes as it, ProtocolEventHandlers as j, ProtocolMessageContentNode as jt, ProtocolEvent as k, ProtocolMessageAtSegment as kt, Transport as l, ProtocolMessageVideoRecvSegment as ln, ProtocolNoticeGroupEssenceEventSubTypes as lt, PubSub as m, MaybePromiseLike as mn, ProtocolNoticeGroupMessageEmojiLikeEvent as mt, ConnectionBasicEventHandlers as n, ProtocolMessageRefNode as nn, ProtocolNoticeGroupAdminEventSubTypes as nt, OpenConnection as o, ProtocolMessageSegment as on, ProtocolNoticeGroupDecreaseEvent as ot, PubHalf as p, MaybeArray as pn, ProtocolNoticeGroupIncreaseEventSubTypes as pt, ProtocolMetaLifecycleEvent as q, ProtocolMessageMusicRecvSegment as qt, ConnectionEventHandlers as r, ProtocolMessageReplySegment as rn, ProtocolNoticeGroupBanEvent as rt, OpenConnectionOptions as s, ProtocolMessageSendSegment as sn, ProtocolNoticeGroupDecreaseEventSubTypes as st, Connection as t, ProtocolMessageRecvSegment as tn, ProtocolNoticeGroupAdminEvent as tt, TransportCommon as u, ProtocolMessageVideoSendSegment as un, ProtocolNoticeGroupEvent as ut, ProtocolReadableStream as v, ProtocolNoticeNotifyEvent as vt, ProtocolRequest as w, ProtocolNoticeNotifyPokeEvent as wt, ProtocolReplyOk as x, ProtocolNoticeNotifyGroupPokeEvent as xt, ProtocolReply as y, ProtocolNoticeNotifyFriendPokeEvent as yt, ProtocolMessageEventCommon as z, ProtocolMessageImageRecvSegment as zt };
+//# sourceMappingURL=connection-CBr_CAbl.d.mts.map