@sovovs/bycli 1.8.0 → 2.0.0

package/clis/duckduckgo/suggest.test.js

@@ -1,66 +0,0 @@
-import { afterEach, describe, it, expect, vi } from 'vitest';
-
-const { __test__ } = await import('./suggest.js');
-const command = __test__.command;
-
-afterEach(() => {
-  vi.restoreAllMocks();
-});
-
-describe('duckduckgo suggest', () => {
-  it('should register as a valid command', () => {
-    expect(command).toBeDefined();
-    expect(command.site).toBe('duckduckgo');
-    expect(command.name).toBe('suggest');
-    expect(command.access).toBe('read');
-    expect(command.browser).toBe(false);
-    expect(command.strategy).toBe('public');
-  });
-
-  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 8', () => {
-    const limitArg = command.args.find(a => a.name === 'limit');
-    expect(limitArg).toBeDefined();
-    expect(limitArg.default).toBe(8);
-  });
-
-  it('should define phrase column', () => {
-    expect(command.columns).toEqual(['phrase']);
-  });
-
-  it('rejects empty query and invalid limit before fetch', async () => {
-    const fetchSpy = vi.spyOn(globalThis, 'fetch');
-    await expect(command.func({ keyword: '', limit: 5 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    await expect(command.func({ keyword: 'bycli', limit: 21 })).rejects.toMatchObject({ code: 'ARGUMENT' });
-    expect(fetchSpy).not.toHaveBeenCalled();
-  });
-
-  it('returns filtered suggestion rows from the public API payload', async () => {
-    vi.spyOn(globalThis, 'fetch').mockResolvedValue({
-      ok: true,
-      json: async () => ['open', ['bycli', '', 'open source']],
-    });
-
-    await expect(command.func({ keyword: 'open', limit: 3 })).resolves.toEqual([
-      { phrase: 'bycli' },
-      { phrase: 'open source' },
-    ]);
-  });
-
-  it('maps fetch and malformed JSON failures to typed command errors', async () => {
-    vi.spyOn(globalThis, 'fetch').mockRejectedValueOnce(new Error('offline'));
-    await expect(command.func({ keyword: 'open', limit: 3 })).rejects.toMatchObject({ code: 'COMMAND_EXEC' });
-
-    vi.spyOn(globalThis, 'fetch').mockResolvedValueOnce({
-      ok: true,
-      json: async () => { throw new Error('bad json'); },
-    });
-    await expect(command.func({ keyword: 'open', limit: 3 })).rejects.toMatchObject({ code: 'COMMAND_EXEC' });
-  });
-});

package/clis/eastmoney/hot-rank.test.js

@@ -1,59 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import './hot-rank.js';
-
-describe('eastmoney hot-rank command', () => {
-  it('registers the command with correct metadata', () => {
-    const command = getRegistry().get('eastmoney/hot-rank');
-    expect(command).toBeDefined();
-    expect(command).toMatchObject({
-      site: 'eastmoney',
-      name: 'hot-rank',
-      description: expect.stringContaining('东方财富'),
-      domain: 'guba.eastmoney.com',
-      navigateBefore: true,
-    });
-  });
-
-  it('returns hot stock data from the page', async () => {
-    const command = getRegistry().get('eastmoney/hot-rank');
-    const mockData = [
-      { rank: 1, symbol: '600519', name: '贵州茅台', price: '1680.00', changePercent: '+2.35%', heat: '28.5万', url: 'https://guba.eastmoney.com/list,600519.html' },
-      { rank: 2, symbol: '000001', name: '平安银行', price: '12.50', changePercent: '-0.80%', heat: '15.2万', url: 'https://guba.eastmoney.com/list,000001.html' },
-    ];
-    const page = {
-      goto: vi.fn().mockResolvedValue(undefined),
-      wait: vi.fn().mockResolvedValue(undefined),
-      evaluate: vi.fn().mockResolvedValue(mockData),
-    };
-    const result = await command.func(page, { limit: 20 });
-    expect(result).toHaveLength(2);
-    expect(result[0]).toEqual(mockData[0]);
-    expect(page.goto).toHaveBeenCalledWith('https://guba.eastmoney.com/rank/');
-  });
-
-  it('respects the limit parameter', async () => {
-    const command = getRegistry().get('eastmoney/hot-rank');
-    const mockData = Array.from({ length: 30 }, (_, i) => ({
-      rank: i + 1, symbol: `${i}`, name: `stock${i}`, price: '0', changePercent: '0%', heat: '0', url: '',
-    }));
-    const page = {
-      goto: vi.fn().mockResolvedValue(undefined),
-      wait: vi.fn().mockResolvedValue(undefined),
-      evaluate: vi.fn().mockResolvedValue(mockData),
-    };
-    const result = await command.func(page, { limit: 10 });
-    expect(result).toHaveLength(10);
-  });
-
-  it('returns empty array when evaluate returns non-array', async () => {
-    const command = getRegistry().get('eastmoney/hot-rank');
-    const page = {
-      goto: vi.fn().mockResolvedValue(undefined),
-      wait: vi.fn().mockResolvedValue(undefined),
-      evaluate: vi.fn().mockResolvedValue(null),
-    };
-    const result = await command.func(page, { limit: 20 });
-    expect(result).toEqual([]);
-  });
-});

package/clis/endoflife/endoflife.test.js

@@ -1,51 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-import './product.js';
-
-afterEach(() => {
-    vi.unstubAllGlobals();
-    vi.restoreAllMocks();
-});
-
-describe('endoflife product adapter', () => {
-    const cmd = getRegistry().get('endoflife/product');
-
-    it('rejects empty / malformed product before fetching', async () => {
-        const fetchMock = vi.fn();
-        vi.stubGlobal('fetch', fetchMock);
-
-        await expect(cmd.func({ product: '' })).rejects.toThrow(ArgumentError);
-        await expect(cmd.func({ product: 'BAD/PRODUCT' })).rejects.toThrow(ArgumentError);
-        expect(fetchMock).not.toHaveBeenCalled();
-    });
-
-    it('maps HTTP 429 to CommandExecutionError', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('rate limited', { status: 429 })));
-        await expect(cmd.func({ product: 'nodejs' })).rejects.toThrow(CommandExecutionError);
-    });
-
-    it('maps HTTP 404 to EmptyResultError', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response('not found', { status: 404 })));
-        await expect(cmd.func({ product: 'no-such-product' })).rejects.toThrow(EmptyResultError);
-    });
-
-    it('normalises lts/support/eol booleans + dates and projects eolStatus', async () => {
-        const cycles = [
-            { cycle: '24', releaseDate: '2025-05-06', latest: '24.15.0', latestReleaseDate: '2026-04-15', lts: '2025-10-28', support: '2026-10-20', eol: '2028-04-30', extendedSupport: false },
-            { cycle: '20', releaseDate: '2023-04-18', latest: '20.20.2', latestReleaseDate: '2026-03-24', lts: '2023-10-24', support: '2024-10-22', eol: '2026-04-30', extendedSupport: true },
-            { cycle: 'rolling', releaseDate: '2020-01-01', latest: 'next', latestReleaseDate: '2026-01-01', lts: false, support: true, eol: false, extendedSupport: false },
-        ];
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue(new Response(JSON.stringify(cycles), { status: 200 })));
-
-        const rows = await cmd.func({ product: 'nodejs' });
-        expect(rows).toHaveLength(3);
-        // Future eol -> active
-        expect(rows[0]).toMatchObject({ product: 'nodejs', cycle: '24', eol: '2028-04-30', eolStatus: 'active' });
-        expect(rows[1]).toMatchObject({ cycle: '20', eol: '2026-04-30', eolStatus: 'eol' });
-        // Boolean true -> "ongoing"; boolean false -> null
-        expect(rows[2]).toMatchObject({ cycle: 'rolling', lts: null, support: 'ongoing', eol: null, eolStatus: null });
-        // Round-trip: product is the slug into endoflife.date URLs
-        expect(rows[0].url).toBe('https://endoflife.date/nodejs');
-    });
-});

package/clis/facebook/feed.test.js

@@ -1,169 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { JSDOM } from 'jsdom';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@sovovs/bycli/errors';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { __test__ } from './feed.js';
-
-function runExtract(html, limit = 10, url = 'https://www.facebook.com/') {
-  const dom = new JSDOM(html, { url });
-  return Function('window', 'document', `return ${__test__.buildFeedExtractScript(limit)};`)(dom.window, dom.window.document);
-}
-
-function createPage(payload) {
-  return {
-    goto: vi.fn().mockResolvedValue(undefined),
-    evaluate: vi.fn().mockResolvedValue(payload),
-  };
-}
-
-describe('facebook feed', () => {
-  it('registers the feed command with the existing row contract', () => {
-    const cmd = getRegistry().get('facebook/feed');
-    expect(cmd).toBeDefined();
-    expect(cmd.columns).toEqual(['index', 'author', 'content', 'likes', 'comments', 'shares']);
-  });
-
-  it('extracts existing role=article feed rows', () => {
-    const payload = runExtract(`
-      <main role="main">
-        <div role="article">
-          <h2><a href="https://www.facebook.com/alice">Alice Example</a></h2>
-          <div dir="auto">This is a normal Facebook feed post with enough text to extract.</div>
-          <span>All: 12</span>
-          <span>3 comments</span>
-          <span>2 shares</span>
-          <div aria-label="Like"></div><div aria-label="Comment"></div>
-        </div>
-      </main>
-    `);
-
-    expect(payload.status).toBe('ok');
-    expect(payload.rows).toEqual([{
-      index: 1,
-      author: 'Alice Example',
-      content: 'This is a normal Facebook feed post with enough text to extract.',
-      likes: '12',
-      comments: '3',
-      shares: '2',
-    }]);
-  });
-
-  it('falls back from empty article nodes to action-bounded feed containers', () => {
-    const payload = runExtract(`
-      <main role="main">
-        <div role="article"></div>
-        <section>
-          <div>
-            <h2><a href="https://www.facebook.com/bob/posts/123">Bob Builder</a></h2>
-            <div dir="auto">Fallback post body from a Facebook feed card with empty article text.</div>
-            <a href="https://www.facebook.com/bob/posts/123">Permalink</a>
-            <span>All: 1.2K</span>
-            <span>4 comments</span>
-            <span>1 shares</span>
-            <div><button aria-label="Like">Like</button><button aria-label="Comment">Comment</button></div>
-          </div>
-        </section>
-      </main>
-    `);
-
-    expect(payload.status).toBe('ok');
-    expect(payload.rows).toEqual([{
-      index: 1,
-      author: 'Bob Builder',
-      content: 'Fallback post body from a Facebook feed card with empty article text.',
-      likes: '1.2K',
-      comments: '4',
-      shares: '1',
-    }]);
-  });
-
-  it('does not turn suggestions or side chrome action buttons into feed rows', () => {
-    const payload = runExtract(`
-      <main role="main">
-        <aside>
-          <h2>People you may know</h2>
-          <div dir="auto">Charlie Suggested</div>
-          <div dir="auto">Add friend from suggested people card with plenty of text.</div>
-          <button aria-label="Like">Like</button>
-          <button aria-label="Comment">Comment</button>
-        </aside>
-        <nav>
-          <div dir="auto">Navigation item with a Like button but not a feed post.</div>
-          <button aria-label="Like">Like</button>
-          <button aria-label="Comment">Comment</button>
-        </nav>
-      </main>
-    `);
-
-    expect(payload.status).toBe('no_rows');
-    expect(payload.rows).toEqual([]);
-  });
-
-  it('still considers bounded fallback rows when article nodes are suggestion chrome', () => {
-    const payload = runExtract(`
-      <main role="main">
-        <div role="article">
-          <h2>People you may know</h2>
-          <div dir="auto">Suggested profile card with enough text to look article-like.</div>
-          <button aria-label="Like">Like</button>
-          <button aria-label="Comment">Comment</button>
-        </div>
-        <section>
-          <div>
-            <h2><a href="https://www.facebook.com/dana/posts/456">Dana Poster</a></h2>
-            <div dir="auto">Fallback feed post should still be extracted after suggestion articles are filtered.</div>
-            <a href="https://www.facebook.com/dana/posts/456">Permalink</a>
-            <button aria-label="Like">Like</button>
-            <button aria-label="Comment">Comment</button>
-          </div>
-        </section>
-      </main>
-    `, 1);
-
-    expect(payload.status).toBe('ok');
-    expect(payload.rows).toEqual([{
-      index: 1,
-      author: 'Dana Poster',
-      content: 'Fallback feed post should still be extracted after suggestion articles are filtered.',
-      likes: '-',
-      comments: '-',
-      shares: '-',
-    }]);
-  });
-
-  it('reports auth pages from the browser extractor', () => {
-    const payload = runExtract('<main role="main">Log in to Facebook</main>', 10, 'https://www.facebook.com/login/');
-    expect(payload.status).toBe('auth');
-    expect(payload.rows).toEqual([]);
-  });
-
-  it('validates limit before browser navigation', async () => {
-    const page = createPage({ status: 'ok', rows: [] });
-    await expect(__test__.command.func(page, { limit: 0 })).rejects.toBeInstanceOf(ArgumentError);
-    expect(page.goto).not.toHaveBeenCalled();
-  });
-
-  it('maps browser envelopes and returns extracted rows', async () => {
-    const page = createPage({ session: 'site:facebook', data: { status: 'ok', rows: [{ index: 1, author: 'A', content: 'Body', likes: '-', comments: '-', shares: '-' }] } });
-
-    await expect(__test__.command.func(page, { limit: 1 })).resolves.toEqual([{
-      index: 1,
-      author: 'A',
-      content: 'Body',
-      likes: '-',
-      comments: '-',
-      shares: '-',
-    }]);
-  });
-
-  it('maps auth, real empty, parser drift, and malformed payloads to typed errors', async () => {
-    await expect(__test__.command.func(createPage({ status: 'auth', rows: [] }), { limit: 1 }))
-      .rejects.toBeInstanceOf(AuthRequiredError);
-    await expect(__test__.command.func(createPage({ status: 'empty', rows: [] }), { limit: 1 }))
-      .rejects.toBeInstanceOf(EmptyResultError);
-    await expect(__test__.command.func(createPage({ status: 'no_rows', rows: [], diagnostics: { articleCount: 1, fallbackActionCount: 2, mainTextLength: 500 } }), { limit: 1 }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-    await expect(__test__.command.func(createPage({ rows: null }), { limit: 1 }))
-      .rejects.toBeInstanceOf(CommandExecutionError);
-  });
-});

package/clis/facebook/marketplace.test.js

@@ -1,91 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@sovovs/bycli/registry';
-import { ArgumentError, AuthRequiredError, EmptyResultError } from '@sovovs/bycli/errors';
-import './marketplace-listings.js';
-import './marketplace-inbox.js';
-
-function makePage(overrides = {}) {
-  return {
-    goto: vi.fn().mockResolvedValue(undefined),
-    wait: vi.fn().mockResolvedValue(undefined),
-    evaluate: vi.fn().mockResolvedValue([]),
-    ...overrides,
-  };
-}
-
-describe('facebook marketplace read commands', () => {
-  it('marketplace-listings navigates to selling page and returns limited listing rows', async () => {
-    const command = getRegistry().get('facebook/marketplace-listings');
-    expect(command).toBeDefined();
-    const page = makePage({
-      evaluate: vi.fn().mockResolvedValue({
-        authRequired: false,
-        rows: [
-          { title: 'Black electric standing desk', price: 'CA$80', status: 'Active', listed: 'Listed on 4/26', clicks: '87', actions: ['Mark as sold', 'Share'] },
-          { title: 'Large gray corduroy beanbag chair', price: 'CA$30', status: 'Sold', listed: 'Listed on 4/26', clicks: '52', actions: ['Mark as available', 'Relist this item'] },
-        ],
-      }),
-    });
-
-    const rows = await command.func(page, { limit: 1 });
-
-    expect(page.goto).toHaveBeenCalledWith('https://www.facebook.com/marketplace/you/selling/');
-    expect(page.wait).toHaveBeenCalledWith(4);
-    expect(rows).toEqual([
-      {
-        index: 1,
-        title: 'Black electric standing desk',
-        price: 'CA$80',
-        status: 'Active',
-        listed: 'Listed on 4/26',
-        clicks: '87',
-        actions: 'Mark as sold, Share',
-      },
-    ]);
-  });
-
-  it('marketplace-inbox navigates to inbox and returns recent buyer conversations', async () => {
-    const command = getRegistry().get('facebook/marketplace-inbox');
-    expect(command).toBeDefined();
-    const page = makePage({
-      evaluate: vi.fn().mockResolvedValue({
-        authRequired: false,
-        rows: [
-          { buyer: 'Kulwant', listing: 'White 3-tier rolling utility cart', snippet: 'Can I pick up today?', time: '3:43 PM', unread: true },
-          { buyer: 'Gabriel', listing: 'Black electric standing desk', snippet: 'Yes, still available.', time: '12:17 PM', unread: false },
-        ],
-      }),
-    });
-
-    const rows = await command.func(page, { limit: 2 });
-
-    expect(page.goto).toHaveBeenCalledWith('https://www.facebook.com/marketplace/inbox/');
-    expect(page.wait).toHaveBeenCalledWith(4);
-    expect(rows).toEqual([
-      { index: 1, buyer: 'Kulwant', listing: 'White 3-tier rolling utility cart', snippet: 'Can I pick up today?', time: '3:43 PM', unread: true },
-      { index: 2, buyer: 'Gabriel', listing: 'Black electric standing desk', snippet: 'Yes, still available.', time: '12:17 PM', unread: false },
-    ]);
-  });
-
-  it('throws EmptyResultError when Marketplace returns no inbox rows', async () => {
-    const command = getRegistry().get('facebook/marketplace-inbox');
-    const page = makePage({ evaluate: vi.fn().mockResolvedValue({ authRequired: false, rows: [] }) });
-
-    await expect(command.func(page, { limit: 5 })).rejects.toThrow(EmptyResultError);
-  });
-
-  it('throws AuthRequiredError when Marketplace returns a login page', async () => {
-    const command = getRegistry().get('facebook/marketplace-listings');
-    const page = makePage({ evaluate: vi.fn().mockResolvedValue({ authRequired: true, rows: [] }) });
-
-    await expect(command.func(page, { limit: 5 })).rejects.toThrow(AuthRequiredError);
-  });
-
-  it('throws ArgumentError for invalid limits', async () => {
-    const command = getRegistry().get('facebook/marketplace-listings');
-    const page = makePage();
-
-    await expect(command.func(page, { limit: 0 })).rejects.toThrow(ArgumentError);
-    expect(page.goto).not.toHaveBeenCalled();
-  });
-});