@sovovs/bycli 1.8.0 → 2.0.0

package/clis/douyin/profile.test.js

@@ -1,46 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-const { browserFetchMock } = vi.hoisted(() => ({
-    browserFetchMock: vi.fn(),
-}));
-vi.mock('./_shared/browser-fetch.js', () => ({
-    browserFetch: browserFetchMock,
-}));
-import { getRegistry } from '@sovovs/bycli/registry';
-import './profile.js';
-describe('douyin profile registration', () => {
-    beforeEach(() => {
-        browserFetchMock.mockReset();
-    });
-    it('registers the profile command', () => {
-        const registry = getRegistry();
-        const values = [...registry.values()];
-        const cmd = values.find(c => c.site === 'douyin' && c.name === 'profile');
-        expect(cmd).toBeDefined();
-    });
-    it('maps the current user payload shape returned by creator center', async () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find(c => c.site === 'douyin' && c.name === 'profile');
-        expect(cmd?.func).toBeDefined();
-        if (!cmd?.func)
-            throw new Error('douyin profile command not registered');
-        browserFetchMock.mockResolvedValueOnce({
-            user: {
-                uid: '100',
-                nickname: 'creator',
-                follower_count: 12,
-                following_count: 3,
-                aweme_count: 7,
-            },
-        });
-        const rows = await cmd.func({}, {});
-        expect(rows).toEqual([
-            {
-                uid: '100',
-                nickname: 'creator',
-                follower_count: 12,
-                following_count: 3,
-                aweme_count: 7,
-            },
-        ]);
-    });
-});

package/clis/douyin/publish-upload-id.test.js

@@ -1,170 +0,0 @@
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-
-const mocks = vi.hoisted(() => ({
-  browserFetch: vi.fn(),
-  getUploadAuthV5Credentials: vi.fn(),
-  applyVideoUploadInner: vi.fn(),
-  commitVideoUploadInner: vi.fn(),
-  tosUpload: vi.fn(),
-  pollTranscode: vi.fn(),
-  imagexUpload: vi.fn(),
-}));
-
-vi.mock('./_shared/browser-fetch.js', () => ({ browserFetch: mocks.browserFetch }));
-vi.mock('./_shared/vod-upload.js', () => ({
-  getUploadAuthV5Credentials: mocks.getUploadAuthV5Credentials,
-  applyVideoUploadInner: mocks.applyVideoUploadInner,
-  commitVideoUploadInner: mocks.commitVideoUploadInner,
-}));
-vi.mock('./_shared/tos-upload.js', () => ({ tosUpload: mocks.tosUpload }));
-vi.mock('./_shared/transcode.js', () => ({ pollTranscode: mocks.pollTranscode }));
-vi.mock('./_shared/imagex-upload.js', () => ({ imagexUpload: mocks.imagexUpload }));
-
-describe('douyin publish upload identifier handling', () => {
-  beforeEach(() => {
-    vi.resetModules();
-    vi.clearAllMocks();
-    mocks.getUploadAuthV5Credentials.mockResolvedValue({ access_key_id: 'ak', secret_access_key: 'sk', session_token: 'token' });
-    mocks.applyVideoUploadInner.mockResolvedValue({ video_id: 'apply-video-id', tos_upload_url: 'https://tos.example.com/bucket/key', auth: 'auth', session_key: 'session-key' });
-    mocks.commitVideoUploadInner.mockResolvedValue({ video_id: 'canonical-video-id', poster_uri: 'poster-uri' });
-    mocks.tosUpload.mockResolvedValue('object-key-returned-by-complete');
-    mocks.pollTranscode.mockResolvedValue({ width: 720, height: 1280, poster_uri: 'poster-uri' });
-    mocks.browserFetch.mockImplementation(async (_page, method, url) => {
-      if (method === 'POST' && String(url).includes('/aweme/create_v2/')) return { aweme_id: 'aweme-1' };
-      return { status_code: 0 };
-    });
-  });
-
-  it('uses CommitUploadInner Vid for create_v2, not the completed TOS object key', async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'douyin-publish-id-'));
-    const video = path.join(tmpDir, 'video.mp4');
-    fs.writeFileSync(video, Buffer.from('fake-video'));
-
-    const { getRegistry } = await import('@sovovs/bycli/registry');
-    getRegistry().delete('douyin/publish');
-    await import('./publish.js');
-    const cmd = getRegistry().get('douyin/publish');
-    if (!cmd) throw new Error('douyin publish command not registered');
-
-    await cmd.func({}, {
-      video,
-      title: 'byCLI自测',
-      schedule: new Date(Date.now() + 3 * 60 * 60 * 1000).toISOString(),
-      caption: '',
-      visibility: 'private',
-      no_safety_check: true,
-    });
-
-    expect(mocks.commitVideoUploadInner).toHaveBeenCalledWith(
-      { video_id: 'apply-video-id', tos_upload_url: 'https://tos.example.com/bucket/key', auth: 'auth', session_key: 'session-key' },
-      { access_key_id: 'ak', secret_access_key: 'sk', session_token: 'token' },
-    );
-    expect(mocks.pollTranscode).not.toHaveBeenCalled();
-    const createCall = mocks.browserFetch.mock.calls.find((call) => String(call[2]).includes('/aweme/create_v2/'));
-    expect(createCall?.[3]?.body.item.common.video_id).toBe('canonical-video-id');
-    expect(createCall?.[3]?.body.item.common.video_id).not.toBe('object-key-returned-by-complete');
-  });
-
-  it('continues to create_v2 when the legacy fast detect API returns an empty response', async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'douyin-publish-safety-'));
-    const video = path.join(tmpDir, 'video.mp4');
-    fs.writeFileSync(video, Buffer.from('fake-video'));
-    mocks.browserFetch.mockImplementation(async (_page, method, url) => {
-      if (method === 'POST' && String(url).includes('/post_assistant/fast_detect/pre_check')) {
-        throw new Error('Empty response from Douyin API (POST https://creator.douyin.com/aweme/v1/post_assistant/fast_detect/pre_check)');
-      }
-      if (method === 'POST' && String(url).includes('/post_assistant/fast_detect/poll')) return { status: -1, has_done: true, detect_result: { reason_code: 0 }, detect_list: [] };
-      if (method === 'POST' && String(url).includes('/aweme/create_v2/')) return { item_id: 'item-1' };
-      return { status_code: 0 };
-    });
-
-    const { getRegistry } = await import('@sovovs/bycli/registry');
-    getRegistry().delete('douyin/publish');
-    await import('./publish.js');
-    const cmd = getRegistry().get('douyin/publish');
-    if (!cmd) throw new Error('douyin publish command not registered');
-
-    await cmd.func({}, {
-      video,
-      title: 'byCLI自测',
-      schedule: new Date(Date.now() + 3 * 60 * 60 * 1000).toISOString(),
-      visibility: 'public',
-      caption: 'caption',
-      no_safety_check: false,
-    });
-
-    expect(mocks.browserFetch.mock.calls.some((call) => String(call[2]).includes('/post_assistant/fast_detect/pre_check'))).toBe(true);
-    expect(mocks.browserFetch.mock.calls.some((call) => String(call[2]).includes('/aweme/create_v2/'))).toBe(true);
-  });
-
-  it('unwraps Browser Bridge envelopes around cover ImageX evaluate results', async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'douyin-publish-cover-'));
-    const video = path.join(tmpDir, 'video.mp4');
-    const cover = path.join(tmpDir, 'cover.jpg');
-    fs.writeFileSync(video, Buffer.from('fake-video'));
-    fs.writeFileSync(cover, Buffer.from('fake-cover'));
-    mocks.imagexUpload.mockResolvedValue('cover-store-uri');
-
-    const page = {
-      evaluate: vi.fn()
-        .mockResolvedValueOnce({
-          session: 'site:douyin:test',
-          data: { Result: { UploadAddress: { StoreInfos: [{ UploadHost: 'imagex.example.com', StoreUri: 'cover/key.jpg' }] } } },
-        })
-        .mockResolvedValueOnce({ session: 'site:douyin:test', data: { Result: {} } }),
-    };
-
-    const { getRegistry } = await import('@sovovs/bycli/registry');
-    getRegistry().delete('douyin/publish');
-    await import('./publish.js');
-    const cmd = getRegistry().get('douyin/publish');
-    if (!cmd) throw new Error('douyin publish command not registered');
-
-    await cmd.func(page, {
-      video,
-      cover,
-      title: 'byCLI自测',
-      schedule: new Date(Date.now() + 3 * 60 * 60 * 1000).toISOString(),
-      caption: '',
-      visibility: 'private',
-      no_safety_check: true,
-    });
-
-    expect(mocks.imagexUpload).toHaveBeenCalledWith(cover, {
-      upload_url: 'https://imagex.example.com/cover/key.jpg',
-      store_uri: 'cover/key.jpg',
-    });
-    const createCall = mocks.browserFetch.mock.calls.find((call) => String(call[2]).includes('/aweme/create_v2/'));
-    expect(createCall?.[3]?.body.item.cover.poster).toBe('cover-store-uri');
-  });
-
-  it('throws typed when cover ImageX apply returns the wrong shape', async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'douyin-publish-cover-bad-'));
-    const video = path.join(tmpDir, 'video.mp4');
-    const cover = path.join(tmpDir, 'cover.jpg');
-    fs.writeFileSync(video, Buffer.from('fake-video'));
-    fs.writeFileSync(cover, Buffer.from('fake-cover'));
-
-    const page = { evaluate: vi.fn().mockResolvedValueOnce({ session: 'site:douyin:test', data: { Result: { UploadAddress: { StoreInfos: [] } } } }) };
-
-    const { getRegistry } = await import('@sovovs/bycli/registry');
-    getRegistry().delete('douyin/publish');
-    await import('./publish.js');
-    const cmd = getRegistry().get('douyin/publish');
-    if (!cmd) throw new Error('douyin publish command not registered');
-
-    await expect(cmd.func(page, {
-      video,
-      cover,
-      title: 'byCLI自测',
-      schedule: new Date(Date.now() + 3 * 60 * 60 * 1000).toISOString(),
-      caption: '',
-      visibility: 'private',
-      no_safety_check: true,
-    })).rejects.toThrow('UploadHost/StoreUri');
-    expect(mocks.imagexUpload).not.toHaveBeenCalled();
-  });
-});

package/clis/douyin/publish.test.js

@@ -1,38 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './publish.js';
-describe('douyin publish registration', () => {
-    it('registers the publish command', () => {
-        const registry = getRegistry();
-        const cmds = [...registry.values()];
-        const cmd = cmds.find((c) => c.site === 'douyin' && c.name === 'publish');
-        expect(cmd).toBeDefined();
-        expect(cmd?.args.some((a) => a.name === 'video')).toBe(true);
-        expect(cmd?.args.some((a) => a.name === 'title')).toBe(true);
-        expect(cmd?.args.some((a) => a.name === 'schedule')).toBe(true);
-    });
-    it('has all expected args', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find((c) => c.site === 'douyin' && c.name === 'publish');
-        const argNames = cmd?.args.map((a) => a.name) ?? [];
-        expect(argNames).toContain('video');
-        expect(argNames).toContain('title');
-        expect(argNames).toContain('schedule');
-        expect(argNames).toContain('caption');
-        expect(argNames).toContain('cover');
-        expect(argNames).toContain('visibility');
-        expect(argNames).toContain('allow_download');
-        expect(argNames).toContain('collection');
-        expect(argNames).toContain('activity');
-        expect(argNames).toContain('poi_id');
-        expect(argNames).toContain('poi_name');
-        expect(argNames).toContain('hotspot');
-        expect(argNames).toContain('no_safety_check');
-        expect(argNames).toContain('sync_toutiao');
-    });
-    it('uses COOKIE strategy', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find((c) => c.site === 'douyin' && c.name === 'publish');
-        expect(cmd?.strategy).toBe('cookie');
-    });
-});

package/clis/douyin/stats.test.js

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './stats.js';
-describe('douyin stats registration', () => {
-    it('registers the stats command', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find(c => c.site === 'douyin' && c.name === 'stats');
-        expect(cmd).toBeDefined();
-        expect(cmd?.args.some(a => a.name === 'aweme_id')).toBe(true);
-    });
-    it('has expected columns', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find(c => c.site === 'douyin' && c.name === 'stats');
-        expect(cmd?.columns).toContain('metric');
-        expect(cmd?.columns).toContain('value');
-    });
-    it('uses COOKIE strategy', () => {
-        const registry = getRegistry();
-        const cmd = [...registry.values()].find(c => c.site === 'douyin' && c.name === 'stats');
-        expect(cmd?.strategy).toBe('cookie');
-    });
-});

package/clis/douyin/update.test.js

@@ -1,11 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './update.js';
-describe('douyin update registration', () => {
-    it('registers the update command', () => {
-        const registry = getRegistry();
-        const values = [...registry.values()];
-        const cmd = values.find(c => c.site === 'douyin' && c.name === 'update');
-        expect(cmd).toBeDefined();
-    });
-});

package/clis/douyin/user-videos.test.js

@@ -1,151 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-const { fetchDouyinUserVideosMock, fetchDouyinCommentsMock } = vi.hoisted(() => ({
-    fetchDouyinUserVideosMock: vi.fn(),
-    fetchDouyinCommentsMock: vi.fn(),
-}));
-vi.mock('./_shared/public-api.js', () => ({
-    fetchDouyinUserVideos: fetchDouyinUserVideosMock,
-    fetchDouyinComments: fetchDouyinCommentsMock,
-}));
-import { getRegistry } from '@sovovs/bycli/registry';
-import { CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-import { DEFAULT_COMMENT_LIMIT, MAX_USER_VIDEOS_LIMIT, normalizeCommentLimit, normalizeUserVideosLimit } from './user-videos.js';
-describe('douyin user-videos', () => {
-    beforeEach(() => {
-        fetchDouyinUserVideosMock.mockReset();
-        fetchDouyinCommentsMock.mockReset();
-    });
-    it('registers the command', () => {
-        const registry = getRegistry();
-        const values = [...registry.values()];
-        const command = values.find((cmd) => cmd.site === 'douyin' && cmd.name === 'user-videos');
-        expect(command).toBeDefined();
-    });
-    it('clamps limit to a safe maximum', () => {
-        expect(normalizeUserVideosLimit(100)).toBe(MAX_USER_VIDEOS_LIMIT);
-        expect(normalizeUserVideosLimit(0)).toBe(1);
-        expect(normalizeCommentLimit(99)).toBe(DEFAULT_COMMENT_LIMIT);
-    });
-    it('uses shared public-api helpers and applies clamped limits', async () => {
-        const registry = getRegistry();
-        const command = [...registry.values()].find((cmd) => cmd.site === 'douyin' && cmd.name === 'user-videos');
-        expect(command?.func).toBeDefined();
-        if (!command?.func)
-            throw new Error('douyin user-videos command not registered');
-        fetchDouyinUserVideosMock.mockResolvedValueOnce([
-            {
-                aweme_id: '1',
-                desc: 'test video',
-                video: { duration: 1234, play_addr: { url_list: ['https://example.com/video.mp4'] } },
-                statistics: { digg_count: 9 },
-            },
-        ]);
-        fetchDouyinCommentsMock.mockResolvedValueOnce([
-            { text: 'nice', digg_count: 3, nickname: 'alice' },
-        ]);
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-        };
-        const rows = await command.func(page, {
-            sec_uid: 'MS4w-test',
-            limit: 100,
-            comment_limit: 99,
-            with_comments: true,
-        });
-        expect(fetchDouyinUserVideosMock).toHaveBeenCalledWith(page, 'MS4w-test', MAX_USER_VIDEOS_LIMIT);
-        expect(fetchDouyinCommentsMock).toHaveBeenCalledWith(page, '1', DEFAULT_COMMENT_LIMIT);
-        expect(rows).toEqual([
-            {
-                index: 1,
-                aweme_id: '1',
-                title: 'test video',
-                duration: 1,
-                digg_count: 9,
-                play_url: 'https://example.com/video.mp4',
-                top_comments: [
-                    { text: 'nice', digg_count: 3, nickname: 'alice' },
-                ],
-            },
-        ]);
-    });
-    it('skips comment enrichment when with_comments is false', async () => {
-        const registry = getRegistry();
-        const command = [...registry.values()].find((cmd) => cmd.site === 'douyin' && cmd.name === 'user-videos');
-        expect(command?.func).toBeDefined();
-        if (!command?.func)
-            throw new Error('douyin user-videos command not registered');
-        fetchDouyinUserVideosMock.mockResolvedValueOnce([
-            {
-                aweme_id: '2',
-                desc: 'plain video',
-                video: { duration: 2000, play_addr: { url_list: ['https://example.com/plain.mp4'] } },
-                statistics: { digg_count: 1 },
-            },
-        ]);
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-        };
-        const rows = await command.func(page, {
-            sec_uid: 'MS4w-test',
-            limit: 3,
-            with_comments: false,
-            comment_limit: 5,
-        });
-        expect(fetchDouyinCommentsMock).not.toHaveBeenCalled();
-        expect(rows).toEqual([
-            {
-                index: 1,
-                aweme_id: '2',
-                title: 'plain video',
-                duration: 2,
-                digg_count: 1,
-                play_url: 'https://example.com/plain.mp4',
-                top_comments: [],
-            },
-        ]);
-    });
-    it('throws EmptyResultError when the user videos API returns no rows', async () => {
-        const command = [...getRegistry().values()].find((cmd) => cmd.site === 'douyin' && cmd.name === 'user-videos');
-        expect(command?.func).toBeDefined();
-        if (!command?.func)
-            throw new Error('douyin user-videos command not registered');
-        fetchDouyinUserVideosMock.mockResolvedValueOnce([]);
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-        };
-        await expect(command.func(page, {
-            sec_uid: 'MS4w-empty',
-            limit: 3,
-            with_comments: true,
-            comment_limit: 5,
-        })).rejects.toBeInstanceOf(EmptyResultError);
-    });
-    it('surfaces comment enrichment failures instead of returning empty comments', async () => {
-        const command = [...getRegistry().values()].find((cmd) => cmd.site === 'douyin' && cmd.name === 'user-videos');
-        expect(command?.func).toBeDefined();
-        if (!command?.func)
-            throw new Error('douyin user-videos command not registered');
-        fetchDouyinUserVideosMock.mockResolvedValueOnce([
-            {
-                aweme_id: '3',
-                desc: 'comment failure',
-                video: { duration: 2000, play_addr: { url_list: ['https://example.com/fail.mp4'] } },
-                statistics: { digg_count: 1 },
-            },
-        ]);
-        fetchDouyinCommentsMock.mockRejectedValueOnce(new Error('comment API down'));
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-        };
-        await expect(command.func(page, {
-            sec_uid: 'MS4w-test',
-            limit: 3,
-            with_comments: true,
-            comment_limit: 5,
-        })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-});

package/clis/douyin/videos.test.js

@@ -1,54 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-const { browserFetchMock } = vi.hoisted(() => ({
-    browserFetchMock: vi.fn(),
-}));
-vi.mock('./_shared/browser-fetch.js', () => ({
-    browserFetch: browserFetchMock,
-}));
-import { getRegistry } from '@sovovs/bycli/registry';
-import './videos.js';
-describe('douyin videos', () => {
-    beforeEach(() => {
-        browserFetchMock.mockReset();
-    });
-    it('registers the videos command', () => {
-        const registry = getRegistry();
-        const values = [...registry.values()];
-        const cmd = values.find(c => c.site === 'douyin' && c.name === 'videos');
-        expect(cmd).toBeDefined();
-    });
-    it('parses the current creator work_list api shape', async () => {
-        const registry = getRegistry();
-        const command = [...registry.values()].find((cmd) => cmd.site === 'douyin' && cmd.name === 'videos');
-        expect(command?.func).toBeDefined();
-        if (!command?.func)
-            throw new Error('douyin videos command not registered');
-        browserFetchMock.mockResolvedValueOnce({
-            aweme_list: [
-                {
-                    aweme_id: '7000000000000000001',
-                    desc: '测试视频标题',
-                    create_time: 1581571130,
-                    statistics: {
-                        play_count: 0,
-                        digg_count: 12,
-                    },
-                    status: {
-                        is_private: true,
-                    },
-                },
-            ],
-        });
-        const rows = await command.func({}, { limit: 5, page: 1, status: 'all' });
-        expect(rows).toEqual([
-            {
-                aweme_id: '7000000000000000001',
-                title: '测试视频标题',
-                status: 'private',
-                play_count: 0,
-                digg_count: 12,
-                create_time: new Date(1581571130 * 1000).toLocaleString('zh-CN', { timeZone: 'Asia/Tokyo' }),
-            },
-        ]);
-    });
-});

package/clis/duckduckgo/search.test.js

@@ -1,128 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { JSDOM } from 'jsdom';
-
-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('duckduckgo search', () => {
-  it('should register as a valid command', () => {
-    expect(command).toBeDefined();
-    expect(command.site).toBe('duckduckgo');
-    expect(command.name).toBe('search');
-    expect(command.access).toBe('read');
-    expect(command.browser).toBe(true);
-    expect(command.strategy).toBe('public');
-    expect(command.domain).toBe('html.duckduckgo.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 10', () => {
-    const limitArg = command.args.find(a => a.name === 'limit');
-    expect(limitArg).toBeDefined();
-    expect(limitArg.type).toBe('int');
-    expect(limitArg.default).toBe(10);
-  });
-
-  it('should define columns for output', () => {
-    expect(command.columns).toContain('rank');
-    expect(command.columns).toContain('title');
-    expect(command.columns).toContain('url');
-    expect(command.columns).toContain('snippet');
-    expect(command.columns).toContain('displayUrl');
-    expect(command.columns).toContain('icon');
-    expect(command.columns).toContain('resultType');
-  });
-
-  it('rejects empty query and out-of-range pagination 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: 11 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    await expect(command.func(page, { keyword: 'opencli', limit: 5, offset: 5 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    expect(page.goto).not.toHaveBeenCalled();
-  });
-
-  it('decodes DuckDuckGo redirect URLs and assigns listing rank', async () => {
-    const page = createPageMock([
-      [
-        'OpenCLI',
-        '/l/?uddg=https%3A%2F%2Fgithub.com%2Fjackwener%2FOpenCLI',
-        'CLI browser tooling',
-        'github.com/jackwener/OpenCLI',
-        '',
-        'web',
-      ],
-    ]);
-
-    await expect(command.func(page, { keyword: 'opencli', limit: 1 })).resolves.toEqual([{
-      rank: 1,
-      title: 'OpenCLI',
-      url: 'https://github.com/jackwener/OpenCLI',
-      snippet: 'CLI browser tooling',
-      displayUrl: 'github.com/jackwener/OpenCLI',
-      icon: '',
-      resultType: 'web',
-    }]);
-  });
-
-  it('executes the DOM extractor, filters ads, and returns canonical rows', async () => {
-    const dom = new JSDOM(`
-      <div class="result result--ad">
-        <a class="result__a" href="https://ads.example/">Sponsored result</a>
-      </div>
-      <div class="result">
-        <a class="result__a" href="/l/?uddg=https%3A%2F%2Fexample.com%2Farticle">Organic result</a>
-        <a class="result__snippet">Organic snippet</a>
-        <span class="result__url">example.com/article</span>
-        <img class="result__icon__img" src="https://icons.duckduckgo.com/ip3/example.com.ico">
-      </div>
-    `);
-    const page = {
-      goto: vi.fn().mockResolvedValue(undefined),
-      wait: vi.fn().mockResolvedValue(undefined),
-      evaluate: vi.fn(async (source) => Function('document', `return ${source};`)(dom.window.document)),
-    };
-
-    await expect(command.func(page, { keyword: 'opencli', limit: 5 })).resolves.toEqual([{
-      rank: 1,
-      title: 'Organic result',
-      url: 'https://example.com/article',
-      snippet: 'Organic snippet',
-      displayUrl: 'example.com/article',
-      icon: 'https://icons.duckduckgo.com/ip3/example.com.ico',
-      resultType: 'web',
-    }]);
-  });
-
-  it('unwraps browser envelopes for paginated extraction', async () => {
-    const page = createPageMock({ session: 'site:duckduckgo', data: [
-      ['Result', 'https://example.com/', 'snippet', 'example.com', '', 'web'],
-    ] });
-
-    const result = await command.func(page, { keyword: 'opencli', limit: 1, offset: 10 });
-
-    expect(result[0]).toMatchObject({ rank: 11, url: 'https://example.com/' });
-  });
-
-  it('fails typed instead of 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'),
-    });
-  });
-});