@sovovs/bycli 1.8.0 → 2.0.0

package/clis/twitter/list-tweets.test.js

@@ -1,196 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { extractTimelineTweet, parseListTimeline } from './list-tweets.js';
-
-describe('twitter list-tweets parser', () => {
-    it('extracts core tweet fields from a ListLatestTweetsTimeline result', () => {
-        const tweet = extractTimelineTweet({
-            rest_id: '99',
-            legacy: {
-                full_text: 'hello list',
-                favorite_count: 3,
-                retweet_count: 1,
-                reply_count: 2,
-                created_at: 'Wed Apr 16 10:00:00 +0000 2026',
-            },
-            core: {
-                user_results: {
-                    result: {
-                        legacy: { screen_name: 'bob', name: 'Bob', description: 'List author bio' },
-                    },
-                },
-            },
-        }, new Set());
-        expect(tweet).toEqual({
-            id: '99',
-            author: 'bob',
-            name: 'Bob',
-            bio: 'List author bio',
-            text: 'hello list',
-            likes: 3,
-            retweets: 1,
-            replies: 2,
-            created_at: 'Wed Apr 16 10:00:00 +0000 2026',
-            url: 'https://x.com/bob/status/99',
-            has_media: false,
-            media_urls: [],
-            card: null,
-            quoted_tweet: null,
-        });
-    });
-
-    it('surfaces quoted_tweet field on quote tweets (mini-tweet shape)', () => {
-        // 1778721843 stale-snapshot case from ml-scout — downstream consumers
-        // need quote-tweet content to render the embedded preview card.
-        const tweet = extractTimelineTweet({
-            rest_id: '500',
-            legacy: {
-                full_text: '总的来说，还是有个好爹',
-                is_quote_status: true,
-                quoted_status_id_str: '499',
-            },
-            core: { user_results: { result: { legacy: { screen_name: 'rwayne' } } } },
-            quoted_status_result: {
-                result: {
-                    rest_id: '499',
-                    legacy: {
-                        full_text: '罗某官二代背景考',
-                        created_at: 'Wed May 13 22:00:00 +0000 2026',
-                        extended_entities: {
-                            media: [{ type: 'photo', media_url_https: 'https://pbs.twimg.com/media/x.jpg' }],
-                        },
-                    },
-                    core: { user_results: { result: { legacy: { screen_name: 'alice', name: 'Alice' } } } },
-                },
-            },
-        }, new Set());
-        expect(tweet?.quoted_tweet).toEqual({
-            id: '499',
-            author: 'alice',
-            name: 'Alice',
-            text: '罗某官二代背景考',
-            created_at: 'Wed May 13 22:00:00 +0000 2026',
-            url: 'https://x.com/alice/status/499',
-            has_media: true,
-            media_urls: ['https://pbs.twimg.com/media/x.jpg'],
-        });
-    });
-
-    it('includes photo media URLs from extended_entities', () => {
-        const tweet = extractTimelineTweet({
-            rest_id: '101',
-            legacy: {
-                full_text: 'pic post',
-                extended_entities: {
-                    media: [
-                        { type: 'photo', media_url_https: 'https://pbs.twimg.com/media/abc.jpg' },
-                        { type: 'photo', media_url_https: 'https://pbs.twimg.com/media/def.jpg' },
-                    ],
-                },
-            },
-            core: { user_results: { result: { legacy: { screen_name: 'dave' } } } },
-        }, new Set());
-        expect(tweet?.has_media).toBe(true);
-        expect(tweet?.media_urls).toEqual([
-            'https://pbs.twimg.com/media/abc.jpg',
-            'https://pbs.twimg.com/media/def.jpg',
-        ]);
-    });
-
-    it('extracts mp4 variant URL for video media', () => {
-        const tweet = extractTimelineTweet({
-            rest_id: '102',
-            legacy: {
-                full_text: 'video post',
-                extended_entities: {
-                    media: [{
-                        type: 'video',
-                        media_url_https: 'https://pbs.twimg.com/amplify_video_thumb/thumb.jpg',
-                        video_info: {
-                            variants: [
-                                { content_type: 'application/x-mpegURL', url: 'https://video.twimg.com/playlist.m3u8' },
-                                { content_type: 'video/mp4', bitrate: 832000, url: 'https://video.twimg.com/low.mp4' },
-                                { content_type: 'video/mp4', bitrate: 2176000, url: 'https://video.twimg.com/high.mp4' },
-                            ],
-                        },
-                    }],
-                },
-            },
-            core: { user_results: { result: { legacy: { screen_name: 'erin' } } } },
-        }, new Set());
-        expect(tweet?.has_media).toBe(true);
-        expect(tweet?.media_urls?.[0]).toMatch(/\.mp4$/);
-    });
-
-    it('prefers long-form note_tweet text over truncated legacy full_text', () => {
-        const tweet = extractTimelineTweet({
-            rest_id: '100',
-            legacy: { full_text: 'short…' },
-            note_tweet: {
-                note_tweet_results: {
-                    result: { text: 'the full long-form body' },
-                },
-            },
-            core: { user_results: { result: { legacy: { screen_name: 'carol' } } } },
-        }, new Set());
-        expect(tweet?.text).toBe('the full long-form body');
-    });
-
-    it('deduplicates on rest_id', () => {
-        const seen = new Set();
-        const first = extractTimelineTweet({ rest_id: '1', legacy: {}, core: {} }, seen);
-        const second = extractTimelineTweet({ rest_id: '1', legacy: {}, core: {} }, seen);
-        expect(first).not.toBeNull();
-        expect(second).toBeNull();
-    });
-
-    it('parses entries and bottom cursor from the list timeline payload', () => {
-        const payload = {
-            data: {
-                list: {
-                    tweets_timeline: {
-                        timeline: {
-                            instructions: [
-                                {
-                                    entries: [
-                                        {
-                                            entryId: 'tweet-1',
-                                            content: {
-                                                itemContent: {
-                                                    tweet_results: {
-                                                        result: {
-                                                            rest_id: '1',
-                                                            legacy: { full_text: 't1' },
-                                                            core: { user_results: { result: { legacy: { screen_name: 'a' } } } },
-                                                        },
-                                                    },
-                                                },
-                                            },
-                                        },
-                                        {
-                                            entryId: 'cursor-bottom-1',
-                                            content: {
-                                                entryType: 'TimelineTimelineCursor',
-                                                cursorType: 'Bottom',
-                                                value: 'cursor-next',
-                                            },
-                                        },
-                                    ],
-                                },
-                            ],
-                        },
-                    },
-                },
-            },
-        };
-        const result = parseListTimeline(payload, new Set());
-        expect(result.nextCursor).toBe('cursor-next');
-        expect(result.tweets).toHaveLength(1);
-        expect(result.tweets[0]).toMatchObject({ id: '1', author: 'a', text: 't1' });
-    });
-
-    it('returns empty tweets and null cursor for malformed payload', () => {
-        const result = parseListTimeline({}, new Set());
-        expect(result.tweets).toEqual([]);
-        expect(result.nextCursor).toBeNull();
-    });
-});

package/clis/twitter/lists.test.js

@@ -1,253 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { extractListEntry, isOwnedSubscribedEntry, parseListsManagement } from './lists.js';
-
-describe('twitter lists parser', () => {
-    it('extracts a list entry with full metadata', () => {
-        const entry = {
-            content: {
-                itemContent: {
-                    list: {
-                        id_str: '1597593475389984769',
-                        name: 'Crypto',
-                        member_count: 44,
-                        subscriber_count: 8747,
-                        mode: 'Public',
-                    },
-                },
-            },
-        };
-        expect(extractListEntry(entry, new Set())).toEqual({
-            id: '1597593475389984769',
-            name: 'Crypto',
-            members: '44',
-            followers: '8747',
-            mode: 'public',
-        });
-    });
-
-    it('maps Private mode to private', () => {
-        const entry = {
-            content: {
-                itemContent: {
-                    list: {
-                        id_str: '2044679538156912976',
-                        name: 'AI & Agents',
-                        member_count: 15,
-                        subscriber_count: 0,
-                        mode: 'Private',
-                    },
-                },
-            },
-        };
-        expect(extractListEntry(entry, new Set())?.mode).toBe('private');
-    });
-
-    it('deduplicates by list id', () => {
-        const entry = {
-            content: { itemContent: { list: { id_str: '1', name: 'X' } } },
-        };
-        const seen = new Set();
-        expect(extractListEntry(entry, seen)).not.toBeNull();
-        expect(extractListEntry(entry, seen)).toBeNull();
-    });
-
-    it('returns null when no list payload is present', () => {
-        expect(extractListEntry({}, new Set())).toBeNull();
-        expect(extractListEntry({ content: { itemContent: {} } }, new Set())).toBeNull();
-    });
-
-    it('parses ListsManagementPageTimeline payload instructions (real shape: nested module items)', () => {
-        const payload = {
-            data: {
-                viewer: {
-                    list_management_timeline: {
-                        timeline: {
-                            instructions: [
-                                {
-                                    type: 'TimelineAddEntries',
-                                    entries: [
-                                        {
-                                            entryId: 'owned-subscribed-list-module-0',
-                                            content: {
-                                                entryType: 'TimelineTimelineModule',
-                                                items: [
-                                                    {
-                                                        entryId: 'owned-subscribed-list-module-0-list-1',
-                                                        item: {
-                                                            itemContent: {
-                                                                itemType: 'TimelineTwitterList',
-                                                                list: { id_str: '1', name: 'AI & Agents', member_count: 33, subscriber_count: 0, mode: 'Private' },
-                                                            },
-                                                        },
-                                                    },
-                                                    {
-                                                        entryId: 'owned-subscribed-list-module-0-list-2',
-                                                        item: {
-                                                            itemContent: {
-                                                                itemType: 'TimelineTwitterList',
-                                                                list: { id_str: '2', name: 'Anthropic Team', member_count: 10, subscriber_count: 0, mode: 'Public' },
-                                                            },
-                                                        },
-                                                    },
-                                                ],
-                                            },
-                                        },
-                                    ],
-                                },
-                            ],
-                        },
-                    },
-                },
-            },
-        };
-        const result = parseListsManagement(payload, new Set());
-        expect(result).toHaveLength(2);
-        expect(result[0]).toMatchObject({ id: '1', name: 'AI & Agents', mode: 'private' });
-        expect(result[1]).toMatchObject({ id: '2', name: 'Anthropic Team', mode: 'public' });
-    });
-
-    it('skips "Discover new Lists" recommendations (list-to-follow-module-*)', () => {
-        // 真实 X.com /<user>/lists 响应：Discover 推荐 + Your Lists 同 instruction，
-        // 区别只在 entry.entryId 前缀。Parser 必须按前缀剔除推荐。
-        const payload = {
-            data: {
-                viewer: {
-                    list_management_timeline: {
-                        timeline: {
-                            instructions: [
-                                {
-                                    type: 'TimelineAddEntries',
-                                    entries: [
-                                        {
-                                            entryId: 'list-to-follow-module-2050754937725386752',
-                                            content: {
-                                                entryType: 'TimelineTimelineModule',
-                                                items: [
-                                                    {
-                                                        entryId: 'list-to-follow-module-XYZ-list-1597593475389984769',
-                                                        item: { itemContent: { itemType: 'TimelineTwitterList', list: { id_str: '1597593475389984769', name: 'Crypto', member_count: 44, subscriber_count: 8947, mode: 'Public' } } },
-                                                    },
-                                                    {
-                                                        entryId: 'list-to-follow-module-XYZ-list-1499395616262217730',
-                                                        item: { itemContent: { itemType: 'TimelineTwitterList', list: { id_str: '1499395616262217730', name: 'Crypto Blockchain', member_count: 24, subscriber_count: 1166, mode: 'Public' } } },
-                                                    },
-                                                ],
-                                            },
-                                        },
-                                        {
-                                            entryId: 'owned-subscribed-list-module-0',
-                                            content: {
-                                                entryType: 'TimelineTimelineModule',
-                                                items: [
-                                                    {
-                                                        entryId: 'owned-subscribed-list-module-0-list-2044679538156912976',
-                                                        item: { itemContent: { itemType: 'TimelineTwitterList', list: { id_str: '2044679538156912976', name: 'AI & Agents', member_count: 33, subscriber_count: 0, mode: 'Private' } } },
-                                                    },
-                                                ],
-                                            },
-                                        },
-                                        {
-                                            entryId: 'cursor-bottom-2050754937725386750',
-                                            content: { entryType: 'TimelineTimelineCursor' },
-                                        },
-                                    ],
-                                },
-                            ],
-                        },
-                    },
-                },
-            },
-        };
-        const result = parseListsManagement(payload, new Set());
-        expect(result).toHaveLength(1);
-        expect(result[0]).toMatchObject({ id: '2044679538156912976', name: 'AI & Agents' });
-        // No Crypto/Blockchain leakage
-        expect(result.find(l => l.name === 'Crypto')).toBeUndefined();
-        expect(result.find(l => l.name === 'Crypto Blockchain')).toBeUndefined();
-    });
-
-    it('isOwnedSubscribedEntry classifies entryIds', () => {
-        expect(isOwnedSubscribedEntry({ entryId: 'owned-subscribed-list-module-0' })).toBe(true);
-        expect(isOwnedSubscribedEntry({ entryId: 'list-to-follow-module-2050754937725386752' })).toBe(false);
-        expect(isOwnedSubscribedEntry({ entryId: 'cursor-bottom-XYZ' })).toBe(false);
-        expect(isOwnedSubscribedEntry({})).toBe(false);
-        expect(isOwnedSubscribedEntry({ entryId: null })).toBe(false);
-    });
-
-    it('returns empty list for malformed payload', () => {
-        expect(parseListsManagement({}, new Set())).toEqual([]);
-        expect(parseListsManagement({ data: {} }, new Set())).toEqual([]);
-    });
-
-    it('dedupes across repeated entries within owned-subscribed module', () => {
-        const itemA = {
-            entryId: 'owned-subscribed-list-module-0-list-1',
-            item: { itemContent: { list: { id_str: '1', name: 'A' } } },
-        };
-        const payload = {
-            data: {
-                viewer: {
-                    list_management_timeline: {
-                        timeline: {
-                            instructions: [{
-                                entries: [{
-                                    entryId: 'owned-subscribed-list-module-0',
-                                    content: { items: [itemA, itemA] },
-                                }],
-                            }],
-                        },
-                    },
-                },
-            },
-        };
-        const result = parseListsManagement(payload, new Set());
-        expect(result).toHaveLength(1);
-    });
-
-    it('fails malformed command payloads as parser drift instead of empty success', async () => {
-        const command = getRegistry().get('twitter/lists');
-        const page = {
-            getCookies: async () => [{ name: 'ct0', value: 'token' }],
-            evaluate: async (script) => {
-                if (script.includes('placeholder.json')) return null;
-                return { data: {} };
-            },
-        };
-
-        await expect(command.func(page, { limit: 10 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('treats a recommendation-only timeline as a true empty result', async () => {
-        const command = getRegistry().get('twitter/lists');
-        const page = {
-            getCookies: async () => [{ name: 'ct0', value: 'token' }],
-            evaluate: async (script) => {
-                if (script.includes('placeholder.json')) return null;
-                return {
-                    data: {
-                        viewer: {
-                            list_management_timeline: {
-                                timeline: {
-                                    instructions: [{
-                                        entries: [{
-                                            entryId: 'list-to-follow-module-1',
-                                            content: {
-                                                items: [{
-                                                    item: { itemContent: { list: { id_str: '9', name: 'Recommended' } } },
-                                                }],
-                                            },
-                                        }],
-                                    }],
-                                },
-                            },
-                        },
-                    },
-                };
-            },
-        };
-
-        await expect(command.func(page, { limit: 10 })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-});