@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/flomo/memos.test.js

@@ -1,144 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import {
-  ArgumentError,
-  AuthRequiredError,
-  CommandExecutionError,
-  EmptyResultError,
-} from '@agentrhq/webcmd/errors';
-
-const { __test__ } = await import('./memos.js');
-const { command, normalizeMemo, parsePositiveIntArg, parseSinceArg, parseSlugArg } = __test__;
-
-function createPage(token = 'token-123') {
-  return {
-    wait: vi.fn().mockResolvedValue(undefined),
-    evaluate: vi.fn().mockResolvedValue({ session: 'browser:default', data: token }),
-  };
-}
-
-function mockFetchJson(body, status = 200) {
-  vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-    ok: status >= 200 && status < 300,
-    status,
-    json: vi.fn().mockResolvedValue(body),
-  }));
-}
-
-describe('flomo memos registration', () => {
-  it('registers as a browser cookie read command with stable columns', () => {
-    expect(command.site).toBe('flomo');
-    expect(command.name).toBe('memos');
-    expect(command.access).toBe('read');
-    expect(command.browser).toBe(true);
-    expect(command.strategy).toBe('cookie');
-    expect(command.columns).toEqual(['id', 'url', 'content', 'slug', 'tags', 'images', 'created_at', 'updated_at']);
-  });
-});
-
-describe('flomo memos argument validation', () => {
-  it('rejects invalid limits instead of silently clamping', () => {
-    expect(() => parsePositiveIntArg('0', 'limit', 20, 200)).toThrow(ArgumentError);
-    expect(() => parsePositiveIntArg('201', 'limit', 20, 200)).toThrow(ArgumentError);
-    expect(() => parsePositiveIntArg('10.5', 'limit', 20, 200)).toThrow(ArgumentError);
-    expect(() => parsePositiveIntArg('abc', 'limit', 20, 200)).toThrow(ArgumentError);
-    expect(parsePositiveIntArg(undefined, 'limit', 20, 200)).toBe(20);
-    expect(parsePositiveIntArg('200', 'limit', 20, 200)).toBe(200);
-  });
-
-  it('rejects invalid since and slug arguments', () => {
-    expect(parseSinceArg(undefined)).toBe(0);
-    expect(parseSinceArg('1735689600')).toBe(1735689600);
-    expect(() => parseSinceArg('-1')).toThrow(ArgumentError);
-    expect(() => parseSinceArg('1.5')).toThrow(ArgumentError);
-    expect(parseSlugArg(undefined)).toBe('');
-    expect(parseSlugArg('abc_DEF-123')).toBe('abc_DEF-123');
-    expect(() => parseSlugArg('bad/slash')).toThrow(ArgumentError);
-    expect(() => parseSlugArg('bad space')).toThrow(ArgumentError);
-  });
-});
-
-describe('flomo memo normalization', () => {
-  it('emits string-safe id/url fields and normalizes tags/images', () => {
-    expect(normalizeMemo({
-      slug: 'memo_12345678901234567890',
-      content: ' <p>Hello</p> ',
-      tags: [{ name: 'work' }, 'idea'],
-      files: [{ thumbnail_url: 'https://img/thumb.jpg' }, { url: 'https://img/full.jpg' }],
-      created_at: '2026-01-01T00:00:00+08:00',
-      updated_at: '2026-01-02T00:00:00+08:00',
-    })).toEqual({
-      id: 'memo_12345678901234567890',
-      url: 'https://v.flomoapp.com/mine/?memo_id=memo_12345678901234567890',
-      content: '<p>Hello</p>',
-      slug: 'memo_12345678901234567890',
-      tags: 'work, idea',
-      images: 'https://img/thumb.jpg | https://img/full.jpg',
-      created_at: '2026-01-01T00:00:00+08:00',
-      updated_at: '2026-01-02T00:00:00+08:00',
-    });
-  });
-
-  it('fails typed on malformed memo entries', () => {
-    expect(() => normalizeMemo(null)).toThrow(CommandExecutionError);
-    expect(() => normalizeMemo({ content: 'missing slug' })).toThrow(CommandExecutionError);
-  });
-});
-
-describe('flomo memos command', () => {
-  beforeEach(() => {
-    vi.unstubAllGlobals();
-  });
-
-  it('reads token from Browser Bridge envelope and returns memo rows', async () => {
-    mockFetchJson({
-      code: 0,
-      data: [{
-        slug: 'memo_1',
-        content: 'hello',
-        tags: ['tag'],
-        files: [],
-        created_at: '2026-01-01',
-        updated_at: '2026-01-02',
-      }],
-    });
-
-    const rows = await command.func(createPage(), { limit: '1' });
-
-    expect(globalThis.fetch).toHaveBeenCalledWith(expect.stringContaining('limit=1'), expect.objectContaining({
-      headers: expect.objectContaining({ Authorization: 'Bearer token-123' }),
-    }));
-    expect(rows).toEqual([{
-      id: 'memo_1',
-      url: 'https://v.flomoapp.com/mine/?memo_id=memo_1',
-      content: 'hello',
-      slug: 'memo_1',
-      tags: 'tag',
-      images: '',
-      created_at: '2026-01-01',
-      updated_at: '2026-01-02',
-    }]);
-  });
-
-  it('throws AuthRequiredError when the browser session has no token', async () => {
-    await expect(command.func(createPage(null), {})).rejects.toBeInstanceOf(AuthRequiredError);
-  });
-
-  it('maps Flomo auth failures to AuthRequiredError', async () => {
-    mockFetchJson({ code: 401, message: 'unauthorized' });
-    await expect(command.func(createPage(), {})).rejects.toBeInstanceOf(AuthRequiredError);
-  });
-
-  it('maps HTTP, malformed JSON, malformed data, and empty results to typed errors', async () => {
-    vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 500, json: vi.fn() }));
-    await expect(command.func(createPage(), {})).rejects.toBeInstanceOf(CommandExecutionError);
-
-    vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: true, status: 200, json: vi.fn().mockRejectedValue(new Error('bad json')) }));
-    await expect(command.func(createPage(), {})).rejects.toBeInstanceOf(CommandExecutionError);
-
-    mockFetchJson({ code: 0, data: {} });
-    await expect(command.func(createPage(), {})).rejects.toBeInstanceOf(CommandExecutionError);
-
-    mockFetchJson({ code: 0, data: [] });
-    await expect(command.func(createPage(), {})).rejects.toBeInstanceOf(EmptyResultError);
-  });
-});

package/clis/gitee/auth.js

@@ -1,41 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-// Gitee's logged-in cookie (gitee-session-n) is httpOnly and its exact name
-// rotates, so the poll uses a no-navigation API probe instead of a cookie gate.
-const WHOAMI_PROBE = `(async () => {
-  try {
-    const r = await fetch('/api/v5/user', { credentials: 'include', headers: { Accept: 'application/json' } });
-    if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'Gitee /api/v5/user HTTP ' + r.status };
-    if (!r.ok) return { kind: 'http', httpStatus: r.status };
-    const d = await r.json();
-    if (!d || !d.id || !d.login) return { kind: 'auth', detail: 'Gitee /api/v5/user has no id/login — anonymous' };
-    return { ok: true, user_id: String(d.id), username: String(d.login), name: String(d.name || '') };
-  } catch (e) {
-    return { kind: 'exception', detail: String(e && e.message || e) };
-  }
-})()`;
-
-async function verifyGiteeIdentity(page) {
-  await page.goto('https://gitee.com/');
-  await page.wait(1);
-  const probe = await page.evaluate(WHOAMI_PROBE);
-  if (probe?.kind === 'auth') throw new AuthRequiredError('gitee.com', probe.detail);
-  if (probe?.kind === 'http') throw new CommandExecutionError(`HTTP ${probe.httpStatus} from Gitee /api/v5/user`);
-  if (probe?.kind === 'exception') throw new CommandExecutionError(`Gitee whoami failed: ${probe.detail}`);
-  if (!probe?.ok) throw new CommandExecutionError(`Unexpected Gitee probe: ${JSON.stringify(probe)}`);
-  return { user_id: probe.user_id, username: probe.username, name: probe.name };
-}
-
-registerSiteAuthCommands({
-  site: 'gitee',
-  domain: 'gitee.com',
-  loginUrl: 'https://gitee.com/login',
-  columns: ['user_id', 'username', 'name'],
-  verify: verifyGiteeIdentity,
-  poll: async (page) => {
-    const probe = await page.evaluate(WHOAMI_PROBE);
-    if (!probe?.ok) throw new AuthRequiredError('gitee.com', 'Waiting for Gitee login');
-    return { user_id: probe.user_id, username: probe.username, name: probe.name };
-  },
-});

package/clis/gitee/index.js

@@ -1,3 +0,0 @@
-import './trending.js';
-import './search.js';
-import './user.js';

package/clis/gitee/search.js

@@ -1,137 +0,0 @@
-import { CliError } from '@agentrhq/webcmd/errors';
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-const GITEE_SEARCH_URL = 'https://gitee.com/search';
-const GITEE_SEARCH_WIDGET = 'wong1slagnlmzwvsu5ya';
-const GITEE_SEARCH_API = `https://so.gitee.com/v1/search/widget/${GITEE_SEARCH_WIDGET}`;
-const MAX_LIMIT = 50;
-function clampLimit(value) {
-    const parsed = Number(value);
-    if (Number.isNaN(parsed))
-        return 10;
-    return Math.max(1, Math.min(parsed, MAX_LIMIT));
-}
-function normalizeText(value) {
-    return value.replace(/\s+/g, ' ').trim();
-}
-function normalizeStars(value) {
-    let raw = '';
-    if (typeof value === 'number')
-        raw = String(value);
-    else if (typeof value === 'string')
-        raw = value;
-    else if (Array.isArray(value) && value.length > 0)
-        raw = String(value[0] ?? '');
-    const compact = normalizeText(raw).replace(/\s+/g, '');
-    if (!compact)
-        return '-';
-    const match = compact.match(/\d+(?:[.,]\d+)?(?:[kKmMwW]|\u4E07)?/);
-    return match ? match[0] : '-';
-}
-function getFirstText(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number')
-        return String(value);
-    if (Array.isArray(value)) {
-        for (const item of value) {
-            if (typeof item === 'string' || typeof item === 'number') {
-                return String(item);
-            }
-        }
-    }
-    return '';
-}
-function asRecord(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return null;
-    return value;
-}
-function normalizeUrl(value) {
-    try {
-        const parsed = new URL(value, 'https://gitee.com');
-        const host = parsed.hostname.toLowerCase();
-        if (host !== 'gitee.com' && host !== 'www.gitee.com')
-            return null;
-        const parts = parsed.pathname.split('/').filter(Boolean);
-        if (parts.length !== 2)
-            return null;
-        return `https://gitee.com/${parts[0]}/${parts[1]}`;
-    }
-    catch {
-        return null;
-    }
-}
-cli({
-    site: 'gitee',
-    name: 'search',
-    access: 'read',
-    description: 'Search repositories on Gitee',
-    domain: 'gitee.com',
-    strategy: Strategy.PUBLIC,
-    browser: true,
-    args: [
-        { name: 'keyword', positional: true, required: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of results (max 50)' },
-    ],
-    columns: ['rank', 'name', 'language', 'stars', 'description', 'url'],
-    func: async (page, args) => {
-        const keyword = String(args.keyword ?? '').trim();
-        if (!keyword) {
-            throw new CliError('INVALID_ARGUMENT', 'Keyword is required', 'Provide a search keyword');
-        }
-        const limit = clampLimit(args.limit);
-        const encodedKeyword = encodeURIComponent(keyword);
-        const searchUrl = `${GITEE_SEARCH_URL}?q=${encodedKeyword}&type=repository`;
-        const fetchSize = Math.max(10, limit);
-        const apiUrl = new URL(GITEE_SEARCH_API);
-        apiUrl.searchParams.set('q', keyword);
-        apiUrl.searchParams.set('from', '0');
-        apiUrl.searchParams.set('size', String(fetchSize));
-        await page.goto(searchUrl);
-        await page.wait(2);
-        const response = await fetch(apiUrl.toString(), {
-            headers: {
-                Accept: 'application/json',
-                'User-Agent': 'Mozilla/5.0',
-                Referer: searchUrl,
-            },
-        });
-        if (!response.ok) {
-            throw new CliError('REQUEST_FAILED', `Failed to request Gitee search API: ${response.status}`, 'Try again later or verify network access to so.gitee.com');
-        }
-        const payload = await response.json();
-        const payloadRecord = asRecord(payload);
-        const hitsRecord = asRecord(payloadRecord?.hits);
-        const rawRows = Array.isArray(hitsRecord?.hits) ? hitsRecord.hits : [];
-        if (rawRows.length === 0) {
-            throw new CliError('NOT_FOUND', 'No Gitee repository search results found', 'Try a different keyword or check whether Gitee search API changed');
-        }
-        const seen = new Set();
-        const rows = [];
-        for (let i = 0; i < rawRows.length && rows.length < limit; i++) {
-            const row = asRecord(rawRows[i]);
-            const fields = asRecord(row?.fields);
-            if (!fields)
-                continue;
-            const name = normalizeText(getFirstText(fields.title));
-            const repoUrl = normalizeUrl(getFirstText(fields.url));
-            if (!name || !repoUrl)
-                continue;
-            if (seen.has(repoUrl))
-                continue;
-            seen.add(repoUrl);
-            rows.push({
-                rank: rows.length + 1,
-                name,
-                language: normalizeText(getFirstText(fields.langs)) || '',
-                description: normalizeText(getFirstText(fields.description)) || '',
-                stars: normalizeStars(fields['count.star']),
-                url: repoUrl,
-            });
-        }
-        if (rows.length === 0) {
-            throw new CliError('NOT_FOUND', 'No valid Gitee repository results parsed', 'Try a different keyword or check whether Gitee search API changed');
-        }
-        return rows;
-    },
-});

package/clis/gitee/search.test.js

@@ -1,65 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './search.js';
-
-function mockGiteeResponse(hits) {
-    return {
-        ok: true,
-        json: () => Promise.resolve({ hits: { hits } }),
-    };
-}
-
-function makePage() {
-    return {
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-    };
-}
-
-describe('gitee search', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    afterEach(() => {
-        vi.unstubAllGlobals();
-    });
-
-    it('emits empty-string for missing language / description instead of a sentinel', async () => {
-        const cmd = getRegistry().get('gitee/search');
-        expect(cmd?.func).toBeTypeOf('function');
-        const fetchMock = vi.fn().mockResolvedValue(mockGiteeResponse([
-            {
-                fields: {
-                    title: 'someuser/no-meta-repo',
-                    url: 'https://gitee.com/someuser/no-meta-repo',
-                },
-            },
-        ]));
-        vi.stubGlobal('fetch', fetchMock);
-        const rows = await cmd.func(makePage(), { keyword: 'test', limit: 10 });
-        expect(rows).toHaveLength(1);
-        expect(rows[0].name).toBe('someuser/no-meta-repo');
-        expect(rows[0].language).toBe('');
-        expect(rows[0].description).toBe('');
-    });
-
-    it('passes through populated language / description verbatim', async () => {
-        const cmd = getRegistry().get('gitee/search');
-        const fetchMock = vi.fn().mockResolvedValue(mockGiteeResponse([
-            {
-                fields: {
-                    title: 'org/repo-a',
-                    url: 'https://gitee.com/org/repo-a',
-                    langs: 'TypeScript',
-                    description: 'A test repo',
-                    'count.star': '42',
-                },
-            },
-        ]));
-        vi.stubGlobal('fetch', fetchMock);
-        const rows = await cmd.func(makePage(), { keyword: 'test', limit: 10 });
-        expect(rows[0].language).toBe('TypeScript');
-        expect(rows[0].description).toBe('A test repo');
-        expect(rows[0].stars).toBe('42');
-    });
-});