@sovovs/bycli 1.8.0 → 2.1.0

package/clis/xueqiu/danjuan-utils.test.js

@@ -1,41 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { fetchDanjuanAll } from './danjuan-utils.js';
-describe('fetchDanjuanAll', () => {
-    it('throws when no Danjuan accounts are visible', async () => {
-        const mockPage = {
-            evaluate: vi.fn().mockResolvedValue({ _emptyAccounts: true }),
-        };
-        await expect(fetchDanjuanAll(mockPage)).rejects.toThrow('No fund accounts found');
-    });
-    it('throws when any account detail request fails', async () => {
-        const mockPage = {
-            evaluate: vi.fn().mockResolvedValue({
-                detailErrors: [
-                    { accountName: '默认账户', accountId: 'acc-1', error: 403 },
-                ],
-            }),
-        };
-        await expect(fetchDanjuanAll(mockPage)).rejects.toThrow('Failed to fetch Danjuan account details: 默认账户 (acc-1): 403');
-    });
-    it('returns the combined snapshot when all account details succeed', async () => {
-        const snapshot = {
-            asOf: '2026-03-25',
-            totalAssetAmount: 100,
-            totalAssetDailyGain: 1,
-            totalAssetHoldGain: 2,
-            totalAssetTotalGain: 3,
-            totalFundMarketValue: 80,
-            accounts: [{ accountId: 'acc-1', accountName: '默认账户' }],
-            holdings: [{ accountId: 'acc-1', fdCode: '000001', fdName: '示例基金' }],
-            detailErrors: [],
-        };
-        const mockPage = {
-            evaluate: vi.fn().mockResolvedValue(snapshot),
-        };
-        await expect(fetchDanjuanAll(mockPage)).resolves.toMatchObject({
-            asOf: '2026-03-25',
-            accounts: [{ accountId: 'acc-1', accountName: '默认账户' }],
-            holdings: [{ accountId: 'acc-1', fdCode: '000001', fdName: '示例基金' }],
-        });
-    });
-});

package/clis/xueqiu/utils.test.js

@@ -1,26 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { formatChinaDate } from './utils.js';
-
-describe('formatChinaDate', () => {
-    it('returns the Asia/Shanghai date for a UTC ms at China midnight', () => {
-        expect(formatChinaDate(Date.UTC(2026, 4, 7, 16, 0, 0))).toBe('2026-05-08');
-    });
-    it('returns the same China date for a moment late in the day', () => {
-        expect(formatChinaDate(Date.UTC(2026, 4, 8, 14, 0, 0))).toBe('2026-05-08');
-    });
-    it('formats representative A-share and US-market bars on xueqiu Beijing dates', () => {
-        expect(formatChinaDate(Date.UTC(2026, 4, 7, 16, 0, 0))).toBe('2026-05-08');
-        expect(formatChinaDate(Date.UTC(2026, 4, 10, 16, 0, 0))).toBe('2026-05-11');
-    });
-    it('crosses the China day boundary at 16:00 UTC', () => {
-        expect(formatChinaDate(Date.UTC(2026, 0, 1, 15, 59, 59))).toBe('2026-01-01');
-        expect(formatChinaDate(Date.UTC(2026, 0, 1, 16, 0, 0))).toBe('2026-01-02');
-    });
-    it('always returns an ISO calendar date string, not a locale-shaped slash date', () => {
-        expect(formatChinaDate(Date.UTC(2026, 0, 1, 16, 0, 0))).toMatch(/^\d{4}-\d{2}-\d{2}$/);
-    });
-    it('returns null for nullish input', () => {
-        expect(formatChinaDate(null)).toBeNull();
-        expect(formatChinaDate(undefined)).toBeNull();
-    });
-});

package/clis/yahoo/search.test.js

@@ -1,94 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-
-const { __test__ } = await import('./search.js');
-const command = __test__.command;
-
-function createPageMock(evaluateResult = []) {
-  return {
-    goto: vi.fn().mockResolvedValue(undefined),
-    wait: vi.fn().mockResolvedValue(undefined),
-    evaluate: vi.fn().mockResolvedValue(evaluateResult),
-  };
-}
-
-describe('yahoo search', () => {
-  it('should register as a valid command', () => {
-    expect(command).toBeDefined();
-    expect(command.site).toBe('yahoo');
-    expect(command.name).toBe('search');
-    expect(command.access).toBe('read');
-    expect(command.browser).toBe(true);
-    expect(command.strategy).toBe('public');
-    expect(command.domain).toBe('search.yahoo.com');
-  });
-
-  it('should define keyword positional arg', () => {
-    const kwArg = command.args.find(a => a.name === 'keyword');
-    expect(kwArg).toBeDefined();
-    expect(kwArg.positional).toBe(true);
-    expect(kwArg.required).toBe(true);
-  });
-
-  it('should define limit arg with default 7', () => {
-    const limitArg = command.args.find(a => a.name === 'limit');
-    expect(limitArg).toBeDefined();
-    expect(limitArg.type).toBe('int');
-    expect(limitArg.default).toBe(7);
-  });
-
-  it('should define output columns', () => {
-    expect(command.columns).toContain('rank');
-    expect(command.columns).toContain('title');
-    expect(command.columns).toContain('url');
-    expect(command.columns).toContain('snippet');
-  });
-
-  it('rejects empty query, invalid limit, and invalid page before navigation', async () => {
-    const page = createPageMock();
-    await expect(command.func(page, { keyword: ' ', limit: 5 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    await expect(command.func(page, { keyword: 'opencli', limit: 8 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    await expect(command.func(page, { keyword: 'opencli', limit: 5, page: 0 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    expect(page.goto).not.toHaveBeenCalled();
-  });
-
-  it('decodes Yahoo redirect URLs and assigns listing rank', async () => {
-    const page = createPageMock({
-      session: 'site:yahoo',
-      data: [[
-        'OpenCLI',
-        'https://r.search.yahoo.com/_ylt=x/RU=https%3A%2F%2Fgithub.com%2Fjackwener%2FOpenCLI/RK=2/RS=x',
-        'CLI browser tooling',
-      ]],
-    });
-
-    await expect(command.func(page, { keyword: 'opencli', limit: 1, page: 2 })).resolves.toEqual([{
-      rank: 8,
-      title: 'OpenCLI',
-      url: 'https://github.com/jackwener/OpenCLI',
-      snippet: 'CLI browser tooling',
-    }]);
-  });
-
-  it('drops decoded Yahoo redirect targets that are not http(s) URLs', async () => {
-    const page = createPageMock([
-      [
-        'Bad redirect',
-        'https://r.search.yahoo.com/_ylt=x/RU=javascript%3Aalert(1)/RK=2/RS=x',
-        'should not be emitted',
-      ],
-    ]);
-
-    await expect(command.func(page, { keyword: 'opencli', limit: 1 })).rejects.toMatchObject({
-      code: 'EMPTY_RESULT',
-    });
-  });
-
-  it('fails typed instead of silently returning [] for malformed extraction payloads', async () => {
-    const page = createPageMock({ rows: [] });
-
-    await expect(command.func(page, { keyword: 'opencli', limit: 1 })).rejects.toMatchObject({
-      code: 'COMMAND_EXEC',
-      message: expect.stringContaining('payload shape'),
-    });
-  });
-});

package/clis/youdao/note.test.js

@@ -1,99 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-
-const { __test__ } = await import('./note.js');
-const command = __test__.command;
-
-function makePage(evaluatePayload) {
-  return {
-    goto: vi.fn().mockResolvedValue(undefined),
-    wait: vi.fn().mockResolvedValue(undefined),
-    evaluate: vi.fn().mockResolvedValue(evaluatePayload),
-  };
-}
-
-describe('youdao note', () => {
-  it('registers as a public browser read command', () => {
-    expect(command).toBeDefined();
-    expect(command.site).toBe('youdao');
-    expect(command.name).toBe('note');
-    expect(command.access).toBe('read');
-    expect(command.browser).toBe(true);
-    expect(command.strategy).toBe('public');
-    expect(command.domain).toBe('share.note.youdao.com');
-    expect(command.columns).toEqual(['title', 'content', 'summary', 'keywords', 'created_at', 'file_size', 'url']);
-  });
-
-  it('strictly validates share URL before navigation', async () => {
-    const page = makePage({});
-    await expect(command.func(page, { url: '' })).rejects.toBeInstanceOf(ArgumentError);
-    await expect(command.func(page, { url: 'https://share.note.youdao.com.evil/ynoteshare/index.html?id=1&type=note' })).rejects.toBeInstanceOf(ArgumentError);
-    await expect(command.func(page, { url: 'javascript:alert(1)' })).rejects.toBeInstanceOf(ArgumentError);
-    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?type=note' })).rejects.toBeInstanceOf(ArgumentError);
-    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=1&type=notebook' })).rejects.toBeInstanceOf(ArgumentError);
-    expect(page.goto).not.toHaveBeenCalled();
-  });
-
-  it('accepts canonical youdao share URLs', () => {
-    expect(__test__.normalizeShareUrl('https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/')).toBe('https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/');
-    expect(__test__.normalizeShareUrl('https://note.youdao.cn/ynoteshare/index.html?id=abc')).toBe('https://note.youdao.cn/ynoteshare/index.html?id=abc');
-  });
-
-  it('unwraps Browser Bridge envelopes and returns full note rows', async () => {
-    const page = makePage({
-      session: 'site:youdao:test',
-      data: [true, 'Expert call', 'Question\nAnswer', 'Short summary', 'PCB | ABF', 1715750400000, 1234, true, 42, 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/'],
-    });
-    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/' }))
-      .resolves.toEqual([{
-        title: 'Expert call',
-        content: 'Question\nAnswer',
-        summary: 'Short summary',
-        keywords: 'PCB | ABF',
-        created_at: '2024-05-15T05:20:00.000Z',
-        file_size: '1234',
-        url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note#/',
-      }]);
-  });
-
-  it('maps missing or expired shares to EmptyResultError', async () => {
-    const page = makePage([false, 'not_found']);
-    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=missing&type=note' }))
-      .rejects.toBeInstanceOf(EmptyResultError);
-  });
-
-  it('maps permission/login pages to AuthRequiredError', async () => {
-    const page = makePage([false, 'auth']);
-    await expect(command.func(page, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=private&type=note' }))
-      .rejects.toBeInstanceOf(AuthRequiredError);
-  });
-
-  it('treats parser drift as CommandExecutionError instead of an empty success row', async () => {
-    await expect(command.func(makePage([false, 'store_missing']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-    await expect(command.func(makePage([true, 'Only title', '', '', '', null, null, false, 0, '']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-    await expect(command.func(makePage([true, 'Bad body', '', '', '', null, null, true, 100, '']), { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-  });
-
-  it('wraps navigation and evaluate failures as CommandExecutionError', async () => {
-    const navPage = makePage({});
-    navPage.goto.mockRejectedValueOnce(new Error('network down'));
-    await expect(command.func(navPage, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-
-    const evalPage = makePage({});
-    evalPage.evaluate.mockRejectedValueOnce(new Error('bad script'));
-    await expect(command.func(evalPage, { url: 'https://share.note.youdao.com/ynoteshare/index.html?id=abc&type=note' }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-  });
-
-  it('keeps the full-content React store extractor contract in source', () => {
-    const js = __test__.buildExtractorJs();
-    expect(js).toContain('store.content');
-    expect(js).toContain('contentData.content');
-    expect(js).toContain('__reactContainer$');
-    expect(js).toContain('walkText');
-  });
-});

package/clis/youtube/channel.test.js

@@ -1,59 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { __test__ } from './channel.js';
-
-function tab(title, contents, selected = false) {
-    return {
-        tabRenderer: {
-            title,
-            selected,
-            content: {
-                richGridRenderer: {
-                    contents,
-                },
-            },
-        },
-    };
-}
-
-function browseData(tabs) {
-    return {
-        contents: {
-            twoColumnBrowseResultsRenderer: {
-                tabs,
-            },
-        },
-    };
-}
-
-describe('youtube channel helpers', () => {
-    it('uses the selected rich-grid tab instead of the first tab', () => {
-        const home = [{ richItemRenderer: { content: { videoRenderer: { videoId: 'home' } } } }];
-        const videos = [{ richItemRenderer: { content: { videoRenderer: { videoId: 'videos' } } } }];
-
-        expect(__test__.extractSelectedRichGridContents(browseData([
-            tab('Home', home),
-            tab('Videos', videos, true),
-        ]))).toBe(videos);
-    });
-
-    it('falls back to the first non-empty rich-grid tab when no tab is selected', () => {
-        const videos = [{ richItemRenderer: { content: { videoRenderer: { videoId: 'only' } } } }];
-
-        expect(__test__.extractSelectedRichGridContents(browseData([
-            tab('Home', []),
-            tab('Videos', videos),
-        ]))).toBe(videos);
-    });
-
-    it('is self-contained for browser evaluate injection', () => {
-        const extractSelectedRichGridContents = Function(
-            `return ${__test__.extractSelectedRichGridContents.toString()}`
-        )();
-        const videos = [{ richItemRenderer: { content: { videoRenderer: { videoId: 'serialized' } } } }];
-
-        expect(extractSelectedRichGridContents(browseData([
-            tab('Home', []),
-            tab('Videos', videos, true),
-        ]))).toEqual(videos);
-    });
-});

package/clis/youtube/feed.test.js

@@ -1,131 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './feed.js';
-
-function makePage({ initialData, continuationData, fetchImpl } = {}) {
-    const fetchMock = fetchImpl || vi.fn().mockResolvedValue({
-        ok: true,
-        json: async () => continuationData,
-    });
-
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn(async (script) => {
-            const previousWindow = globalThis.window;
-            const previousFetch = globalThis.fetch;
-
-            globalThis.window = {
-                ytInitialData: initialData,
-                ytcfg: {
-                    data_: {
-                        INNERTUBE_API_KEY: 'test-key',
-                        INNERTUBE_CONTEXT: { client: { clientName: 'WEB', clientVersion: '1.0' } },
-                    },
-                },
-            };
-            globalThis.fetch = fetchMock;
-
-            try {
-                return await eval(script);
-            }
-            finally {
-                globalThis.window = previousWindow;
-                globalThis.fetch = previousFetch;
-            }
-        }),
-        __fetchMock: fetchMock,
-    };
-}
-
-const initialData = {
-    contents: {
-        twoColumnBrowseResultsRenderer: {
-            tabs: [{
-                tabRenderer: {
-                    content: {
-                        richGridRenderer: {
-                            contents: [
-                                {
-                                    richItemRenderer: {
-                                        content: {
-                                            videoRenderer: {
-                                                videoId: 'first-video',
-                                                title: { runs: [{ text: 'First video' }] },
-                                                ownerText: { runs: [{ text: 'First channel' }] },
-                                                viewCountText: { simpleText: '1K views' },
-                                                lengthText: { simpleText: '10:00' },
-                                                publishedTimeText: { simpleText: '1 day ago' },
-                                            },
-                                        },
-                                    },
-                                },
-                                {
-                                    continuationItemRenderer: {
-                                        continuationEndpoint: {
-                                            continuationCommand: {
-                                                token: 'next-token',
-                                            },
-                                        },
-                                    },
-                                },
-                            ],
-                        },
-                    },
-                },
-            }],
-        },
-    },
-};
-
-const continuationData = {
-    onResponseReceivedActions: [{
-        appendContinuationItemsAction: {
-            continuationItems: [{
-                richItemRenderer: {
-                    content: {
-                        videoRenderer: {
-                            videoId: 'second-video',
-                            title: { runs: [{ text: 'Second video' }] },
-                            ownerText: { runs: [{ text: 'Second channel' }] },
-                            viewCountText: { simpleText: '2K views' },
-                            lengthText: { simpleText: '11:00' },
-                            publishedTimeText: { simpleText: '2 days ago' },
-                        },
-                    },
-                },
-            }],
-        },
-    }],
-};
-
-afterEach(() => {
-    vi.restoreAllMocks();
-});
-
-describe('youtube feed', () => {
-    it('uses continuation results when the first page is below limit', async () => {
-        const page = makePage({ initialData, continuationData });
-        const cmd = getRegistry().get('youtube/feed');
-
-        const rows = await cmd.func(page, { limit: 2 });
-
-        expect(page.goto).toHaveBeenCalledWith('https://www.youtube.com');
-        expect(page.wait).toHaveBeenCalledWith(3);
-        expect(page.__fetchMock).toHaveBeenCalledTimes(1);
-        expect(rows).toEqual([
-            expect.objectContaining({
-                rank: 1,
-                title: 'First video',
-                video_id: 'first-video',
-                url: 'https://www.youtube.com/watch?v=first-video',
-            }),
-            expect.objectContaining({
-                rank: 2,
-                title: 'Second video',
-                video_id: 'second-video',
-                url: 'https://www.youtube.com/watch?v=second-video',
-            }),
-        ]);
-    });
-});

package/clis/youtube/transcript-group.test.js

@@ -1,99 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { groupTranscriptSegments, formatGroupedTranscript } from './transcript-group.js';
-describe('groupTranscriptSegments', () => {
-    it('groups segments by sentence boundaries', () => {
-        const segments = [
-            { start: 0, text: 'Hello there.' },
-            { start: 2, text: 'How are you doing today?' },
-            { start: 5, text: 'I am' },
-            { start: 6, text: 'doing well.' },
-        ];
-        const result = groupTranscriptSegments(segments);
-        expect(result).toHaveLength(3);
-        expect(result[0].text).toBe('Hello there.');
-        expect(result[1].text).toBe('How are you doing today?');
-        expect(result[2].text).toBe('I am doing well.');
-    });
-    it('flushes on large time gaps', () => {
-        const segments = [
-            { start: 0, text: 'First part' },
-            { start: 2, text: 'still first' },
-            { start: 25, text: 'second part after gap' },
-        ];
-        const result = groupTranscriptSegments(segments);
-        expect(result).toHaveLength(2);
-        expect(result[0].text).toBe('First part still first');
-        expect(result[1].text).toBe('second part after gap');
-    });
-    it('respects 30s max group span for unpunctuated text', () => {
-        // Simulate CJK captions without punctuation
-        const segments = Array.from({ length: 20 }, (_, i) => ({
-            start: i * 2,
-            text: `segment${i}`,
-        }));
-        const result = groupTranscriptSegments(segments);
-        // 20 segments * 2s = 40s total, should be split into at least 2 groups
-        expect(result.length).toBeGreaterThanOrEqual(2);
-        // No single group should span more than ~30s
-        for (const g of result) {
-            const words = g.text.split(' ');
-            // With 2s per segment and 30s max, each group should have at most ~16 segments
-            expect(words.length).toBeLessThanOrEqual(16);
-        }
-    });
-    it('detects speaker changes via >> markers', () => {
-        const segments = [
-            { start: 0, text: '>> How are you?' },
-            { start: 3, text: '>> I am fine.' },
-        ];
-        const result = groupTranscriptSegments(segments);
-        expect(result.some(g => g.speakerChange)).toBe(true);
-        expect(result.some(g => g.speaker !== undefined)).toBe(true);
-    });
-    it('recognizes CJK sentence-ending punctuation', () => {
-        const segments = [
-            { start: 0, text: '你好世界。' },
-            { start: 2, text: '这是测试' },
-            { start: 4, text: '内容。' },
-        ];
-        const result = groupTranscriptSegments(segments);
-        expect(result).toHaveLength(2);
-        expect(result[0].text).toBe('你好世界。');
-        expect(result[1].text).toBe('这是测试 内容。');
-    });
-    it('returns empty array for empty input', () => {
-        expect(groupTranscriptSegments([])).toEqual([]);
-    });
-});
-describe('formatGroupedTranscript', () => {
-    it('formats timestamps correctly', () => {
-        const segments = [
-            { start: 65, text: 'One minute five.', speakerChange: false },
-            { start: 3661, text: 'One hour one minute.', speakerChange: false },
-        ];
-        const { rows } = formatGroupedTranscript(segments);
-        expect(rows[0].timestamp).toBe('1:05');
-        expect(rows[1].timestamp).toBe('1:01:01');
-    });
-    it('inserts chapter headings at correct positions', () => {
-        const segments = [
-            { start: 0, text: 'Intro text.', speakerChange: false },
-            { start: 60, text: 'Chapter content.', speakerChange: false },
-        ];
-        const chapters = [{ title: 'Introduction', start: 0 }, { title: 'Main', start: 50 }];
-        const { rows } = formatGroupedTranscript(segments, chapters);
-        expect(rows[0].text).toBe('[Chapter] Introduction');
-        expect(rows[1].text).toBe('Intro text.');
-        expect(rows[2].text).toBe('[Chapter] Main');
-        expect(rows[3].text).toBe('Chapter content.');
-    });
-    it('labels speakers', () => {
-        const segments = [
-            { start: 0, text: 'Hello.', speakerChange: true, speaker: 0 },
-            { start: 5, text: 'Hi there.', speakerChange: true, speaker: 1 },
-        ];
-        const { rows } = formatGroupedTranscript(segments);
-        expect(rows[0].speaker).toBe('Speaker 1');
-        expect(rows[1].speaker).toBe('Speaker 2');
-    });
-});