refactor: ntqqapi types

src/ntqqapi/types/cache.ts

@@ -0,0 +1,65 @@
+import {ChatType} from "./msg";
+
+export interface CacheScanResult {
+    result: number,
+    size: [ // 单位为字节
+        string, // 系统总存储空间
+        string, // 系统可用存储空间
+        string, // 系统已用存储空间
+        string, // QQ总大小
+        string, // 「聊天与文件」大小
+        string, // 未知
+        string, // 「缓存数据」大小
+        string, // 「其他数据」大小
+        string, // 未知
+    ]
+}
+
+export interface ChatCacheList {
+    pageCount: number,
+    infos: ChatCacheListItem[]
+}
+
+export interface ChatCacheListItem {
+    chatType: ChatType,
+    basicChatCacheInfo: ChatCacheListItemBasic,
+    guildChatCacheInfo: unknown[] // TODO: 没用过频道所以不知道这里边的详细内容
+}
+
+export interface ChatCacheListItemBasic {
+    chatSize: string,
+    chatTime: string,
+    uid: string,
+    uin: string,
+    remarkName: string,
+    nickName: string,
+    chatType?: ChatType,
+    isChecked?: boolean
+}
+
+export enum CacheFileType {
+    IMAGE = 0,
+    VIDEO = 1,
+    AUDIO = 2,
+    DOCUMENT = 3,
+    OTHER = 4,
+}
+
+export interface CacheFileList {
+    infos: CacheFileListItem[],
+}
+
+export interface CacheFileListItem {
+    fileSize: string,
+    fileTime: string,
+    fileKey: string,
+    elementId: string,
+    elementIdStr: string,
+    fileType: CacheFileType,
+    path: string,
+    fileName: string,
+    senderId: string,
+    previewPath: string,
+    senderName: string,
+    isChecked?: boolean,
+}

src/ntqqapi/types/group.ts

@@ -0,0 +1,55 @@
+import {QQLevel, Sex} from "./user";
+
+export interface Group {
+    groupCode: string,
+    maxMember: number,
+    memberCount: number,
+    groupName: string,
+    groupStatus: 0,
+    memberRole: 2,
+    isTop: boolean,
+    toppedTimestamp: "0",
+    privilegeFlag: number, //65760
+    isConf: boolean,
+    hasModifyConfGroupFace: boolean,
+    hasModifyConfGroupName: boolean,
+    remarkName: string,
+    hasMemo: boolean,
+    groupShutupExpireTime: string, //"0",
+    personShutupExpireTime: string, //"0",
+    discussToGroupUin: string, //"0",
+    discussToGroupMaxMsgSeq: number,
+    discussToGroupTime: number,
+    groupFlagExt: number, //1073938496,
+    authGroupType: number, //0,
+    groupCreditLevel: number, //0,
+    groupFlagExt3: number, //0,
+    groupOwnerId: {
+        "memberUin": string, //"0",
+        "memberUid": string, //"u_fbf8N7aeuZEnUiJAbQ9R8Q"
+    },
+    members: GroupMember[]  // 原始数据是没有这个的，为了方便自己加了这个字段
+}
+
+export enum GroupMemberRole {
+    normal = 2,
+    admin = 3,
+    owner = 4
+}
+
+export interface GroupMember {
+    avatarPath: string;
+    cardName: string;
+    cardType: number;
+    isDelete: boolean;
+    nick: string;
+    qid: string;
+    remark: string;
+    role: GroupMemberRole; // 群主:4, 管理员:3，群员:2
+    shutUpTime: number; // 禁言时间，单位是什么暂时不清楚
+    uid: string; // 加密的字符串
+    uin: string; // QQ号
+    isRobot: boolean;
+    sex?: Sex
+    qqLevel?: QQLevel
+}

src/ntqqapi/types/index.ts

@@ -0,0 +1,7 @@
+
+export * from './user';
+export * from './group';
+export * from './msg';
+export * from './notify';
+export * from './cache';
+

src/ntqqapi/types/msg.ts

@@ -0,0 +1,320 @@
+import {GroupMemberRole} from "./group";
+
+export enum ElementType {
+    TEXT = 1,
+    PIC = 2,
+    FILE = 3,
+    PTT = 4,
+    VIDEO = 5,
+    FACE = 6,
+    REPLY = 7,
+    ARK = 10,
+}
+
+export interface SendTextElement {
+    elementType: ElementType.TEXT,
+    elementId: "",
+    textElement: {
+        content: string,
+        atType: number,
+        atUid: string,
+        atTinyId: string,
+        atNtUid: string,
+    }
+}
+
+export interface SendPttElement {
+    elementType: ElementType.PTT,
+    elementId: "",
+    pttElement: {
+        fileName: string,
+        filePath: string,
+        md5HexStr: string,
+        fileSize: number,
+        duration: number,  // 单位是秒
+        formatType: number,
+        voiceType: number,
+        voiceChangeType: number,
+        canConvert2Text: boolean,
+        waveAmplitudes: number[],
+        fileSubId: "",
+        playState: number,
+        autoConvertText: number,
+    }
+}
+
+export enum PicType {
+    gif = 2000,
+    jpg = 1000
+}
+
+export interface SendPicElement {
+    elementType: ElementType.PIC,
+    elementId: "",
+    picElement: {
+        md5HexStr: string,
+        fileSize: number,
+        picWidth: number,
+        picHeight: number,
+        fileName: string,
+        sourcePath: string,
+        original: boolean,
+        picType: PicType,
+        picSubType: number,
+        fileUuid: string,
+        fileSubId: string,
+        thumbFileSize: number,
+        summary: string,
+    }
+}
+
+export interface SendReplyElement {
+    elementType: ElementType.REPLY,
+    elementId: "",
+    replyElement: {
+        replayMsgSeq: string,
+        replayMsgId: string,
+        senderUin: string,
+        senderUinStr: string,
+    }
+}
+
+export interface SendFaceElement {
+    elementType: ElementType.FACE,
+    elementId: "",
+    faceElement: FaceElement
+}
+
+export interface FileElement {
+    "fileMd5"?: "",
+    "fileName": string,
+    "filePath": string,
+    "fileSize": string,
+    "picHeight"?: number,
+    "picWidth"?: number,
+    "picThumbPath"?: {},
+    "file10MMd5"?: "",
+    "fileSha"?: "",
+    "fileSha3"?: "",
+    "fileUuid"?: "",
+    "fileSubId"?: "",
+    "thumbFileSize"?: number
+}
+
+export interface SendFileElement {
+    elementType: ElementType.FILE
+    elementId: "",
+    fileElement: FileElement
+}
+
+export interface SendVideoElement {
+    elementType: ElementType.VIDEO
+    elementId: "",
+    videoElement: VideoElement
+}
+
+export interface SendArkElement {
+    elementType: ElementType.ARK,
+    elementId: "",
+    arkElement: ArkElement
+
+}
+
+export type SendMessageElement = SendTextElement | SendPttElement |
+    SendPicElement | SendReplyElement | SendFaceElement | SendFileElement | SendVideoElement | SendArkElement
+
+export enum AtType {
+    notAt = 0,
+    atAll = 1,
+    atUser = 2
+}
+
+export enum ChatType {
+    friend = 1,
+    group = 2,
+    temp = 100
+}
+
+export interface PttElement {
+    canConvert2Text: boolean;
+    duration: number; // 秒数
+    fileBizId: null;
+    fileId: number; // 0
+    fileName: string; // "e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
+    filePath: string; // "/Users//Library/Containers/com.tencent.qq/Data/Library/Application Support/QQ/nt_qq_a6b15c9820595d25a56c1633ce19ad40/nt_data/Ptt/2023-11/Ori/e4d09c784d5a2abcb2f9980bdc7acfe6.amr"
+    fileSize: string; // "4261"
+    fileSubId: string; // "0"
+    fileUuid: string; // "90j3z7rmRphDPrdVgP9udFBaYar#oK0TWZIV"
+    formatType: string; // 1
+    invalidState: number; // 0
+    md5HexStr: string; // "e4d09c784d5a2abcb2f9980bdc7acfe6"
+    playState: number; // 0
+    progress: number; // 0
+    text: string; // ""
+    transferStatus: number; // 0
+    translateStatus: number; // 0
+    voiceChangeType: number; // 0
+    voiceType: number; // 0
+    waveAmplitudes: number[];
+}
+
+export interface ArkElement {
+    bytesData: string;
+    linkInfo: null,
+    subElementType: null
+}
+
+export const IMAGE_HTTP_HOST = "https://gchat.qpic.cn"
+
+export interface PicElement {
+    originImageUrl: string;  // http url, 没有host，host是https://gchat.qpic.cn/
+    sourcePath: string; // 图片本地路径
+    thumbPath: Map<number, string>;
+    picWidth: number;
+    picHeight: number;
+    fileSize: number;
+    fileName: string;
+    fileUuid: string;
+    md5HexStr?: string;
+}
+
+export enum GrayTipElementSubType {
+    INVITE_NEW_MEMBER = 12,
+}
+
+export interface GrayTipElement {
+    subElementType: GrayTipElementSubType;
+    revokeElement: {
+        operatorRole: string;
+        operatorUid: string;
+        operatorNick: string;
+        operatorRemark: string;
+        operatorMemRemark?: string;
+        wording: string;  // 自定义的撤回提示语
+    }
+    aioOpGrayTipElement: TipAioOpGrayTipElement,
+    groupElement: TipGroupElement,
+    xmlElement: {
+        content: string;
+    }
+}
+
+export interface FaceElement {
+    faceIndex: number,
+    faceType: 1
+}
+
+export interface VideoElement {
+    "filePath": string,
+    "fileName": string,
+    "videoMd5"?: string,
+    "thumbMd5"?: string
+    "fileTime"?: number, // second
+    "thumbSize"?: number, // byte
+    "fileFormat"?: number,  // 2表示mp4？
+    "fileSize"?: string,  // byte
+    "thumbWidth"?: number,
+    "thumbHeight"?: number,
+    "busiType"?: 0, // 未知
+    "subBusiType"?: 0, // 未知
+    "thumbPath"?: Map<number, any>,
+    "transferStatus"?: 0, // 未知
+    "progress"?: 0,  // 下载进度？
+    "invalidState"?: 0, // 未知
+    "fileUuid"?: string,  // 可以用于下载链接？
+    "fileSubId"?: "",
+    "fileBizId"?: null,
+    "originVideoMd5"?: "",
+    "import_rich_media_context"?: null,
+    "sourceVideoCodecFormat"?: number
+}
+
+export interface TipAioOpGrayTipElement {  // 这是什么提示来着？
+    operateType: number,
+    peerUid: string,
+    fromGrpCodeOfTmpChat: string,
+}
+
+export enum TipGroupElementType {
+    memberIncrease = 1,
+    ban = 8
+}
+
+export interface TipGroupElement {
+    "type": TipGroupElementType,  // 1是表示有人加入群, 自己加入群也会收到这个
+    "role": 0,  // 暂时不知
+    "groupName": string,  // 暂时获取不到
+    "memberUid": string,
+    "memberNick": string,
+    "memberRemark": string,
+    "adminUid": string,  // 同意加群的管理员uid
+    "adminNick": string,
+    "adminRemark": string,
+    "createGroup": null,
+    "memberAdd"?: {
+        "showType": 1,
+        "otherAdd": null,
+        "otherAddByOtherQRCode": null,
+        "otherAddByYourQRCode": null,
+        "youAddByOtherQRCode": null,
+        "otherInviteOther": null,
+        "otherInviteYou": null,
+        "youInviteOther": null
+    },
+    "shutUp"?: {
+        "curTime": string,
+        "duration": string,  // 禁言时间，秒
+        "admin": {
+            "uid": string,
+            "card": string,
+            "name": string,
+            "role": GroupMemberRole
+        },
+        "member": {
+            "uid": string
+            "card": string,
+            "name": string,
+            "role": GroupMemberRole
+        }
+    }
+}
+
+
+export interface RawMessage {
+    msgId: string;
+    msgShortId?: number;  // 自己维护的消息id
+    msgTime: string; // 时间戳，秒
+    msgSeq: string;
+    senderUid: string;
+    senderUin?: string; // 发送者QQ号
+    peerUid: string; // 群号 或者 QQ uid
+    peerUin: string; // 群号 或者 发送者QQ号
+    sendNickName: string;
+    sendMemberName?: string; // 发送者群名片
+    chatType: ChatType;
+    sendStatus?: number;  // 消息状态，别人发的2是已撤回，自己发的2是已发送
+    recallTime: string; // 撤回时间, "0"是没有撤回
+    elements: {
+        elementId: string,
+        elementType: ElementType;
+        replyElement: {
+            senderUid: string; // 原消息发送者QQ号
+            sourceMsgIsIncPic: boolean; // 原消息是否有图片
+            sourceMsgText: string;
+            replayMsgSeq: string; // 源消息的msgSeq，可以通过这个找到源消息的msgId
+        };
+        textElement: {
+            atType: AtType;
+            atUid: string; // QQ号
+            content: string;
+            atNtUid: string; // uid号
+        };
+        picElement: PicElement;
+        pttElement: PttElement;
+        arkElement: ArkElement;
+        grayTipElement: GrayTipElement;
+        faceElement: FaceElement;
+        videoElement: VideoElement;
+        fileElement: FileElement;
+    }[];
+}

src/ntqqapi/types/notify.ts

@@ -0,0 +1,64 @@
+
+export enum GroupNotifyTypes {
+    INVITE_ME = 1,
+    INVITED_JOIN = 4,  // 有人接受了邀请入群
+    JOIN_REQUEST = 7,
+    ADMIN_SET = 8,
+    ADMIN_UNSET = 12,
+    MEMBER_EXIT = 11, // 主动退出?
+
+}
+
+export interface GroupNotifies {
+    doubt: boolean,
+    nextStartSeq: string,
+    notifies: GroupNotify[],
+}
+
+export enum GroupNotifyStatus {
+    IGNORE = 0,
+    WAIT_HANDLE = 1,
+    APPROVE = 2,
+    REJECT = 3
+}
+
+export interface GroupNotify {
+    time: number;  // 自己添加的字段，时间戳，毫秒, 用于判断收到短时间内收到重复的notify
+    seq: string, // 唯一标识符，转成数字再除以1000应该就是时间戳？
+    type: GroupNotifyTypes,
+    status: GroupNotifyStatus,  // 0是已忽略？，1是未处理，2是已同意
+    group: { groupCode: string, groupName: string },
+    user1: { uid: string, nickName: string }, // 被设置管理员的人
+    user2: { uid: string, nickName: string },  // 操作者
+    actionUser: { uid: string, nickName: string }, //未知
+    actionTime: string,
+    invitationExt: {
+        srcType: number,  // 0?未知
+        groupCode: string, waitStatus: number
+    },
+    postscript: string,  // 加群用户填写的验证信息
+    repeatSeqs: [],
+    warningTips: string
+}
+
+export enum GroupRequestOperateTypes {
+    approve = 1,
+    reject = 2
+}
+
+export interface FriendRequest {
+    friendUid: string,
+    reqTime: string,  // 时间戳,秒
+    extWords: string,  // 申请人填写的验证消息
+    isUnread: boolean,
+    friendNick: string,
+    sourceId: number,
+    groupCode: string
+}
+
+export interface FriendRequestNotify {
+    data: {
+        unreadNums: number,
+        buddyReqs: FriendRequest[]
+    }
+}

src/ntqqapi/types/user.ts

@@ -0,0 +1,28 @@
+export enum Sex {
+    male = 0,
+    female = 2,
+    unknown = 255,
+}
+
+export interface QQLevel {
+    "crownNum": number,
+    "sunNum": number,
+    "moonNum": number,
+    "starNum": number
+}
+export interface User {
+    uid: string; // 加密的字符串
+    uin: string; // QQ号
+    nick: string;
+    avatarUrl?: string;
+    longNick?: string; // 签名
+    remark?: string;
+    sex?: Sex;
+    "qqLevel"?: QQLevel
+}
+
+export interface SelfInfo extends User {
+    online?: boolean;
+}
+
+export interface Friend extends User {}