@agentrhq/webcmd 0.1.2 → 0.2.1

package/clis/zhihu/answer-comments.js

@@ -1,280 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { stripHtml as stripHtmlText } from './text.js';
-
-function stripHtml(html) {
-    return stripHtmlText(html, { preserveBlocks: true });
-}
-
-const ANSWER_ID_RE = /^\d+$/;
-const ANSWER_TYPED_RE = /^answer:(\d+):(\d+)$/;
-const ANSWER_PATH_RE = /^\/question\/(\d+)\/answer\/(\d+)\/?$/;
-const BARE_ANSWER_PATH_RE = /^\/answer\/(\d+)\/?$/;
-
-function parseAnswerTarget(input) {
-    const value = String(input ?? '').trim();
-    if (!value) return null;
-    if (ANSWER_ID_RE.test(value)) return { answerId: value, questionId: '' };
-    const typed = value.match(ANSWER_TYPED_RE);
-    if (typed) return { questionId: typed[1], answerId: typed[2] };
-    try {
-        const url = new URL(value);
-        if (
-            url.protocol !== 'https:' ||
-            url.username ||
-            url.password ||
-            url.port ||
-            (url.hostname !== 'www.zhihu.com' && url.hostname !== 'zhihu.com')
-        ) {
-            return null;
-        }
-        let m = url.pathname.match(ANSWER_PATH_RE);
-        if (m) return { questionId: m[1], answerId: m[2] };
-        m = url.pathname.match(BARE_ANSWER_PATH_RE);
-        if (m) return { answerId: m[1], questionId: '' };
-    } catch {
-        return null;
-    }
-    return null;
-}
-
-function extractQuestionIdFromAnswerUrl(input) {
-    const value = String(input ?? '').trim();
-    if (!value) return '';
-    try {
-        const url = new URL(value);
-        if (url.protocol !== 'https:' || (url.hostname !== 'www.zhihu.com' && url.hostname !== 'zhihu.com')) return '';
-        return url.pathname.match(ANSWER_PATH_RE)?.[1] || '';
-    } catch {
-        return '';
-    }
-}
-
-function normalizeCount(value) {
-    return Number.isInteger(value) && value >= 0 ? value : 0;
-}
-
-function normalizeUnixSeconds(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value > 0
-        ? new Date(value * 1000).toISOString()
-        : '';
-}
-
-function memberName(author) {
-    return author?.member?.name || author?.name || '';
-}
-
-function normalizeCommentId(value) {
-    if (typeof value === 'string') return value.trim();
-    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) return String(value);
-    return '';
-}
-
-function normalizeCommentUrl(url, questionId, answerId, commentId) {
-    if (questionId && answerId && commentId) {
-        return `https://www.zhihu.com/question/${questionId}/answer/${answerId}#comment-${commentId}`;
-    }
-    return typeof url === 'string' ? url : '';
-}
-
-function normalizeCommentsApiUrl(url, answerId) {
-    if (typeof url !== 'string' || !url) return '';
-    try {
-        const parsed = new URL(url);
-        const expectedWwwPath = `/api/v4/answers/${answerId}/comments`;
-        const expectedApiPath = `/answers/${answerId}/comments`;
-        if (parsed.protocol !== 'https:' || parsed.username || parsed.password || parsed.port) return '';
-        if (parsed.hostname === 'www.zhihu.com' && parsed.pathname === expectedWwwPath) return parsed.toString();
-        if (parsed.hostname === 'api.zhihu.com' && parsed.pathname === expectedApiPath) {
-            return `https://www.zhihu.com${expectedWwwPath}${parsed.search}`;
-        }
-    } catch {
-        return '';
-    }
-    return '';
-}
-
-function buildRows(comments, { answerId, questionId, topLevelLimit, repliesLimit }) {
-    const rows = [];
-    let topLevelCount = 0;
-    let currentCommentRank = 0;
-    let currentReplyCount = 0;
-    let reachedTopLevelLimit = false;
-    let malformedComments = 0;
-
-    for (const comment of comments) {
-        if (!comment || typeof comment !== 'object' || Array.isArray(comment)) {
-            malformedComments += 1;
-            continue;
-        }
-        const id = normalizeCommentId(comment.id);
-        if (!id) {
-            malformedComments += 1;
-            continue;
-        }
-        const author = memberName(comment.author);
-        const replyToAuthor = memberName(comment.reply_to_author);
-        const isReply = Boolean(replyToAuthor);
-
-        if (!isReply) {
-            if (topLevelCount >= topLevelLimit) {
-                reachedTopLevelLimit = true;
-                break;
-            }
-            topLevelCount += 1;
-            currentCommentRank = topLevelCount;
-            currentReplyCount = 0;
-        } else if (!currentCommentRank || currentReplyCount >= repliesLimit) {
-            continue;
-        } else {
-            currentReplyCount += 1;
-        }
-
-        rows.push({
-            rank: rows.length + 1,
-            comment_rank: currentCommentRank,
-            reply_rank: isReply ? currentReplyCount : 0,
-            depth: 0,
-            id,
-            parent_id: '',
-            author: author || 'anonymous',
-            reply_to: replyToAuthor,
-            likes: normalizeCount(comment.vote_count),
-            created_at: normalizeUnixSeconds(comment.created_time),
-            url: normalizeCommentUrl(comment.url, questionId, answerId, id),
-            content: stripHtml(comment.content || ''),
-        });
-    }
-    return { rows, topLevelCount, reachedTopLevelLimit, malformedComments };
-}
-
-const MAX_LIMIT = 1000;
-const MAX_REPLIES_LIMIT = 100;
-const ZHIHU_PAGE_SIZE = 20;
-
-cli({
-    site: 'zhihu',
-    name: 'answer-comments',
-    access: 'read',
-    description: '知乎回答评论列表',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'id', required: true, positional: true, help: 'Answer ID, full Zhihu answer URL, or typed target (answer:<qid>:<aid>)' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of top-level comments (max 1000)' },
-        { name: 'replies-limit', type: 'int', default: 3, help: 'Number of replies to include per top-level comment (max 100)' },
-    ],
-    columns: ['rank', 'comment_rank', 'reply_rank', 'depth', 'id', 'parent_id', 'author', 'reply_to', 'likes', 'created_at', 'url', 'content'],
-    func: async (page, kwargs) => {
-        const target = parseAnswerTarget(kwargs.id);
-        if (!target) {
-            throw new ArgumentError(
-                'Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>',
-                'Example: webcmd zhihu answer-comments 1937205528846655537',
-            );
-        }
-        const topLevelLimit = Number(kwargs.limit ?? 20);
-        if (!Number.isInteger(topLevelLimit) || topLevelLimit <= 0 || topLevelLimit > MAX_LIMIT) {
-            throw new ArgumentError(`--limit must be a positive integer no greater than ${MAX_LIMIT}`);
-        }
-        const repliesLimit = Number(kwargs['replies-limit'] ?? 3);
-        if (!Number.isInteger(repliesLimit) || repliesLimit < 0 || repliesLimit > MAX_REPLIES_LIMIT) {
-            throw new ArgumentError(`--replies-limit must be an integer between 0 and ${MAX_REPLIES_LIMIT}`);
-        }
-
-        const { answerId } = target;
-        try {
-            await page.goto(`https://www.zhihu.com/answer/${answerId}`);
-        } catch (err) {
-            throw new CommandExecutionError(
-                `Failed to open Zhihu answer ${answerId}: ${err instanceof Error ? err.message : String(err)}`,
-                'Open the answer URL in Chrome and retry after the page is reachable.',
-            );
-        }
-        const currentQuestionId = page.getCurrentUrl
-            ? extractQuestionIdFromAnswerUrl(await page.getCurrentUrl().catch(() => ''))
-            : '';
-        const questionId = target.questionId || currentQuestionId;
-
-        let url = `https://www.zhihu.com/api/v4/answers/${answerId}/comments?order=normal&limit=${ZHIHU_PAGE_SIZE}&offset=0&status=open`;
-        const fetched = [];
-        const visited = new Set();
-
-        while (url && !visited.has(url)) {
-            visited.add(url);
-            const data = await page.evaluate(`
-      (async () => {
-        const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
-        if (!r.ok) return { __httpError: r.status };
-        try {
-          return await r.json();
-        } catch (error) {
-          return { __malformedJson: error instanceof Error ? error.message : String(error) };
-        }
-      })()
-    `).catch((err) => {
-                throw new CommandExecutionError(
-                    `Zhihu answer comments request failed: ${err instanceof Error ? err.message : String(err)}`,
-                    'Try again later or rerun with -v for more detail.',
-                );
-            });
-            if (!data || data.__httpError) {
-                const status = data?.__httpError;
-                if (status === 401 || status === 403) {
-                    throw new AuthRequiredError('www.zhihu.com', 'Failed to fetch Zhihu answer comments');
-                }
-                if (status === 404) {
-                    throw new EmptyResultError('zhihu answer-comments', `No Zhihu answer comments resource was found for ${answerId}.`);
-                }
-                throw new CommandExecutionError(
-                    status
-                        ? `Zhihu answer comments request failed (HTTP ${status})`
-                        : 'Zhihu answer comments request failed',
-                    'Try again later or rerun with -v for more detail',
-                );
-            }
-            if (data.__malformedJson) {
-                throw new CommandExecutionError(
-                    `Zhihu answer comments returned malformed JSON: ${data.__malformedJson}`,
-                    'Try again later or rerun with -v for more detail',
-                );
-            }
-            if (!Array.isArray(data.data) || !data.paging || typeof data.paging !== 'object') {
-                throw new CommandExecutionError(
-                    'Zhihu answer comments returned a malformed payload',
-                    'Try again later or rerun with -v for more detail',
-                );
-            }
-            fetched.push(...data.data);
-            const built = buildRows(fetched, { answerId, questionId, topLevelLimit, repliesLimit });
-            if (built.malformedComments > 0) {
-                throw new CommandExecutionError('Zhihu answer comments contained rows without comment ids');
-            }
-            if (built.reachedTopLevelLimit || data.paging?.is_end) {
-                if (built.rows.length === 0) {
-                    throw new EmptyResultError('zhihu answer-comments', `No comments found for answer ${answerId}.`);
-                }
-                return built.rows;
-            }
-            const next = normalizeCommentsApiUrl(data.paging?.next, answerId);
-            if (!next) {
-                throw new CommandExecutionError('Zhihu answer comments pagination returned malformed next URL');
-            }
-            if (visited.has(next)) {
-                throw new CommandExecutionError('Zhihu answer comments pagination returned a repeated next URL');
-            }
-            url = next;
-        }
-
-        const built = buildRows(fetched, { answerId, questionId, topLevelLimit, repliesLimit });
-        if (built.malformedComments > 0) {
-            throw new CommandExecutionError('Zhihu answer comments contained rows without comment ids');
-        }
-        if (built.rows.length === 0) {
-            throw new EmptyResultError('zhihu answer-comments', `No comments found for answer ${answerId}.`);
-        }
-        return built.rows;
-    },
-});
-
-export const __test__ = { stripHtml, parseAnswerTarget, normalizeCommentsApiUrl, buildRows };

package/clis/zhihu/answer-comments.test.js

@@ -1,287 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import './answer-comments.js';
-import { __test__ as helpers } from './answer-comments.js';
-
-describe('zhihu answer-comments', () => {
-    it('registers as a cookie read command', () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        expect(cmd).toBeDefined();
-        expect(cmd.access).toBe('read');
-        expect(cmd.strategy).toBe('cookie');
-    });
-
-    it('returns flattened comments while limiting only top-level comments', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const goto = vi.fn().mockResolvedValue(undefined);
-        const evaluate = vi.fn().mockImplementation(async (js) => {
-            expect(js).toContain('/api/v4/answers/2036567240334653053/comments?order=normal&limit=20');
-            expect(js).toContain("credentials: 'include'");
-            return {
-                data: [
-                    {
-                        id: 'c1',
-                        author: { member: { id: 'u1', name: 'alice' } },
-                        vote_count: 3,
-                        created_time: 1700000000,
-                        content: '<p>top &#34;one&#34;</p>',
-                    },
-                    {
-                        id: 'r1',
-                        author: { member: { id: 'u2', name: 'bob' } },
-                        reply_to_author: { member: { id: 'u1', name: 'alice' } },
-                        vote_count: 1,
-                        created_time: 1700000100,
-                        content: '<p>reply one</p>',
-                    },
-                    {
-                        id: 'r2',
-                        author: { member: { id: 'u3', name: 'carol' } },
-                        reply_to_author: { member: { id: 'u1', name: 'alice' } },
-                        vote_count: 2,
-                        created_time: 1700000200,
-                        content: '<p>reply two should be capped</p>',
-                    },
-                    {
-                        id: 'c2',
-                        author: { member: { id: 'u4', name: 'dave' } },
-                        vote_count: 4,
-                        created_time: 1700000300,
-                        content: '<p>top two</p>',
-                    },
-                    {
-                        id: 'c3',
-                        author: { member: { id: 'u5', name: 'erin' } },
-                        vote_count: 5,
-                        content: '<p>top three should stop the page walk</p>',
-                    },
-                ],
-                paging: { is_end: false, next: 'https://www.zhihu.com/api/v4/answers/2036567240334653053/comments?offset=20' },
-            };
-        });
-        const page = {
-            goto,
-            getCurrentUrl: vi.fn().mockResolvedValue('https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053'),
-            evaluate,
-        };
-        await expect(cmd.func(page, {
-            id: 'https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053',
-            limit: 2,
-            'replies-limit': 1,
-        })).resolves.toEqual([
-            {
-                rank: 1,
-                comment_rank: 1,
-                reply_rank: 0,
-                depth: 0,
-                id: 'c1',
-                parent_id: '',
-                author: 'alice',
-                reply_to: '',
-                likes: 3,
-                created_at: '2023-11-14T22:13:20.000Z',
-                url: 'https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053#comment-c1',
-                content: 'top "one"',
-            },
-            {
-                rank: 2,
-                comment_rank: 1,
-                reply_rank: 1,
-                depth: 0,
-                id: 'r1',
-                parent_id: '',
-                author: 'bob',
-                reply_to: 'alice',
-                likes: 1,
-                created_at: '2023-11-14T22:15:00.000Z',
-                url: 'https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053#comment-r1',
-                content: 'reply one',
-            },
-            {
-                rank: 3,
-                comment_rank: 2,
-                reply_rank: 0,
-                depth: 0,
-                id: 'c2',
-                parent_id: '',
-                author: 'dave',
-                reply_to: '',
-                likes: 4,
-                created_at: '2023-11-14T22:18:20.000Z',
-                url: 'https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053#comment-c2',
-                content: 'top two',
-            },
-        ]);
-        expect(goto).toHaveBeenCalledWith('https://www.zhihu.com/answer/2036567240334653053');
-        expect(evaluate).toHaveBeenCalledTimes(1);
-    });
-
-    it('follows paging.next until enough top-level comments are collected', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const evaluate = vi.fn()
-            .mockResolvedValueOnce({
-                data: [
-                    { id: 'c1', author: { member: { id: 'u1', name: 'alice' } }, content: 'first' },
-                    { id: 'r1', author: { member: { id: 'u2', name: 'bob' } }, reply_to_author: { member: { id: 'u1', name: 'alice' } }, content: 'reply' },
-                ],
-                paging: { is_end: false, next: 'https://www.zhihu.com/api/v4/answers/1/comments?offset=20' },
-            })
-            .mockResolvedValueOnce({
-                data: [
-                    { id: 'c2', author: { member: { id: 'u3', name: 'carol' } }, content: 'second' },
-                ],
-                paging: { is_end: true },
-            });
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate };
-        const rows = await cmd.func(page, { id: '1', limit: 2, 'replies-limit': 0 });
-        expect(rows.map((row) => row.id)).toEqual(['c1', 'c2']);
-        expect(evaluate).toHaveBeenCalledTimes(2);
-        expect(evaluate.mock.calls[1][0]).toContain('offset=20');
-    });
-
-    it('supports typed answer targets', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({
-                data: [
-                    { id: 'c1', author: { member: { id: 'u1', name: 'alice' } }, content: 'typed target comment' },
-                ],
-                paging: { is_end: true },
-            }),
-        };
-        await expect(cmd.func(page, { id: 'answer:2022852734622114542:2036567240334653053', limit: 1, 'replies-limit': 0 }))
-            .resolves.toMatchObject([{ id: 'c1', url: 'https://www.zhihu.com/question/2022852734622114542/answer/2036567240334653053#comment-c1' }]);
-        expect(page.goto).toHaveBeenCalledWith('https://www.zhihu.com/answer/2036567240334653053');
-    });
-
-    it('maps auth failures to AuthRequiredError', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({ __httpError: 403 }),
-        };
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('maps 404 not found to EmptyResultError', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({ __httpError: 404 }),
-        };
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-
-    it('maps malformed responses to CommandExecutionError', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({ data: {} }),
-        };
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('maps valid empty comments to EmptyResultError', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({ data: [], paging: { is_end: true } }),
-        };
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-
-    it('rejects malformed pagination next URLs and repeated next URLs', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const malformedNextPage = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({
-                data: [{ id: 'c1', author: { member: { id: 'u1', name: 'alice' } }, content: 'first' }],
-                paging: { is_end: false, next: 'https://evil.example/api/v4/answers/1/comments?offset=20' },
-            }),
-        };
-        await expect(cmd.func(malformedNextPage, { id: '1', limit: 2, 'replies-limit': 0 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-
-        const repeatedNextPage = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({
-                data: [{ id: 'c1', author: { member: { id: 'u1', name: 'alice' } }, content: 'first' }],
-                paging: { is_end: false, next: 'https://www.zhihu.com/api/v4/answers/1/comments?order=normal&limit=20&offset=0&status=open' },
-            }),
-        };
-        await expect(cmd.func(repeatedNextPage, { id: '1', limit: 2, 'replies-limit': 0 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects comment rows without stable comment id anchors', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({
-                data: [{ author: { member: { id: 'u1', name: 'alice' } }, content: 'missing id' }],
-                paging: { is_end: true },
-            }),
-        };
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects null comment items and non-primitive comment ids', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const basePage = (data) => ({
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValue({ data, paging: { is_end: true } }),
-        });
-        await expect(cmd.func(basePage([null]), { id: '1', limit: 1, 'replies-limit': 0 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(cmd.func(basePage([{ id: { value: 'c1' }, content: 'object id' }]), { id: '1', limit: 1, 'replies-limit': 0 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-        await expect(cmd.func(basePage([{ id: true, content: 'boolean id' }]), { id: '1', limit: 1, 'replies-limit': 0 }))
-            .rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects invalid inputs before navigation', async () => {
-        const cmd = getRegistry().get('zhihu/answer-comments');
-        const page = { goto: vi.fn(), evaluate: vi.fn() };
-        await expect(cmd.func(page, { id: 'not-an-answer', limit: 1, 'replies-limit': 0 })).rejects.toBeInstanceOf(ArgumentError);
-        await expect(cmd.func(page, { id: '1', limit: 0, 'replies-limit': 0 })).rejects.toBeInstanceOf(ArgumentError);
-        await expect(cmd.func(page, { id: '1', limit: 1001, 'replies-limit': 0 })).rejects.toBeInstanceOf(ArgumentError);
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': -1 })).rejects.toBeInstanceOf(ArgumentError);
-        await expect(cmd.func(page, { id: '1', limit: 1, 'replies-limit': 101 })).rejects.toBeInstanceOf(ArgumentError);
-        expect(page.goto).not.toHaveBeenCalled();
-        expect(page.evaluate).not.toHaveBeenCalled();
-    });
-});
-
-describe('zhihu answer-comments helpers', () => {
-    it('parseAnswerTarget handles exact input shapes', () => {
-        expect(helpers.parseAnswerTarget('123')).toEqual({ answerId: '123', questionId: '' });
-        expect(helpers.parseAnswerTarget('answer:10:123')).toEqual({ answerId: '123', questionId: '10' });
-        expect(helpers.parseAnswerTarget('https://www.zhihu.com/question/10/answer/123')).toEqual({ answerId: '123', questionId: '10' });
-        expect(helpers.parseAnswerTarget('https://zhihu.com/answer/123?utm=1')).toEqual({ answerId: '123', questionId: '' });
-        expect(helpers.parseAnswerTarget('https://example.com/question/10/answer/123')).toBeNull();
-    });
-
-    it('normalizeCommentsApiUrl only accepts same-answer Zhihu comments API URLs', () => {
-        expect(helpers.normalizeCommentsApiUrl('https://www.zhihu.com/api/v4/answers/123/comments?offset=20', '123'))
-            .toBe('https://www.zhihu.com/api/v4/answers/123/comments?offset=20');
-        expect(helpers.normalizeCommentsApiUrl('https://api.zhihu.com/answers/123/comments?offset=20', '123'))
-            .toBe('https://www.zhihu.com/api/v4/answers/123/comments?offset=20');
-        expect(helpers.normalizeCommentsApiUrl('https://www.zhihu.com/api/v4/answers/999/comments?offset=20', '123')).toBe('');
-        expect(helpers.normalizeCommentsApiUrl('https://evil.example/api/v4/answers/123/comments?offset=20', '123')).toBe('');
-    });
-
-    it('buildRows keeps replies flat without guessing parent comment ids', () => {
-        const rows = helpers.buildRows([
-            { id: 'c1', author: { member: { id: 'u1', name: 'alice' } }, content: 'top' },
-            { id: 'r1', author: { member: { id: 'u2', name: 'bob' } }, reply_to_author: { member: { id: 'u1', name: 'alice' } }, content: 'reply' },
-            { id: 'r2', author: { member: { id: 'u3', name: 'carol' } }, reply_to_author: { member: { id: 'u2', name: 'bob' } }, content: 'nested' },
-        ], { answerId: 'a1', questionId: 'q1', topLevelLimit: 1, repliesLimit: 5 }).rows;
-        expect(rows.map((row) => [row.id, row.parent_id, row.depth, row.comment_rank, row.reply_rank])).toEqual([
-            ['c1', '', 0, 1, 0],
-            ['r1', '', 0, 1, 1],
-            ['r2', '', 0, 1, 2],
-        ]);
-    });
-});