publishport-opencli 1.0.0

package/clis/reddit/subreddit-info.js

@@ -0,0 +1,29 @@
+import{ArgumentError as K,CommandExecutionError as G,EmptyResultError as Q}from"@jackwener/opencli/errors";import{cli as V,Strategy as W}from"@jackwener/opencli/registry";const X=/^[A-Za-z][A-Za-z0-9_]{2,20}$/;export function parseSubredditName(F){let z=String(F||"").trim();if(!z)throw new K("Subreddit name is required.","Pass a subreddit name like `python` (or `r/python`).");if(z.startsWith("/r/"))z=z.slice(3);else if(z.startsWith("r/"))z=z.slice(2);if(!X.test(z))throw new K("Invalid subreddit name.","Subreddit names are 3–21 characters, start with a letter, and contain only letters, digits, and underscores.");return z}V({site:"reddit",name:"subreddit-info",access:"read",description:"Show metadata for a Reddit subreddit (subscribers, description, created date, NSFW)",domain:"reddit.com",strategy:W.COOKIE,browser:!0,args:[{name:"name",type:"string",required:!0,positional:!0,help:"Subreddit name (no `r/` prefix needed)"}],columns:["field","value"],func:async(F,z)=>{const L=parseSubredditName(z.name);await F.goto("https://www.reddit.com");const q=await F.evaluate(`(async () => {
+      try {
+        const sub = ${JSON.stringify(L)};
+        const res = await fetch('/r/' + encodeURIComponent(sub) + '/about.json?raw_json=1', { credentials: 'include' });
+        if (res.status === 401 || res.status === 403 || res.status === 404) {
+          return { kind: 'missing', detail: 'Subreddit r/' + sub + ' was not found or is not accessible (HTTP ' + res.status + ').' };
+        }
+        if (!res.ok) {
+          return { kind: 'http', httpStatus: res.status, where: '/r/' + sub + '/about.json' };
+        }
+        const j = await res.json();
+        // Reddit may return an envelope-style 200 with {"kind":"Listing"} or
+        // an error body for quarantined / private subs. Identify "subreddit
+        // not found / not accessible" by the absence of data.display_name.
+        if (j?.error) {
+          if (j.error === 404 || j.reason === 'banned' || j.reason === 'private' || j.reason === 'quarantined') {
+            return { kind: 'missing', detail: 'Subreddit r/' + sub + ' is ' + (j.reason || 'unavailable') + '.' };
+          }
+          return { kind: 'http', httpStatus: j.error, where: '/r/' + sub + '/about.json (' + (j.reason || 'error') + ')' };
+        }
+        const info = j?.data;
+        if (!info || !info.display_name) {
+          return { kind: 'malformed', detail: 'Reddit returned malformed subreddit info for r/' + sub + ' (missing data.display_name).' };
+        }
+        return { kind: 'ok', info };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()`);if(q?.kind==="missing")throw new Q(q.detail);if(q?.kind==="http")throw new G(`HTTP ${q.httpStatus} from ${q.where}`);if(q?.kind==="malformed")throw new G(q.detail);if(q?.kind==="exception")throw new G(`subreddit-info failed: ${q.detail}`);if(q?.kind!=="ok")throw new G(`Unexpected result from reddit subreddit-info: ${JSON.stringify(q)}`);const h=q.info,O=h.created_utc?new Date(h.created_utc*1000).toISOString().split("T")[0]:null,H=typeof h.subscribers==="number"?h.subscribers:null,J=typeof h.active_user_count==="number"?h.active_user_count:typeof h.accounts_active==="number"?h.accounts_active:null,P=typeof h.public_description==="string"?h.public_description.trim():"";return[{field:"Name",value:h.display_name_prefixed||"r/"+h.display_name},{field:"Title",value:typeof h.title==="string"?h.title:null},{field:"Subscribers",value:H!=null?String(H):null},{field:"Active Now",value:J!=null?String(J):null},{field:"NSFW",value:h.over18?"Yes":"No"},{field:"Type",value:typeof h.subreddit_type==="string"?h.subreddit_type:null},{field:"Description",value:P||null},{field:"Created",value:O},{field:"URL",value:h.url?"https://www.reddit.com"+h.url:null}]}});

package/clis/reddit/subreddit.js

@@ -0,0 +1,52 @@
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"reddit",name:"subreddit",access:"read",description:"Get posts from a specific Subreddit",domain:"reddit.com",strategy:e.COOKIE,browser:!0,args:[{name:"name",type:"string",required:!0,positional:!0,help:"Subreddit name (no `r/` prefix; e.g. `python`)"},{name:"sort",type:"string",default:"hot",help:"Sorting method: hot, new, top, rising, controversial"},{name:"time",type:"string",default:"all",help:"Time filter for top/controversial: hour, day, week, month, year, all"},{name:"limit",type:"int",default:15}],columns:["id","title","subreddit","author","upvotes","comments","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
+      .replace(/&/g, '&')
+      .replace(/&lt;/g, '<')
+      .replace(/&gt;/g, '>')
+      .replace(/&quot;/g, '"')
+      .replace(/&#x27;/gi, "'")
+      .replace(/&#39;/g, "'");
+  }
+  function extractRedditMedia(d) {
+    const post_hint = d?.post_hint || '';
+    const url_overridden_by_dest = d?.url_overridden_by_dest || '';
+    const preview_image_url = decodeHtml(d?.preview?.images?.[0]?.source?.url || '');
+    const gallery_urls = [];
+    const items = d?.gallery_data?.items;
+    const meta = d?.media_metadata;
+    if (Array.isArray(items) && meta) {
+      for (const it of items) {
+        const m = it && meta[it.media_id];
+        const u = m?.s?.u;
+        if (u) gallery_urls.push(decodeHtml(u));
+      }
+    }
+    return { post_hint, url_overridden_by_dest, preview_image_url, gallery_urls };
+  }
+  let sub = \${{ args.name | json }};
+  if (sub.startsWith('r/')) sub = sub.slice(2);
+  const sort = \${{ args.sort | json }};
+  const time = \${{ args.time | json }};
+  const limit = \${{ args.limit }};
+  let url = '/r/' + sub + '/' + sort + '.json?limit=' + limit + '&raw_json=1';
+  if ((sort === 'top' || sort === 'controversial') && time) {
+    url += '&t=' + time;
+  }
+  const res = await fetch(url, { credentials: 'include' });
+  const j = await res.json();
+  return (j?.data?.children || []).map(c => ({
+    id: c.data.id,
+    title: c.data.title,
+    subreddit: c.data.subreddit_name_prefixed,
+    author: c.data.author,
+    upvotes: c.data.score,
+    comments: c.data.num_comments,
+    url: 'https://www.reddit.com' + c.data.permalink,
+    created_utc: c.data.created_utc,
+    selftext: c.data.selftext || '',
+    ...extractRedditMedia(c.data),
+  }));
+})()
+`},{map:{id:"${{ item.id }}",title:"${{ item.title }}",subreddit:"${{ item.subreddit }}",author:"${{ item.author }}",upvotes:"${{ item.upvotes }}",comments:"${{ item.comments }}",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/subscribe.js

@@ -0,0 +1,29 @@
+import{CommandExecutionError as o}from"@jackwener/opencli/errors";import{cli as r,Strategy as a}from"@jackwener/opencli/registry";r({site:"reddit",name:"subscribe",access:"write",description:"Subscribe or unsubscribe to a subreddit",domain:"reddit.com",strategy:a.COOKIE,browser:!0,args:[{name:"subreddit",type:"string",required:!0,positional:!0,help:"Subreddit name (e.g. python)"},{name:"undo",type:"boolean",default:!1,help:"Unsubscribe instead of subscribe"}],columns:["status","message"],func:async(e,s)=>{if(!e)throw new o("Browser session required");await e.goto("https://www.reddit.com");const t=await e.evaluate(`(async () => {
+      try {
+        let sub = ${JSON.stringify(s.subreddit)};
+        if (sub.startsWith('r/')) sub = sub.slice(2);
+
+        const undo = ${s.undo?"true":"false"};
+        const action = undo ? 'unsub' : 'sub';
+
+        // Get modhash
+        const meRes = await fetch('/api/me.json', { credentials: 'include' });
+        const me = await meRes.json();
+        const modhash = me?.data?.modhash || '';
+
+        const res = await fetch('/api/subscribe', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: 'sr_name=' + encodeURIComponent(sub)
+            + '&action=' + action
+            + (modhash ? '&uh=' + encodeURIComponent(modhash) : ''),
+        });
+
+        if (!res.ok) return { ok: false, message: 'HTTP ' + res.status };
+        const label = undo ? 'Unsubscribed from' : 'Subscribed to';
+        return { ok: true, message: label + ' r/' + sub };
+      } catch (e) {
+        return { ok: false, message: e.toString() };
+      }
+    })()`);return[{status:t.ok?"success":"failed",message:t.message}]}});

package/clis/reddit/subscribed.js

@@ -0,0 +1,68 @@
+import{ArgumentError as $,AuthRequiredError as q,CommandExecutionError as P,EmptyResultError as J}from"@jackwener/opencli/errors";import{cli as v,Strategy as O}from"@jackwener/opencli/registry";import{BROWSER_JSON_SNIFF_FN as f,throwIfLoginWall as j}from"@jackwener/opencli/utils";export const REDDIT_SUBSCRIBED_MAX_LIMIT=1000;export function parseRedditSubscribedLimit(G){if(G===void 0||G===null||G==="")return 100;const K=Number(G);if(!Number.isFinite(K)||!Number.isInteger(K)||K<1||K>REDDIT_SUBSCRIBED_MAX_LIMIT)throw new $(`limit must be an integer in [1, ${REDDIT_SUBSCRIBED_MAX_LIMIT}].`,`Got: ${G}`);return K}export function unwrapEvaluateResult(G){if(G&&typeof G==="object"&&!Array.isArray(G)&&"session"in G&&"data"in G)return G.data;return G}function F(G,K){const z=G?.data;if(!z||typeof z!=="object")throw new P(`Reddit subscriptions row ${K+1} was missing data.`);const H=typeof z.name==="string"?z.name:"",Q=H.startsWith("t5_")?H:G?.kind==="t5"&&typeof z.id==="string"&&z.id?`t5_${z.id}`:"",V=typeof z.display_name==="string"&&z.display_name?z.display_name:"",Y=typeof z.display_name_prefixed==="string"&&z.display_name_prefixed?z.display_name_prefixed:V?`r/${V}`:"",Z=typeof z.url==="string"&&z.url.startsWith("/r/")?z.url:"";if(!Q||!V||!Y||!Z)throw new P(`Reddit subscriptions row ${K+1} was missing subreddit identity.`);return{id:Q,subreddit:Y,title:typeof z.title==="string"?z.title:"",subscribers:typeof z.subscribers==="number"?z.subscribers:null,description:typeof z.public_description==="string"?z.public_description.slice(0,200):"",url:"https://www.reddit.com"+Z}}v({site:"reddit",name:"subscribed",description:"List subreddits you are subscribed to",access:"read",domain:"reddit.com",strategy:O.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:100,help:`Max subreddits to return (1-${REDDIT_SUBSCRIBED_MAX_LIMIT}, auto-paginates)`}],columns:["id","subreddit","title","subscribers","description","url"],func:async(G,K)=>{const z=parseRedditSubscribedLimit(K.limit);if(!G)throw new P("Browser session required");await G.goto("https://www.reddit.com");const H=unwrapEvaluateResult(await G.evaluate(`(async () => {
+      ${f}
+      try {
+        // fetchJsonOrLoginWall sniffs HTML responses (login wall / WAF / rate-limit
+        // page) and returns a structured { __loginWall, status, url, ... } sentinel
+        // instead of letting JSON.parse blow up with "Unexpected token '<'".
+        const me = await fetchJsonOrLoginWall('/api/me.json?raw_json=1', { credentials: 'include' });
+        if (me && me.__loginWall) {
+          return { kind: 'login-wall', sentinel: me, where: '/api/me.json' };
+        }
+        if (me && me.error === 401 || me && me.error === 403) {
+          return { kind: 'auth', detail: 'Reddit /api/me.json returned HTTP ' + me.error };
+        }
+        if (me && me.error) {
+          return { kind: 'http', httpStatus: me.error, where: '/api/me.json' };
+        }
+        const username = me?.data?.name || me?.name;
+        if (!username) return { kind: 'auth', detail: 'Not logged in to reddit.com (no identity in /api/me.json)' };
+
+        const target = ${JSON.stringify(z)};
+        const PAGE_SIZE = 100;
+        const out = [];
+        let after = null;
+        const seenCursors = new Set();
+        for (let pageIndex = 0; pageIndex < 20 && out.length < target; pageIndex++) {
+          const remaining = target - out.length;
+          const pageLimit = Math.min(PAGE_SIZE, remaining);
+          const url = '/subreddits/mine/subscriptions.json?limit=' + pageLimit
+            + '&raw_json=1'
+            + (after ? '&after=' + encodeURIComponent(after) : '');
+          const d = await fetchJsonOrLoginWall(url, { credentials: 'include' });
+          if (d && d.__loginWall) {
+            return { kind: 'login-wall', sentinel: d, where: url };
+          }
+          if (d && (d.error === 401 || d.error === 403)) {
+            return { kind: 'auth', detail: 'Reddit subscriptions endpoint returned HTTP ' + d.error };
+          }
+          if (d && d.error) return { kind: 'http', httpStatus: d.error, where: url };
+          const children = d?.data?.children;
+          if (!Array.isArray(children)) {
+            return { kind: 'malformed', detail: 'Reddit subscriptions payload was missing data.children.' };
+          }
+          for (const child of children) {
+            if (out.length >= target) break;
+            out.push(child);
+          }
+          const next = d?.data?.after ?? null;
+          if (next !== null && typeof next !== 'string') {
+            return { kind: 'malformed', detail: 'Reddit subscriptions payload had a malformed after cursor.' };
+          }
+          if (out.length >= target || !next) break;
+          if (children.length === 0) {
+            return { kind: 'malformed', detail: 'Reddit subscriptions page was empty but returned an after cursor.' };
+          }
+          if (seenCursors.has(next)) {
+            return { kind: 'malformed', detail: 'Reddit subscriptions repeated pagination cursor ' + next + '.' };
+          }
+          seenCursors.add(next);
+          after = next;
+        }
+        if (out.length < target && after) {
+          return { kind: 'malformed', detail: 'Reddit subscriptions pagination exceeded the safety cap before satisfying the requested limit.' };
+        }
+        return { kind: 'ok', entries: out };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()`));if(H?.kind==="login-wall")j(H.sentinel,{url:H.where});if(H?.kind==="auth")throw new q("reddit.com",H.detail);if(H?.kind==="http")throw new P(`HTTP ${H.httpStatus} from ${H.where}`);if(H?.kind==="malformed")throw new P(H.detail);if(H?.kind==="exception")throw new P(`subscribed failed: ${H.detail}`);if(H?.kind!=="ok"||!Array.isArray(H.entries))throw new P(`Unexpected result from reddit subscribed: ${JSON.stringify(H)}`);const Q=H.entries.slice(0,z).map((V,Y)=>F(V,Y));if(Q.length===0)throw new J("Reddit returned no subscribed subreddits for the logged-in account.");return Q}});

package/clis/reddit/upvote.js

@@ -0,0 +1,43 @@
+import{CommandExecutionError as s}from"@jackwener/opencli/errors";import{cli as n,Strategy as i}from"@jackwener/opencli/registry";n({site:"reddit",name:"upvote",access:"write",description:"Upvote or downvote a Reddit post",domain:"reddit.com",strategy:i.COOKIE,browser:!0,args:[{name:"post-id",type:"string",required:!0,positional:!0,help:"Post ID (e.g. 1abc123) or fullname (t3_xxx)"},{name:"direction",type:"string",default:"up",help:"Vote direction: up, down, none"}],columns:["status","message"],func:async(e,t)=>{if(!e)throw new s("Browser session required");await e.goto("https://www.reddit.com");const o=await e.evaluate(`(async () => {
+      try {
+        let postId = ${JSON.stringify(t["post-id"])};
+        // Extract ID from URL if needed
+        const urlMatch = postId.match(/comments\\/([a-z0-9]+)/);
+        if (urlMatch) postId = urlMatch[1];
+        // Build fullname
+        const fullname = postId.startsWith('t3_') || postId.startsWith('t1_')
+          ? postId : 't3_' + postId;
+
+        const dir = ${JSON.stringify(t.direction)};
+        const direction = dir === 'down' ? -1 : dir === 'none' ? 0 : 1;
+
+        // Get modhash from Reddit config
+        const configEl = document.getElementById('config');
+        let modhash = '';
+        if (configEl) {
+          modhash = configEl.querySelector('[name="uh"]')?.getAttribute('content') || '';
+        }
+        if (!modhash) {
+          // Try fetching from /api/me.json
+          const meRes = await fetch('/api/me.json', { credentials: 'include' });
+          const me = await meRes.json();
+          modhash = me?.data?.modhash || '';
+        }
+
+        const res = await fetch('/api/vote', {
+          method: 'POST',
+          credentials: 'include',
+          headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+          body: 'id=' + encodeURIComponent(fullname)
+            + '&dir=' + direction
+            + (modhash ? '&uh=' + encodeURIComponent(modhash) : ''),
+        });
+
+        if (!res.ok) return { ok: false, message: 'HTTP ' + res.status };
+
+        const labels = { '1': 'Upvoted', '-1': 'Downvoted', '0': 'Vote removed' };
+        return { ok: true, message: (labels[String(direction)] || 'Voted') + ' ' + fullname };
+      } catch (e) {
+        return { ok: false, message: e.toString() };
+      }
+    })()`);return[{status:o.ok?"success":"failed",message:o.message}]}});

package/clis/reddit/upvoted.js

@@ -0,0 +1,24 @@
+import{AuthRequiredError as o,CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as n,Strategy as a}from"@jackwener/opencli/registry";n({site:"reddit",name:"upvoted",access:"read",description:"Browse your upvoted Reddit posts",domain:"reddit.com",strategy:a.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:15}],columns:["title","subreddit","score","comments","url"],func:async(t,r)=>{if(!t)throw new i("Browser session required");await t.goto("https://www.reddit.com");const e=await t.evaluate(`(async () => {
+      try {
+        // Get current username
+        const meRes = await fetch('/api/me.json?raw_json=1', { credentials: 'include' });
+        const me = await meRes.json();
+        const username = me?.name || me?.data?.name;
+        if (!username) return { error: 'Not logged in — cannot determine username' };
+
+        const limit = ${r.limit};
+        const res = await fetch('/user/' + username + '/upvoted.json?limit=' + limit + '&raw_json=1', {
+          credentials: 'include'
+        });
+        const d = await res.json();
+        return (d?.data?.children || []).map(c => ({
+          title: c.data.title || '',
+          subreddit: c.data.subreddit_name_prefixed || 'r/' + (c.data.subreddit || '?'),
+          score: c.data.score || 0,
+          comments: c.data.num_comments || 0,
+          url: 'https://www.reddit.com' + (c.data.permalink || ''),
+        }));
+      } catch (e) {
+        return { error: e.toString() };
+      }
+    })()`);if(e?.error){if(String(e.error).includes("Not logged in"))throw new o("reddit.com",e.error);throw new i(e.error)}return(e||[]).slice(0,r.limit)}});

package/clis/reddit/user-comments.js

@@ -0,0 +1,20 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"reddit",name:"user-comments",access:"read",description:"View a Reddit user's comment history",domain:"reddit.com",strategy:t.COOKIE,browser:!0,args:[{name:"username",type:"string",required:!0,positional:!0,help:"Reddit username (no `u/` prefix needed)"},{name:"limit",type:"int",default:15}],columns:["subreddit","score","body","url"],pipeline:[{navigate:"https://www.reddit.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const name = username.startsWith('u/') ? username.slice(2) : username;
+  const limit = \${{ args.limit }};
+  const res = await fetch('/user/' + name + '/comments.json?limit=' + limit + '&raw_json=1', {
+    credentials: 'include'
+  });
+  const d = await res.json();
+  return (d?.data?.children || []).map(c => {
+    let body = c.data.body || '';
+    if (body.length > 300) body = body.slice(0, 300) + '...';
+    return {
+      subreddit: c.data.subreddit_name_prefixed,
+      score: c.data.score,
+      body: body,
+      url: 'https://www.reddit.com' + c.data.permalink,
+    };
+  });
+})()
+`},{map:{subreddit:"${{ item.subreddit }}",score:"${{ item.score }}",body:"${{ item.body }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/reddit/user-posts.js

@@ -0,0 +1,17 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"reddit",name:"user-posts",access:"read",description:"View a Reddit user's submitted posts",domain:"reddit.com",strategy:t.COOKIE,browser:!0,args:[{name:"username",type:"string",required:!0,positional:!0,help:"Reddit username (no `u/` prefix needed)"},{name:"limit",type:"int",default:15}],columns:["title","subreddit","score","comments","url"],pipeline:[{navigate:"https://www.reddit.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const name = username.startsWith('u/') ? username.slice(2) : username;
+  const limit = \${{ args.limit }};
+  const res = await fetch('/user/' + name + '/submitted.json?limit=' + limit + '&raw_json=1', {
+    credentials: 'include'
+  });
+  const d = await res.json();
+  return (d?.data?.children || []).map(c => ({
+    title: c.data.title,
+    subreddit: c.data.subreddit_name_prefixed,
+    score: c.data.score,
+    comments: c.data.num_comments,
+    url: 'https://www.reddit.com' + c.data.permalink,
+  }));
+})()
+`},{map:{title:"${{ item.title }}",subreddit:"${{ item.subreddit }}",score:"${{ item.score }}",comments:"${{ item.comments }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/reddit/user.js

@@ -0,0 +1,20 @@
+import{cli as e,Strategy as a}from"@jackwener/opencli/registry";e({site:"reddit",name:"user",access:"read",description:"View a Reddit user profile",domain:"reddit.com",strategy:a.COOKIE,browser:!0,args:[{name:"username",type:"string",required:!0,positional:!0,help:"Reddit username (no `u/` prefix needed)"}],columns:["field","value"],pipeline:[{navigate:"https://www.reddit.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const name = username.startsWith('u/') ? username.slice(2) : username;
+  const res = await fetch('/user/' + name + '/about.json?raw_json=1', {
+    credentials: 'include'
+  });
+  const d = await res.json();
+  const u = d?.data || d || {};
+  const created = u.created_utc ? new Date(u.created_utc * 1000).toISOString().split('T')[0] : '-';
+  return [
+    { field: 'Username', value: 'u/' + (u.name || name) },
+    { field: 'Post Karma', value: String(u.link_karma || 0) },
+    { field: 'Comment Karma', value: String(u.comment_karma || 0) },
+    { field: 'Total Karma', value: String(u.total_karma || (u.link_karma||0) + (u.comment_karma||0)) },
+    { field: 'Account Created', value: created },
+    { field: 'Gold', value: u.is_gold ? '⭐ Yes' : 'No' },
+    { field: 'Verified', value: u.verified ? '✅ Yes' : 'No' },
+  ];
+})()
+`},{map:{field:"${{ item.field }}",value:"${{ item.value }}"}}]});

package/clis/reddit/whoami.js

@@ -0,0 +1,19 @@
+import{AuthRequiredError as L,CommandExecutionError as F}from"@jackwener/opencli/errors";import{cli as M,Strategy as N}from"@jackwener/opencli/registry";import{cookieQuickCheck as O}from"../_shared/article/auth.js";M({site:"reddit",name:"whoami",access:"read",description:"Show the currently logged-in Reddit user",domain:"reddit.com",strategy:N.COOKIE,browser:!0,args:[],columns:["field","value"],authStatus:{quickCheck:O("https://www.reddit.com",["reddit_session"])},func:async(G)=>{await G.goto("https://www.reddit.com");const z=await G.evaluate(`(async () => {
+      try {
+        const res = await fetch('/api/me.json?raw_json=1', { credentials: 'include' });
+        if (res.status === 401 || res.status === 403) {
+          return { kind: 'auth', detail: 'Reddit /api/me.json returned HTTP ' + res.status };
+        }
+        if (!res.ok) {
+          return { kind: 'http', httpStatus: res.status, where: '/api/me.json' };
+        }
+        const d = await res.json();
+        const me = d?.data;
+        if (!me?.name) {
+          return { kind: 'auth', detail: 'Not logged in to reddit.com (no identity in /api/me.json)' };
+        }
+        return { kind: 'ok', identity: me };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()`);if(z?.kind==="auth")throw new L("reddit.com",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from ${z.where}`);if(z?.kind==="exception")throw new F(`whoami failed: ${z.detail}`);if(z?.kind!=="ok")throw new F(`Unexpected result from reddit whoami: ${JSON.stringify(z)}`);const f=z.identity,J=f.created_utc?new Date(f.created_utc*1000).toISOString().split("T")[0]:null,B=typeof f.link_karma==="number"?f.link_karma:null,D=typeof f.comment_karma==="number"?f.comment_karma:null,H=typeof f.total_karma==="number"?f.total_karma:B!=null&&D!=null?B+D:null,I=typeof f.inbox_count==="number"?f.inbox_count:null;return[{field:"Username",value:"u/"+f.name},{field:"ID",value:f.id?"t2_"+f.id:null},{field:"Post Karma",value:B!=null?String(B):null},{field:"Comment Karma",value:D!=null?String(D):null},{field:"Total Karma",value:H!=null?String(H):null},{field:"Account Created",value:J},{field:"Gold",value:f.is_gold?"Yes":"No"},{field:"Mod",value:f.is_mod?"Yes":"No"},{field:"Verified Email",value:f.has_verified_email?"Yes":"No"},{field:"Has Mail",value:f.has_mail?"Yes":"No"},{field:"Inbox Count",value:I!=null?String(I):null}]}});

package/clis/rednote/auth.js

@@ -0,0 +1,19 @@
+import{AuthRequiredError as o,CommandExecutionError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";async function t(e){return(await e.getCookies({url:"https://www.rednote.com"})).some((i)=>i.name==="web_session"&&i.value)}async function r(e){if(!await t(e))throw new o("rednote.com","Rednote web_session cookie missing");await e.goto("https://www.rednote.com/explore");await e.wait(2);const n=await e.evaluate(`
+    (() => {
+      const state = window.__INITIAL_STATE__;
+      if (!state?.user) {
+        return { kind: 'auth', detail: 'Rednote __INITIAL_STATE__.user missing' };
+      }
+      const loggedIn = state.user.loggedIn?._value;
+      const userInfo = state.user.userInfo?._value || {};
+      if (loggedIn !== true) {
+        return { kind: 'auth', detail: 'Rednote loggedIn._value=' + String(loggedIn) + ' — anonymous' };
+      }
+      const userId = String(userInfo.userId || userInfo.user_id || '');
+      const nickname = String(userInfo.nickname || userInfo.name || '');
+      if (!userId) {
+        return { kind: 'auth', detail: 'Rednote logged-in but userId missing — stale session' };
+      }
+      return { ok: true, user_id: userId, nickname };
+    })()
+  `);if(n?.kind==="auth")throw new o("rednote.com",n.detail);if(!n?.ok)throw new s(`Unexpected Rednote probe: ${JSON.stringify(n)}`);return{user_id:n.user_id,nickname:n.nickname}}u({site:"rednote",domain:"rednote.com",loginUrl:"https://www.rednote.com/explore",columns:["user_id","nickname"],quickCheck:t,verify:r,poll:async(e)=>{if(!await t(e))throw new o("rednote.com","Waiting for Rednote web_session cookie");return r(e)}});

package/clis/rednote/comments.js

@@ -0,0 +1 @@
+import{cli as p,Strategy as f}from"@jackwener/opencli/registry";import{ArgumentError as u,AuthRequiredError as h,CommandExecutionError as w,EmptyResultError as y}from"@jackwener/opencli/errors";import{buildCommentsExtractJs as b}from"../xiaohongshu/comments.js";import{buildNoteUrl as g,parseNoteId as x}from"../xiaohongshu/note-helpers.js";const R="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";function _(o){const e=Number(o??20);if(!Number.isFinite(e)||!Number.isInteger(e))throw new u(`--limit must be an integer between 1 and 50, got ${JSON.stringify(o)}`);if(e<1||e>50)throw new u(`--limit must be between 1 and 50, got ${e}`);return e}p({site:"rednote",name:"comments",access:"read",description:"Read comments from a rednote note (supports nested replies)",domain:"www.rednote.com",strategy:f.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full rednote note URL with xsec_token"},{name:"limit",type:"int",default:20,help:"Number of top-level comments (max 50)"},{name:"with-replies",type:"boolean",default:!1,help:"Include nested replies (楼中楼)"}],columns:["rank","author","text","likes","time","is_reply","reply_to"],func:async(o,e)=>{const s=_(e.limit),a=Boolean(e["with-replies"]),i=String(e["note-id"]),d=x(i);await o.goto(g(i,{commandName:"rednote comments",cookieRoot:"rednote.com",signedUrlHint:R}));await o.wait({time:2+Math.random()*3});const r=await o.evaluate(b(a));if(!r||typeof r!=="object")throw new y("rednote/comments","Unexpected evaluate response");if(r.securityBlock)throw new w("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(i)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(r.loginWall)throw new h("www.rednote.com","Note comments require login");const m=r.results??[],l=(t,n)=>({rank:n+1,author:t.author,text:t.text,likes:t.likes,time:t.time,is_reply:t.is_reply,reply_to:t.reply_to});if(a){const t=[];let n=0;for(const c of m){if(!c.is_reply)n++;if(n>s)break;t.push(c)}return t.map(l)}return m.slice(0,s).map(l)}});

package/clis/rednote/download.js

@@ -0,0 +1 @@
+import{cli as V,Strategy as W}from"@jackwener/opencli/registry";import{formatCookieHeader as X}from"@jackwener/opencli/download";import{downloadMedia as Y}from"@jackwener/opencli/download/media-download";import{CommandExecutionError as Z,EmptyResultError as $}from"@jackwener/opencli/errors";import{buildDownloadExtractJs as f}from"../xiaohongshu/download.js";import{buildNoteUrl as G,parseNoteId as J}from"../xiaohongshu/note-helpers.js";const L="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";V({site:"rednote",name:"download",access:"read",description:"Download images and videos from a rednote note",domain:"www.rednote.com",strategy:W.COOKIE,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full rednote note URL with xsec_token"},{name:"output",default:"./rednote-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(z,B)=>{const A=String(B["note-id"]),P=B.output,F=J(A);await z.goto(G(A,{commandName:"rednote download",cookieRoot:"rednote.com",signedUrlHint:L}));await z.wait({time:1+Math.random()*2});const q=await z.evaluate(f(F));if(q?.securityBlock)throw new Z("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(A)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(!q||!q.media||q.media.length===0)throw new $("rednote/download","No downloadable media found on this rednote note.");const Q=X(await z.getCookies({url:"https://www.rednote.com"})),K=typeof q.noteId==="string"&&q.noteId.trim()?q.noteId.trim():F;return Y(q.media,{output:P,subdir:K,cookies:Q,filenamePrefix:K,timeout:60000})}});

package/clis/rednote/feed.js

@@ -0,0 +1 @@
+import{cli as t,Strategy as r}from"@jackwener/opencli/registry";import{runFeed as n}from"../xiaohongshu/feed.js";export const command=t({site:"rednote",name:"feed",access:"read",description:"Rednote home feed (reads hydrated Pinia store)",domain:"www.rednote.com",strategy:r.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Number of items to return"}],columns:["id","title","author","likes","type","url"],func:async(e,o)=>n(e,o,"www.rednote.com")});

package/clis/rednote/note.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{AuthRequiredError as f,CommandExecutionError as h,EmptyResultError as a}from"@jackwener/opencli/errors";import{NOTE_EXTRACT_JS as w}from"../xiaohongshu/note.js";import{buildNoteUrl as g,parseNoteId as p}from"../xiaohongshu/note-helpers.js";const y="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";u({site:"rednote",name:"note",access:"read",description:"Read note body and engagement counts from a rednote note",domain:"www.rednote.com",strategy:m.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full rednote note URL with xsec_token"}],columns:["field","value"],func:async(o,l)=>{const n=String(l["note-id"]),d=p(n),c=g(n,{commandName:"rednote note",cookieRoot:"rednote.com",signedUrlHint:y});await o.goto(c);await o.wait({time:2+Math.random()*3});const t=await o.evaluate(w);if(!t||typeof t!=="object")throw new a("rednote/note","Unexpected evaluate response");if(t.securityBlock)throw new h("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(n)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(t.loginWall)throw new f("www.rednote.com","Note content requires login");if(t.notFound)throw new a("rednote/note",`Note ${d} not found or unavailable — it may have been deleted or restricted`);const e=t,r=(s)=>/^\d+/.test(s)?s:"0";if(!e.title&&!e.author)throw new a("rednote/note","The note page loaded without visible content. The note may be deleted or restricted.");const i=[{field:"title",value:e.title||""},{field:"author",value:e.author||""},{field:"content",value:e.desc||""},{field:"likes",value:r(e.likes||"")},{field:"collects",value:r(e.collects||"")},{field:"comments",value:r(e.comments||"")}];if(e.tags?.length)i.push({field:"tags",value:e.tags.join(", ")});return i}});

package/clis/rednote/notifications.js

@@ -0,0 +1,67 @@
+import{cli as f,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as a}from"@jackwener/opencli/errors";const p=new Set(["mentions","likes","connections"]);function u(t){const e=String(t??"mentions");if(!p.has(e))throw new n(`--type must be one of mentions, likes, or connections, got ${JSON.stringify(t)}`);return e}function d(t){const e=Number(t??20);if(!Number.isFinite(e)||!Number.isInteger(e))throw new n(`--limit must be a positive integer, got ${JSON.stringify(t)}`);if(e<1)throw new n(`--limit must be a positive integer, got ${e}`);return e}const g=`
+  (async (type) => {
+    let pinia = null;
+    const probe = (el) => el?.__vue_app__?.config?.globalProperties?.$pinia ?? null;
+    pinia = probe(document.querySelector('#app'));
+    if (!pinia) {
+      for (const el of document.querySelectorAll('*')) {
+        pinia = probe(el);
+        if (pinia) break;
+      }
+    }
+    if (!pinia || !pinia._s) return { error: 'no_pinia' };
+    const store = pinia._s.get('notification');
+    if (!store) return { error: 'no_notification_store' };
+    if (typeof store.getNotification !== 'function') return { error: 'no_getNotification_action' };
+    try { await store.getNotification(type); } catch (e) { return { error: 'action_failed', detail: e?.message }; }
+    // Read messages from whichever store path is populated. rednote keeps the
+    // current tab in activeTabMessageList but may instead drop the list into
+    // notificationMap[type] (or notificationMap[type].messages) depending on
+    // the build, so check both before timing out.
+    const readMessages = () => {
+      if (Array.isArray(store.activeTabMessageList) && store.activeTabMessageList.length > 0) return store.activeTabMessageList;
+      const tab = store.notificationMap?.[type];
+      if (Array.isArray(tab) && tab.length > 0) return tab;
+      if (Array.isArray(tab?.messages) && tab.messages.length > 0) return tab.messages;
+      if (Array.isArray(tab?.messageList) && tab.messageList.length > 0) return tab.messageList;
+      return null;
+    };
+    let messages = null;
+    for (let i = 0; i < 16; i++) {
+      messages = readMessages();
+      if (messages) break;
+      await new Promise(r => setTimeout(r, 500));
+    }
+    const arr = messages ?? (Array.isArray(store.activeTabMessageList) ? store.activeTabMessageList : []);
+    const pick = (item, snake, camel) => item?.[snake] ?? item?.[camel];
+    // Try the leaf as written, plus its snake→camel and camel→snake variants.
+    // Needed because rednote ships e.g. \`userInfo.nickName\` while xhs returns
+    // \`user_info.nickname\` (or \`user_info.nick_name\`); the field name varies
+    // independently of the wrapping object name.
+    const leafVariants = (leaf) => {
+      const camel = leaf.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+      const snake = leaf.replace(/([A-Z])/g, (_, c) => '_' + c.toLowerCase());
+      const capCamel = leaf.charAt(0) + leaf.slice(1).replace(/([a-z])([A-Z])/g, '$1$2').replace(/(^|_)([a-z])/g, (_, sep, c) => (sep ? c.toUpperCase() : c));
+      return [...new Set([leaf, camel, snake, capCamel])];
+    };
+    const nested = (item, snake, camel, ...leafCandidates) => {
+      const a = pick(item, snake, camel);
+      if (!a || typeof a !== 'object') return '';
+      for (const candidate of leafCandidates) {
+        for (const variant of leafVariants(candidate)) {
+          if (a[variant] != null && a[variant] !== '') return a[variant];
+        }
+      }
+      return '';
+    };
+    return {
+      items: arr.map(item => ({
+        user: nested(item, 'user_info', 'userInfo', 'nickname', 'nickName'),
+        action: item?.title ?? item?.actionTitle ?? '',
+        content: nested(item, 'comment_info', 'commentInfo', 'content'),
+        note: nested(item, 'item_info', 'itemInfo', 'content'),
+        time: item?.time ?? item?.timestamp ?? '',
+      })),
+    };
+  })(${JSON.stringify("PLACEHOLDER_TYPE")})
+`;export const command=f({site:"rednote",name:"notifications",access:"read",description:"Rednote notifications (mentions/likes/connections)",domain:"www.rednote.com",strategy:l.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"type",default:"mentions",help:"Notification type: mentions, likes, or connections"},{name:"limit",type:"int",default:20,help:"Number of notifications to return"}],columns:["rank","user","action","content","note","time"],func:async(t,e)=>{const o=u(e.type),s=d(e.limit);await t.goto("https://www.rednote.com/notification");await t.wait({time:2});const r=g.replace(JSON.stringify("PLACEHOLDER_TYPE"),JSON.stringify(o)),i=await t.evaluate(r);if(!i||typeof i!=="object")throw new a("rednote notifications: unexpected evaluate response");if(i.error)throw new a(`rednote notifications: ${i.error}${i.detail?" ("+i.detail+")":""}`,"The rednote SPA may still be hydrating; reload www.rednote.com/notification and retry.");return(i.items||[]).slice(0,s).map((c,m)=>({rank:m+1,...c}))}});

package/clis/rednote/search.js

@@ -0,0 +1,32 @@
+import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as Y,CommandExecutionError as Z}from"@jackwener/opencli/errors";import{buildScrollUntilJs as $,buildSearchExtractJs as f,noteIdToDate as D,unwrapEvaluateResult as M}from"../xiaohongshu/search.js";function F(B){const z=Number(B);if(!Number.isFinite(z)||!Number.isInteger(z))throw new K(`--limit must be an integer between 1 and 100, got ${JSON.stringify(B)}`);if(z<1||z>100)throw new K(`--limit must be between 1 and 100, got ${z}`);return z}function L(B){const z=M(B);if(!Array.isArray(z))throw new Z("Unexpected Rednote search extraction payload shape; expected an array of rows.");return z}const U=`
+  new Promise((resolve) => {
+    const hasLoginModal = () => {
+      const candidates = document.querySelectorAll(
+        '[class*="login-modal"], [class*="LoginModal"], [class*="login-container"], [class*="LoginContainer"], dialog[role="dialog"]'
+      );
+      for (const el of candidates) {
+        if (!(el instanceof HTMLElement)) continue;
+        const rect = el.getBoundingClientRect();
+        if (rect.width <= 0 || rect.height <= 0) continue;
+        const style = getComputedStyle(el);
+        if (style.display === 'none' || style.visibility === 'hidden') continue;
+        return true;
+      }
+      return false;
+    };
+    const detect = () => {
+      if (document.querySelector('section.note-item')) return 'content';
+      if (/登录后查看搜索结果|请登录/.test(document.body?.innerText || '')) return 'login_wall';
+      if (hasLoginModal()) return 'login_wall';
+      return null;
+    };
+    const found = detect();
+    if (found) return resolve(found);
+    const observer = new MutationObserver(() => {
+      const result = detect();
+      if (result) { observer.disconnect(); resolve(result); }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    setTimeout(() => { observer.disconnect(); resolve('timeout'); }, 5000);
+  })
+`;V({site:"rednote",name:"search",access:"read",description:"Search rednote notes",domain:"www.rednote.com",strategy:X.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","author","likes","published_at","url","author_url"],func:async(B,z)=>{const H=F(z.limit??20),P=encodeURIComponent(z.query);await B.goto(`https://www.rednote.com/search_result?keyword=${P}&source=web_search_result_notes`);if(M(await B.evaluate(U))==="login_wall")throw new Y("www.rednote.com","Rednote search results are blocked behind a login wall");await B.evaluate($(H));return L(await B.evaluate(f("www.rednote.com"))).filter((G)=>G.title).slice(0,H).map((G,Q)=>({rank:Q+1,...G,published_at:D(G.url)}))}});

package/clis/rednote/user.js

@@ -0,0 +1 @@
+import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as m,EmptyResultError as h}from"@jackwener/opencli/errors";import{USER_SNAPSHOT_JS as f}from"../xiaohongshu/user.js";import{extractXhsUserNotes as c,normalizeXhsUserId as w}from"../xiaohongshu/user-helpers.js";const i="www.rednote.com";function g(e){const t=Number(e??15);if(!Number.isFinite(t)||!Number.isInteger(t))throw new m(`--limit must be a positive integer, got ${JSON.stringify(e)}`);if(t<1)throw new m(`--limit must be a positive integer, got ${t}`);return t}export const command=p({site:"rednote",name:"user",access:"read",description:"Get public notes from a rednote user profile",domain:i,strategy:d.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"id",type:"str",required:!0,positional:!0,help:"User id or profile URL"},{name:"limit",type:"int",default:15,help:"Number of notes to return"}],columns:["id","title","type","likes","url"],func:async(e,t)=>{const o=w(String(t.id)),l=g(t.limit);await e.goto(`https://${i}/user/profile/${o}`);let s=await e.evaluate(f),r=c(s??{},o,i),a=r.length;for(let u=0;r.length<l&&u<4;u+=1){await e.autoScroll({times:1,delayMs:1500});await e.wait({time:1});s=await e.evaluate(f);const n=c(s??{},o,i);if(n.length<=a)break;r=n;a=n.length}if(r.length===0)throw new h("rednote/user","No public notes found for this rednote user.");return r.slice(0,l)}});

package/clis/rest-countries/country.js

@@ -0,0 +1 @@
+import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{EmptyResultError as W}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as X,REST_COUNTRIES_BASE as Z,projectCountry as $,requireBoundedInt as f,requireString as x,restCountriesFetch as A}from"./utils.js";Q({site:"rest-countries",name:"country",access:"read",description:"Look up countries by name (common / official, substring match)",domain:"restcountries.com",strategy:V.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Country name (e.g. "japan", "united kingdom")'},{name:"limit",type:"int",default:25,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(G)=>{const H=x(G.name,"name"),M=f(G.limit,25,250),P=`${Z}/name/${encodeURIComponent(H)}?fields=${X}`,J=await A(P,"rest-countries country"),K=Array.isArray(J)?J:[];if(!K.length)throw new W("rest-countries country",`No countries matched "${H}".`);return[...K].sort((v,z)=>(z?.population??0)-(v?.population??0)).slice(0,M).map((v,z)=>({rank:z+1,...$(v)}))}});

package/clis/rest-countries/region.js

@@ -0,0 +1 @@
+import{cli as c,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as m,REST_COUNTRIES_BASE as g,projectCountry as p,requireBoundedInt as d,requireRegion as f,restCountriesFetch as y}from"./utils.js";c({site:"rest-countries",name:"region",access:"read",description:"List countries in a region (africa / americas / asia / europe / oceania / antarctic)",domain:"restcountries.com",strategy:u.PUBLIC,browser:!1,args:[{name:"region",positional:!0,required:!0,help:"Region name (case-insensitive)"},{name:"limit",type:"int",default:250,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(i)=>{const n=f(i.region),a=d(i.limit,250,250),s=`${g}/region/${encodeURIComponent(n)}?fields=${m}`,o=await y(s,"rest-countries region"),t=Array.isArray(o)?o:[];if(!t.length)throw new l("rest-countries region",`No countries returned for region "${n}".`);return[...t].sort((e,r)=>(r?.population??0)-(e?.population??0)).slice(0,a).map((e,r)=>({rank:r+1,...p(e)}))}});

package/clis/rest-countries/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as H,CommandExecutionError as K,EmptyResultError as M}from"@jackwener/opencli/errors";export const REST_COUNTRIES_BASE="https://restcountries.com/v3.1";const Q="opencli-rest-countries-adapter/1.0 (+https://github.com/jackwener/opencli; mailto:opencli@example.com)";export const REST_COUNTRIES_REGIONS=new Set(["africa","americas","asia","europe","oceania","antarctic"]),COUNTRY_FIELDS=["name","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","flag","latlng","timezones","independent","unMember","landlocked"].join(",");export function requireString(q,z){const B=String(q??"").trim();if(!B)throw new H(`rest-countries ${z} cannot be empty`);return B}export function requireBoundedInt(q,z,B,D="limit"){const F=q??z,J=typeof F==="number"?F:Number(F);if(!Number.isInteger(J)||J<=0)throw new H(`rest-countries ${D} must be a positive integer`);if(J>B)throw new H(`rest-countries ${D} must be <= ${B}`);return J}export function requireRegion(q){const z=String(q??"").trim().toLowerCase();if(!z)throw new H('rest-countries region is required (e.g. "europe", "asia")');if(!REST_COUNTRIES_REGIONS.has(z))throw new H(`rest-countries region "${q}" is not recognised`,`Allowed regions: ${[...REST_COUNTRIES_REGIONS].join(", ")}.`);return z}export async function restCountriesFetch(q,z){let B;try{B=await fetch(q,{headers:{"user-agent":Q,accept:"application/json"}})}catch(F){throw new K(`${z} request failed: ${F?.message??F}`,"Check that restcountries.com is reachable from this network.")}if(B.status===404)throw new M(z,`REST Countries returned 404 for ${q}.`);if(B.status===429)throw new K(`${z} returned HTTP 429 (rate limited)`);if(!B.ok)throw new K(`${z} returned HTTP ${B.status}`);let D;try{D=await B.json()}catch(F){throw new K(`${z} returned malformed JSON: ${F?.message??F}`)}return D}export function joinCurrencies(q){if(!q||typeof q!=="object")return"";return Object.entries(q).map(([z,B])=>{const D=B&&typeof B.name==="string"?B.name:"";return D?`${z} (${D})`:z}).join(", ")}export function joinLanguages(q){if(!q||typeof q!=="object")return"";return Object.values(q).filter((z)=>typeof z==="string"&&z.trim()).join(", ")}export function projectCountry(q){const z=q?.name?.common??null,B=q?.name?.official??null,D=typeof q?.cca3==="string"?q.cca3:null;return{commonName:typeof z==="string"?z:null,officialName:typeof B==="string"?B:null,cca2:typeof q?.cca2==="string"?q.cca2:null,cca3:D,ccn3:typeof q?.ccn3==="string"?q.ccn3:null,capital:Array.isArray(q?.capital)?q.capital.join(", "):null,region:typeof q?.region==="string"?q.region:null,subregion:typeof q?.subregion==="string"?q.subregion:null,population:typeof q?.population==="number"?q.population:null,area:typeof q?.area==="number"?q.area:null,languages:joinLanguages(q?.languages),currencies:joinCurrencies(q?.currencies),latitude:Array.isArray(q?.latlng)&&typeof q.latlng[0]==="number"?q.latlng[0]:null,longitude:Array.isArray(q?.latlng)&&typeof q.latlng[1]==="number"?q.latlng[1]:null,timezones:Array.isArray(q?.timezones)?q.timezones.join(", "):null,independent:typeof q?.independent==="boolean"?q.independent:null,unMember:typeof q?.unMember==="boolean"?q.unMember:null,landlocked:typeof q?.landlocked==="boolean"?q.landlocked:null,flag:typeof q?.flag==="string"?q.flag:null,url:D?`https://restcountries.com/v3.1/alpha/${D.toLowerCase()}`:""}}

package/clis/reuters/article-detail.js

@@ -0,0 +1 @@
+import{ArgumentError as a,AuthRequiredError as n,CommandExecutionError as o,EmptyResultError as u}from"@jackwener/opencli/errors";import{cli as s,Strategy as c}from"@jackwener/opencli/registry";import{buildArticleDetailScript as d,mapArticleDetail as w}from"./utils.js";const m=/^https?:\/\/(?:www\.)?reuters\.com\//i;s({site:"reuters",name:"article-detail",access:"read",description:"Reuters 路透社文章详情：标题/作者/正文文本",domain:"www.reuters.com",strategy:c.COOKIE,args:[{name:"url",required:!0,positional:!0,help:"Reuters article URL (must be on reuters.com)"}],columns:["title","date","section","section_path","authors","description","word_count","url","body"],func:async(i,l)=>{const t=String(l.url||"").trim();if(!t)throw new a("Article URL cannot be empty");if(!m.test(t))throw new a(`URL must be on reuters.com, got ${t}`);await i.goto(t);await i.wait(2);const e=await i.evaluate(d());if(e?.error)throw new o(`Reuters article-detail failed inside the page: ${e.error}`);if(e?.authRequired)throw new n("www.reuters.com","Reuters article-detail is gated by login, subscription, or human verification");if(!e||e.ok!==!0)throw new o("Reuters article-detail returned no payload","Check that the URL points to a Reuters article and that the page loaded");const r=w(e.body?.article,e.body?.bodyText,t);if(!r||!r.title&&!r.body)throw new u("reuters article-detail","Page rendered no article body — likely paywalled or a non-article URL");return[r]}});

package/clis/reuters/auth.js

@@ -0,0 +1,39 @@
+import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as H}from"../_shared/site-auth.js";async function G(B){await B.goto("https://www.reuters.com/");await B.wait(2);const z=await B.evaluate(`
+    (() => {
+      try {
+        const subStateRaw = localStorage.getItem('rcom-subscription-state');
+        let subState = null;
+        if (subStateRaw) { try { subState = JSON.parse(subStateRaw); } catch {} }
+        if (!subState || subState.isLoggedIn !== true) {
+          return { kind: 'auth', detail: 'Reuters rcom-subscription-state.isLoggedIn is not true — anonymous' };
+        }
+        let oidcKey = null;
+        for (let i = 0; i < localStorage.length; i++) {
+          const k = localStorage.key(i);
+          if (k && k.startsWith('oidc.user:')) { oidcKey = k; break; }
+        }
+        let cuid = '';
+        if (oidcKey) {
+          try {
+            const u = JSON.parse(localStorage.getItem(oidcKey) || '{}');
+            cuid = String(u?.profile?.cuid || u?.profile?.sub || '');
+          } catch {}
+        }
+        if (!cuid) {
+          const ajs = localStorage.getItem('ajs_user_id');
+          if (ajs && ajs !== 'null') cuid = ajs;
+        }
+        if (!cuid) {
+          return { kind: 'auth', detail: 'Reuters logged-in but cuid missing — session shape drifted' };
+        }
+        return { ok: true, user_id: cuid, subscribed: Boolean(subState.isSubscribed) };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()
+  `);if(z?.kind==="auth")throw new D("reuters.com",z.detail);if(z?.kind==="exception")throw new F(`Reuters whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected Reuters probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,subscribed:z.subscribed}}H({site:"reuters",domain:"reuters.com",loginUrl:"https://www.reuters.com/account/sign-in/",columns:["user_id","subscribed"],verify:G,poll:async(B)=>{if(!await B.evaluate(`(() => {
+      try {
+        const raw = localStorage.getItem('rcom-subscription-state');
+        return raw ? JSON.parse(raw).isLoggedIn === true : false;
+      } catch { return false; }
+    })()`))throw new D("reuters.com","Waiting for Reuters login");return G(B)}});

package/clis/reuters/search.js

@@ -0,0 +1 @@
+import{ArgumentError as u,AuthRequiredError as c,CommandExecutionError as r,EmptyResultError as h}from"@jackwener/opencli/errors";import{cli as w,Strategy as m}from"@jackwener/opencli/registry";import{buildSearchScript as l,isAuthStatus as d,looksAuthWallText as p,mapSearchArticles as y,parseLimit as f}from"./utils.js";w({site:"reuters",name:"search",access:"read",description:"Reuters 路透社新闻搜索",domain:"www.reuters.com",strategy:m.COOKIE,args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (1-40)"}],columns:["rank","title","date","section","section_path","authors","url"],func:async(t,o)=>{const i=f(o.limit),s=String(o.query||"").trim();if(!s)throw new u("Search query cannot be empty","Provide a non-empty keyword");await t.goto("https://www.reuters.com");await t.wait(2);const e=await t.evaluate(l(s,i));if(e?.error)throw new r(`Reuters search failed inside the page: ${e.error}`);if(!e||typeof e!=="object")throw new r("Reuters search API returned an unreadable response");if(d(e.status)||p(e.textPreview))throw new c("www.reuters.com",`Reuters search requires an accessible Reuters browser session or completed human verification${e.status?` (HTTP ${e.status})`:""}`);if(e.ok!==!0){const a=Number.isFinite(e.status)&&e.status>0?`HTTP ${e.status}${e.statusText?` ${e.statusText}`:""}`:"no upstream response";throw new r(`Reuters search API failed (${a})`)}if(!e.body){const a=e.parseError?`: ${e.parseError}`:"";throw new r(`Reuters search returned a non-JSON body${a}`,"Open www.reuters.com in your browser and clear any challenge before retrying.")}const n=y(e.body,i);if(!n.length)throw new h("reuters search",`No articles matched "${s}". Try broadening the query.`);return n}});