publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/reddit/home.js

@@ -1,78 +1,4 @@
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-
-const REDDIT_HOME_MAX_LIMIT = 100;
-
-export function parseRedditHomeLimit(raw) {
-    if (raw === undefined || raw === null || raw === '') return 25;
-    const n = Number(raw);
-    if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1 || n > REDDIT_HOME_MAX_LIMIT) {
-        throw new ArgumentError(
-            `limit must be an integer in [1, ${REDDIT_HOME_MAX_LIMIT}].`,
-            `Got: ${raw}`,
-        );
-    }
-    return n;
-}
-
-export function decodeRedditHtml(value) {
-    if (typeof value !== 'string' || !value) return '';
-    return value
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/&#x27;/gi, "'")
-        .replace(/&#39;/g, "'");
-}
-
-export function extractRedditMedia(d) {
-    const galleryUrls = [];
-    const items = d?.gallery_data?.items;
-    const meta = d?.media_metadata;
-    if (Array.isArray(items) && meta && typeof meta === 'object') {
-        for (const item of items) {
-            const url = meta[item?.media_id]?.s?.u;
-            if (typeof url === 'string' && url) galleryUrls.push(decodeRedditHtml(url));
-        }
-    }
-    return {
-        post_hint: typeof d?.post_hint === 'string' ? d.post_hint : '',
-        url_overridden_by_dest: decodeRedditHtml(d?.url_overridden_by_dest || ''),
-        preview_image_url: decodeRedditHtml(d?.preview?.images?.[0]?.source?.url || ''),
-        gallery_urls: galleryUrls,
-    };
-}
-
-cli({
-    site: 'reddit',
-    name: 'home',
-    access: 'read',
-    description: 'Reddit personalized home feed (Best, requires login)',
-    domain: 'reddit.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 25, help: `Number of posts (1–${REDDIT_HOME_MAX_LIMIT})` },
-    ],
-    columns: ['rank', 'title', 'subreddit', 'score', 'comments', 'postId', 'author', 'url', 'post_hint', 'url_overridden_by_dest', 'preview_image_url', 'gallery_urls'],
-    func: async (page, kwargs) => {
-        const limit = parseRedditHomeLimit(kwargs.limit);
-        await page.goto('https://www.reddit.com');
-        // The Best feed is personalized only when logged in — for anonymous
-        // sessions Reddit returns a generic listing that overlaps with /r/all.
-        // To make `home` semantically meaningful (vs the public `frontpage`
-        // command) we require auth and surface the logged-out case via
-        // AuthRequiredError instead of silently returning the public feed.
-        //
-        // Two-pronged auth detection: HTTP 401/403 OR `me.data.name` missing
-        // on 200 (stale anonymous cookie session). See PR #1428 sediment.
-        //
-        // Intermediate object keys avoid `rank`/`title`/`subreddit`/etc. to
-        // sidestep the silent-column-drop audit; we use `entries` for the
-        // raw payload. See PR #1329 sediment "中间解析对象 key 不能跟
-        // columns 任一项重叠".
-        const result = await page.evaluate(`(async () => {
+import{ArgumentError as V,AuthRequiredError as W,CommandExecutionError as N,EmptyResultError as Y}from"@jackwener/opencli/errors";import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";const Q=100;export function parseRedditHomeLimit(b){if(b===void 0||b===null||b==="")return 25;const B=Number(b);if(!Number.isFinite(B)||!Number.isInteger(B)||B<1||B>Q)throw new V(`limit must be an integer in [1, ${Q}].`,`Got: ${b}`);return B}export function decodeRedditHtml(b){if(typeof b!=="string"||!b)return"";return b.replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&#x27;/gi,"'").replace(/&#39;/g,"'")}export function extractRedditMedia(b){const B=[],G=b?.gallery_data?.items,z=b?.media_metadata;if(Array.isArray(G)&&z&&typeof z==="object")for(const J of G){const F=z[J?.media_id]?.s?.u;if(typeof F==="string"&&F)B.push(decodeRedditHtml(F))}return{post_hint:typeof b?.post_hint==="string"?b.post_hint:"",url_overridden_by_dest:decodeRedditHtml(b?.url_overridden_by_dest||""),preview_image_url:decodeRedditHtml(b?.preview?.images?.[0]?.source?.url||""),gallery_urls:B}}Z({site:"reddit",name:"home",access:"read",description:"Reddit personalized home feed (Best, requires login)",domain:"reddit.com",strategy:$.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:25,help:`Number of posts (1–${Q})`}],columns:["rank","title","subreddit","score","comments","postId","author","url","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],func:async(b,B)=>{const G=parseRedditHomeLimit(B.limit);await b.goto("https://www.reddit.com");const z=await b.evaluate(`(async () => {
       try {
         const meRes = await fetch('/api/me.json', { credentials: 'include' });
         if (meRes.status === 401 || meRes.status === 403) {
@@ -86,7 +12,7 @@ cli({
           return { kind: 'auth', detail: 'Not logged in to reddit.com (no identity in /api/me.json)' };
         }
 
-        const limit = ${JSON.stringify(limit)};
+        const limit = ${JSON.stringify(G)};
         const res = await fetch('/best.json?limit=' + limit + '&raw_json=1', { credentials: 'include' });
         if (res.status === 401 || res.status === 403) {
           return { kind: 'auth', detail: 'Reddit /best.json returned HTTP ' + res.status };
@@ -103,44 +29,4 @@ cli({
       } catch (e) {
         return { kind: 'exception', detail: String(e && e.message || e) };
       }
-    })()`);
-
-        if (result?.kind === 'auth') {
-            throw new AuthRequiredError('reddit.com', result.detail);
-        }
-        if (result?.kind === 'http') {
-            throw new CommandExecutionError(`HTTP ${result.httpStatus} from ${result.where}`);
-        }
-        if (result?.kind === 'exception') {
-            throw new CommandExecutionError(`home failed: ${result.detail}`);
-        }
-        if (result?.kind !== 'ok') {
-            throw new CommandExecutionError(`Unexpected result from reddit home: ${JSON.stringify(result)}`);
-        }
-
-        const rows = [];
-        const entries = result.entries.slice(0, limit);
-        for (let i = 0; i < entries.length; i++) {
-            const d = entries[i]?.data;
-            if (!d || !d.id) continue;
-            rows.push({
-                rank: i + 1,
-                title: typeof d.title === 'string' ? d.title : null,
-                subreddit: typeof d.subreddit_name_prefixed === 'string' ? d.subreddit_name_prefixed : null,
-                score: typeof d.score === 'number' ? d.score : null,
-                comments: typeof d.num_comments === 'number' ? d.num_comments : null,
-                postId: d.id,
-                author: typeof d.author === 'string' ? d.author : null,
-                url: d.permalink ? 'https://www.reddit.com' + d.permalink : null,
-                ...extractRedditMedia(d),
-            });
-        }
-        if (rows.length === 0) {
-            if (entries.length > 0) {
-                throw new CommandExecutionError('Reddit home feed entries were missing required post id anchors');
-            }
-            throw new EmptyResultError('Reddit returned no posts in the personalized home feed.');
-        }
-        return rows;
-    },
-});
+    })()`);if(z?.kind==="auth")throw new W("reddit.com",z.detail);if(z?.kind==="http")throw new N(`HTTP ${z.httpStatus} from ${z.where}`);if(z?.kind==="exception")throw new N(`home failed: ${z.detail}`);if(z?.kind!=="ok")throw new N(`Unexpected result from reddit home: ${JSON.stringify(z)}`);const J=[],F=z.entries.slice(0,G);for(let K=0;K<F.length;K++){const f=F[K]?.data;if(!f||!f.id)continue;J.push({rank:K+1,title:typeof f.title==="string"?f.title:null,subreddit:typeof f.subreddit_name_prefixed==="string"?f.subreddit_name_prefixed:null,score:typeof f.score==="number"?f.score:null,comments:typeof f.num_comments==="number"?f.num_comments:null,postId:f.id,author:typeof f.author==="string"?f.author:null,url:f.permalink?"https://www.reddit.com"+f.permalink:null,...extractRedditMedia(f)})}if(J.length===0){if(F.length>0)throw new N("Reddit home feed entries were missing required post id anchors");throw new Y("Reddit returned no posts in the personalized home feed.")}return J}});

package/clis/reddit/hot.js

@@ -1,22 +1,4 @@
-import { cli } from '@jackwener/opencli/registry';
-cli({
-    site: 'reddit',
-    name: 'hot',
-    access: 'read',
-    description: 'Reddit 热门帖子',
-    domain: 'www.reddit.com',
-    args: [
-        {
-            name: 'subreddit',
-            default: '',
-            help: 'Subreddit name (e.g. programming). Empty for frontpage',
-        },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of posts' },
-    ],
-    columns: ['rank', 'title', 'subreddit', 'score', 'comments', 'postId', 'author', 'url', 'post_hint', 'url_overridden_by_dest', 'preview_image_url', 'gallery_urls'],
-    pipeline: [
-        { navigate: 'https://www.reddit.com' },
-        { evaluate: `(async () => {
+import{cli as e}from"@jackwener/opencli/registry";e({site:"reddit",name:"hot",access:"read",description:"Reddit 热门帖子",domain:"www.reddit.com",args:[{name:"subreddit",default:"",help:"Subreddit name (e.g. programming). Empty for frontpage"},{name:"limit",type:"int",default:20,help:"Number of posts"}],columns:["rank","title","subreddit","score","comments","postId","author","url","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],pipeline:[{navigate:"https://www.reddit.com"},{evaluate:`(async () => {
   function decodeHtml(s) {
     if (typeof s !== 'string' || !s) return '';
     return s
@@ -61,21 +43,4 @@ cli({
     ...extractRedditMedia(c.data),
   }));
 })()
-` },
-        { map: {
-                rank: '${{ index + 1 }}',
-                title: '${{ item.title }}',
-                subreddit: '${{ item.subreddit }}',
-                score: '${{ item.score }}',
-                comments: '${{ item.comments }}',
-                postId: '${{ item.postId }}',
-                author: '${{ item.author }}',
-                url: '${{ item.url }}',
-                post_hint: '${{ item.post_hint }}',
-                url_overridden_by_dest: '${{ item.url_overridden_by_dest }}',
-                preview_image_url: '${{ item.preview_image_url }}',
-                gallery_urls: '${{ item.gallery_urls }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+`},{map:{rank:"${{ index + 1 }}",title:"${{ item.title }}",subreddit:"${{ item.subreddit }}",score:"${{ item.score }}",comments:"${{ item.comments }}",postId:"${{ item.postId }}",author:"${{ item.author }}",url:"${{ item.url }}",post_hint:"${{ item.post_hint }}",url_overridden_by_dest:"${{ item.url_overridden_by_dest }}",preview_image_url:"${{ item.preview_image_url }}",gallery_urls:"${{ item.gallery_urls }}"}},{limit:"${{ args.limit }}"}]});

package/clis/reddit/popular.js

@@ -1,18 +1,4 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'reddit',
-    name: 'popular',
-    access: 'read',
-    description: 'Reddit Popular posts (/r/popular)',
-    domain: 'reddit.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 20 },
-    ],
-    columns: ['rank', 'id', 'title', 'subreddit', 'score', 'comments', 'author', 'url', 'created_utc', 'selftext', 'post_hint', 'url_overridden_by_dest', 'preview_image_url', 'gallery_urls'],
-    pipeline: [
-        { evaluate: `(async () => {
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"reddit",name:"popular",access:"read",description:"Reddit Popular posts (/r/popular)",domain:"reddit.com",strategy:t.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20}],columns:["rank","id","title","subreddit","score","comments","author","url","created_utc","selftext","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],pipeline:[{evaluate:`(async () => {
   function decodeHtml(s) {
     if (typeof s !== 'string' || !s) return '';
     return s
@@ -57,23 +43,4 @@ cli({
     ...extractRedditMedia(c.data),
   }));
 })()
-` },
-        { map: {
-                rank: '${{ index + 1 }}',
-                id: '${{ item.id }}',
-                title: '${{ item.title }}',
-                subreddit: '${{ item.subreddit }}',
-                score: '${{ item.score }}',
-                comments: '${{ item.comments }}',
-                author: '${{ item.author }}',
-                url: '${{ item.url }}',
-                created_utc: '${{ item.created_utc }}',
-                selftext: '${{ item.selftext }}',
-                post_hint: '${{ item.post_hint }}',
-                url_overridden_by_dest: '${{ item.url_overridden_by_dest }}',
-                preview_image_url: '${{ item.preview_image_url }}',
-                gallery_urls: '${{ item.gallery_urls }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+`},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",subreddit:"${{ item.subreddit }}",score:"${{ item.score }}",comments:"${{ item.comments }}",author:"${{ item.author }}",url:"${{ item.url }}",created_utc:"${{ item.created_utc }}",selftext:"${{ item.selftext }}",post_hint:"${{ item.post_hint }}",url_overridden_by_dest:"${{ item.url_overridden_by_dest }}",preview_image_url:"${{ item.preview_image_url }}",gallery_urls:"${{ item.gallery_urls }}"}},{limit:"${{ args.limit }}"}]});

package/clis/reddit/read.js

@@ -1,166 +1,4 @@
-/**
- * Reddit post reader with threaded comment tree.
- *
- * Replaces the original flat read.yaml with recursive comment traversal:
- * - Top-K comments by score at each level
- * - Configurable depth and replies-per-level
- * - Indented output showing conversation threads
- * - Optional --expand-more to follow Reddit's "more comments" stubs via
- *   /api/morechildren.json (rdt-cli parity, PR B of #1481 follow-up)
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-const REDDIT_EXPAND_ROUNDS_MIN = 1;
-const REDDIT_EXPAND_ROUNDS_MAX = 5;
-const DEFAULT_EXPAND_ROUNDS = 2;
-const REDDIT_POST_ID_RE = /^[a-z0-9]+$/i;
-
-function normalizeBareRedditPostId(value) {
-    const postId = String(value || '').trim();
-    if (!REDDIT_POST_ID_RE.test(postId)) {
-        throw new ArgumentError(
-            'Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.',
-            'Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.',
-        );
-    }
-    return postId.toLowerCase();
-}
-
-export function normalizeRedditPostId(value) {
-    const raw = String(value || '').trim();
-    if (!raw) {
-        throw new ArgumentError(
-            'Post ID is required.',
-            'Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.',
-        );
-    }
-
-    const fullname = raw.match(/^t3_([a-z0-9]+)$/i);
-    if (fullname) return normalizeBareRedditPostId(fullname[1]);
-
-    if (/^https?:\/\//i.test(raw)) {
-        let parsed;
-        try {
-            parsed = new URL(raw);
-        } catch {
-            throw new ArgumentError(`Invalid Reddit post URL: ${raw}`);
-        }
-        const host = parsed.hostname.toLowerCase();
-        if (parsed.protocol !== 'https:' || (host !== 'reddit.com' && !host.endsWith('.reddit.com'))) {
-            throw new ArgumentError(
-                'Post URL must be an https reddit.com URL.',
-                'Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/',
-            );
-        }
-        const parts = parsed.pathname.split('/').filter(Boolean);
-        const commentsIndex = parts.indexOf('comments');
-        const postIndex = commentsIndex + 1;
-        if (commentsIndex < 0 || parts.length <= postIndex) {
-            throw new ArgumentError(
-                'Post URL must include the target post id.',
-                'Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/',
-            );
-        }
-        if (parts.length > postIndex + 3) {
-            throw new ArgumentError(
-                'Post URL must end at the post slug or comment permalink id.',
-                'Remove extra path segments after the post slug or comment id.',
-            );
-        }
-        if (parts.length === postIndex + 3) normalizeBareRedditPostId(parts[postIndex + 2]);
-        return normalizeBareRedditPostId(parts[postIndex]);
-    }
-
-    if (raw.includes('/') || raw.startsWith('t1_')) {
-        throw new ArgumentError(
-            'Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.',
-            'Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.',
-        );
-    }
-
-    return normalizeBareRedditPostId(raw);
-}
-
-export function parseExpandRounds(raw) {
-    if (raw === undefined || raw === null || raw === '') return DEFAULT_EXPAND_ROUNDS;
-    const n = Number(raw);
-    if (
-        !Number.isFinite(n) || !Number.isInteger(n)
-        || n < REDDIT_EXPAND_ROUNDS_MIN || n > REDDIT_EXPAND_ROUNDS_MAX
-    ) {
-        throw new ArgumentError(
-            `expand-rounds must be an integer in [${REDDIT_EXPAND_ROUNDS_MIN}, ${REDDIT_EXPAND_ROUNDS_MAX}].`,
-            `Got: ${raw}`,
-        );
-    }
-    return n;
-}
-
-cli({
-    site: 'reddit',
-    name: 'read',
-    access: 'read',
-    description: 'Read a Reddit post and its comments',
-    domain: 'reddit.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'post-id', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or full URL' },
-        { name: 'sort', default: 'best', help: 'Comment sort: best, top, new, controversial, old, qa' },
-        { name: 'limit', type: 'int', default: 25, help: 'Number of top-level comments' },
-        { name: 'depth', type: 'int', default: 2, help: 'Max reply depth (1=no replies, 2=one level of replies, etc.)' },
-        { name: 'replies', type: 'int', default: 5, help: 'Max replies shown per comment at each level (sorted by score)' },
-        { name: 'max-length', type: 'int', default: 2000, help: 'Max characters per comment body (min 100)' },
-        {
-            name: 'expand-more',
-            type: 'bool',
-            default: false,
-            help: 'Follow Reddit "more comments" stubs by calling /api/morechildren.json',
-        },
-        {
-            name: 'expand-rounds',
-            type: 'int',
-            default: DEFAULT_EXPAND_ROUNDS,
-            help: `Max expansion passes when --expand-more is on (${REDDIT_EXPAND_ROUNDS_MIN}–${REDDIT_EXPAND_ROUNDS_MAX}; each round can fan out new "more" stubs)`,
-        },
-    ],
-    columns: ['type', 'author', 'score', 'text', 'post_hint', 'url_overridden_by_dest', 'preview_image_url', 'gallery_urls'],
-    func: async (page, kwargs) => {
-        // Note: --limit / --depth / --replies / --max-length keep their original
-        // Math.max-style behaviour for backward compatibility (grandfathered in
-        // the typed-error-lint baseline). The new --expand-rounds argument is
-        // strictly validated via parseExpandRounds — no silent clamp.
-        const sort = kwargs.sort ?? 'best';
-        const limit = Math.max(1, kwargs.limit ?? 25);
-        const maxDepth = Math.max(1, kwargs.depth ?? 2);
-        const maxReplies = Math.max(1, kwargs.replies ?? 5);
-        const maxLength = Math.max(100, kwargs['max-length'] ?? 2000);
-        const expandMore = Boolean(kwargs['expand-more']);
-        const expandRounds = parseExpandRounds(kwargs['expand-rounds']);
-        const postId = normalizeRedditPostId(kwargs['post-id']);
-
-        // 不再显式导航首页：框架 navigateBefore（domain=reddit.com）已把页面带到 reddit origin，
-        // 下面的相对 fetch(/comments/<id>.json) 照常可用。省掉每条评论命令一次冗余首页导航。
-
-        // The in-browser script returns a discriminated union so we can map
-        // each failure mode to its proper typed error on the Node side
-        // (page.evaluate boundary can't carry typed error instances). Kinds:
-        //   - inaccessible: 401/403/404 on /comments/<id>.json (post-specific,
-        //     not session auth — same session works for other posts)
-        //   - auth:         /api/morechildren.json 401/403 (session-level on
-        //     the write-like expand endpoint — see two-pronged auth detection
-        //     sediment from PR #1428)
-        //   - http:         5xx or other non-ok
-        //   - malformed:    200 but Reddit shape is unexpected (schema drift)
-        //   - parser-drift: tree non-empty but walk produced 0 rows
-        //   - expand-failed: morechildren returned errors
-        //   - ok:           rows array
-        //
-        // Intermediate keys (`rows` / `detail` / `httpStatus` / `where`)
-        // deliberately avoid the declared columns (`type`/`author`/`score`/
-        // `text`) to sidestep the silent-column-drop audit (PR #1329).
-        const result = await page.evaluate(`
+import{cli as v,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as z,CommandExecutionError as W,EmptyResultError as h}from"@jackwener/opencli/errors";const f=1,j=5,F=2,C=/^[a-z0-9]+$/i;function q(H){const b=String(H||"").trim();if(!C.test(b))throw new K("Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");return b.toLowerCase()}export function normalizeRedditPostId(H){const b=String(H||"").trim();if(!b)throw new K("Post ID is required.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");const Y=b.match(/^t3_([a-z0-9]+)$/i);if(Y)return q(Y[1]);if(/^https?:\/\//i.test(b)){let V;try{V=new URL(b)}catch{throw new K(`Invalid Reddit post URL: ${b}`)}const Z=V.hostname.toLowerCase();if(V.protocol!=="https:"||Z!=="reddit.com"&&!Z.endsWith(".reddit.com"))throw new K("Post URL must be an https reddit.com URL.","Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/");const J=V.pathname.split("/").filter(Boolean),$=J.indexOf("comments"),Q=$+1;if($<0||J.length<=Q)throw new K("Post URL must include the target post id.","Use a URL like https://www.reddit.com/r/sub/comments/1abc123/title_slug/");if(J.length>Q+3)throw new K("Post URL must end at the post slug or comment permalink id.","Remove extra path segments after the post slug or comment id.");if(J.length===Q+3)q(J[Q+2]);return q(J[Q])}if(b.includes("/")||b.startsWith("t1_"))throw new K("Post ID must be a Reddit post id, t3_ fullname, or reddit.com post URL.","Use a bare post id like 1abc123, a fullname like t3_1abc123, or a full Reddit post URL.");return q(b)}export function parseExpandRounds(H){if(H===void 0||H===null||H==="")return F;const b=Number(H);if(!Number.isFinite(b)||!Number.isInteger(b)||b<f||b>j)throw new K(`expand-rounds must be an integer in [${f}, ${j}].`,`Got: ${H}`);return b}v({site:"reddit",name:"read",access:"read",description:"Read a Reddit post and its comments",domain:"reddit.com",strategy:B.COOKIE,browser:!0,args:[{name:"post-id",required:!0,positional:!0,help:"Post ID (e.g. 1abc123) or full URL"},{name:"sort",default:"best",help:"Comment sort: best, top, new, controversial, old, qa"},{name:"limit",type:"int",default:25,help:"Number of top-level comments"},{name:"depth",type:"int",default:2,help:"Max reply depth (1=no replies, 2=one level of replies, etc.)"},{name:"replies",type:"int",default:5,help:"Max replies shown per comment at each level (sorted by score)"},{name:"max-length",type:"int",default:2000,help:"Max characters per comment body (min 100)"},{name:"expand-more",type:"bool",default:!1,help:'Follow Reddit "more comments" stubs by calling /api/morechildren.json'},{name:"expand-rounds",type:"int",default:F,help:`Max expansion passes when --expand-more is on (${f}–${j}; each round can fan out new "more" stubs)`}],columns:["type","author","score","text","post_hint","url_overridden_by_dest","preview_image_url","gallery_urls"],func:async(H,b)=>{const Y=b.sort??"best",V=Math.max(1,b.limit??25),Z=Math.max(1,b.depth??2),J=Math.max(1,b.replies??5),$=Math.max(100,b["max-length"]??2000),Q=Boolean(b["expand-more"]),y=parseExpandRounds(b["expand-rounds"]),L=normalizeRedditPostId(b["post-id"]),G=await H.evaluate(`
       (async function() {
         function decodeHtml(s) {
           if (typeof s !== 'string' || !s) return '';
@@ -196,16 +34,16 @@ cli({
             gallery_urls: gallery_urls,
           };
         }
-        var postId = ${JSON.stringify(postId)};
+        var postId = ${JSON.stringify(L)};
         var linkFullname = 't3_' + postId;
 
-        var sort = ${JSON.stringify(sort)};
-        var limit = ${limit};
-        var maxDepth = ${maxDepth};
-        var maxReplies = ${maxReplies};
-        var maxLength = ${maxLength};
-        var expandMore = ${JSON.stringify(expandMore)};
-        var expandRounds = ${expandRounds};
+        var sort = ${JSON.stringify(Y)};
+        var limit = ${V};
+        var maxDepth = ${Z};
+        var maxReplies = ${J};
+        var maxLength = ${$};
+        var expandMore = ${JSON.stringify(Q)};
+        var expandRounds = ${y};
 
         // ---------------------------------------------------------------
         // Step 1: fetch the post + initial comment tree
@@ -557,32 +395,4 @@ cli({
 
         return { kind: 'ok', rows: rows, expandMeta: expandMeta };
       })()
-    `);
-
-        if (!result || typeof result !== 'object') {
-            throw new CommandExecutionError('Reddit /comments fetch returned no result envelope.');
-        }
-        if (result.kind === 'inaccessible') {
-            throw new EmptyResultError(result.detail);
-        }
-        if (result.kind === 'auth') {
-            throw new AuthRequiredError('reddit.com', result.detail);
-        }
-        if (result.kind === 'http') {
-            throw new CommandExecutionError(`HTTP ${result.httpStatus} from ${result.where}`);
-        }
-        if (result.kind === 'malformed') {
-            throw new CommandExecutionError(result.detail);
-        }
-        if (result.kind === 'parser-drift') {
-            throw new CommandExecutionError(result.detail);
-        }
-        if (result.kind === 'expand-failed') {
-            throw new CommandExecutionError(result.detail);
-        }
-        if (result.kind !== 'ok' || !Array.isArray(result.rows)) {
-            throw new CommandExecutionError(`Unexpected result from reddit read: ${JSON.stringify(result)}`);
-        }
-        return result.rows;
-    },
-});
+    `);if(!G||typeof G!=="object")throw new W("Reddit /comments fetch returned no result envelope.");if(G.kind==="inaccessible")throw new h(G.detail);if(G.kind==="auth")throw new z("reddit.com",G.detail);if(G.kind==="http")throw new W(`HTTP ${G.httpStatus} from ${G.where}`);if(G.kind==="malformed")throw new W(G.detail);if(G.kind==="parser-drift")throw new W(G.detail);if(G.kind==="expand-failed")throw new W(G.detail);if(G.kind!=="ok"||!Array.isArray(G.rows))throw new W(`Unexpected result from reddit read: ${JSON.stringify(G)}`);return G.rows}});

package/clis/reddit/reply.js

@@ -1,111 +1,7 @@
-import { ArgumentError, AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-
-const REDDIT_COMMENT_ID_RE = /^[a-z0-9]+$/i;
-
-function normalizeBareCommentId(value) {
-    const commentId = String(value || '').trim();
-    if (!REDDIT_COMMENT_ID_RE.test(commentId)) {
-        throw new ArgumentError(
-            'Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.',
-            'Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.',
-        );
-    }
-    return commentId.toLowerCase();
-}
-
-export function normalizeRedditCommentFullname(value) {
-    const raw = String(value || '').trim();
-    if (!raw) {
-        throw new ArgumentError(
-            'Comment ID is required.',
-            'Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.',
-        );
-    }
-
-    const fullname = raw.match(/^t1_([a-z0-9]+)$/i);
-    if (fullname) return `t1_${normalizeBareCommentId(fullname[1])}`;
-
-    if (/^https?:\/\//i.test(raw)) {
-        let parsed;
-        try {
-            parsed = new URL(raw);
-        } catch {
-            throw new ArgumentError(`Invalid Reddit comment URL: ${raw}`);
-        }
-        const host = parsed.hostname.toLowerCase();
-        if (parsed.protocol !== 'https:' || (host !== 'reddit.com' && !host.endsWith('.reddit.com'))) {
-            throw new ArgumentError(
-                'Comment URL must be an https reddit.com URL.',
-                'Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/',
-            );
-        }
-        const parts = parsed.pathname.split('/').filter(Boolean);
-        const commentsIndex = parts.indexOf('comments');
-        const commentIndex = commentsIndex + 3;
-        if (commentsIndex < 0 || parts.length <= commentIndex) {
-            throw new ArgumentError(
-                'Comment URL must include the target comment id.',
-                'Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/',
-            );
-        }
-        if (parts.length !== commentIndex + 1) {
-            throw new ArgumentError(
-                'Comment URL must end at the target comment id.',
-                'Remove extra path segments after the comment id.',
-            );
-        }
-        return `t1_${normalizeBareCommentId(parts[commentIndex])}`;
-    }
-
-    if (raw.includes('/') || raw.startsWith('t3_')) {
-        throw new ArgumentError(
-            'Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.',
-            'Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.',
-        );
-    }
-
-    return `t1_${normalizeBareCommentId(raw)}`;
-}
-
-export function requireReplyText(value) {
-    const text = String(value || '');
-    if (!text.trim()) {
-        throw new ArgumentError('Reply text is required.', 'Pass non-empty text to post as the Reddit reply.');
-    }
-    return text;
-}
-
-cli({
-    site: 'reddit',
-    name: 'reply',
-    access: 'write',
-    description: 'Reply to a Reddit comment',
-    domain: 'reddit.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'comment-id', type: 'string', required: true, positional: true, help: 'Comment ID (e.g. okf3s7u) or fullname (t1_xxx)' },
-        { name: 'text', type: 'string', required: true, positional: true, help: 'Reply text' },
-    ],
-    columns: ['status', 'message'],
-    func: async (page, kwargs) => {
-        const fullname = normalizeRedditCommentFullname(kwargs['comment-id']);
-        const text = requireReplyText(kwargs.text);
-        await page.goto('https://www.reddit.com');
-        // Inside page.evaluate we can't throw typed errors (they don't survive
-        // the worker boundary), so we surface a structured `kind` discriminator
-        // and re-throw the matching typed error on the Node side. Each kind
-        // maps 1:1 to a typed-error class — no silent-sentinel rows on failure.
-        //
-        // Intermediate object keys deliberately avoid `status` / `message` to
-        // sidestep the silent-column-drop audit (columns are ['status',
-        // 'message']) — see PR #1329 sediment "中间解析对象 key 不能跟 columns
-        // 任一项重叠".
-        const result = await page.evaluate(`(async () => {
+import{ArgumentError as J,AuthRequiredError as Y,CommandExecutionError as L}from"@jackwener/opencli/errors";import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";const F=/^[a-z0-9]+$/i;function W(H){const b=String(H||"").trim();if(!F.test(b))throw new J("Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");return b.toLowerCase()}export function normalizeRedditCommentFullname(H){const b=String(H||"").trim();if(!b)throw new J("Comment ID is required.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");const Q=b.match(/^t1_([a-z0-9]+)$/i);if(Q)return`t1_${W(Q[1])}`;if(/^https?:\/\//i.test(b)){let K;try{K=new URL(b)}catch{throw new J(`Invalid Reddit comment URL: ${b}`)}const G=K.hostname.toLowerCase();if(K.protocol!=="https:"||G!=="reddit.com"&&!G.endsWith(".reddit.com"))throw new J("Comment URL must be an https reddit.com URL.","Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/");const U=K.pathname.split("/").filter(Boolean),X=U.indexOf("comments"),V=X+3;if(X<0||U.length<=V)throw new J("Comment URL must include the target comment id.","Use a URL like https://www.reddit.com/r/sub/comments/post/title/okf3s7u/");if(U.length!==V+1)throw new J("Comment URL must end at the target comment id.","Remove extra path segments after the comment id.");return`t1_${W(U[V])}`}if(b.includes("/")||b.startsWith("t3_"))throw new J("Comment ID must be a Reddit comment id, t1_ fullname, or reddit.com comment URL.","Use a bare comment id like okf3s7u, a fullname like t1_okf3s7u, or a full Reddit comment URL.");return`t1_${W(b)}`}export function requireReplyText(H){const b=String(H||"");if(!b.trim())throw new J("Reply text is required.","Pass non-empty text to post as the Reddit reply.");return b}Z({site:"reddit",name:"reply",access:"write",description:"Reply to a Reddit comment",domain:"reddit.com",strategy:$.COOKIE,browser:!0,args:[{name:"comment-id",type:"string",required:!0,positional:!0,help:"Comment ID (e.g. okf3s7u) or fullname (t1_xxx)"},{name:"text",type:"string",required:!0,positional:!0,help:"Reply text"}],columns:["status","message"],func:async(H,b)=>{const Q=normalizeRedditCommentFullname(b["comment-id"]),K=requireReplyText(b.text);await H.goto("https://www.reddit.com");const G=await H.evaluate(`(async () => {
       try {
-        const fullname = ${JSON.stringify(fullname)};
-        const text = ${JSON.stringify(text)};
+        const fullname = ${JSON.stringify(Q)};
+        const text = ${JSON.stringify(K)};
 
         // Probe identity + modhash. /api/me.json returns data.name only when
         // logged in — empty modhash alone is not a strong enough auth signal
@@ -157,26 +53,4 @@ cli({
       } catch (e) {
         return { kind: 'exception', detail: String(e && e.message || e) };
       }
-    })()`);
-
-        if (result?.kind === 'auth') {
-            throw new AuthRequiredError('reddit.com', result.detail);
-        }
-        if (result?.kind === 'http') {
-            throw new CommandExecutionError(`HTTP ${result.httpStatus} from ${result.where}`);
-        }
-        if (result?.kind === 'reddit-error') {
-            throw new CommandExecutionError(`Reddit rejected reply: ${result.detail}`);
-        }
-        if (result?.kind === 'postcondition') {
-            throw new CommandExecutionError(result.detail);
-        }
-        if (result?.kind === 'exception') {
-            throw new CommandExecutionError(`Reply failed: ${result.detail}`);
-        }
-        if (result?.kind !== 'ok') {
-            throw new CommandExecutionError(`Unexpected result from reddit reply: ${JSON.stringify(result)}`);
-        }
-        return [{ status: 'success', message: result.detail }];
-    },
-});
+    })()`);if(G?.kind==="auth")throw new Y("reddit.com",G.detail);if(G?.kind==="http")throw new L(`HTTP ${G.httpStatus} from ${G.where}`);if(G?.kind==="reddit-error")throw new L(`Reddit rejected reply: ${G.detail}`);if(G?.kind==="postcondition")throw new L(G.detail);if(G?.kind==="exception")throw new L(`Reply failed: ${G.detail}`);if(G?.kind!=="ok")throw new L(`Unexpected result from reddit reply: ${JSON.stringify(G)}`);return[{status:"success",message:G.detail}]}});

package/clis/reddit/save.js

@@ -1,31 +1,12 @@
-import { CommandExecutionError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'reddit',
-    name: 'save',
-    access: 'write',
-    description: 'Save or unsave a Reddit post',
-    domain: 'reddit.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'post-id', type: 'string', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
-        { name: 'undo', type: 'boolean', default: false, help: 'Unsave instead of save' },
-    ],
-    columns: ['status', 'message'],
-    func: async (page, kwargs) => {
-        if (!page)
-            throw new CommandExecutionError('Browser session required');
-        await page.goto('https://www.reddit.com');
-        const result = await page.evaluate(`(async () => {
+import{CommandExecutionError as o}from"@jackwener/opencli/errors";import{cli as a,Strategy as n}from"@jackwener/opencli/registry";a({site:"reddit",name:"save",access:"write",description:"Save or unsave a Reddit post",domain:"reddit.com",strategy:n.COOKIE,browser:!0,args:[{name:"post-id",type:"string",required:!0,positional:!0,help:"Post ID (e.g. 1abc123) or fullname (t3_xxx)"},{name:"undo",type:"boolean",default:!1,help:"Unsave instead of save"}],columns:["status","message"],func:async(e,t)=>{if(!e)throw new o("Browser session required");await e.goto("https://www.reddit.com");const s=await e.evaluate(`(async () => {
       try {
-        let postId = ${JSON.stringify(kwargs['post-id'])};
+        let postId = ${JSON.stringify(t["post-id"])};
         const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
         if (urlMatch) postId = urlMatch[1];
         const fullname = postId.startsWith('t3_') || postId.startsWith('t1_')
           ? postId : 't3_' + postId;
 
-        const undo = ${kwargs.undo ? 'true' : 'false'};
+        const undo = ${t.undo?"true":"false"};
         const endpoint = undo ? '/api/unsave' : '/api/save';
 
         // Get modhash
@@ -46,7 +27,4 @@ cli({
       } catch (e) {
         return { ok: false, message: e.toString() };
       }
-    })()`);
-        return [{ status: result.ok ? 'success' : 'failed', message: result.message }];
-    }
-});
+    })()`);return[{status:s.ok?"success":"failed",message:s.message}]}});