@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/bilibili/summary.test.js

@@ -1,210 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-
-const { mockApiGet, mockResolveBvid } = vi.hoisted(() => ({
-    mockApiGet: vi.fn(),
-    mockResolveBvid: vi.fn(),
-}));
-
-vi.mock('./utils.js', async (importOriginal) => ({
-    ...(await importOriginal()),
-    apiGet: mockApiGet,
-    resolveBvid: mockResolveBvid,
-}));
-
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './summary.js';
-
-describe('bilibili summary', () => {
-    const command = getRegistry().get('bilibili/summary');
-    const page = {};
-
-    beforeEach(() => {
-        mockApiGet.mockReset();
-        mockResolveBvid.mockReset();
-        mockResolveBvid.mockRejectedValue(new Error('short link not found'));
-    });
-
-    function mockView(data = { aid: 114, cid: 222, owner: { mid: 333 } }) {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data });
-    }
-
-    function mockConclusion(modelResult) {
-        mockApiGet.mockResolvedValueOnce({
-            code: 0,
-            data: {
-                code: 0,
-                model_result: modelResult,
-            },
-        });
-    }
-
-    it('returns the summary plus timestamped outline rows', async () => {
-        mockView();
-        mockConclusion({
-            summary: '整体总结',
-            outline: [
-                {
-                    title: '第一节',
-                    timestamp: 0,
-                    part_outline: [
-                        { timestamp: 12, content: '要点A' },
-                        { timestamp: 3725, content: '要点B' },
-                    ],
-                },
-            ],
-        });
-
-        const result = await command.func(page, { bvid: 'BV1xxx' });
-
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, page, '/x/web-interface/view', { params: { bvid: 'BV1xxx' } });
-        expect(mockApiGet).toHaveBeenNthCalledWith(2, page, '/x/web-interface/view/conclusion/get', {
-            params: { bvid: 'BV1xxx', cid: 222, up_mid: 333 },
-            signed: true,
-        });
-        expect(result).toEqual([
-            { time: '', content: '整体总结' },
-            { time: '00:00', content: '# 第一节' },
-            { time: '00:12', content: '要点A' },
-            { time: '1:02:05', content: '要点B' },
-        ]);
-    });
-
-    it('returns just the summary when the video has no outline', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion({ summary: '只有总结', outline: [] });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).resolves.toEqual([
-            { time: '', content: '只有总结' },
-        ]);
-    });
-
-    it('parses model_result when Bilibili returns it as a JSON string', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion(JSON.stringify({ summary: '字符串总结', outline: [] }));
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).resolves.toEqual([
-            { time: '', content: '字符串总结' },
-        ]);
-    });
-
-    it('normalizes Bilibili video URLs before calling the APIs', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion({ summary: 'URL 总结', outline: [] });
-
-        await command.func(page, {
-            bvid: 'https://www.bilibili.com/video/BV1abc12345/?spm_id_from=333.1007',
-        });
-
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, page, '/x/web-interface/view', { params: { bvid: 'BV1abc12345' } });
-    });
-
-    it('resolves b23.tv short links through the shared resolver', async () => {
-        mockResolveBvid.mockResolvedValueOnce('BVshort12345');
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion({ summary: '短链总结', outline: [] });
-
-        await command.func(page, { bvid: 'https://b23.tv/abc' });
-
-        expect(mockResolveBvid).toHaveBeenCalledWith('https://b23.tv/abc');
-        expect(mockApiGet).toHaveBeenNthCalledWith(1, page, '/x/web-interface/view', { params: { bvid: 'BVshort12345' } });
-    });
-
-    it('rejects invalid inputs before calling Bilibili APIs', async () => {
-        const cases = [
-            '',
-            'javascript:alert(1)',
-            'https://example.com/video/BV1abc12345',
-            'https://share.note.youdao.com/video/BV1abc12345',
-            'https://www.bilibili.com/read/cv12345',
-        ];
-
-        for (const bvid of cases) {
-            await expect(command.func(page, { bvid })).rejects.toBeInstanceOf(ArgumentError);
-        }
-        expect(mockApiGet).not.toHaveBeenCalled();
-    });
-
-    it('maps unresolved short-code inputs to ArgumentError without calling APIs', async () => {
-        await expect(command.func(page, { bvid: 'not-a-bv' })).rejects.toBeInstanceOf(ArgumentError);
-
-        expect(mockResolveBvid).toHaveBeenCalledWith('not-a-bv');
-        expect(mockApiGet).not.toHaveBeenCalled();
-    });
-
-    it('throws EmptyResultError when Bilibili has not generated an AI summary for the video', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: { code: 1, model_result: {} } });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-
-    it('throws CommandExecutionError when the view payload is malformed', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: 0, data: {} });
-
-        await expect(command.func(page, { bvid: 'BVbroken' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /cid\/up_mid/.test(err.message),
-        );
-    });
-
-    it('throws CommandExecutionError when the view API returns a non-auth error', async () => {
-        mockApiGet.mockResolvedValueOnce({ code: -404, message: '啥都木有' });
-
-        await expect(command.func(page, { bvid: 'BVbroken' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /啥都木有.*-404/.test(err.message),
-        );
-    });
-
-    it('maps conclusion auth or permission errors to AuthRequiredError', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockApiGet.mockResolvedValueOnce({ code: -403, message: '访问权限不足' });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('maps conclusion non-auth API errors to CommandExecutionError', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockApiGet.mockResolvedValueOnce({ code: -500, message: 'server error' });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /server error.*-500/.test(err.message),
-        );
-    });
-
-    it('throws CommandExecutionError for malformed conclusion API payloads', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockApiGet.mockResolvedValueOnce(null);
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('throws CommandExecutionError for malformed model_result JSON', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion('{bad json');
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /model_result JSON/.test(err.message),
-        );
-    });
-
-    it('throws CommandExecutionError for malformed outline shapes', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion({ summary: '坏 outline', outline: {} });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /outline/.test(err.message),
-        );
-    });
-
-    it('throws CommandExecutionError for malformed part outline shapes', async () => {
-        mockView({ aid: 1, cid: 2, owner: { mid: 3 } });
-        mockConclusion({
-            summary: '坏 part_outline',
-            outline: [{ title: '段落', timestamp: 0, part_outline: {} }],
-        });
-
-        await expect(command.func(page, { bvid: 'BV1xxx' })).rejects.toSatisfy(
-            (err) => err instanceof CommandExecutionError && /part outline/.test(err.message),
-        );
-    });
-});

package/clis/bilibili/unfollow.js

@@ -1,121 +0,0 @@
-/**
- * Bilibili unfollow — removes a follow relation via the official write API.
- * Mirror of follow.js with act=2. If the viewer is not currently following the
- * target, the API call is skipped and `not-following` is returned without
- * touching state.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { apiPost, fetchJson, getSelfUid, requireOkPayload, resolveUid } from './utils.js';
-
-const RELATION_VERIFY_TIMEOUT_MS = 5000;
-const RELATION_VERIFY_POLL_MS = 500;
-
-function parseSpaceMidUrl(raw) {
-    const trimmed = String(raw ?? '').trim();
-    if (!trimmed) return '';
-    const candidate = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
-    let parsed;
-    try {
-        parsed = new URL(candidate);
-    } catch {
-        return '';
-    }
-    if (parsed.hostname.toLowerCase() !== 'space.bilibili.com') return '';
-    const match = parsed.pathname.match(/^\/(\d+)\/?$/);
-    return match ? match[1] : '';
-}
-
-async function resolveTargetMid(page, raw) {
-    const trimmed = String(raw ?? '').trim();
-    if (!trimmed) {
-        throw new ArgumentError('bilibili unfollow target cannot be empty');
-    }
-    if (/^(?:https?:\/\/)?space\.bilibili\.com\//i.test(trimmed)) {
-        const mid = parseSpaceMidUrl(trimmed);
-        if (!mid) {
-            throw new ArgumentError('bilibili unfollow target must be a valid space.bilibili.com/<uid> URL');
-        }
-        return mid;
-    }
-    try {
-        return await resolveUid(page, trimmed);
-    } catch (error) {
-        if (error instanceof EmptyResultError) throw error;
-        throw new ArgumentError(
-            `Cannot resolve Bilibili target from input: ${trimmed}`,
-            error instanceof Error ? error.message : String(error),
-        );
-    }
-}
-
-async function fetchRelationAttribute(page, mid) {
-    const payload = await fetchJson(page, `https://api.bilibili.com/x/relation?fid=${mid}`);
-    requireOkPayload(payload, 'relation query');
-    const attribute = payload?.data?.attribute;
-    if (typeof attribute !== 'number') {
-        throw new CommandExecutionError('Bilibili relation query returned a malformed attribute');
-    }
-    return attribute;
-}
-
-async function waitForRelation(page, mid, predicate, expectedLabel) {
-    const deadline = Date.now() + RELATION_VERIFY_TIMEOUT_MS;
-    let lastAttribute;
-    while (Date.now() <= deadline) {
-        lastAttribute = await fetchRelationAttribute(page, mid);
-        if (predicate(lastAttribute)) return lastAttribute;
-        if (typeof page.wait !== 'function') break;
-        await page.wait({ time: RELATION_VERIFY_POLL_MS / 1000 });
-    }
-    throw new CommandExecutionError(
-        `Bilibili relation modify did not verify ${expectedLabel}; last attribute=${lastAttribute}`,
-    );
-}
-
-cli({
-    site: 'bilibili',
-    name: 'unfollow',
-    access: 'write',
-    description: '取消关注 B站用户（官方 API，需登录）',
-    domain: 'www.bilibili.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        {
-            name: 'target',
-            required: true,
-            positional: true,
-            help: '目标 UID / 用户名 / space.bilibili.com 链接',
-        },
-    ],
-    columns: ['mid', 'name', 'status', 'url'],
-    func: async (page, kwargs) => {
-        if (!page) {
-            throw new CommandExecutionError('Browser session required for bilibili unfollow');
-        }
-        const mid = await resolveTargetMid(page, kwargs.target);
-        const self = await getSelfUid(page);
-        if (mid === self) {
-            throw new ArgumentError('Cannot unfollow yourself');
-        }
-        const attribute = await fetchRelationAttribute(page, mid);
-        const url = `https://space.bilibili.com/${mid}`;
-        // attribute 2=following, 6=mutual. Anything else means the viewer isn't
-        // currently following — skip the POST and return idempotent status.
-        if (attribute !== 2 && attribute !== 6) {
-            return [{ mid, name: '', status: 'not-following', url }];
-        }
-        const payload = await apiPost(page, '/x/relation/modify', {
-            params: { fid: mid, act: 2, re_src: 11 },
-        });
-        requireOkPayload(payload, 'relation modify');
-        await waitForRelation(page, mid, (nextAttribute) => nextAttribute !== 2 && nextAttribute !== 6, 'not following');
-        return [{ mid, name: '', status: 'unfollowed', url }];
-    },
-});
-
-export const __test__ = {
-    resolveTargetMid,
-    fetchRelationAttribute,
-    waitForRelation,
-};

package/clis/bilibili/user-videos.js

@@ -1,39 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { apiGet, payloadData, resolveUid } from './utils.js';
-cli({
-    site: 'bilibili',
-    name: 'user-videos',
-    access: 'read',
-    description: '查看指定用户的投稿视频',
-    domain: 'www.bilibili.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'uid', required: true, positional: true, help: 'User UID or username' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
-        { name: 'order', default: 'pubdate', help: 'Sort: pubdate, click, stow' },
-        { name: 'page', type: 'int', default: 1, help: 'Page number' },
-    ],
-    columns: ['rank', 'title', 'plays', 'likes', 'date', 'url'],
-    func: async (page, kwargs) => {
-        const { uid: uidInput, limit = 20, order = 'pubdate', page: pageNum = 1 } = kwargs;
-        const uid = await resolveUid(page, String(uidInput));
-        const payload = await apiGet(page, '/x/space/wbi/arc/search', {
-            params: {
-                mid: uid,
-                pn: pageNum,
-                ps: Math.min(Number(limit), 50),
-                order,
-            },
-            signed: true,
-        });
-        const vlist = payloadData(payload)?.list?.vlist ?? [];
-        return vlist.slice(0, Number(limit)).map((item, i) => ({
-            rank: i + 1,
-            title: item.title ?? '',
-            plays: item.play ?? 0,
-            likes: item.like ?? 0,
-            date: item.created ? new Date(item.created * 1000).toISOString().slice(0, 10) : '',
-            url: item.bvid ? `https://www.bilibili.com/video/${item.bvid}` : '',
-        }));
-    },
-});

package/clis/bilibili/utils.js

@@ -1,273 +0,0 @@
-/**
- * Bilibili shared helpers: WBI signing, authenticated fetch, nav data, UID resolution.
- */
-import https from 'node:https';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-/**
- * Resolve Bilibili short URL / short code to BV ID.
- * Supports: BV1MV9NBtENN, XYzsqGa, b23.tv/XYzsqGa, https://b23.tv/XYzsqGa
- */
-export function resolveBvid(input) {
-    const trimmed = String(input).trim();
-    if (/^BV[A-Za-z0-9]+$/i.test(trimmed)) {
-        return Promise.resolve(trimmed);
-    }
-    try {
-        const parsed = new URL(trimmed);
-        if (/(\.|^)bilibili\.com$/i.test(parsed.hostname)) {
-            const match = parsed.pathname.match(/\/(?:video|bangumi\/play)\/(BV[A-Za-z0-9]+)/i);
-            if (match) {
-                return Promise.resolve(match[1]);
-            }
-        }
-    }
-    catch {
-        // Non-URL inputs fall through to b23.tv short-code resolution.
-    }
-    const shortCode = trimmed.replace(/^https?:\/\//, '').replace(/^(www\.)?b23\.tv\//, '');
-    if (!/^[A-Za-z0-9]+$/.test(shortCode)) {
-        return Promise.reject(new Error(`Cannot resolve BV ID from invalid b23.tv short code: ${trimmed}`));
-    }
-    const url = 'https://b23.tv/' + shortCode;
-    return new Promise((resolve, reject) => {
-        const req = https.get(url, (res) => {
-            const location = res.headers.location;
-            if (location) {
-                const match = location.match(/\/video\/(BV[A-Za-z0-9]+)/);
-                if (match) {
-                    res.resume();
-                    resolve(match[1]);
-                    return;
-                }
-            }
-            res.resume();
-            reject(new Error(`Cannot resolve BV ID from short URL: ${trimmed}`));
-        });
-        req.on('error', reject);
-        req.setTimeout(4000, () => { req.destroy(); reject(new Error(`Timeout resolving short URL: ${trimmed}`)); });
-    });
-}
-/**
- * 解析 --page 选集序号（分P / 视频选集）。
- * 缺省/空串 → null（不下钻，保持整集默认 P1 旧行为）。
- * 非正十进制整数 → 抛 ArgumentError（参数错误，不静默吞）。
- */
-export function parsePageArg(value) {
-    if (value == null || value === '') return null;
-    if (typeof value === 'number') {
-        if (Number.isSafeInteger(value) && value >= 1) return value;
-        throw new ArgumentError(`--page must be a positive decimal integer, got: ${value}`);
-    }
-    if (typeof value !== 'string' || !/^[1-9]\d*$/.test(value)) {
-        throw new ArgumentError(`--page must be a positive decimal integer, got: ${String(value)}`);
-    }
-    const n = Number(value);
-    if (!Number.isSafeInteger(n)) {
-        throw new ArgumentError(`--page is too large: ${value}`);
-    }
-    return n;
-}
-
-function readApiPositiveInteger(value, label) {
-    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 1) {
-        return value;
-    }
-    if (typeof value === 'string' && /^[1-9]\d*$/.test(value)) {
-        const n = Number(value);
-        if (Number.isSafeInteger(n)) return n;
-    }
-    throw new CommandExecutionError(`Bilibili view API returned a malformed ${label}`);
-}
-
-/**
- * 从 view API 的 data.pages 数组取第 N 集（1-based）。
- * page/cid 都以 view API 的 pages[] 为 source-of-truth；缺失、重复或畸形都 fail closed。
- * 返回该集 raw 对象（含 cid / part(分集标题) / page / duration）。
- */
-export function selectVideoPart(viewData, pageNum) {
-    const pages = Array.isArray(viewData?.pages) ? viewData.pages : null;
-    if (!pages || pages.length === 0) {
-        throw new CommandExecutionError('Bilibili view API did not return pages[] for --page selection');
-    }
-    const matches = [];
-    for (const entry of pages) {
-        if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
-            throw new CommandExecutionError('Bilibili view API returned a malformed pages[] entry');
-        }
-        const apiPage = readApiPositiveInteger(entry.page, 'page number');
-        if (apiPage === pageNum) {
-            matches.push(entry);
-        }
-    }
-    if (matches.length > 1) {
-        throw new CommandExecutionError(`Bilibili view API returned duplicate page entries for p=${pageNum}`);
-    }
-    const part = matches[0];
-    if (!part) {
-        const total = pages.length || viewData?.videos || 1;
-        throw new CommandExecutionError(`分P 序号超出范围：p=${pageNum}（该视频共 ${total} 集）`);
-    }
-    readApiPositiveInteger(part.cid, `cid for p=${pageNum}`);
-    return part;
-}
-
-const MIXIN_KEY_ENC_TAB = [
-    46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49,
-    33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13, 37, 48, 7, 16, 24, 55, 40,
-    61, 26, 17, 0, 1, 60, 51, 30, 4, 22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11,
-    36, 20, 34, 44, 52,
-];
-export function stripHtml(s) {
-    return s.replace(/<[^>]+>/g, '').replace(/&[a-z]+;/gi, ' ').trim();
-}
-export function payloadData(payload) {
-    return payload?.data ?? payload;
-}
-async function getNavData(page) {
-    return page.evaluate(`
-    async () => {
-      const res = await fetch('https://api.bilibili.com/x/web-interface/nav', { credentials: 'include' });
-      return await res.json();
-    }
-  `);
-}
-async function getWbiKeys(page) {
-    const nav = await getNavData(page);
-    const wbiImg = nav?.data?.wbi_img ?? {};
-    const imgUrl = wbiImg.img_url ?? '';
-    const subUrl = wbiImg.sub_url ?? '';
-    const imgKey = imgUrl.split('/').pop()?.split('.')[0] ?? '';
-    const subKey = subUrl.split('/').pop()?.split('.')[0] ?? '';
-    return { imgKey, subKey };
-}
-function getMixinKey(imgKey, subKey) {
-    const raw = imgKey + subKey;
-    return MIXIN_KEY_ENC_TAB.map(i => raw[i] || '').join('').slice(0, 32);
-}
-async function md5(text) {
-    const { createHash } = await import('node:crypto');
-    return createHash('md5').update(text).digest('hex');
-}
-export async function wbiSign(page, params) {
-    const { imgKey, subKey } = await getWbiKeys(page);
-    const mixinKey = getMixinKey(imgKey, subKey);
-    const wts = Math.floor(Date.now() / 1000);
-    const sorted = {};
-    const allParams = { ...params, wts: String(wts) };
-    for (const key of Object.keys(allParams).sort()) {
-        sorted[key] = String(allParams[key]).replace(/[!'()*]/g, '');
-    }
-    // Bilibili WBI verification expects %20 for spaces, not + (URLSearchParams default).
-    // Using + causes signature mismatch → CORS-blocked error response → TypeError: Failed to fetch.
-    const query = new URLSearchParams(sorted).toString().replace(/\+/g, '%20');
-    const wRid = await md5(query + mixinKey);
-    sorted.w_rid = wRid;
-    return sorted;
-}
-export async function apiGet(page, path, opts = {}) {
-    const baseUrl = 'https://api.bilibili.com';
-    let params = opts.params ?? {};
-    if (opts.signed) {
-        params = await wbiSign(page, params);
-    }
-    const qs = new URLSearchParams(Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)]))).toString().replace(/\+/g, '%20');
-    const url = `${baseUrl}${path}?${qs}`;
-    return fetchJson(page, url);
-}
-export async function fetchJson(page, url) {
-    const urlJs = JSON.stringify(url);
-    return page.evaluate(`
-    async () => {
-      const res = await fetch(${urlJs}, { credentials: "include" });
-      return await res.json();
-    }
-  `);
-}
-/**
- * Bilibili write APIs return a JSON envelope `{ code, message, data }`. A non-zero
- * `code` carries either an auth/permission failure (login expired, CSRF rejected,
- * forbidden) or an application-level error (rate limit, validation, etc.). These
- * two helpers route the envelope to the right typed error so every write adapter
- * surfaces login problems as `AuthRequiredError`, not a generic execution error.
- */
-export function isAuthLikeBilibiliError(code, message) {
-    return code === -101 || code === -111 || code === -403 || /csrf|登录|账号|权限|forbidden|permission|login/i.test(String(message ?? ''));
-}
-
-export function requireOkPayload(payload, label) {
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload) || !Object.hasOwn(payload, 'code')) {
-        throw new CommandExecutionError(`Bilibili ${label} API returned a malformed payload`);
-    }
-    if (payload.code !== 0) {
-        const message = payload.message ?? 'unknown error';
-        if (isAuthLikeBilibiliError(payload.code, message)) {
-            throw new AuthRequiredError('bilibili.com', `Bilibili ${label} API requires login or permission: ${message} (${payload.code})`);
-        }
-        throw new CommandExecutionError(`Bilibili ${label} API failed: ${message} (${payload.code})`);
-    }
-    return payload.data;
-}
-
-/**
- * POST form-encoded params to a Bilibili API endpoint.
- * Runs inside the logged-in browser context and auto-attaches the bili_jct CSRF token,
- * which Bilibili requires on every authenticated write request.
- */
-export async function apiPost(page, path, opts = {}) {
-    const params = opts.params ?? {};
-    const stringified = Object.fromEntries(Object.entries(params).map(([k, v]) => [k, String(v)]));
-    const paramsJs = JSON.stringify(stringified);
-    const urlJs = JSON.stringify(`https://api.bilibili.com${path}`);
-    return page.evaluate(`
-    async () => {
-      const csrf = (document.cookie.match(/bili_jct=([^;]+)/) || [])[1] || "";
-      const body = new URLSearchParams(${paramsJs});
-      body.set("csrf", csrf);
-      const res = await fetch(${urlJs}, {
-        method: "POST",
-        credentials: "include",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
-        body: body.toString(),
-      });
-      // Bilibili write endpoints can return an HTML risk-control page (e.g. HTTP 412)
-      // instead of JSON. Surface that as a structured error rather than a parse crash.
-      const text = await res.text();
-      try {
-        return JSON.parse(text);
-      } catch {
-        return { code: -1, message: "Non-JSON response (HTTP " + res.status + "): " + text.slice(0, 200) };
-      }
-    }
-  `);
-}
-export async function getSelfUid(page) {
-    const nav = await getNavData(page);
-    const mid = nav?.data?.mid;
-    if (!mid)
-        throw new AuthRequiredError('bilibili.com');
-    return String(mid);
-}
-export async function resolveUid(page, input) {
-    if (/^\d+$/.test(input))
-        return input;
-    // Search for user by name
-    const payload = await apiGet(page, '/x/web-interface/wbi/search/type', {
-        params: { search_type: 'bili_user', keyword: input },
-        signed: true,
-    });
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload) || !payload.data || typeof payload.data !== 'object' || Array.isArray(payload.data) || !Object.hasOwn(payload.data, 'result')) {
-        throw new CommandExecutionError(`Bilibili user search returned malformed result for ${input}`);
-    }
-    const results = payload.data.result;
-    if (!Array.isArray(results)) {
-        throw new CommandExecutionError(`Bilibili user search returned malformed result for ${input}`);
-    }
-    if (results.length > 0) {
-        const mid = String(results[0]?.mid ?? '').trim();
-        if (!mid) {
-            throw new CommandExecutionError(`Bilibili user search returned malformed mid for ${input}`);
-        }
-        return mid;
-    }
-    throw new EmptyResultError(`bilibili user search: ${input}`, 'User may not exist or username may have changed.');
-}