weflow-cli 1.5.0

package/dist/src/core/wcdbCore.d.ts

@@ -0,0 +1,738 @@
+export declare function getLastDllInitError(): string | null;
+export declare class WcdbCore {
+    private resourcesPath;
+    private userDataPath;
+    private logEnabled;
+    private lib;
+    private koffi;
+    private initialized;
+    private handle;
+    private currentPath;
+    private currentKey;
+    private currentWxid;
+    private currentDbStoragePath;
+    private wcdbInitProtection;
+    private wcdbInit;
+    private wcdbShutdown;
+    private wcdbOpenAccount;
+    private wcdbCloseAccount;
+    private wcdbSetMyWxid;
+    private wcdbFreeString;
+    private wcdbUpdateMessage;
+    private wcdbDeleteMessage;
+    private wcdbGetSessions;
+    private wcdbGetMessages;
+    private wcdbGetMessageCount;
+    private wcdbGetDisplayNames;
+    private wcdbGetAvatarUrls;
+    private wcdbGetGroupMemberCount;
+    private wcdbGetGroupMemberCounts;
+    private wcdbGetGroupMembers;
+    private wcdbGetGroupNicknames;
+    private wcdbGetMessageTables;
+    private wcdbGetMessageMeta;
+    private wcdbGetContact;
+    private wcdbGetContactStatus;
+    private wcdbGetContactTypeCounts;
+    private wcdbGetContactsCompact;
+    private wcdbGetContactAliasMap;
+    private wcdbGetContactFriendFlags;
+    private wcdbGetChatRoomExtBuffer;
+    private wcdbGetMessageTableStats;
+    private wcdbGetAggregateStats;
+    private wcdbGetAvailableYears;
+    private wcdbGetAnnualReportStats;
+    private wcdbGetAnnualReportExtras;
+    private wcdbGetDualReportStats;
+    private wcdbGetGroupStats;
+    private wcdbGetMyFootprintStats;
+    private wcdbGetMessageDates;
+    private wcdbOpenMessageCursor;
+    private wcdbOpenMessageCursorLite;
+    private wcdbFetchMessageBatch;
+    private wcdbCloseMessageCursor;
+    private wcdbGetLogs;
+    private wcdbExecQuery;
+    private wcdbListMessageDbs;
+    private wcdbListMediaDbs;
+    private wcdbGetMessageById;
+    private wcdbGetEmoticonCdnUrl;
+    private wcdbGetEmoticonCaption;
+    private wcdbGetEmoticonCaptionStrict;
+    private wcdbGetDbStatus;
+    private wcdbGetVoiceData;
+    private wcdbGetVoiceDataBatch;
+    private wcdbGetMediaSchemaSummary;
+    private wcdbGetSessionMessageCounts;
+    private wcdbGetSessionMessageTypeStats;
+    private wcdbGetSessionMessageTypeStatsBatch;
+    private wcdbGetSessionMessageDateCounts;
+    private wcdbGetSessionMessageDateCountsBatch;
+    private wcdbGetMessagesByType;
+    private wcdbScanMediaStream;
+    private wcdbGetHeadImageBuffers;
+    private wcdbSearchMessages;
+    private wcdbGetSnsTimeline;
+    private wcdbGetSnsAnnualStats;
+    private wcdbGetSnsUsernames;
+    private wcdbGetSnsExportStats;
+    private wcdbGetMessageTableColumns;
+    private wcdbListTables;
+    private wcdbGetTableSchema;
+    private wcdbExportTableSnapshot;
+    private wcdbImportTableSnapshot;
+    private wcdbImportTableSnapshotWithSchema;
+    private wcdbGetMessageTableTimeRange;
+    private wcdbResolveImageHardlink;
+    private wcdbResolveImageHardlinkBatch;
+    private wcdbResolveVideoHardlinkMd5;
+    private wcdbResolveVideoHardlinkMd5Batch;
+    private wcdbInstallMessageAntiRevokeTrigger;
+    private wcdbUninstallMessageAntiRevokeTrigger;
+    private wcdbCheckMessageAntiRevokeTrigger;
+    private wcdbInstallSnsBlockDeleteTrigger;
+    private wcdbUninstallSnsBlockDeleteTrigger;
+    private wcdbCheckSnsBlockDeleteTrigger;
+    private wcdbDeleteSnsPost;
+    private wcdbVerifyUser;
+    private wcdbStartMonitorPipe;
+    private wcdbStopMonitorPipe;
+    private wcdbGetMonitorPipeName;
+    private wcdbCloudInit;
+    private wcdbCloudReport;
+    private wcdbCloudStop;
+    private monitorPipeClient;
+    private monitorCallback;
+    private monitorReconnectTimer;
+    private monitorPipePath;
+    private avatarUrlCache;
+    private readonly avatarCacheTtlMs;
+    private imageHardlinkCache;
+    private videoHardlinkCache;
+    private readonly hardlinkCacheTtlMs;
+    private readonly hardlinkCacheMaxEntries;
+    private mediaStreamSessionCache;
+    private mediaStreamSessionCacheAt;
+    private readonly mediaStreamSessionCacheTtlMs;
+    private logTimer;
+    private lastLogTail;
+    private lastResolvedLogPath;
+    private lastCursorForceReopenAt;
+    private readonly cursorForceReopenCooldownMs;
+    setPaths(resourcesPath: string, userDataPath: string): void;
+    getLastInitError(): string | null;
+    setLogEnabled(enabled: boolean): void;
+    startMonitor(callback: (type: string, json: string) => void): boolean;
+    private connectMonitorPipe;
+    private scheduleReconnect;
+    stopMonitor(): void;
+    setMonitor(callback: (type: string, json: string) => void): boolean;
+    /**
+     * 获取库文件路径（跨平台）
+     */
+    private getDllPath;
+    private formatInitProtectionError;
+    private isLogEnabled;
+    private writeLog;
+    private formatSqlForLog;
+    private dumpDbStatus;
+    private runPostOpenDiagnostics;
+    /**
+     * 递归查找 session.db 文件
+     */
+    private findSessionDb;
+    private resolveDbStoragePath;
+    private findDbStorageRecursive;
+    private isRealDbFileName;
+    private resolveContactDbPath;
+    private pickFirstStringField;
+    private escapeSqlString;
+    private buildContactSelectSql;
+    private deriveContactTypeCounts;
+    /**
+     * 初始化 WCDB
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * 测试数据库连接
+     */
+    testConnection(dbPath: string, hexKey: string, wxid: string): Promise<{
+        success: boolean;
+        error?: string;
+        sessionCount?: number;
+    }>;
+    /**
+     * 打印数据服务内部日志（仅在出错时调用）
+     */
+    private printLogs;
+    private startLogPolling;
+    private stopLogPolling;
+    private pollLogs;
+    private decodeJsonPtr;
+    private parseMessageJson;
+    private ensureReady;
+    private normalizeTimestamp;
+    private normalizeRange;
+    private makeHardlinkCacheKey;
+    private readHardlinkCache;
+    private writeHardlinkCache;
+    private cloneHardlinkResult;
+    private clearHardlinkCaches;
+    private clearMediaStreamSessionCache;
+    isReady(): boolean;
+    /**
+     * 打开数据库
+     */
+    open(dbPath: string, hexKey: string, wxid: string): Promise<boolean>;
+    /**
+     * 关闭数据库
+     * 注意：wcdb_close_account 可能导致崩溃，使用 shutdown 代替
+     */
+    close(): void;
+    /**
+     * 关闭服务（与 close 相同）
+     */
+    shutdown(): void;
+    /**
+     * 检查是否已连接
+     */
+    isConnected(): boolean;
+    getSessions(): Promise<{
+        success: boolean;
+        sessions?: any[];
+        error?: string;
+    }>;
+    getMessages(sessionId: string, limit: number, offset: number): Promise<{
+        success: boolean;
+        messages?: any[];
+        error?: string;
+    }>;
+    /**
+     * 获取指定时间之后的新消息
+     */
+    getNewMessages(sessionId: string, minTime: number, limit?: number): Promise<{
+        success: boolean;
+        messages?: any[];
+        error?: string;
+    }>;
+    getMessageCount(sessionId: string): Promise<{
+        success: boolean;
+        count?: number;
+        error?: string;
+    }>;
+    getMessageCounts(sessionIds: string[]): Promise<{
+        success: boolean;
+        counts?: Record<string, number>;
+        error?: string;
+    }>;
+    getSessionMessageCounts(sessionIds: string[]): Promise<{
+        success: boolean;
+        counts?: Record<string, number>;
+        error?: string;
+    }>;
+    getSessionMessageTypeStats(sessionId: string, beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getSessionMessageTypeStatsBatch(sessionIds: string[], options?: {
+        beginTimestamp?: number;
+        endTimestamp?: number;
+        quickMode?: boolean;
+        includeGroupSenderCount?: boolean;
+    }): Promise<{
+        success: boolean;
+        data?: Record<string, any>;
+        error?: string;
+    }>;
+    getSessionMessageDateCounts(sessionId: string): Promise<{
+        success: boolean;
+        counts?: Record<string, number>;
+        error?: string;
+    }>;
+    getSessionMessageDateCountsBatch(sessionIds: string[]): Promise<{
+        success: boolean;
+        data?: Record<string, Record<string, number>>;
+        error?: string;
+    }>;
+    getMessagesByType(sessionId: string, localType: number, ascending?: boolean, limit?: number, offset?: number): Promise<{
+        success: boolean;
+        rows?: any[];
+        error?: string;
+    }>;
+    getMediaStream(options?: {
+        sessionId?: string;
+        mediaType?: 'image' | 'video' | 'all';
+        beginTimestamp?: number;
+        endTimestamp?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        success: boolean;
+        items?: Array<{
+            sessionId: string;
+            sessionDisplayName?: string;
+            mediaType: 'image' | 'video';
+            localId: number;
+            serverId?: string;
+            createTime: number;
+            localType: number;
+            senderUsername?: string;
+            isSend?: number | null;
+            imageMd5?: string;
+            imageDatName?: string;
+            videoMd5?: string;
+            content?: string;
+        }>;
+        hasMore?: boolean;
+        nextOffset?: number;
+        error?: string;
+    }>;
+    getDisplayNames(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, string>;
+        error?: string;
+    }>;
+    getAvatarUrls(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, string>;
+        error?: string;
+    }>;
+    getGroupMemberCount(chatroomId: string): Promise<{
+        success: boolean;
+        count?: number;
+        error?: string;
+    }>;
+    getGroupMemberCounts(chatroomIds: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, number>;
+        error?: string;
+    }>;
+    getGroupMembers(chatroomId: string): Promise<{
+        success: boolean;
+        members?: any[];
+        error?: string;
+    }>;
+    getGroupNicknames(chatroomId: string): Promise<{
+        success: boolean;
+        nicknames?: Record<string, string>;
+        error?: string;
+    }>;
+    getMessageTables(sessionId: string): Promise<{
+        success: boolean;
+        tables?: any[];
+        error?: string;
+    }>;
+    getMessageDates(sessionId: string): Promise<{
+        success: boolean;
+        dates?: string[];
+        error?: string;
+    }>;
+    getMessageTableStats(sessionId: string): Promise<{
+        success: boolean;
+        tables?: any[];
+        error?: string;
+    }>;
+    getMessageMeta(dbPath: string, tableName: string, limit: number, offset: number): Promise<{
+        success: boolean;
+        rows?: any[];
+        error?: string;
+    }>;
+    getContact(username: string): Promise<{
+        success: boolean;
+        contact?: any;
+        error?: string;
+    }>;
+    getContactStatus(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, {
+            isFolded: boolean;
+            isMuted: boolean;
+        }>;
+        error?: string;
+    }>;
+    getMessageTableColumns(dbPath: string, tableName: string): Promise<{
+        success: boolean;
+        columns?: string[];
+        error?: string;
+    }>;
+    listTables(kind: string, dbPath?: string): Promise<{
+        success: boolean;
+        tables?: string[];
+        error?: string;
+    }>;
+    getTableSchema(kind: string, dbPath: string, tableName: string): Promise<{
+        success: boolean;
+        schema?: string;
+        error?: string;
+    }>;
+    exportTableSnapshot(kind: string, dbPath: string, tableName: string, outputPath: string): Promise<{
+        success: boolean;
+        rows?: number;
+        columns?: number;
+        error?: string;
+    }>;
+    importTableSnapshot(kind: string, dbPath: string, tableName: string, inputPath: string): Promise<{
+        success: boolean;
+        rows?: number;
+        inserted?: number;
+        ignored?: number;
+        malformed?: number;
+        columns?: number;
+        error?: string;
+    }>;
+    importTableSnapshotWithSchema(kind: string, dbPath: string, tableName: string, inputPath: string, createTableSql: string): Promise<{
+        success: boolean;
+        rows?: number;
+        inserted?: number;
+        ignored?: number;
+        malformed?: number;
+        columns?: number;
+        error?: string;
+    }>;
+    getMessageTableTimeRange(dbPath: string, tableName: string): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getContactTypeCounts(): Promise<{
+        success: boolean;
+        counts?: {
+            private: number;
+            group: number;
+            official: number;
+            former_friend: number;
+        };
+        error?: string;
+    }>;
+    getContactsCompact(usernames?: string[]): Promise<{
+        success: boolean;
+        contacts?: any[];
+        error?: string;
+    }>;
+    getContactAliasMap(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, string>;
+        error?: string;
+    }>;
+    getContactFriendFlags(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, boolean>;
+        error?: string;
+    }>;
+    getChatRoomExtBuffer(chatroomId: string): Promise<{
+        success: boolean;
+        extBuffer?: string;
+        error?: string;
+    }>;
+    getAggregateStats(sessionIds: string[], beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getAvailableYears(sessionIds: string[]): Promise<{
+        success: boolean;
+        data?: number[];
+        error?: string;
+    }>;
+    getAnnualReportStats(sessionIds: string[], beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getAnnualReportExtras(sessionIds: string[], beginTimestamp?: number, endTimestamp?: number, peakDayBegin?: number, peakDayEnd?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getGroupStats(chatroomId: string, beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getMyFootprintStats(options: {
+        beginTimestamp?: number;
+        endTimestamp?: number;
+        myWxid?: string;
+        privateSessionIds?: string[];
+        groupSessionIds?: string[];
+        mentionLimit?: number;
+        privateLimit?: number;
+        mentionMode?: 'text_at_me' | string;
+    }): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    /**
+     * 强制重新打开账号连接（绕过路径缓存），用于微信重装后消息数据库刷新失败时的自动恢复。
+     * 返回重新打开是否成功。
+     */
+    private forceReopen;
+    private shouldRetryCursorAfterNoDb;
+    openMessageCursor(sessionId: string, batchSize: number, ascending: boolean, beginTimestamp: number, endTimestamp: number): Promise<{
+        success: boolean;
+        cursor?: number;
+        error?: string;
+    }>;
+    openMessageCursorLite(sessionId: string, batchSize: number, ascending: boolean, beginTimestamp: number, endTimestamp: number): Promise<{
+        success: boolean;
+        cursor?: number;
+        error?: string;
+    }>;
+    fetchMessageBatch(cursor: number): Promise<{
+        success: boolean;
+        rows?: any[];
+        hasMore?: boolean;
+        error?: string;
+    }>;
+    closeMessageCursor(cursor: number): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    getLogs(): Promise<{
+        success: boolean;
+        logs?: string[];
+        error?: string;
+    }>;
+    execQuery(kind: string, path: string | null, sql: string, params?: any[]): Promise<{
+        success: boolean;
+        rows?: any[];
+        error?: string;
+    }>;
+    getEmoticonCdnUrl(dbPath: string, md5: string): Promise<{
+        success: boolean;
+        url?: string;
+        error?: string;
+    }>;
+    getEmoticonCaption(dbPath: string, md5: string): Promise<{
+        success: boolean;
+        caption?: string;
+        error?: string;
+    }>;
+    getEmoticonCaptionStrict(md5: string): Promise<{
+        success: boolean;
+        caption?: string;
+        error?: string;
+    }>;
+    listMessageDbs(): Promise<{
+        success: boolean;
+        data?: string[];
+        error?: string;
+    }>;
+    listMediaDbs(): Promise<{
+        success: boolean;
+        data?: string[];
+        error?: string;
+    }>;
+    getMessageById(sessionId: string, localId: number): Promise<{
+        success: boolean;
+        message?: any;
+        error?: string;
+    }>;
+    getVoiceData(sessionId: string, createTime: number, candidates: string[], localId?: number, svrId?: string | number): Promise<{
+        success: boolean;
+        hex?: string;
+        error?: string;
+    }>;
+    getVoiceDataBatch(requests: Array<{
+        session_id: string;
+        create_time: number;
+        local_id?: number;
+        svr_id?: string | number;
+        candidates?: string[];
+    }>): Promise<{
+        success: boolean;
+        rows?: Array<{
+            index: number;
+            hex?: string;
+        }>;
+        error?: string;
+    }>;
+    getMediaSchemaSummary(dbPath: string): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getHeadImageBuffers(usernames: string[]): Promise<{
+        success: boolean;
+        map?: Record<string, string>;
+        error?: string;
+    }>;
+    resolveImageHardlink(md5: string, accountDir?: string): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    resolveVideoHardlinkMd5(md5: string, dbPath?: string): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    resolveImageHardlinkBatch(requests: Array<{
+        md5: string;
+        accountDir?: string;
+    }>): Promise<{
+        success: boolean;
+        rows?: Array<{
+            index: number;
+            md5: string;
+            success: boolean;
+            data?: any;
+            error?: string;
+        }>;
+        error?: string;
+    }>;
+    resolveVideoHardlinkMd5Batch(requests: Array<{
+        md5: string;
+        dbPath?: string;
+    }>): Promise<{
+        success: boolean;
+        rows?: Array<{
+            index: number;
+            md5: string;
+            success: boolean;
+            data?: any;
+            error?: string;
+        }>;
+        error?: string;
+    }>;
+    /**
+     * 数据收集初始化
+     */
+    cloudInit(intervalSeconds?: number): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    cloudReport(statsJson: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    cloudStop(): {
+        success: boolean;
+        error?: string;
+    };
+    verifyUser(message: string, hwnd?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    searchMessages(keyword: string, sessionId?: string, limit?: number, offset?: number, beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        messages?: any[];
+        error?: string;
+    }>;
+    getSnsTimeline(limit: number, offset: number, usernames?: string[], keyword?: string, startTime?: number, endTime?: number): Promise<{
+        success: boolean;
+        timeline?: any[];
+        error?: string;
+    }>;
+    getSnsAnnualStats(beginTimestamp: number, endTimestamp: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    getSnsUsernames(): Promise<{
+        success: boolean;
+        usernames?: string[];
+        error?: string;
+    }>;
+    getSnsExportStats(myWxid?: string): Promise<{
+        success: boolean;
+        data?: {
+            totalPosts: number;
+            totalFriends: number;
+            myPosts: number | null;
+        };
+        error?: string;
+    }>;
+    installMessageAntiRevokeTrigger(sessionId: string): Promise<{
+        success: boolean;
+        alreadyInstalled?: boolean;
+        error?: string;
+    }>;
+    uninstallMessageAntiRevokeTrigger(sessionId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    checkMessageAntiRevokeTrigger(sessionId: string): Promise<{
+        success: boolean;
+        installed?: boolean;
+        error?: string;
+    }>;
+    checkMessageAntiRevokeTriggers(sessionIds: string[]): Promise<{
+        success: boolean;
+        rows?: Array<{
+            sessionId: string;
+            success: boolean;
+            installed?: boolean;
+            error?: string;
+        }>;
+        error?: string;
+    }>;
+    installMessageAntiRevokeTriggers(sessionIds: string[]): Promise<{
+        success: boolean;
+        rows?: Array<{
+            sessionId: string;
+            success: boolean;
+            alreadyInstalled?: boolean;
+            error?: string;
+        }>;
+        error?: string;
+    }>;
+    uninstallMessageAntiRevokeTriggers(sessionIds: string[]): Promise<{
+        success: boolean;
+        rows?: Array<{
+            sessionId: string;
+            success: boolean;
+            error?: string;
+        }>;
+        error?: string;
+    }>;
+    /**
+     * 为朋友圈安装删除
+     */
+    installSnsBlockDeleteTrigger(): Promise<{
+        success: boolean;
+        alreadyInstalled?: boolean;
+        error?: string;
+    }>;
+    /**
+     * 关闭朋友圈删除拦截
+     */
+    uninstallSnsBlockDeleteTrigger(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 查询朋友圈删除拦截是否已安装
+     */
+    checkSnsBlockDeleteTrigger(): Promise<{
+        success: boolean;
+        installed?: boolean;
+        error?: string;
+    }>;
+    deleteSnsPost(postId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    getDualReportStats(sessionId: string, beginTimestamp?: number, endTimestamp?: number): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    /**
+     * 修改消息内容
+     */
+    updateMessage(sessionId: string, localId: number, createTime: number, newContent: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 删除消息
+     */
+    deleteMessage(sessionId: string, localId: number, createTime: number, dbPathHint?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=wcdbCore.d.ts.map