@jackwener/opencli 1.7.11 → 1.7.12

package/clis/yollomi/try-on.js

@@ -9,6 +9,7 @@ import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.j
 cli({
     site: 'yollomi',
     name: 'try-on',
+    access: 'write',
     description: 'Virtual try-on — see how clothes look on a person (3 credits)',
     domain: YOLLOMI_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/yollomi/upload.js

@@ -19,6 +19,7 @@ const MIME_MAP = {
 cli({
     site: 'yollomi',
     name: 'upload',
+    access: 'write',
     description: 'Upload an image or video to Yollomi (returns URL for other commands)',
     domain: YOLLOMI_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/yollomi/upscale.js

@@ -9,6 +9,7 @@ import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.j
 cli({
     site: 'yollomi',
     name: 'upscale',
+    access: 'write',
     description: 'Upscale image resolution with AI (1 credit)',
     domain: YOLLOMI_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/yollomi/video.js

@@ -10,6 +10,7 @@ import { YOLLOMI_DOMAIN, yollomiPost, downloadOutput, fmtBytes } from './utils.j
 cli({
     site: 'yollomi',
     name: 'video',
+    access: 'write',
     description: 'Generate videos with AI (text-to-video or image-to-video)',
     domain: YOLLOMI_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/youtube/channel.js

@@ -21,6 +21,7 @@ export function extractSelectedRichGridContents(browseData) {
 cli({
     site: 'youtube',
     name: 'channel',
+    access: 'read',
     description: 'Get YouTube channel info and recent videos',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/comments.js

@@ -7,6 +7,7 @@ import { parseVideoId } from './utils.js';
 cli({
     site: 'youtube',
     name: 'comments',
+    access: 'read',
     description: 'Get YouTube video comments',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/feed.js

@@ -8,13 +8,14 @@ import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/erro
 cli({
     site: 'youtube',
     name: 'feed',
+    access: 'read',
     description: 'Get YouTube homepage recommended videos',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Max videos to return (default 20, max 100)' },
     ],
-    columns: ['rank', 'title', 'channel', 'views', 'duration', 'published', 'url'],
+    columns: ['rank', 'title', 'channel', 'video_id', 'views', 'duration', 'published', 'url'],
     func: async (page, kwargs) => {
         const limit = Math.min(kwargs.limit || 20, 100);
         await page.goto('https://www.youtube.com');
@@ -48,7 +49,7 @@ cli({
               views: parts[1] || '',
               duration,
               published: parts[2] || '',
-              videoId: lvm.contentId,
+              video_id: lvm.contentId,
             };
           }
 
@@ -61,7 +62,7 @@ cli({
               views: v.viewCountText?.simpleText || v.shortViewCountText?.simpleText || '',
               duration: v.lengthText?.simpleText || '',
               published: v.publishedTimeText?.simpleText || '',
-              videoId: v.videoId,
+              video_id: v.videoId,
             };
           }
           return null;
@@ -74,8 +75,8 @@ cli({
         for (const item of richContents) {
           if (videos.length >= limit) break;
           const v = extractFromItem(item);
-          if (v?.videoId) {
-            videos.push({ rank: videos.length + 1, ...v, url: 'https://www.youtube.com/watch?v=' + v.videoId });
+          if (v?.video_id) {
+            videos.push({ rank: videos.length + 1, ...v, url: 'https://www.youtube.com/watch?v=' + v.video_id });
           }
         }
 
@@ -97,8 +98,8 @@ cli({
             for (const item of newItems) {
               if (videos.length >= limit) break;
               const v = extractFromItem(item);
-              if (v?.videoId) {
-                videos.push({ rank: videos.length + 1, ...v, url: 'https://www.youtube.com/watch?v=' + v.videoId });
+              if (v?.video_id) {
+                videos.push({ rank: videos.length + 1, ...v, url: 'https://www.youtube.com/watch?v=' + v.video_id });
               }
             }
             contItem = newItems[newItems.length - 1];

package/clis/youtube/feed.test.js

@@ -0,0 +1,131 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './feed.js';
+
+function makePage({ initialData, continuationData, fetchImpl } = {}) {
+    const fetchMock = fetchImpl || vi.fn().mockResolvedValue({
+        ok: true,
+        json: async () => continuationData,
+    });
+
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        wait: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn(async (script) => {
+            const previousWindow = globalThis.window;
+            const previousFetch = globalThis.fetch;
+
+            globalThis.window = {
+                ytInitialData: initialData,
+                ytcfg: {
+                    data_: {
+                        INNERTUBE_API_KEY: 'test-key',
+                        INNERTUBE_CONTEXT: { client: { clientName: 'WEB', clientVersion: '1.0' } },
+                    },
+                },
+            };
+            globalThis.fetch = fetchMock;
+
+            try {
+                return await eval(script);
+            }
+            finally {
+                globalThis.window = previousWindow;
+                globalThis.fetch = previousFetch;
+            }
+        }),
+        __fetchMock: fetchMock,
+    };
+}
+
+const initialData = {
+    contents: {
+        twoColumnBrowseResultsRenderer: {
+            tabs: [{
+                tabRenderer: {
+                    content: {
+                        richGridRenderer: {
+                            contents: [
+                                {
+                                    richItemRenderer: {
+                                        content: {
+                                            videoRenderer: {
+                                                videoId: 'first-video',
+                                                title: { runs: [{ text: 'First video' }] },
+                                                ownerText: { runs: [{ text: 'First channel' }] },
+                                                viewCountText: { simpleText: '1K views' },
+                                                lengthText: { simpleText: '10:00' },
+                                                publishedTimeText: { simpleText: '1 day ago' },
+                                            },
+                                        },
+                                    },
+                                },
+                                {
+                                    continuationItemRenderer: {
+                                        continuationEndpoint: {
+                                            continuationCommand: {
+                                                token: 'next-token',
+                                            },
+                                        },
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                },
+            }],
+        },
+    },
+};
+
+const continuationData = {
+    onResponseReceivedActions: [{
+        appendContinuationItemsAction: {
+            continuationItems: [{
+                richItemRenderer: {
+                    content: {
+                        videoRenderer: {
+                            videoId: 'second-video',
+                            title: { runs: [{ text: 'Second video' }] },
+                            ownerText: { runs: [{ text: 'Second channel' }] },
+                            viewCountText: { simpleText: '2K views' },
+                            lengthText: { simpleText: '11:00' },
+                            publishedTimeText: { simpleText: '2 days ago' },
+                        },
+                    },
+                },
+            }],
+        },
+    }],
+};
+
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+
+describe('youtube feed', () => {
+    it('uses continuation results when the first page is below limit', async () => {
+        const page = makePage({ initialData, continuationData });
+        const cmd = getRegistry().get('youtube/feed');
+
+        const rows = await cmd.func(page, { limit: 2 });
+
+        expect(page.goto).toHaveBeenCalledWith('https://www.youtube.com');
+        expect(page.wait).toHaveBeenCalledWith(3);
+        expect(page.__fetchMock).toHaveBeenCalledTimes(1);
+        expect(rows).toEqual([
+            expect.objectContaining({
+                rank: 1,
+                title: 'First video',
+                video_id: 'first-video',
+                url: 'https://www.youtube.com/watch?v=first-video',
+            }),
+            expect.objectContaining({
+                rank: 2,
+                title: 'Second video',
+                video_id: 'second-video',
+                url: 'https://www.youtube.com/watch?v=second-video',
+            }),
+        ]);
+    });
+});

package/clis/youtube/history.js

@@ -7,6 +7,7 @@ import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/erro
 cli({
     site: 'youtube',
     name: 'history',
+    access: 'read',
     description: 'Get YouTube watch history',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/like.js

@@ -8,6 +8,7 @@ import { CommandExecutionError, AuthRequiredError } from '@jackwener/opencli/err
 cli({
     site: 'youtube',
     name: 'like',
+    access: 'write',
     description: 'Like a YouTube video',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/playlist.js

@@ -23,6 +23,7 @@ function parsePlaylistId(input) {
 cli({
     site: 'youtube',
     name: 'playlist',
+    access: 'read',
     description: 'Get YouTube playlist info and video list',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/search.js

@@ -5,6 +5,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'youtube',
     name: 'search',
+    access: 'read',
     description: 'Search YouTube videos',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/subscribe.js

@@ -8,6 +8,7 @@ import { CommandExecutionError, AuthRequiredError } from '@jackwener/opencli/err
 cli({
     site: 'youtube',
     name: 'subscribe',
+    access: 'write',
     description: 'Subscribe to a YouTube channel',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/subscriptions.js

@@ -8,6 +8,7 @@ import { extractSubscriptionChannel } from './utils.js';
 cli({
     site: 'youtube',
     name: 'subscriptions',
+    access: 'read',
     description: 'List subscribed YouTube channels',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/transcript.js

@@ -16,6 +16,7 @@ import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/erro
 cli({
     site: 'youtube',
     name: 'transcript',
+    access: 'read',
     description: 'Get YouTube video transcript/subtitles',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/unlike.js

@@ -8,6 +8,7 @@ import { CommandExecutionError, AuthRequiredError } from '@jackwener/opencli/err
 cli({
     site: 'youtube',
     name: 'unlike',
+    access: 'write',
     description: 'Remove like from a YouTube video',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/unsubscribe.js

@@ -8,6 +8,7 @@ import { CommandExecutionError, AuthRequiredError } from '@jackwener/opencli/err
 cli({
     site: 'youtube',
     name: 'unsubscribe',
+    access: 'write',
     description: 'Unsubscribe from a YouTube channel',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/video.js

@@ -7,6 +7,7 @@ import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'youtube',
     name: 'video',
+    access: 'read',
     description: 'Get YouTube video metadata (title, views, description, etc.)',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/youtube/watch-later.js

@@ -9,6 +9,7 @@ import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/erro
 cli({
     site: 'youtube',
     name: 'watch-later',
+    access: 'read',
     description: 'Get your YouTube Watch Later queue',
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,

package/clis/yuanbao/ask.js

@@ -352,6 +352,7 @@ async function waitForYuanbaoResponse(page, baselineAssistantCount, beforeLines,
 export const askCommand = cli({
     site: 'yuanbao',
     name: 'ask',
+    access: 'write',
     description: 'Send a prompt to Yuanbao web chat and wait for the assistant response',
     domain: YUANBAO_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/yuanbao/new.js

@@ -50,6 +50,7 @@ async function startNewYuanbaoChat(page) {
 export const newCommand = cli({
     site: 'yuanbao',
     name: 'new',
+    access: 'read',
     description: 'Start a new conversation in Yuanbao web chat',
     domain: YUANBAO_DOMAIN,
     strategy: Strategy.COOKIE,

package/clis/zhihu/answer.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute, resolveCurrentUserIdentity, resolvePayl
 cli({
     site: 'zhihu',
     name: 'answer',
+    access: 'write',
     description: 'Answer a Zhihu question',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/collection.js

@@ -104,6 +104,7 @@ function mapCollectionItem(item, rank) {
 cli({
   site: 'zhihu',
   name: 'collection',
+    access: 'read',
   description: '知乎收藏夹内容列表（需要登录）',
   domain: 'www.zhihu.com',
   strategy: Strategy.COOKIE,

package/clis/zhihu/collections.js

@@ -39,6 +39,7 @@ function collectionKey(item) {
 cli({
   site: 'zhihu',
   name: 'collections',
+    access: 'read',
   description: '知乎收藏夹列表（需要登录）',
   domain: 'www.zhihu.com',
   strategy: Strategy.COOKIE,

package/clis/zhihu/comment.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute, resolveCurrentUserIdentity, resolvePayl
 cli({
     site: 'zhihu',
     name: 'comment',
+    access: 'write',
     description: 'Create a top-level comment on a Zhihu answer or article',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/download.js

@@ -9,6 +9,7 @@ import { downloadArticle } from '@jackwener/opencli/download/article-download';
 cli({
     site: 'zhihu',
     name: 'download',
+    access: 'read',
     description: '导出知乎文章为 Markdown 格式',
     domain: 'zhuanlan.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/favorite.js

@@ -12,6 +12,7 @@ function normalizeCollectionName(value) {
 cli({
     site: 'zhihu',
     name: 'favorite',
+    access: 'write',
     description: 'Favorite a Zhihu answer or article into a specific collection',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/follow.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute } from './write-shared.js';
 cli({
     site: 'zhihu',
     name: 'follow',
+    access: 'write',
     description: 'Follow a Zhihu user or question',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/hot.js

@@ -2,6 +2,7 @@ import { cli } from '@jackwener/opencli/registry';
 cli({
     site: 'zhihu',
     name: 'hot',
+    access: 'read',
     description: '知乎热榜',
     domain: 'www.zhihu.com',
     args: [

package/clis/zhihu/like.js

@@ -5,6 +5,7 @@ import { buildResultRow, requireExecute } from './write-shared.js';
 cli({
     site: 'zhihu',
     name: 'like',
+    access: 'write',
     description: 'Like a Zhihu answer or article',
     domain: 'zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/question.js

@@ -12,6 +12,7 @@ function stripHtml(html) {
 cli({
     site: 'zhihu',
     name: 'question',
+    access: 'read',
     description: '知乎问题详情和回答',
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,

package/clis/zhihu/search.js

@@ -2,6 +2,7 @@ import { cli } from '@jackwener/opencli/registry';
 cli({
     site: 'zhihu',
     name: 'search',
+    access: 'read',
     description: '知乎搜索',
     domain: 'www.zhihu.com',
     args: [

package/clis/zlibrary/info.js

@@ -5,6 +5,7 @@ import { ZLIBRARY_DOMAIN, extractBookTitle, extractFormats, normalizeZlibraryBoo
 cli({
   site: 'zlibrary',
   name: 'info',
+    access: 'read',
   description: 'Get book details and available download formats from a Z-Library book page',
   domain: ZLIBRARY_DOMAIN,
   strategy: Strategy.COOKIE,

package/clis/zlibrary/search.js

@@ -5,6 +5,7 @@ import { ZLIBRARY_DOMAIN, buildSearchUrl, extractSearchResults } from './utils.j
 cli({
   site: 'zlibrary',
   name: 'search',
+    access: 'read',
   description: 'Search Z-Library for books by title, author, ISBN, or keyword',
   domain: ZLIBRARY_DOMAIN,
   strategy: Strategy.COOKIE,

package/clis/zsxq/dynamics.js

@@ -3,6 +3,7 @@ import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicText, getTopicA
 cli({
     site: 'zsxq',
     name: 'dynamics',
+    access: 'read',
     description: '获取所有星球的最新动态',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,

package/clis/zsxq/groups.js

@@ -3,6 +3,7 @@ import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse,
 cli({
     site: 'zsxq',
     name: 'groups',
+    access: 'read',
     description: '列出当前账号加入的星球',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,

package/clis/zsxq/search.js

@@ -3,6 +3,7 @@ import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGr
 cli({
     site: 'zsxq',
     name: 'search',
+    access: 'read',
     description: '搜索星球内容',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,

package/clis/zsxq/topic.js

@@ -4,6 +4,7 @@ import { getActiveGroupId, browserJsonRequest, ensureZsxqAuth, ensureZsxqPage, f
 cli({
     site: 'zsxq',
     name: 'topic',
+    access: 'read',
     description: '获取单个话题详情和评论',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,

package/clis/zsxq/topics.js

@@ -3,6 +3,7 @@ import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTo
 cli({
     site: 'zsxq',
     name: 'topics',
+    access: 'read',
     description: '获取当前星球的话题列表',
     domain: 'wx.zsxq.com',
     strategy: Strategy.COOKIE,

package/dist/src/adapter-source.test.js

@@ -3,7 +3,7 @@ import { resolveAdapterSourcePath } from './adapter-source.js';
 function makeCmd(overrides = {}) {
     return {
         site: 'test-site',
-        name: 'test-cmd',
+        name: 'test-cmd', access: 'read',
         description: 'test',
         args: [],
         ...overrides,

package/dist/src/browser/analyze.test.js

@@ -20,8 +20,10 @@ function mkCmd(site, name, domain) {
     return {
         site,
         name,
+        access: 'read',
         description: '',
         domain,
+        browser: false,
         args: [],
     };
 }

package/dist/src/browser/base-page.d.ts

@@ -23,6 +23,7 @@ export declare abstract class BasePage implements IPage {
     protected _lastUrl: string | null;
     /** Cached previous snapshot hashes for incremental diff marking */
     private _prevSnapshotHashes;
+    private _cdpTargetMarkerSeq;
     abstract goto(url: string, options?: {
         waitUntil?: 'load' | 'none';
         settleMs?: number;
@@ -53,6 +54,14 @@ export declare abstract class BasePage implements IPage {
     protected tryNativeType(text: string): Promise<boolean>;
     /** Uses native CDP key events when the concrete page exposes them. */
     protected tryNativeKeyPress(key: string, modifiers: string[]): Promise<boolean>;
+    /**
+     * Run a DOM-domain CDP command against `window.__resolved`.
+     *
+     * CDP DOM.focus / DOM.scrollIntoViewIfNeeded need a nodeId, while our
+     * resolver stores the live Element in page JS. Bridge the two worlds with a
+     * short-lived marker attribute, then query it through CDP.
+     */
+    protected tryCdpOnResolvedElement(method: 'DOM.focus' | 'DOM.scrollIntoViewIfNeeded'): Promise<boolean>;
     typeText(ref: string, text: string, opts?: ResolveOptions): Promise<ResolveSuccess>;
     pressKey(key: string): Promise<void>;
     scrollTo(ref: string, opts?: ResolveOptions): Promise<unknown>;