@sovovs/bycli 1.8.0 → 2.0.0

package/clis/xiaohongshu/search.test.js

@@ -1,325 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { JSDOM } from 'jsdom';
-import { __test__, buildScrollUntilJs, noteIdToDate, unwrapEvaluateResult } from './search.js';
-
-function markVisible(el) {
-    el.getBoundingClientRect = () => ({ width: 100, height: 100 });
-}
-function createPageMock(evaluateResults) {
-    const evaluate = vi.fn();
-    for (const result of evaluateResults) {
-        evaluate.mockResolvedValueOnce(result);
-    }
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        evaluate,
-        snapshot: vi.fn().mockResolvedValue(undefined),
-        click: vi.fn().mockResolvedValue(undefined),
-        typeText: vi.fn().mockResolvedValue(undefined),
-        pressKey: vi.fn().mockResolvedValue(undefined),
-        scrollTo: vi.fn().mockResolvedValue(undefined),
-        getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
-        wait: vi.fn().mockResolvedValue(undefined),
-        tabs: vi.fn().mockResolvedValue([]),
-        selectTab: vi.fn().mockResolvedValue(undefined),
-        networkRequests: vi.fn().mockResolvedValue([]),
-        consoleMessages: vi.fn().mockResolvedValue([]),
-        scroll: vi.fn().mockResolvedValue(undefined),
-        autoScroll: vi.fn().mockResolvedValue(undefined),
-        installInterceptor: vi.fn().mockResolvedValue(undefined),
-        getInterceptedRequests: vi.fn().mockResolvedValue([]),
-        getCookies: vi.fn().mockResolvedValue([]),
-        screenshot: vi.fn().mockResolvedValue(''),
-        waitForCapture: vi.fn().mockResolvedValue(undefined),
-    };
-}
-describe('xiaohongshu search', () => {
-    it('rejects invalid limit before browser navigation', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        const page = createPageMock([]);
-
-        await expect(cmd.func(page, { query: '特斯拉', limit: 0 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: expect.stringContaining('--limit'),
-        });
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-    it('throws a clear error when the search page is blocked by a login wall', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const page = createPageMock([
-            // First evaluate: MutationObserver wait (login wall detected)
-            'login_wall',
-        ]);
-        await expect(cmd.func(page, { query: '特斯拉', limit: 5 })).rejects.toThrow('Xiaohongshu search results are blocked behind a login wall');
-        // No scroll-until / autoScroll call when a login wall is detected early.
-        expect(page.evaluate).toHaveBeenCalledTimes(1);
-        expect(page.autoScroll).not.toHaveBeenCalled();
-    });
-    it('unwraps a browser-bridge envelope before handling login-wall wait result', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        const page = createPageMock([
-            { session: 'site:xiaohongshu', data: 'login_wall' },
-        ]);
-
-        await expect(cmd.func(page, { query: '特斯拉', limit: 5 })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: expect.stringContaining('blocked behind a login wall'),
-        });
-        expect(page.evaluate).toHaveBeenCalledTimes(1);
-    });
-    it('returns ranked results with search_result url and author_url preserved', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const detailUrl = 'https://www.xiaohongshu.com/search_result/68e90be80000000004022e66?xsec_token=test-token&xsec_source=';
-        const authorUrl = 'https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40?xsec_token=user-token&xsec_source=pc_search';
-        const rows = [
-            {
-                title: '某鱼买FSD被坑了4万',
-                author: '随风',
-                likes: '261',
-                url: detailUrl,
-                author_url: authorUrl,
-            },
-        ];
-        const page = createPageMock([
-            // First evaluate: MutationObserver wait (content appeared)
-            'content',
-            // Second evaluate: initial DOM extraction (already enough results) through Browser Bridge envelope.
-            { session: 'site:xiaohongshu', data: rows },
-        ]);
-        const result = await cmd.func(page, { query: '特斯拉', limit: 1 });
-        // Should only do one goto (the search page itself), no per-note detail navigation
-        expect(page.goto.mock.calls).toHaveLength(1);
-        expect(result).toEqual([
-            {
-                rank: 1,
-                title: '某鱼买FSD被坑了4万',
-                author: '随风',
-                likes: '261',
-                published_at: '2025-10-10',
-                url: detailUrl,
-                author_url: authorUrl,
-            },
-        ]);
-    });
-    it('fails typed instead of silently returning [] for malformed extraction payloads', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        const page = createPageMock([
-            'content',
-            { session: 'site:xiaohongshu', data: { rows: [] } },
-        ]);
-
-        await expect(cmd.func(page, { query: '测试', limit: 1 })).rejects.toMatchObject({
-            code: 'COMMAND_EXEC',
-            message: expect.stringContaining('payload shape'),
-        });
-    });
-    it('filters out results with no title and respects the limit', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const page = createPageMock([
-            // First evaluate: MutationObserver wait (content appeared)
-            'content',
-            // Second evaluate: initial DOM extraction (already enough valid rows)
-            [
-                {
-                    title: 'Result A',
-                    author: 'UserA',
-                    likes: '10',
-                    url: 'https://www.xiaohongshu.com/search_result/aaa',
-                    author_url: '',
-                },
-                {
-                    title: '',
-                    author: 'UserB',
-                    likes: '5',
-                    url: 'https://www.xiaohongshu.com/search_result/bbb',
-                    author_url: '',
-                },
-                {
-                    title: 'Result C',
-                    author: 'UserC',
-                    likes: '3',
-                    url: 'https://www.xiaohongshu.com/search_result/ccc',
-                    author_url: '',
-                },
-            ],
-        ]);
-        const result = (await cmd.func(page, { query: '测试', limit: 1 }));
-        // limit=1 should return only the first valid-titled result
-        expect(result).toHaveLength(1);
-        expect(result[0]).toMatchObject({ rank: 1, title: 'Result A' });
-    });
-    it('waits for content via MutationObserver before extracting', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const page = createPageMock([
-            // First evaluate: MutationObserver wait (content appeared)
-            'content',
-            // Second evaluate: initial extraction (no rows rendered)
-            [],
-            // Third evaluate: scroll-until row count
-            0,
-            // Fourth evaluate: post-scroll extraction (still no rows)
-            [],
-        ]);
-        const result = (await cmd.func(page, { query: '测试等待', limit: 5 }));
-        expect(result).toHaveLength(0);
-        // Only one navigation, no retry
-        expect(page.goto).toHaveBeenCalledTimes(1);
-        // Four evaluate calls: wait, initial extraction, scroll-until, post-scroll extraction.
-        expect(page.evaluate).toHaveBeenCalledTimes(4);
-    });
-    it('scrolls only when the initial extraction has fewer rows than requested', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const page = createPageMock([
-            'content',
-            [
-                { title: 'Result A', author: 'UserA', likes: '10', url: 'https://www.xiaohongshu.com/search_result/aaa', author_url: '' },
-            ],
-            3,
-            [
-                { title: 'Result A', author: 'UserA', likes: '10', url: 'https://www.xiaohongshu.com/search_result/aaa', author_url: '' },
-                { title: 'Result B', author: 'UserB', likes: '5', url: 'https://www.xiaohongshu.com/search_result/bbb', author_url: '' },
-            ],
-        ]);
-
-        const result = (await cmd.func(page, { query: '测试等待', limit: 2 }));
-
-        expect(result).toHaveLength(2);
-        expect(result.map((item) => item.title)).toEqual(['Result A', 'Result B']);
-        expect(page.evaluate).toHaveBeenCalledTimes(4);
-    });
-    it('separates fallback author text from appended relative date', async () => {
-        const cmd = getRegistry().get('xiaohongshu/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const dom = new JSDOM(`
-          <section class="note-item">
-            <a class="cover mask" href="/search_result/68e90be80000000004022e66?xsec_token=test-token"></a>
-            <div class="title">数字作者测试</div>
-            <a class="author" href="/user/profile/author123">
-              <span>数字3天前端</span><span>3天前</span>
-            </a>
-            <span class="count">8</span>
-          </section>
-        `, { url: 'https://www.xiaohongshu.com/search_result?keyword=test' });
-        markVisible(dom.window.document.querySelector('section.note-item'));
-        const page = createPageMock([]);
-        page.evaluate.mockImplementationOnce(async () => 'content');
-        page.evaluate.mockImplementationOnce(async (script) => Function('document', 'getComputedStyle', `return (${script})`)(dom.window.document, dom.window.getComputedStyle.bind(dom.window)));
-
-        const result = await cmd.func(page, { query: '测试', limit: 1 });
-
-        expect(result[0]).toMatchObject({
-            title: '数字作者测试',
-            author: '数字3天前端',
-            likes: '8',
-            author_url: 'https://www.xiaohongshu.com/user/profile/author123',
-        });
-    });
-});
-describe('buildScrollUntilJs', () => {
-    it('inlines the target count and default maxScrolls into the generated IIFE', () => {
-        const js = buildScrollUntilJs(40);
-        // Target count must drive the early-exit check (#1471: --limit > 13 was capped).
-        expect(js).toContain('countItems() >= 40');
-        // Default safety cap of 15 to bound runtime on infinite-scroll pages.
-        expect(js).toContain('i < 15');
-        // Plateau detection so the loop exits early when XHS stops lazy-loading
-        // instead of spinning all 15 iterations against an exhausted feed.
-        expect(js).toContain('plateauRounds');
-        // Related-search rows must not count toward the target.
-        expect(js).toContain("classList.contains('query-note-item')");
-    });
-    it('respects a custom maxScrolls override', () => {
-        const js = buildScrollUntilJs(100, 5);
-        expect(js).toContain('countItems() >= 100');
-        expect(js).toContain('i < 5');
-    });
-    it('counts only visible real note rows', async () => {
-        const dom = new JSDOM(`
-          <section class="note-item" id="visible"></section>
-          <section class="note-item query-note-item" id="query"></section>
-          <section class="note-item" id="hidden" style="display:none"></section>
-        `, { url: 'https://www.xiaohongshu.com/search_result?keyword=test' });
-        markVisible(dom.window.document.querySelector('#visible'));
-        markVisible(dom.window.document.querySelector('#query'));
-        markVisible(dom.window.document.querySelector('#hidden'));
-
-        const result = await Function('document', 'window', 'MutationObserver', 'getComputedStyle', `return (${buildScrollUntilJs(1)})`)(dom.window.document, dom.window, dom.window.MutationObserver, dom.window.getComputedStyle.bind(dom.window));
-
-        expect(result).toBe(1);
-    });
-    it('rejects unsafe helper arguments instead of interpolating them into code', () => {
-        expect(() => buildScrollUntilJs(0)).toThrow(/targetCount/);
-        expect(() => buildScrollUntilJs(10, 0)).toThrow(/maxScrolls/);
-    });
-});
-describe('stripXhsAuthorDateSuffix', () => {
-    it('only strips trailing date suffixes and preserves date-like author text', () => {
-        expect(__test__.stripXhsAuthorDateSuffix('作者名 3天前')).toBe('作者名');
-        expect(__test__.stripXhsAuthorDateSuffix('作者名2026-04-01')).toBe('作者名');
-        expect(__test__.stripXhsAuthorDateSuffix('3天前端工程师')).toBe('3天前端工程师');
-        expect(__test__.stripXhsAuthorDateSuffix('刚刚好')).toBe('刚刚好');
-        expect(__test__.stripXhsAuthorDateSuffix('刚刚')).toBe('刚刚');
-    });
-});
-describe('noteIdToDate (ObjectID timestamp parsing)', () => {
-    it('parses a known note ID to the correct China-timezone date', () => {
-        // 0x697f6c74 = 1769958516 → 2026-02-01 in UTC+8
-        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17')).toBe('2026-02-01');
-        // 0x68e90be8 → 2025-10-10 in UTC+8
-        expect(noteIdToDate('https://www.xiaohongshu.com/explore/68e90be80000000004022e66')).toBe('2025-10-10');
-    });
-    it('returns China date when UTC+8 crosses into the next day', () => {
-        // 0x69b739f0 = 2026-03-15 23:00 UTC = 2026-03-16 07:00 CST
-        // Without UTC+8 offset this would incorrectly return 2026-03-15
-        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/69b739f00000000000000000')).toBe('2026-03-16');
-    });
-    it('handles /note/ path variant', () => {
-        expect(noteIdToDate('https://www.xiaohongshu.com/note/697f6c74000000002103de17')).toBe('2026-02-01');
-    });
-    it('handles URL with query parameters', () => {
-        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17?xsec_token=abc')).toBe('2026-02-01');
-    });
-    it('returns empty string for non-matching URLs', () => {
-        expect(noteIdToDate('https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40')).toBe('');
-        expect(noteIdToDate('https://www.xiaohongshu.com/')).toBe('');
-    });
-    it('returns empty string for IDs shorter than 24 hex chars', () => {
-        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/abcdef')).toBe('');
-    });
-    it('returns empty string when timestamp is out of range', () => {
-        // All zeros → ts = 0
-        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/000000000000000000000000')).toBe('');
-    });
-});
-describe('unwrapEvaluateResult (browser-bridge envelope normalization)', () => {
-    it('returns the raw array unchanged when payload is already an array', () => {
-        const arr = [{ title: 'a' }, { title: 'b' }];
-        expect(unwrapEvaluateResult(arr)).toBe(arr);
-    });
-    it('unwraps { session, data: [...] } envelope to the inner array', () => {
-        const arr = [{ title: 'a' }];
-        const env = { session: 'site:xiaohongshu:abc', data: arr };
-        expect(unwrapEvaluateResult(env)).toBe(arr);
-    });
-    it('unwraps primitive data from Browser Bridge envelopes', () => {
-        expect(unwrapEvaluateResult({ session: 'site:xiaohongshu:abc', data: 'login_wall' })).toBe('login_wall');
-    });
-    it('passes non-envelope objects through unchanged', () => {
-        const obj = { results: [], loginWall: true };
-        expect(unwrapEvaluateResult(obj)).toBe(obj);
-    });
-    it('handles null and undefined safely', () => {
-        expect(unwrapEvaluateResult(null)).toBe(null);
-        expect(unwrapEvaluateResult(undefined)).toBe(undefined);
-    });
-    it('unwraps non-array envelope data so callers can validate the payload shape', () => {
-        const env = { session: 'x', data: { not: 'an array' } };
-        expect(unwrapEvaluateResult(env)).toEqual({ not: 'an array' });
-    });
-});

package/clis/xiaohongshu/user-helpers.test.js

@@ -1,160 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { CommandExecutionError } from '@sovovs/bycli/errors';
-import { assertReadableUserSnapshot } from './user.js';
-import { buildXhsNoteUrl, extractXhsUserNotes, flattenXhsNoteGroups, normalizeXhsUserId, } from './user-helpers.js';
-describe('normalizeXhsUserId', () => {
-    it('extracts the profile id from a full Xiaohongshu URL', () => {
-        expect(normalizeXhsUserId('https://www.xiaohongshu.com/user/profile/615529370000000002026001?xsec_source=pc_search')).toBe('615529370000000002026001');
-    });
-    it('keeps a bare profile id unchanged', () => {
-        expect(normalizeXhsUserId('615529370000000002026001')).toBe('615529370000000002026001');
-    });
-});
-describe('flattenXhsNoteGroups', () => {
-    it('flattens grouped note arrays and ignores empty groups', () => {
-        expect(flattenXhsNoteGroups([[{ id: 'a' }], [], null, [{ id: 'b' }]])).toEqual([
-            { id: 'a' },
-            { id: 'b' },
-        ]);
-    });
-});
-describe('buildXhsNoteUrl', () => {
-    it('includes xsec token when available', () => {
-        expect(buildXhsNoteUrl('user123', 'note456', 'token789')).toBe('https://www.xiaohongshu.com/user/profile/user123/note456?xsec_token=token789&xsec_source=pc_user');
-    });
-    it('emits a rednote URL when webHost is overridden', () => {
-        expect(buildXhsNoteUrl('user123', 'note456', 'token789', 'www.rednote.com')).toBe('https://www.rednote.com/user/profile/user123/note456?xsec_token=token789&xsec_source=pc_user');
-    });
-});
-describe('extractXhsUserNotes', () => {
-    it('normalizes grouped note cards into CLI rows', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    {
-                        id: 'note-1',
-                        xsecToken: 'abc',
-                        noteCard: {
-                            noteId: 'note-1',
-                            displayTitle: 'First note',
-                            type: 'video',
-                            interactInfo: { likedCount: '4.6万' },
-                            user: { userId: 'user-1' },
-                        },
-                    },
-                    {
-                        noteCard: {
-                            note_id: 'note-2',
-                            display_title: 'Second note',
-                            type: 'normal',
-                            interact_info: { liked_count: 42 },
-                        },
-                    },
-                ],
-                [],
-            ],
-        }, 'fallback-user');
-        expect(rows).toEqual([
-            {
-                id: 'note-1',
-                title: 'First note',
-                type: 'video',
-                likes: '4.6万',
-                cover: '',
-                url: 'https://www.xiaohongshu.com/user/profile/user-1/note-1?xsec_token=abc&xsec_source=pc_user',
-            },
-            {
-                id: 'note-2',
-                title: 'Second note',
-                type: 'normal',
-                likes: '42',
-                cover: '',
-                url: 'https://www.xiaohongshu.com/user/profile/fallback-user/note-2',
-            },
-        ]);
-    });
-    it('extracts cover urls with fallback priority urlDefault -> urlPre -> url', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    { noteCard: { noteId: 'cover-1', cover: { urlDefault: 'https://img.example/default.jpg', urlPre: 'https://img.example/pre.jpg', url: 'https://img.example/raw.jpg' } } },
-                    { noteCard: { noteId: 'cover-2', cover: { urlPre: 'https://img.example/pre-only.jpg', url: 'https://img.example/raw-only.jpg' } } },
-                    { noteCard: { noteId: 'cover-3', cover: { url: 'https://img.example/raw-fallback.jpg' } } },
-                ],
-            ],
-        }, 'fallback-user');
-        expect(rows.map(row => row.cover)).toEqual([
-            'https://img.example/default.jpg',
-            'https://img.example/pre-only.jpg',
-            'https://img.example/raw-fallback.jpg',
-        ]);
-    });
-    it('deduplicates repeated notes by note id', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    { noteCard: { noteId: 'dup-1', displayTitle: 'keep me' } },
-                    { noteCard: { noteId: 'dup-1', displayTitle: 'drop me' } },
-                ],
-            ],
-        }, 'fallback-user');
-        expect(rows).toHaveLength(1);
-        expect(rows[0]?.title).toBe('keep me');
-    });
-    it('emits rednote-hosted URLs when webHost is overridden', () => {
-        const rows = extractXhsUserNotes({
-            noteGroups: [
-                [
-                    {
-                        xsecToken: 'tok',
-                        noteCard: {
-                            noteId: 'note-red',
-                            displayTitle: 'rednote note',
-                            user: { userId: 'user-red' },
-                        },
-                    },
-                ],
-            ],
-        }, 'fallback-user', 'www.rednote.com');
-        expect(rows[0]?.url).toBe('https://www.rednote.com/user/profile/user-red/note-red?xsec_token=tok&xsec_source=pc_user');
-    });
-});
-
-describe('assertReadableUserSnapshot', () => {
-    it('accepts an explicit empty notes array from a readable user store', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: true,
-            pageDataPresent: false,
-            noteGroups: [],
-            pageData: {},
-        })).not.toThrow();
-    });
-    it('fails typed when the user store is missing instead of treating parser drift as empty', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: false,
-            notesPresent: false,
-            pageDataPresent: false,
-            noteGroups: [],
-            pageData: {},
-        })).toThrow(CommandExecutionError);
-    });
-    it('fails typed when profile metadata exists but the notes array is missing', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: false,
-            pageDataPresent: true,
-            noteGroups: [],
-            pageData: { user: { nickname: 'Alice' } },
-        })).toThrow(CommandExecutionError);
-    });
-    it('fails typed when notesPresent metadata and cloned noteGroups disagree', () => {
-        expect(() => assertReadableUserSnapshot({
-            storePresent: true,
-            notesPresent: true,
-            pageDataPresent: false,
-            noteGroups: null,
-            pageData: {},
-        })).toThrow(CommandExecutionError);
-    });
-});

package/clis/xiaoyuzhou/auth.test.js

@@ -1,124 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-const { mockExistsSync, mockReadFileSync, mockMkdirSync, mockWriteFileSync, mockHomedir } = vi.hoisted(() => ({
-    mockExistsSync: vi.fn(),
-    mockReadFileSync: vi.fn(),
-    mockMkdirSync: vi.fn(),
-    mockWriteFileSync: vi.fn(),
-    mockHomedir: vi.fn(() => '/Users/tester'),
-}));
-
-vi.mock('node:fs', () => ({
-    existsSync: mockExistsSync,
-    readFileSync: mockReadFileSync,
-    mkdirSync: mockMkdirSync,
-    writeFileSync: mockWriteFileSync,
-}));
-
-vi.mock('node:os', () => ({
-    homedir: mockHomedir,
-}));
-
-const { extractTranscriptText, getXiaoyuzhouCredentialFile, loadXiaoyuzhouCredentials, normalizeXiaoyuzhouCredentials, refreshXiaoyuzhouCredentials, requestXiaoyuzhouJson, shouldRefreshXiaoyuzhouCredentials, XIAOYUZHOU_TOKEN_TTL_MS } = await import('./auth.js');
-
-function createJsonResponse(status, payload) {
-    return {
-        ok: status >= 200 && status < 300,
-        status,
-        text: vi.fn().mockResolvedValue(JSON.stringify(payload)),
-    };
-}
-
-describe('xiaoyuzhou auth helpers', () => {
-    beforeEach(() => {
-        mockExistsSync.mockReset();
-        mockReadFileSync.mockReset();
-        mockMkdirSync.mockReset();
-        mockWriteFileSync.mockReset();
-        vi.useRealTimers();
-    });
-
-    it('loads credentials from the local credential file', () => {
-        mockExistsSync.mockReturnValue(true);
-        mockReadFileSync.mockReturnValue(JSON.stringify({
-            access_token: 'file-access',
-            refresh_token: 'file-refresh',
-            expires_at: 123,
-        }));
-        const credentials = loadXiaoyuzhouCredentials();
-        expect(mockReadFileSync).toHaveBeenCalledWith(getXiaoyuzhouCredentialFile(), 'utf-8');
-        expect(credentials.access_token).toBe('file-access');
-        expect(credentials.refresh_token).toBe('file-refresh');
-    });
-
-    it('refreshes credentials and persists the updated token file', async () => {
-        vi.useFakeTimers();
-        vi.setSystemTime(new Date('2026-04-15T00:00:00Z'));
-        const fetchMock = vi.fn().mockResolvedValue(createJsonResponse(200, {
-            success: true,
-            'x-jike-access-token': 'new-access',
-            'x-jike-refresh-token': 'new-refresh',
-        }));
-        const refreshed = await refreshXiaoyuzhouCredentials(normalizeXiaoyuzhouCredentials({
-            access_token: 'old-access',
-            refresh_token: 'old-refresh',
-            device_id: 'device-1',
-            device_properties: 'props',
-        }), fetchMock);
-        expect(refreshed.access_token).toBe('new-access');
-        expect(refreshed.refresh_token).toBe('new-refresh');
-        expect(refreshed.expires_at).toBe(Date.now() + XIAOYUZHOU_TOKEN_TTL_MS);
-        expect(mockMkdirSync).toHaveBeenCalledWith('/Users/tester/.bycli', { recursive: true });
-        expect(mockWriteFileSync).toHaveBeenCalledWith('/Users/tester/.bycli/xiaoyuzhou.json', expect.stringContaining('"access_token": "new-access"'), 'utf-8');
-    });
-
-    it('retries once on 401 using refreshed credentials', async () => {
-        const fetchMock = vi.fn()
-            .mockResolvedValueOnce({
-            ok: false,
-            status: 401,
-            text: vi.fn().mockResolvedValue('unauthorized'),
-        })
-            .mockResolvedValueOnce(createJsonResponse(200, {
-            success: true,
-            'x-jike-access-token': 'refreshed-access',
-            'x-jike-refresh-token': 'refreshed-refresh',
-        }))
-            .mockResolvedValueOnce(createJsonResponse(200, {
-            success: true,
-            data: { title: 'Transcript Episode' },
-        }));
-        const result = await requestXiaoyuzhouJson('/v1/episode/get', {
-            query: { eid: 'ep123' },
-            credentials: normalizeXiaoyuzhouCredentials({
-                access_token: 'old-access',
-                refresh_token: 'old-refresh',
-            }),
-        }, fetchMock);
-        expect(fetchMock).toHaveBeenCalledTimes(3);
-        expect(result.data).toEqual({ title: 'Transcript Episode' });
-        expect(result.credentials.access_token).toBe('refreshed-access');
-    });
-
-    it('extracts transcript text from segment arrays and direct text payloads', () => {
-        expect(extractTranscriptText(JSON.stringify({
-            segments: [{ text: 'hello ' }, { text: ' world' }],
-        }))).toEqual({
-            text: 'hello\nworld',
-            segmentCount: 2,
-        });
-        expect(extractTranscriptText(JSON.stringify({ text: 'full transcript' }))).toEqual({
-            text: 'full transcript',
-            segmentCount: 1,
-        });
-    });
-
-    it('detects credentials that are close to expiry', () => {
-        expect(shouldRefreshXiaoyuzhouCredentials({
-            expires_at: Date.now() - 1,
-        })).toBe(true);
-        expect(shouldRefreshXiaoyuzhouCredentials({
-            expires_at: Date.now() + 10 * 60 * 1000,
-        })).toBe(false);
-    });
-});