@jackwener/opencli 1.6.9 → 1.7.0

package/dist/clis/bluesky/feeds.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'feeds',
+    description: 'Popular Bluesky feed generators',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of feeds' },
+    ],
+    columns: ['rank', 'name', 'likes', 'creator', 'description'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.unspecced.getPopularFeedGenerators?limit=${{ args.limit }}',
+            } },
+        { select: 'feeds' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                name: '${{ item.displayName }}',
+                likes: '${{ item.likeCount }}',
+                creator: '${{ item.creator.handle }}',
+                description: '${{ item.description }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/followers.d.ts

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

package/dist/clis/bluesky/followers.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'followers',
+    description: 'List followers of a Bluesky user',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'handle', required: true, positional: true, help: 'Bluesky handle' },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of followers' },
+    ],
+    columns: ['rank', 'handle', 'name', 'description'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.graph.getFollowers?actor=${{ args.handle }}&limit=${{ args.limit }}',
+            } },
+        { select: 'followers' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                handle: '${{ item.handle }}',
+                name: '${{ item.displayName }}',
+                description: '${{ item.description }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/following.d.ts

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

package/dist/clis/bluesky/following.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'following',
+    description: 'List accounts a Bluesky user is following',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'handle', required: true, positional: true, help: 'Bluesky handle' },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of accounts' },
+    ],
+    columns: ['rank', 'handle', 'name', 'description'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.graph.getFollows?actor=${{ args.handle }}&limit=${{ args.limit }}',
+            } },
+        { select: 'follows' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                handle: '${{ item.handle }}',
+                name: '${{ item.displayName }}',
+                description: '${{ item.description }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/profile.d.ts

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

package/dist/clis/bluesky/profile.js

@@ -0,0 +1,29 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'profile',
+    description: 'Get Bluesky user profile info',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'handle',
+            required: true,
+            positional: true,
+            help: 'Bluesky handle (e.g. bsky.app, jay.bsky.team)',
+        },
+    ],
+    columns: ['handle', 'name', 'followers', 'following', 'posts', 'description'],
+    pipeline: [
+        { fetch: { url: 'https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=${{ args.handle }}' } },
+        { map: {
+                handle: '${{ item.handle }}',
+                name: '${{ item.displayName }}',
+                followers: '${{ item.followersCount }}',
+                following: '${{ item.followsCount }}',
+                posts: '${{ item.postsCount }}',
+                description: '${{ item.description }}',
+            } },
+    ],
+});

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

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

package/dist/clis/bluesky/search.js

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'search',
+    description: 'Search Bluesky users',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'query', required: true, positional: true, help: 'Search query' },
+        { name: 'limit', type: 'int', default: 10, help: 'Number of results' },
+    ],
+    columns: ['rank', 'handle', 'name', 'followers', 'description'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.actor.searchActors?q=${{ args.query }}&limit=${{ args.limit }}',
+            } },
+        { select: 'actors' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                handle: '${{ item.handle }}',
+                name: '${{ item.displayName }}',
+                followers: '${{ item.followersCount }}',
+                description: '${{ item.description }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/starter-packs.d.ts

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

package/dist/clis/bluesky/starter-packs.js

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'starter-packs',
+    description: 'Get starter packs created by a Bluesky user',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'handle', required: true, positional: true, help: 'Bluesky handle' },
+        { name: 'limit', type: 'int', default: 10, help: 'Number of starter packs' },
+    ],
+    columns: ['rank', 'name', 'description', 'members', 'joins'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.graph.getActorStarterPacks?actor=${{ args.handle }}&limit=${{ args.limit }}',
+            } },
+        { select: 'starterPacks' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                name: '${{ item.record.name }}',
+                description: '${{ item.record.description }}',
+                members: '${{ item.listItemCount }}',
+                joins: '${{ item.joinedAllTimeCount }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/thread.d.ts

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

package/dist/clis/bluesky/thread.js

@@ -0,0 +1,30 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'thread',
+    description: 'Get a Bluesky post thread with replies',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'uri',
+            required: true,
+            positional: true,
+            help: 'Post AT URI (at://did:.../app.bsky.feed.post/...) or bsky.app URL',
+        },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of replies' },
+    ],
+    columns: ['author', 'text', 'likes', 'reposts', 'replies_count'],
+    pipeline: [
+        { fetch: { url: 'https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread?uri=${{ args.uri }}&depth=2' } },
+        { select: 'thread' },
+        { map: {
+                author: '${{ item.post.author.handle }}',
+                text: '${{ item.post.record.text }}',
+                likes: '${{ item.post.likeCount }}',
+                reposts: '${{ item.post.repostCount }}',
+                replies_count: '${{ item.post.replyCount }}',
+            } },
+    ],
+});

package/dist/clis/bluesky/trending.d.ts

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

package/dist/clis/bluesky/trending.js

@@ -0,0 +1,19 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'trending',
+    description: 'Trending topics on Bluesky',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of topics' },
+    ],
+    columns: ['rank', 'topic', 'link'],
+    pipeline: [
+        { fetch: { url: 'https://public.api.bsky.app/xrpc/app.bsky.unspecced.getTrendingTopics' } },
+        { select: 'topics' },
+        { map: { rank: '${{ index + 1 }}', topic: '${{ item.topic }}', link: '${{ item.link }}' } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/bluesky/user.d.ts

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

package/dist/clis/bluesky/user.js

@@ -0,0 +1,33 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'bluesky',
+    name: 'user',
+    description: 'Get recent posts from a Bluesky user',
+    domain: 'public.api.bsky.app',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'handle',
+            required: true,
+            positional: true,
+            help: 'Bluesky handle (e.g. bsky.app)',
+        },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of posts' },
+    ],
+    columns: ['rank', 'text', 'likes', 'reposts', 'replies'],
+    pipeline: [
+        { fetch: {
+                url: 'https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=${{ args.handle }}&limit=${{ args.limit }}',
+            } },
+        { select: 'feed' },
+        { map: {
+                rank: '${{ index + 1 }}',
+                text: '${{ item.post.record.text }}',
+                likes: '${{ item.post.likeCount }}',
+                reposts: '${{ item.post.repostCount }}',
+                replies: '${{ item.post.replyCount }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

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

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

package/dist/clis/cnki/search.js

@@ -0,0 +1,60 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
+cli({
+    site: 'cnki',
+    name: 'search',
+    description: '中国知网论文搜索（海外版）',
+    domain: 'oversea.cnki.net',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'query', positional: true, required: true, help: '搜索关键词' },
+        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
+    ],
+    columns: ['rank', 'title', 'authors', 'journal', 'date', 'url'],
+    navigateBefore: false,
+    func: async (page, kwargs) => {
+        const limit = clampInt(kwargs.limit, 10, 1, 20);
+        const query = requireNonEmptyQuery(kwargs.query);
+        await page.goto(`https://oversea.cnki.net/kns/search?dbcode=CFLS&kw=${encodeURIComponent(query)}&korder=SU`);
+        await page.wait(8);
+        const data = await page.evaluate(`
+      (async () => {
+        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
+        for (let i = 0; i < 40; i++) {
+          if (document.querySelector('.result-table-list tbody tr, #gridTable tbody tr')) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+        const rows = document.querySelectorAll('.result-table-list tbody tr, #gridTable tbody tr');
+        const results = [];
+        for (const row of rows) {
+          const tds = row.querySelectorAll('td');
+          if (tds.length < 5) continue;
+
+          const nameCell = row.querySelector('td.name') || tds[2];
+          const titleEl = nameCell?.querySelector('a');
+          const title = normalize(titleEl?.textContent).replace(/免费$/, '');
+          if (!title) continue;
+
+          let url = titleEl?.getAttribute('href') || '';
+          if (url && !url.startsWith('http')) url = 'https://oversea.cnki.net' + url;
+
+          const authorCell = row.querySelector('td.author') || tds[3];
+          const journalCell = row.querySelector('td.source') || tds[4];
+          const dateCell = row.querySelector('td.date') || tds[5];
+
+          results.push({
+            rank: results.length + 1,
+            title,
+            authors: normalize(authorCell?.textContent),
+            journal: normalize(journalCell?.textContent),
+            date: normalize(dateCell?.textContent),
+            url,
+          });
+          if (results.length >= ${limit}) break;
+        }
+        return results;
+      })()
+    `);
+        return Array.isArray(data) ? data : [];
+    },
+});

package/dist/clis/cnki/search.test.d.ts

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

package/dist/clis/cnki/search.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './search.js';
+describe('cnki search command', () => {
+    const command = getRegistry().get('cnki/search');
+    it('registers the command', () => {
+        expect(command).toBeDefined();
+        expect(command.site).toBe('cnki');
+        expect(command.name).toBe('search');
+    });
+    it('rejects empty queries before browser navigation', async () => {
+        const page = { goto: async () => undefined };
+        await expect(command.func(page, { query: '   ' })).rejects.toMatchObject({
+            name: 'ArgumentError',
+            code: 'ARGUMENT',
+        });
+    });
+});

package/dist/clis/devto/tag.d.ts

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

package/dist/clis/devto/tag.js

@@ -0,0 +1,32 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'devto',
+    name: 'tag',
+    description: 'Latest DEV.to articles for a specific tag',
+    domain: 'dev.to',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'tag',
+            required: true,
+            positional: true,
+            help: 'Tag name (e.g. javascript, python, webdev)',
+        },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
+    ],
+    columns: ['rank', 'title', 'author', 'reactions', 'comments', 'tags'],
+    pipeline: [
+        { fetch: { url: 'https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}' } },
+        { map: {
+                rank: '${{ index + 1 }}',
+                title: '${{ item.title }}',
+                author: '${{ item.user.username }}',
+                reactions: '${{ item.public_reactions_count }}',
+                comments: '${{ item.comments_count }}',
+                tags: `\${{ item.tag_list | join(', ') }}`,
+                url: '${{ item.url }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/devto/top.d.ts

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

package/dist/clis/devto/top.js

@@ -0,0 +1,26 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'devto',
+    name: 'top',
+    description: 'Top DEV.to articles of the day',
+    domain: 'dev.to',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
+    ],
+    columns: ['rank', 'title', 'author', 'reactions', 'comments', 'tags'],
+    pipeline: [
+        { fetch: { url: 'https://dev.to/api/articles?top=1&per_page=${{ args.limit }}' } },
+        { map: {
+                rank: '${{ index + 1 }}',
+                title: '${{ item.title }}',
+                author: '${{ item.user.username }}',
+                reactions: '${{ item.public_reactions_count }}',
+                comments: '${{ item.comments_count }}',
+                tags: `\${{ item.tag_list | join(', ') }}`,
+                url: '${{ item.url }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/devto/user.d.ts

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

package/dist/clis/devto/user.js

@@ -0,0 +1,31 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'devto',
+    name: 'user',
+    description: 'Recent DEV.to articles from a specific user',
+    domain: 'dev.to',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'username',
+            required: true,
+            positional: true,
+            help: 'DEV.to username (e.g. ben, thepracticaldev)',
+        },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
+    ],
+    columns: ['rank', 'title', 'reactions', 'comments', 'tags'],
+    pipeline: [
+        { fetch: { url: 'https://dev.to/api/articles?username=${{ args.username }}&per_page=${{ args.limit }}' } },
+        { map: {
+                rank: '${{ index + 1 }}',
+                title: '${{ item.title }}',
+                reactions: '${{ item.public_reactions_count }}',
+                comments: '${{ item.comments_count }}',
+                tags: `\${{ item.tag_list | join(', ') }}`,
+                url: '${{ item.url }}',
+            } },
+        { limit: '${{ args.limit }}' },
+    ],
+});

package/dist/clis/dictionary/examples.d.ts

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

package/dist/clis/dictionary/examples.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'dictionary',
+    name: 'examples',
+    description: 'Read real-world example sentences utilizing the word',
+    domain: 'api.dictionaryapi.dev',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'word',
+            type: 'string',
+            required: true,
+            positional: true,
+            help: 'Word to get example sentences for',
+        },
+    ],
+    columns: ['word', 'example'],
+    pipeline: [
+        { fetch: { url: 'https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}' } },
+        { map: {
+                word: '${{ item.word }}',
+                example: `\${{ (() => { if (item.meanings) { for (const m of item.meanings) { if (m.definitions) { for (const d of m.definitions) { if (d.example) return d.example; } } } } return 'No example found in API.'; })() }}`,
+            } },
+        { limit: 1 },
+    ],
+});

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

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

package/dist/clis/dictionary/search.js

@@ -0,0 +1,29 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'dictionary',
+    name: 'search',
+    description: 'Search the Free Dictionary API for definitions, parts of speech, and pronunciations.',
+    domain: 'api.dictionaryapi.dev',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'word',
+            type: 'string',
+            required: true,
+            positional: true,
+            help: 'Word to define (e.g., serendipity)',
+        },
+    ],
+    columns: ['word', 'phonetic', 'type', 'definition'],
+    pipeline: [
+        { fetch: { url: 'https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}' } },
+        { map: {
+                word: '${{ item.word }}',
+                phonetic: `\${{ (() => { if (item.phonetic) return item.phonetic; if (item.phonetics) { for (const p of item.phonetics) { if (p.text) return p.text; } } return ''; })() }}`,
+                type: `\${{ (() => { if (item.meanings && item.meanings[0] && item.meanings[0].partOfSpeech) return item.meanings[0].partOfSpeech; return 'N/A'; })() }}`,
+                definition: `\${{ (() => { if (item.meanings && item.meanings[0] && item.meanings[0].definitions && item.meanings[0].definitions[0] && item.meanings[0].definitions[0].definition) return item.meanings[0].definitions[0].definition; return 'No definition found in API.'; })() }}`,
+            } },
+        { limit: 1 },
+    ],
+});

package/dist/clis/dictionary/synonyms.d.ts

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

package/dist/clis/dictionary/synonyms.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+cli({
+    site: 'dictionary',
+    name: 'synonyms',
+    description: 'Find synonyms for a specific word',
+    domain: 'api.dictionaryapi.dev',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: 'word',
+            type: 'string',
+            required: true,
+            positional: true,
+            help: 'Word to find synonyms for (e.g., serendipity)',
+        },
+    ],
+    columns: ['word', 'synonyms'],
+    pipeline: [
+        { fetch: { url: 'https://api.dictionaryapi.dev/api/v2/entries/en/${{ args.word | urlencode }}' } },
+        { map: {
+                word: '${{ item.word }}',
+                synonyms: `\${{ (() => { const s = new Set(); if (item.meanings) { for (const m of item.meanings) { if (m.synonyms) { for (const syn of m.synonyms) s.add(syn); } if (m.definitions) { for (const d of m.definitions) { if (d.synonyms) { for (const syn of d.synonyms) s.add(syn); } } } } } const arr = Array.from(s); return arr.length > 0 ? arr.slice(0, 5).join(', ') : 'No synonyms found in API.'; })() }}`,
+            } },
+        { limit: 1 },
+    ],
+});

package/dist/clis/douban/subject.d.ts

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