@jackwener/opencli 1.6.1 → 1.6.2

package/dist/clis/twitter/reply.test.js

@@ -0,0 +1,151 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { __test__ } from './reply.js';
+function createPageMock(evaluateResults, overrides = {}) {
+    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),
+        ...overrides,
+    };
+}
+describe('twitter reply command', () => {
+    it('keeps the text-only reply flow working', async () => {
+        const cmd = getRegistry().get('twitter/reply');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            { ok: true, message: 'Reply posted successfully.' },
+        ]);
+        const result = await cmd.func(page, {
+            url: 'https://x.com/_kop6/status/2040254679301718161?s=20',
+            text: 'text-only reply',
+        });
+        expect(page.goto).toHaveBeenCalledWith('https://x.com/_kop6/status/2040254679301718161?s=20');
+        expect(page.wait).toHaveBeenCalledWith({ selector: '[data-testid="primaryColumn"]' });
+        expect(result).toEqual([
+            {
+                status: 'success',
+                message: 'Reply posted successfully.',
+                text: 'text-only reply',
+            },
+        ]);
+    });
+    it('uploads a local image through the dedicated reply composer when --image is provided', async () => {
+        const cmd = getRegistry().get('twitter/reply');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-twitter-reply-'));
+        const imagePath = path.join(tempDir, 'qr.png');
+        fs.writeFileSync(imagePath, Buffer.from([0x89, 0x50, 0x4e, 0x47]));
+        const setFileInput = vi.fn().mockResolvedValue(undefined);
+        const page = createPageMock([
+            { ok: true, previewCount: 1 },
+            { ok: true, message: 'Reply posted successfully.' },
+        ], {
+            setFileInput,
+        });
+        const result = await cmd.func(page, {
+            url: 'https://x.com/_kop6/status/2040254679301718161?s=20',
+            text: 'reply with image',
+            image: imagePath,
+        });
+        expect(page.goto).toHaveBeenCalledWith('https://x.com/compose/post?in_reply_to=2040254679301718161');
+        expect(page.wait).toHaveBeenNthCalledWith(1, { selector: '[data-testid="tweetTextarea_0"]' });
+        expect(page.wait).toHaveBeenNthCalledWith(2, { selector: 'input[type="file"][data-testid="fileInput"]', timeout: 20 });
+        expect(setFileInput).toHaveBeenCalledWith([imagePath], 'input[type="file"][data-testid="fileInput"]');
+        expect(result).toEqual([
+            {
+                status: 'success',
+                message: 'Reply posted successfully.',
+                text: 'reply with image',
+                image: imagePath,
+            },
+        ]);
+    });
+    it('downloads a remote image before uploading when --image-url is provided', async () => {
+        const cmd = getRegistry().get('twitter/reply');
+        expect(cmd?.func).toBeTypeOf('function');
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            headers: {
+                get: vi.fn().mockReturnValue('image/png'),
+            },
+            arrayBuffer: vi.fn().mockResolvedValue(Uint8Array.from([0x89, 0x50, 0x4e, 0x47]).buffer),
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const setFileInput = vi.fn().mockResolvedValue(undefined);
+        const page = createPageMock([
+            { ok: true, previewCount: 1 },
+            { ok: true, message: 'Reply posted successfully.' },
+        ], {
+            setFileInput,
+        });
+        const result = await cmd.func(page, {
+            url: 'https://x.com/_kop6/status/2040254679301718161?s=20',
+            text: 'reply with remote image',
+            'image-url': 'https://example.com/qr',
+        });
+        expect(fetchMock).toHaveBeenCalledWith('https://example.com/qr');
+        expect(setFileInput).toHaveBeenCalledTimes(1);
+        const uploadedPath = setFileInput.mock.calls[0][0][0];
+        expect(uploadedPath).toMatch(/opencli-twitter-reply-.*\/image\.png$/);
+        expect(fs.existsSync(uploadedPath)).toBe(false);
+        expect(result).toEqual([
+            {
+                status: 'success',
+                message: 'Reply posted successfully.',
+                text: 'reply with remote image',
+                'image-url': 'https://example.com/qr',
+            },
+        ]);
+        vi.unstubAllGlobals();
+    });
+    it('rejects invalid image paths early', async () => {
+        await expect(() => __test__.resolveImagePath('/tmp/does-not-exist.png'))
+            .toThrow('Image file not found');
+    });
+    it('rejects using --image and --image-url together', async () => {
+        const cmd = getRegistry().get('twitter/reply');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([]);
+        await expect(cmd.func(page, {
+            url: 'https://x.com/_kop6/status/2040254679301718161?s=20',
+            text: 'nope',
+            image: '/tmp/a.png',
+            'image-url': 'https://example.com/a.png',
+        })).rejects.toThrow('Use either --image or --image-url, not both.');
+    });
+    it('extracts tweet ids from both user and i/status URLs', () => {
+        expect(__test__.extractTweetId('https://x.com/_kop6/status/2040254679301718161?s=20')).toBe('2040254679301718161');
+        expect(__test__.extractTweetId('https://x.com/i/status/2040318731105313143')).toBe('2040318731105313143');
+        expect(__test__.buildReplyComposerUrl('https://x.com/i/status/2040318731105313143'))
+            .toBe('https://x.com/compose/post?in_reply_to=2040318731105313143');
+    });
+    it('prefers content-type when resolving remote image extensions', () => {
+        expect(__test__.resolveImageExtension('https://example.com/no-ext', 'image/webp')).toBe('.webp');
+        expect(__test__.resolveImageExtension('https://example.com/a.jpeg?x=1', null)).toBe('.jpeg');
+    });
+});

package/dist/clis/xianyu/chat.d.ts

@@ -0,0 +1,7 @@
+import { normalizeNumericId } from './utils.js';
+declare function buildChatUrl(itemId: string, peerUserId: string): string;
+export declare const __test__: {
+    normalizeNumericId: typeof normalizeNumericId;
+    buildChatUrl: typeof buildChatUrl;
+};
+export {};

package/dist/clis/xianyu/chat.js

@@ -0,0 +1,146 @@
+import { AuthRequiredError, SelectorError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { normalizeNumericId } from './utils.js';
+function buildChatUrl(itemId, peerUserId) {
+    return `https://www.goofish.com/im?itemId=${encodeURIComponent(itemId)}&peerUserId=${encodeURIComponent(peerUserId)}`;
+}
+function buildExtractChatStateEvaluate() {
+    return `
+    (() => {
+      const clean = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const bodyText = document.body?.innerText || '';
+      const requiresAuth = /请先登录|登录后/.test(bodyText);
+
+      const textarea = document.querySelector('textarea');
+      const sendButton = Array.from(document.querySelectorAll('button'))
+        .find((btn) => clean(btn.textContent || '') === '发送');
+      const topbar = document.querySelector('[class*="message-topbar"]');
+      const itemCard = Array.from(document.querySelectorAll('a[href*="/item?id="]'))
+        .find((el) => el.closest('main'));
+      const itemTitleNode =
+        document.querySelector('[class*="container"] [class*="title"]')
+        || document.querySelector('[class*="item-main-info"] [class*="desc"]')
+        || document.querySelector('[class*="headSkuInfo"]')
+        || itemCard?.querySelector('[class*="title"]')
+        || itemCard?.previousElementSibling?.querySelector?.('[class*="title"]');
+
+      const messageRoot = document.querySelector('#message-list-scrollable');
+      const visibleMessages = Array.from(
+        (messageRoot || document).querySelectorAll('[class*="message"], [class*="msg"], [class*="bubble"]')
+      ).map((el) => clean(el.textContent || ''))
+        .filter(Boolean)
+        .filter((text) => !['发送', '闲鱼号', '立即购买'].includes(text))
+        .filter((text) => !/^消息\\d*\\+?$/.test(text))
+        .slice(-20);
+
+      return {
+        requiresAuth,
+        title: clean(document.title || ''),
+        peer_name: clean(topbar?.querySelector('[class*="text1"]')?.textContent || ''),
+        peer_masked_id: clean(topbar?.querySelector('[class*="text2"]')?.textContent || '').replace(/^\\(|\\)$/g, ''),
+        item_title: clean(itemTitleNode?.textContent || ''),
+        item_url: itemCard?.href || '',
+        price: clean(itemCard?.querySelector('[class*="money"]')?.textContent || ''),
+        location: clean(itemCard?.querySelector('[class*="delivery"] + [class*="delivery"], [class*="delivery"]:last-child')?.textContent || ''),
+        can_input: Boolean(textarea && !textarea.disabled),
+        can_send: Boolean(sendButton),
+        visible_messages: visibleMessages,
+      };
+    })()
+  `;
+}
+function buildSendMessageEvaluate(text) {
+    return `
+    (() => {
+      const clean = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const textarea = document.querySelector('textarea');
+      if (!textarea || textarea.disabled) {
+        return { ok: false, reason: 'input-not-found' };
+      }
+
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value')?.set;
+      if (!setter) {
+        return { ok: false, reason: 'textarea-setter-not-found' };
+      }
+
+      textarea.focus();
+      setter.call(textarea, ${JSON.stringify(text)});
+      textarea.dispatchEvent(new Event('input', { bubbles: true }));
+      textarea.dispatchEvent(new Event('change', { bubbles: true }));
+
+      const sendButton = Array.from(document.querySelectorAll('button'))
+        .find((btn) => clean(btn.textContent || '') === '发送');
+      if (!sendButton) {
+        return { ok: false, reason: 'send-button-not-found' };
+      }
+
+      sendButton.click();
+      return { ok: true };
+    })()
+  `;
+}
+cli({
+    site: 'xianyu',
+    name: 'chat',
+    description: '打开闲鱼聊一聊会话，并可选发送消息',
+    domain: 'www.goofish.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        { name: 'item_id', required: true, positional: true, help: '闲鱼商品 item_id' },
+        { name: 'user_id', required: true, positional: true, help: '聊一聊对方的 user_id / peerUserId' },
+        { name: 'text', help: 'Message to send after opening the chat' },
+    ],
+    columns: ['status', 'peer_name', 'item_title', 'price', 'location', 'message'],
+    func: async (page, kwargs) => {
+        const itemId = normalizeNumericId(kwargs.item_id, 'item_id', '1038951278192');
+        const userId = normalizeNumericId(kwargs.user_id, 'user_id', '3650092411');
+        const url = buildChatUrl(itemId, userId);
+        const text = String(kwargs.text || '').trim();
+        await page.goto(url);
+        await page.wait(2);
+        const state = await page.evaluate(buildExtractChatStateEvaluate());
+        if (state?.requiresAuth) {
+            throw new AuthRequiredError('www.goofish.com', 'Xianyu chat requires a logged-in browser session');
+        }
+        if (!state?.can_input) {
+            throw new SelectorError('闲鱼聊天输入框', '未找到可用的聊天输入框，请确认该会话页已正确加载');
+        }
+        if (!text) {
+            return [{
+                    status: 'ready',
+                    peer_name: state.peer_name || '',
+                    item_title: state.item_title || '',
+                    price: state.price || '',
+                    location: state.location || '',
+                    message: (state.visible_messages || []).slice(-1)[0] || '',
+                    peer_user_id: userId,
+                    item_id: itemId,
+                    url,
+                    item_url: state.item_url || '',
+                }];
+        }
+        const sent = await page.evaluate(buildSendMessageEvaluate(text));
+        if (!sent?.ok) {
+            throw new SelectorError('闲鱼发送按钮', `消息发送失败：${sent?.reason || 'unknown-reason'}`);
+        }
+        await page.wait(1);
+        return [{
+                status: 'sent',
+                peer_name: state.peer_name || '',
+                item_title: state.item_title || '',
+                price: state.price || '',
+                location: state.location || '',
+                message: text,
+                peer_user_id: userId,
+                item_id: itemId,
+                url,
+                item_url: state.item_url || '',
+            }];
+    },
+});
+export const __test__ = {
+    normalizeNumericId,
+    buildChatUrl,
+};

package/dist/clis/xianyu/chat.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/xianyu/chat.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './chat.js';
+describe('xianyu chat helpers', () => {
+    it('builds goofish im urls from ids', () => {
+        expect(__test__.buildChatUrl('1038951278192', '3650092411')).toBe('https://www.goofish.com/im?itemId=1038951278192&peerUserId=3650092411');
+    });
+    it('normalizes numeric ids', () => {
+        expect(__test__.normalizeNumericId('1038951278192', 'item_id', '1038951278192')).toBe('1038951278192');
+        expect(__test__.normalizeNumericId(3650092411, 'user_id', '3650092411')).toBe('3650092411');
+    });
+    it('rejects non-numeric ids', () => {
+        expect(() => __test__.normalizeNumericId('abc', 'item_id', '1038951278192')).toThrow();
+        expect(() => __test__.normalizeNumericId('3650092411x', 'user_id', '3650092411')).toThrow();
+    });
+});

package/dist/clis/xianyu/item.d.ts

@@ -0,0 +1,7 @@
+import { normalizeNumericId } from './utils.js';
+declare function buildItemUrl(itemId: string): string;
+export declare const __test__: {
+    normalizeNumericId: typeof normalizeNumericId;
+    buildItemUrl: typeof buildItemUrl;
+};
+export {};

package/dist/clis/xianyu/item.js

@@ -0,0 +1,152 @@
+import { AuthRequiredError, EmptyResultError, SelectorError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { normalizeNumericId } from './utils.js';
+function buildItemUrl(itemId) {
+    return `https://www.goofish.com/item?id=${encodeURIComponent(itemId)}`;
+}
+function buildFetchItemEvaluate(itemId) {
+    return `
+    (async () => {
+      const clean = (value) => String(value ?? '').replace(/\\s+/g, ' ').trim();
+      const extractRetCode = (ret) => {
+        const first = Array.isArray(ret) ? ret[0] : '';
+        return clean(first).split('::')[0] || '';
+      };
+
+      const waitFor = async (predicate, timeoutMs = 5000) => {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+          if (predicate()) return true;
+          await new Promise((r) => setTimeout(r, 150));
+        }
+        return false;
+      };
+
+      const bodyText = document.body?.innerText || '';
+      if (/请先登录|登录后/.test(bodyText)) {
+        return { error: 'auth-required' };
+      }
+
+      if (/验证码|安全验证|异常访问/.test(bodyText)) {
+        return { error: 'blocked' };
+      }
+
+      await waitFor(() => window.lib?.mtop?.request);
+      if (!window.lib || !window.lib.mtop || typeof window.lib.mtop.request !== 'function') {
+        return { error: 'mtop-not-ready' };
+      }
+
+      let response;
+      try {
+        response = await window.lib.mtop.request({
+          api: 'mtop.taobao.idle.pc.detail',
+          data: { itemId: ${JSON.stringify(itemId)} },
+          type: 'POST',
+          v: '1.0',
+          dataType: 'json',
+          needLogin: false,
+          needLoginPC: false,
+          sessionOption: 'AutoLoginOnly',
+          ecode: 0,
+        });
+      } catch (error) {
+        const ret = error?.ret || [];
+        return {
+          error: 'mtop-request-failed',
+          error_code: extractRetCode(ret),
+          error_message: clean(Array.isArray(ret) ? ret.join(' | ') : error?.message || error),
+        };
+      }
+
+      const retCode = extractRetCode(response?.ret || []);
+      if (retCode && retCode !== 'SUCCESS') {
+        return {
+          error: 'mtop-response-error',
+          error_code: retCode,
+          error_message: clean((response?.ret || []).join(' | ')),
+        };
+      }
+
+      const data = response?.data || {};
+      const item = data.itemDO || {};
+      const seller = data.sellerDO || {};
+      const labels = Array.isArray(item.itemLabelExtList) ? item.itemLabelExtList : [];
+      const findLabel = (name) => labels.find((label) => clean(label.propertyText) === name)?.text || '';
+      const images = Array.isArray(item.imageInfos)
+        ? item.imageInfos.map((entry) => entry?.url).filter(Boolean)
+        : [];
+
+      return {
+        item_id: clean(item.itemId || ${JSON.stringify(itemId)}),
+        title: clean(item.title || ''),
+        description: clean(item.desc || ''),
+        price: clean('¥' + (item.soldPrice || item.defaultPrice || '')).replace(/^¥\\s*$/, ''),
+        original_price: clean(item.originalPrice || ''),
+        want_count: String(item.wantCnt ?? ''),
+        collect_count: String(item.collectCnt ?? ''),
+        browse_count: String(item.browseCnt ?? ''),
+        status: clean(item.itemStatusStr || ''),
+        condition: clean(findLabel('成色')),
+        brand: clean(findLabel('品牌')),
+        category: clean(findLabel('分类')),
+        location: clean(seller.publishCity || seller.city || ''),
+        seller_name: clean(seller.nick || seller.uniqueName || ''),
+        seller_id: String(seller.sellerId || ''),
+        seller_score: clean(seller.xianyuSummary || ''),
+        reply_ratio_24h: clean(seller.replyRatio24h || ''),
+        reply_interval: clean(seller.replyInterval || ''),
+        item_url: ${JSON.stringify(buildItemUrl(itemId))},
+        seller_url: seller.sellerId ? 'https://www.goofish.com/personal?userId=' + seller.sellerId : '',
+        image_count: String(images.length),
+        image_urls: images,
+      };
+    })()
+  `;
+}
+cli({
+    site: 'xianyu',
+    name: 'item',
+    description: '查看闲鱼商品详情',
+    domain: 'www.goofish.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        { name: 'item_id', required: true, positional: true, help: '闲鱼商品 item_id' },
+    ],
+    columns: ['item_id', 'title', 'price', 'condition', 'brand', 'location', 'seller_name', 'want_count'],
+    func: async (page, kwargs) => {
+        const itemId = normalizeNumericId(kwargs.item_id, 'item_id', '1040754408976');
+        await page.goto(buildItemUrl(itemId));
+        await page.wait(2);
+        const result = await page.evaluate(buildFetchItemEvaluate(itemId));
+        if (result?.error === 'auth-required') {
+            throw new AuthRequiredError('www.goofish.com', 'Xianyu item detail requires a logged-in browser session');
+        }
+        if (result?.error === 'blocked') {
+            throw new EmptyResultError('xianyu item', 'Xianyu item detail is blocked by verification or risk control');
+        }
+        if (result?.error === 'mtop-not-ready') {
+            throw new SelectorError('window.lib.mtop', '闲鱼页面未完成初始化，无法调用商品详情接口');
+        }
+        if (!result || typeof result !== 'object') {
+            throw new EmptyResultError('xianyu item', '闲鱼商品详情接口未返回有效数据');
+        }
+        const errorCode = String(result.error_code || '');
+        const errorMessage = String(result.error_message || '');
+        if (/FAIL_SYS_SESSION_EXPIRED|SESSION_EXPIRED|FAIL_SYS/.test(errorCode) || /FAIL_SYS_SESSION_EXPIRED|SESSION_EXPIRED/.test(errorMessage)) {
+            throw new AuthRequiredError('www.goofish.com', 'Xianyu item detail requires a logged-in browser session');
+        }
+        if (result.error) {
+            throw new EmptyResultError('xianyu item', errorMessage || `Xianyu item detail request failed: ${result.error}`);
+        }
+        if (!String(result.title || '').trim()) {
+            throw new EmptyResultError('xianyu item', 'No item detail was returned for the specified item_id');
+        }
+        return [result];
+    },
+});
+export const __test__ = {
+    normalizeNumericId,
+    buildItemUrl,
+};

package/dist/clis/xianyu/item.test.d.ts

@@ -0,0 +1 @@
+import './item.js';

package/dist/clis/xianyu/item.test.js

@@ -0,0 +1,56 @@
+import { describe, expect, it, vi } from 'vitest';
+import { AuthRequiredError, EmptyResultError, SelectorError } from '../../errors.js';
+import { getRegistry } from '../../registry.js';
+import { __test__ } from './item.js';
+import './item.js';
+function createPageMock(evaluateResult) {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+        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('xianyu item helpers', () => {
+    it('normalizes numeric item ids', () => {
+        expect(__test__.normalizeNumericId('1040754408976', 'item_id', '1040754408976')).toBe('1040754408976');
+        expect(__test__.normalizeNumericId(1040754408976, 'item_id', '1040754408976')).toBe('1040754408976');
+    });
+    it('builds item urls', () => {
+        expect(__test__.buildItemUrl('1040754408976')).toBe('https://www.goofish.com/item?id=1040754408976');
+    });
+    it('rejects invalid item ids', () => {
+        expect(() => __test__.normalizeNumericId('abc', 'item_id', '1040754408976')).toThrow();
+    });
+});
+describe('xianyu item command', () => {
+    const command = getRegistry().get('xianyu/item');
+    it('throws AuthRequiredError on login wall before mtop is available', async () => {
+        const page = createPageMock({ error: 'auth-required' });
+        await expect(command.func(page, { item_id: '1040754408976' })).rejects.toBeInstanceOf(AuthRequiredError);
+    });
+    it('throws EmptyResultError on verification or risk-control pages', async () => {
+        const page = createPageMock({ error: 'blocked' });
+        await expect(command.func(page, { item_id: '1040754408976' })).rejects.toBeInstanceOf(EmptyResultError);
+    });
+    it('keeps SelectorError for true mtop initialization failures', async () => {
+        const page = createPageMock({ error: 'mtop-not-ready' });
+        await expect(command.func(page, { item_id: '1040754408976' })).rejects.toBeInstanceOf(SelectorError);
+    });
+});

package/dist/clis/xianyu/search.d.ts

@@ -0,0 +1,10 @@
+declare function normalizeLimit(value: unknown): number;
+declare function buildSearchUrl(query: string): string;
+declare function itemIdFromUrl(url: string): string;
+export declare const __test__: {
+    MAX_LIMIT: number;
+    normalizeLimit: typeof normalizeLimit;
+    buildSearchUrl: typeof buildSearchUrl;
+    itemIdFromUrl: typeof itemIdFromUrl;
+};
+export {};