publishport-opencli 1.0.0

package/clis/facebook/feed.js

@@ -0,0 +1,209 @@
+import{ArgumentError as m,AuthRequiredError as h,CommandExecutionError as s,EmptyResultError as i}from"@jackwener/opencli/errors";import{cli as b,Strategy as k}from"@jackwener/opencli/registry";const x="https://www.facebook.com/",a=50;function c(t){const n=Number(t);if(!Number.isInteger(n)||n<1||n>a)throw new m(`facebook feed --limit must be an integer between 1 and ${a}`);return n}function p(t){if(t&&typeof t==="object"&&"data"in t)return t.data;return t}function l(t){return`(() => {
+    const limit = ${t};
+
+    function clean(value) {
+      return String(value || '').replace(/\\s+/g, ' ').trim();
+    }
+
+    function textOf(el) {
+      return clean(el && el.textContent);
+    }
+
+    function labelOf(el) {
+      return clean(el && el.getAttribute && el.getAttribute('aria-label'));
+    }
+
+    function isAuthPage() {
+      const path = window.location && window.location.pathname ? window.location.pathname : '';
+      const body = textOf(document.body);
+      return /^\\/(login|checkpoint)(\\/|$|\\.php)/.test(path)
+        || /^(Log in to Facebook|Facebook登录|登录 Facebook)/i.test(body)
+        || /You must log in to continue/i.test(body);
+    }
+
+    function isExplicitEmptyFeed() {
+      const body = textOf(document.body);
+      return /No posts available|Nothing to show|暂无动态|没有更多动态|还没有帖子/i.test(body);
+    }
+
+    function isSuggestionOrChrome(text) {
+      return /^(People you may know|People You May Know|可能认识的人?|你可能认识的人?)/i.test(text)
+        || /^(Suggested for you|Suggested Groups|推荐小组|推荐内容)/i.test(text);
+    }
+
+    function isSponsored(text) {
+      return /(^|\\s)(Sponsored|赞助|广告)(\\s|$)/i.test(text);
+    }
+
+    function isActionText(text) {
+      return /^(Like|Comment|Share|Send|Follow|赞|评论|分享|发送|关注)$/i.test(text);
+    }
+
+    function isMetricText(text) {
+      return /^(All:|所有心情：)/i.test(text)
+        || /\\b(likes?|reactions?|comments?|shares?)\\b/i.test(text)
+        || /(条评论|次分享)$/.test(text);
+    }
+
+    function isTimestampText(text) {
+      return /^(\\d+\\s*(s|m|h|d|w|mo|yr|min|sec|second|minute|hour|day|week|month|year)s?|Just now|Yesterday|刚刚|昨天|\\d+小时|\\d+天)(\\s*[·•.])?$/i.test(text);
+    }
+
+    function postUrlFrom(root) {
+      const links = Array.from(root.querySelectorAll('a[href]'));
+      for (const link of links) {
+        const href = link.href || link.getAttribute('href') || '';
+        if (/\\/posts\\/|\\/permalink\\.php|\\/story\\.php|\\/photo\\/\\?fbid=|\\/groups\\/[^/]+\\/posts\\//i.test(href)) {
+          return href;
+        }
+      }
+      return '';
+    }
+
+    function actionKinds(root) {
+      const kinds = new Set();
+      for (const el of root.querySelectorAll('[aria-label]')) {
+        const label = labelOf(el);
+        if (/^(Like|赞)$/i.test(label)) kinds.add('like');
+        if (/^(Comment|评论)$/i.test(label)) kinds.add('comment');
+        if (/^(Share|分享)$/i.test(label)) kinds.add('share');
+      }
+      return kinds;
+    }
+
+    function visibleBlocks(root) {
+      const seen = new Set();
+      return Array.from(root.querySelectorAll('[dir="auto"]'))
+        .map(textOf)
+        .filter((text) => {
+          if (!text || text.length > 600 || seen.has(text)) return false;
+          seen.add(text);
+          return true;
+        });
+    }
+
+    function findAuthor(root) {
+      const links = [
+        root.querySelector('h2 a[href], h3 a[href], h4 a[href], strong a[href]'),
+        ...Array.from(root.querySelectorAll('a[role="link"][href]')),
+      ].filter(Boolean);
+      for (const link of links) {
+        const text = textOf(link);
+        const href = link.href || link.getAttribute('href') || '';
+        if (text.length > 1 && text.length <= 80
+          && !isActionText(text)
+          && !isMetricText(text)
+          && !isTimestampText(text)
+          && !/\\/groups\\/|\\/watch\\/|\\/reel\\/|\\/events\\/|\\/friends\\//i.test(href)) {
+          return text;
+        }
+      }
+      return '';
+    }
+
+    function contentBlocks(root, author) {
+      return visibleBlocks(root).filter((text) => {
+        if (text === author) return false;
+        if (text.length <= 10) return false;
+        if (isSuggestionOrChrome(text) || isSponsored(text)) return false;
+        if (isActionText(text) || isMetricText(text) || isTimestampText(text)) return false;
+        if (/^(See more|查看更多|更多)$/i.test(text)) return false;
+        return true;
+      });
+    }
+
+    function extractPost(root, index) {
+      const fullText = textOf(root);
+      if (!fullText || isSuggestionOrChrome(fullText) || isSponsored(fullText)) return null;
+
+      const author = findAuthor(root);
+      const blocks = contentBlocks(root, author);
+      const content = clean(blocks.join(' '));
+      const postUrl = postUrlFrom(root);
+      const kinds = actionKinds(root);
+
+      if (!author && !content) return null;
+      if (!content && !postUrl && kinds.size < 2) return null;
+
+      const likesMatch = fullText.match(/所有心情：\\s*(\\d[\\d,.\\s万亿KMk]*)/)
+        || fullText.match(/All:\\s*(\\d[\\d,.KMk]*)/)
+        || fullText.match(/(\\d[\\d,.KMk]*)\\s*(?:likes?|reactions?)/i);
+      const commentsMatch = fullText.match(/([\\d,.]+\\s*[万亿]?)\\s*条评论/)
+        || fullText.match(/(\\d[\\d,.KMk]*)\\s*comments?/i);
+      const sharesMatch = fullText.match(/([\\d,.]+\\s*[万亿]?)\\s*次分享/)
+        || fullText.match(/(\\d[\\d,.KMk]*)\\s*shares?/i);
+
+      return {
+        index,
+        author: author.substring(0, 50),
+        content: content.substring(0, 120),
+        likes: likesMatch ? clean(likesMatch[1]) : '-',
+        comments: commentsMatch ? clean(commentsMatch[1]) : '-',
+        shares: sharesMatch ? clean(sharesMatch[1]) : '-',
+      };
+    }
+
+    function primaryContainers() {
+      return Array.from(document.querySelectorAll('[role="article"]'))
+        .filter((el) => textOf(el).length > 30);
+    }
+
+    function fallbackContainers() {
+      const main = document.querySelector('[role="main"]');
+      if (!main) return [];
+      const buttons = Array.from(main.querySelectorAll('[aria-label="Like"], [aria-label="赞"], [aria-label="Comment"], [aria-label="评论"], [aria-label="Share"], [aria-label="分享"]'));
+      const seen = new WeakSet();
+      const containers = [];
+      for (const button of buttons) {
+        let node = button.parentElement;
+        for (let depth = 0; depth < 16 && node && node !== main && node !== document.body; depth += 1, node = node.parentElement) {
+          const text = textOf(node);
+          const kinds = actionKinds(node);
+          const blocks = visibleBlocks(node);
+          const hasPostEvidence = Boolean(postUrlFrom(node)) || blocks.some((block) => block.length > 20 && !isActionText(block) && !isMetricText(block));
+          if (text.length >= 80 && kinds.has('like') && (kinds.has('comment') || kinds.has('share')) && hasPostEvidence) {
+            if (!seen.has(node)) {
+              seen.add(node);
+              containers.push(node);
+            }
+            break;
+          }
+        }
+      }
+      return containers;
+    }
+
+    function dedupe(containers) {
+      const seen = new Set();
+      const result = [];
+      for (const node of containers) {
+        const key = postUrlFrom(node) || contentBlocks(node, findAuthor(node)).join('|').substring(0, 200);
+        if (!key || seen.has(key)) continue;
+        seen.add(key);
+        result.push(node);
+      }
+      return result;
+    }
+
+    if (isAuthPage()) return { status: 'auth', rows: [], diagnostics: {} };
+
+    const primary = primaryContainers();
+    const combined = dedupe([...primary, ...fallbackContainers()]);
+    const rows = [];
+    for (const container of combined) {
+      const row = extractPost(container, rows.length + 1);
+      if (row) rows.push(row);
+      if (rows.length >= limit) break;
+    }
+
+    return {
+      status: rows.length ? 'ok' : (isExplicitEmptyFeed() ? 'empty' : 'no_rows'),
+      rows,
+      diagnostics: {
+        articleCount: document.querySelectorAll('[role="article"]').length,
+        primaryCount: primary.length,
+        fallbackActionCount: document.querySelectorAll('[role="main"] [aria-label="Like"], [role="main"] [aria-label="赞"], [role="main"] [aria-label="Comment"], [role="main"] [aria-label="评论"]').length,
+        mainTextLength: textOf(document.querySelector('[role="main"]')).length,
+      },
+    };
+  })()`}async function u(t,n){const d=c(n.limit??10);try{await t.goto(x,{settleMs:4000})}catch(o){throw new s(`Failed to navigate to facebook feed: ${o instanceof Error?o.message:o}`,"Check that facebook.com is reachable and the browser extension is connected.")}let e;try{e=p(await t.evaluate(l(d)))}catch(o){throw new s(`Failed to read facebook feed: ${o instanceof Error?o.message:o}`,"Facebook may not have rendered or the feed markup may have changed.")}if(!e||typeof e!=="object"||!Array.isArray(e.rows))throw new s("facebook feed returned malformed extraction payload");if(e.status==="auth")throw new h("www.facebook.com","Open Chrome and log in to Facebook before retrying.");if(e.rows.length>0)return e.rows;if(e.status==="empty")throw new i("facebook feed","Facebook did not show any feed posts for this account.");const r=e.diagnostics||{};if(r.articleCount||r.fallbackActionCount||r.mainTextLength>200)throw new s("facebook feed page rendered but no feed rows could be extracted",`Diagnostics: articles=${r.articleCount||0}, actions=${r.fallbackActionCount||0}, mainTextLength=${r.mainTextLength||0}.`);throw new i("facebook feed","No Facebook feed content was visible in the current browser session.")}const f={site:"facebook",name:"feed",access:"read",description:"Get your Facebook news feed",domain:"www.facebook.com",strategy:k.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:10,help:"Number of posts"}],columns:["index","author","content","likes","comments","shares"],func:u};b(f);export const __test__={buildFeedExtractScript:l,command:f,getFacebookFeed:u,requireLimit:c};

package/clis/facebook/friends.js

@@ -0,0 +1,24 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"friends",access:"read",description:"Get Facebook friend suggestions",domain:"www.facebook.com",args:[{name:"limit",type:"int",default:10,help:"Number of friend suggestions"}],columns:["index","name","mutual"],pipeline:[{navigate:{url:"https://www.facebook.com/friends",settleMs:3000}},{evaluate:`(() => {
+  const limit = \${{ args.limit }};
+  const items = document.querySelectorAll('[role="listitem"]');
+  return Array.from(items)
+    .slice(0, limit)
+    .map((el, i) => {
+      const text = el.textContent.trim().replace(/\\s+/g, ' ');
+      // Extract mutual info if present (before name extraction to avoid pollution)
+      const mutualMatch = text.match(/([\\d,]+)\\s*位.*(?:关注|共同|mutual)/);
+      // Extract name: remove mutual info, action buttons, etc.
+      let name = text
+        .replace(/[\\d,]+\\s*位.*(?:关注了|共同好友|mutual friends?)/, '')
+        .replace(/加好友.*/, '').replace(/Add [Ff]riend.*/, '')
+        .replace(/移除$/, '').replace(/Remove$/, '')
+        .trim();
+      return {
+        index: i + 1,
+        name: name.substring(0, 50),
+        mutual: mutualMatch ? mutualMatch[1] : '-',
+      };
+    })
+    .filter(item => item.name.length > 0);
+})()
+`}]});

package/clis/facebook/groups.js

@@ -0,0 +1,32 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"groups",access:"read",description:"List your Facebook groups",domain:"www.facebook.com",args:[{name:"limit",type:"int",default:20,help:"Number of groups"}],columns:["index","name","last_post","url"],pipeline:[{navigate:{url:"https://www.facebook.com/groups/feed/",settleMs:3000}},{evaluate:`(() => {
+  const limit = \${{ args.limit }};
+  const links = Array.from(document.querySelectorAll('a'))
+    .filter(a => {
+      const href = a.href || '';
+      return href.includes('/groups/') &&
+        !href.includes('/feed') &&
+        !href.includes('/discover') &&
+        !href.includes('/joins') &&
+        !href.includes('category=create') &&
+        a.textContent.trim().length > 2;
+    });
+
+  // Deduplicate by href
+  const seen = new Set();
+  const groups = [];
+  for (const a of links) {
+    const href = a.href.split('?')[0];
+    if (seen.has(href)) continue;
+    seen.add(href);
+    const raw = a.textContent.trim().replace(/\\s+/g, ' ');
+    // Split name from "上次发帖" info
+    const parts = raw.split(/上次发帖|Last post/);
+    groups.push({
+      name: (parts[0] || '').trim().substring(0, 60),
+      last_post: parts[1] ? parts[1].replace(/^[：:]/, '').trim() : '-',
+      url: href,
+    });
+  }
+  return groups.slice(0, limit).map((g, i) => ({ index: i + 1, ...g }));
+})()
+`}]});

package/clis/facebook/join-group.js

@@ -0,0 +1,25 @@
+import{cli as t}from"@jackwener/opencli/registry";t({site:"facebook",name:"join-group",access:"write",description:"Join a Facebook group",domain:"www.facebook.com",args:[{name:"group",required:!0,positional:!0,help:"Group ID or URL path (e.g. '1876150192925481' or group name)"}],columns:["status","group"],pipeline:[{navigate:{url:"https://www.facebook.com/groups/${{ args.group }}",settleMs:3000}},{evaluate:`(async () => {
+  const group = \${{ args.group | json }};
+  const groupName = document.querySelector('h1')?.textContent?.trim() || group;
+
+  // Find "Join Group" button
+  const buttons = Array.from(document.querySelectorAll('[role="button"]'));
+  const joinBtn = buttons.find(b => {
+    const text = b.textContent.trim();
+    return text === '加入小组' || text === 'Join group' || text === 'Join Group';
+  });
+
+  if (!joinBtn) {
+    const isMember = buttons.some(b => {
+      const t = b.textContent.trim();
+      return t === '已加入' || t === 'Joined' || t === '成员' || t === 'Member';
+    });
+    if (isMember) return [{ status: 'Already a member', group: groupName }];
+    return [{ status: 'Join button not found', group: groupName }];
+  }
+
+  joinBtn.click();
+  await new Promise(r => setTimeout(r, 1500));
+  return [{ status: 'Join request sent', group: groupName }];
+})()
+`}]});

package/clis/facebook/like.js

@@ -0,0 +1,29 @@
+import{ArgumentError as Z,AuthRequiredError as y,CommandExecutionError as V}from"@jackwener/opencli/errors";import{cli as N,Strategy as R}from"@jackwener/opencli/registry";const $="data-pp-fb-like";function U(){return`(() => {
+    const path = location.pathname || '';
+    if (/^\\/(login|checkpoint)(\\/|$|\\.php)/.test(path)) return { auth: true, detail: 'on login/checkpoint page' };
+    // A permalink often renders as a modal dialog over the feed. Scope to the
+    // dialog so we don't grab a background feed post's Like button.
+    const dialog = document.querySelector('[role="dialog"]');
+    const art = (dialog && dialog.querySelector('div[role="article"]'))
+      || dialog
+      || document.querySelector('div[role="article"]');
+    if (!art) return { notfound: true, detail: 'no post found on page' };
+    // Action buttons = focusable role=button carrying a css-img icon, not part
+    // of the reaction-count toolbar. The first one is Like.
+    const btns = [...art.querySelectorAll('[role="button"][tabindex="0"]')]
+      .filter(b => !b.closest('[role="toolbar"]') && b.querySelector('i[data-visualcompletion="css-img"]'));
+    const like = btns[0];
+    if (!like) return { notfound: true, detail: 'like button not located' };
+    like.setAttribute(${JSON.stringify($)}, '1');
+    like.scrollIntoView({ block: 'center' });
+    const icon = like.querySelector('i[data-visualcompletion="css-img"]');
+    const y = parseFloat((getComputedStyle(icon).backgroundPosition.split(' ')[1] || '0').replace('px','')) || 0;
+    return { y, label: like.getAttribute('aria-label') || '' };
+  })()`}function G(){return`(() => {
+    const like = document.querySelector('[${$}="1"]');
+    if (!like) return null;
+    const icon = like.querySelector('i[data-visualcompletion="css-img"]');
+    if (!icon) return null;
+    const y = parseFloat((getComputedStyle(icon).backgroundPosition.split(' ')[1] || '0').replace('px','')) || 0;
+    return { y, label: like.getAttribute('aria-label') || '' };
+  })()`}async function v(z,O,H){for(let J=0;J<H;J++){await z.click(`[${$}="1"]`);await z.wait(1);const M=await z.evaluate(G());if(M&&M.y!==O)return M}return null}N({site:"facebook",name:"like",access:"write",description:"Like a Facebook post (ends in the liked state; no-op if already liked). Pass the post URL. Reacts as a genuine like from your logged-in account — use it to engage with content you actually mean to endorse.",domain:"facebook.com",strategy:R.COOKIE,browser:!0,args:[{name:"url",type:"string",required:!0,positional:!0,help:"Post URL (e.g. https://www.facebook.com/<user>/posts/<id> or a permalink)"},{name:"remove",type:"bool",default:!1,help:"Remove your like instead (end in the un-liked state)"}],columns:["status","action","url","message"],func:async(z,O)=>{if(!z)throw new V("Browser session required");const H=String(O.url??"").trim();if(!H)throw new Z("Post URL is required.");let J;try{J=new URL(H)}catch{throw new Z(`Invalid post URL: ${H}`)}if(!/facebook\.com$/.test(J.hostname)&&!J.hostname.endsWith(".facebook.com"))throw new Z("URL must be a facebook.com post URL.");const M=O.remove===!0;await z.goto(H,{waitUntil:"none"});let B=null;for(let X=0;X<15;X++){await z.wait(1);B=await z.evaluate(U());if(B?.auth)throw new y("www.facebook.com",`Facebook ${B.detail} — not signed in`);if(typeof B?.y==="number")break}if(typeof B?.y!=="number")throw new V(`Could not act on this post: ${B?.detail||"like button never appeared"}.`);const P=await v(z,B.y,5);if(!P)throw new V("Like did not register — Facebook ignored the click (post may be unavailable or reactions disabled).");const q=Math.max(B.y,P.y),D=P.y===q,j=B.y===q,W=!M;let Q;if(D===W)Q=W?j?"already-liked":"liked":"unliked";else{if(!await v(z,P.y,3))throw new V("Could not settle the reaction to the desired state (second toggle ignored).");Q=W?"already-liked":"already-unliked"}return[{status:"success",action:Q,url:H,message:{liked:"Post liked.","already-liked":"Post was already liked (left liked).",unliked:"Like removed.","already-unliked":"Post was not liked (left un-liked)."}[Q]||"Reaction updated."}]}});

package/clis/facebook/marketplace-inbox.js

@@ -0,0 +1,34 @@
+import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{ArgumentError as u,AuthRequiredError as m,CommandExecutionError as p,EmptyResultError as b}from"@jackwener/opencli/errors";function r(e){const t=Number(e??20);if(!Number.isInteger(t)||t<=0)throw new u("facebook marketplace-inbox --limit must be a positive integer");return Math.min(t,100)}l({site:"facebook",name:"marketplace-inbox",access:"read",description:"List recent Facebook Marketplace buyer/seller conversations",domain:"www.facebook.com",strategy:c.COOKIE,args:[{name:"limit",type:"int",default:20,help:"Number of conversations to return"}],columns:["index","buyer","listing","snippet","time","unread"],func:async(e,t)=>{if(!e)throw new p("Browser session required for facebook marketplace-inbox");const s=r(t.limit);await e.goto("https://www.facebook.com/marketplace/inbox/");await e.wait(4);const n=await e.evaluate(String.raw`(() => {
+      const clean = (s) => String(s || '').replace(/[\u00a0\u202f]/g, ' ').replace(/\s+/g, ' ').trim();
+      const timeRe = /^(?:\d{1,2}:\d{2}\s?(?:AM|PM|am|pm|上午|下午)?|Mon|Tue|Wed|Thu|Fri|Sat|Sun|Today|Yesterday|\d+[mhdw]|\d+\s*(?:min|h|d|w))$/;
+      const text = document.body?.innerText || '';
+      if (/log in|sign in/i.test(text) && !/Marketplace/i.test(text)) {
+        return { authRequired: true, rows: [] };
+      }
+
+      const lines = text.split(/\n+/).map(clean).filter(Boolean);
+      const out = [];
+      const seen = new Set();
+      const skipBuyer = /^(Marketplace|Browse all|Notifications|Inbox|Marketplace access|Buying|Selling|Create new listing|Create multiple listings|Location|Categories|Vehicles|Property Rentals|All|Pending payment|Paid|To be shipped|Shipped|Cash on delivery|Completed|Filter by label)$/i;
+      for (let i = 0; i < lines.length - 2; i += 1) {
+        const buyer = lines[i];
+        const meta = lines[i + 1];
+        if (skipBuyer.test(buyer) || !/^·\s+/.test(meta)) continue;
+        const listing = meta.replace(/^·\s*/, '');
+        if (!listing || /^Within\b/i.test(listing)) continue;
+        const snippet = lines[i + 2] || '';
+        const time = timeRe.test(lines[i + 3] || '') ? lines[i + 3] : '';
+        const key = buyer + '|' + listing;
+        if (seen.has(key)) continue;
+        seen.add(key);
+        const nearby = lines.slice(Math.max(0, i - 2), i + 5).join(' ');
+        out.push({
+          buyer,
+          listing,
+          snippet,
+          time,
+          unread: /Unread/i.test(nearby),
+        });
+      }
+      return { authRequired: false, rows: out };
+    })()`);if(n?.authRequired)throw new m("facebook.com","Facebook Marketplace inbox requires an active signed-in Facebook session.");const o=Array.isArray(n?.rows)?n.rows:[];if(o.length===0)throw new b("facebook marketplace-inbox","No Marketplace inbox conversations were visible. Check that Marketplace inbox is available for this account.");return o.slice(0,s).map((i,a)=>({index:a+1,buyer:i.buyer||"",listing:i.listing||"",snippet:i.snippet||"",time:i.time||"",unread:Boolean(i.unread)}))}});export const __test__={normalizeLimit:r};

package/clis/facebook/marketplace-listings.js

@@ -0,0 +1,33 @@
+import{cli as r,Strategy as c}from"@jackwener/opencli/registry";import{ArgumentError as u,AuthRequiredError as d,CommandExecutionError as w,EmptyResultError as k}from"@jackwener/opencli/errors";function l(e){const t=Number(e??20);if(!Number.isInteger(t)||t<=0)throw new u("facebook marketplace-listings --limit must be a positive integer");return Math.min(t,100)}r({site:"facebook",name:"marketplace-listings",access:"read",description:"List your Facebook Marketplace seller listings",domain:"www.facebook.com",strategy:c.COOKIE,args:[{name:"limit",type:"int",default:20,help:"Number of listings to return"}],columns:["index","title","price","status","listed","clicks","actions"],func:async(e,t)=>{if(!e)throw new w("Browser session required for facebook marketplace-listings");const o=l(t.limit);await e.goto("https://www.facebook.com/marketplace/you/selling/");await e.wait(4);const s=await e.evaluate(String.raw`(() => {
+      const clean = (s) => String(s || '').replace(/\u00a0/g, ' ').replace(/\s+/g, ' ').trim();
+      const allText = document.body?.innerText || '';
+      if (/log in|sign in/i.test(allText) && !/Marketplace/i.test(allText)) {
+        return { authRequired: true, rows: [] };
+      }
+
+      const lines = allText.split(/\n+/).map(clean).filter(Boolean);
+      const seen = new Set();
+      const out = [];
+      for (let i = 1; i < lines.length; i += 1) {
+        if (!/^(?:CA\$|\$)\s*\d+/.test(lines[i])) continue;
+        const title = lines[i - 1];
+        if (!title || /^(Hide|All listings|Needs attention|Marketplace|Selling)$/i.test(title)) continue;
+        if (seen.has(title)) continue;
+        seen.add(title);
+        const windowLines = lines.slice(i, i + 12);
+        const status = windowLines.find((line) => /^(Active|Sold|Pending|Draft)$/i.test(line)) || '';
+        const listed = windowLines.find((line) => /Listed on\b/i.test(line))?.replace(/^·\s*/, '') || '';
+        const clickLine = windowLines.find((line) => /clicks? on listing/i.test(line)) || '';
+        const clickMatch = clickLine.match(/([\d,.]+)\s+clicks? on listing/i);
+        const actions = windowLines.filter((line) => /^(Mark as sold|Mark as available|Relist this item|Share|Boost listing)$/i.test(line));
+        out.push({
+          title,
+          price: lines[i],
+          status,
+          listed,
+          clicks: clickMatch ? clickMatch[1] : '',
+          actions,
+        });
+      }
+      return { authRequired: false, rows: out };
+    })()`);if(s?.authRequired)throw new d("facebook.com","Facebook Marketplace seller listings require an active signed-in Facebook session.");const n=Array.isArray(s?.rows)?s.rows:[];if(n.length===0)throw new k("facebook marketplace-listings","No seller listings were visible. Check that Marketplace selling is available for this account.");return n.slice(0,o).map((i,a)=>({index:a+1,title:i.title||"",price:i.price||"",status:i.status||"",listed:i.listed||"",clicks:i.clicks||"",actions:Array.isArray(i.actions)?i.actions.join(", "):String(i.actions||"")}))}});export const __test__={normalizeLimit:l};

package/clis/facebook/memories.js

@@ -0,0 +1,21 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"memories",access:"read",description:"Get your Facebook memories (On This Day)",domain:"www.facebook.com",args:[{name:"limit",type:"int",default:10,help:"Number of memories"}],columns:["index","source","content","time"],pipeline:[{navigate:{url:"https://www.facebook.com/onthisday",settleMs:4000}},{evaluate:`(() => {
+  const limit = \${{ args.limit }};
+  const articles = document.querySelectorAll('[role="article"]');
+  return Array.from(articles)
+    .slice(0, limit)
+    .map((el, i) => {
+      const headerLink = el.querySelector('h2 a, h3 a, h4 a, strong a');
+      const spans = Array.from(el.querySelectorAll('div[dir="auto"]'))
+        .map(s => s.textContent.trim())
+        .filter(t => t.length > 5 && t.length < 500);
+      const timeEl = el.querySelector('a[href*="/posts/"] span, a[href*="story_fbid"] span');
+      return {
+        index: i + 1,
+        source: headerLink ? headerLink.textContent.trim().substring(0, 50) : '-',
+        content: (spans[0] || '').replace(/\\n/g, ' ').substring(0, 150),
+        time: timeEl ? timeEl.textContent.trim() : '-',
+      };
+    })
+    .filter(item => item.content.length > 0 || item.source !== '-');
+})()
+`}]});

package/clis/facebook/notifications.js

@@ -0,0 +1,31 @@
+import{cli as H,Strategy as L}from"@jackwener/opencli/registry";import{ArgumentError as M,AuthRequiredError as k,CommandExecutionError as C,EmptyResultError as O}from"@jackwener/opencli/errors";export const FB_HOST="https://www.facebook.com",NOTIFICATIONS_LIMIT_DEFAULT=15,NOTIFICATIONS_LIMIT_MAX=100,MARK_AS_READ_PREFIXES=["标记为已读，","Mark as read, ","Mark as Read, ","Marquer comme lu, ","Marcar como leído, ","既読にする, "],UNREAD_BADGE_LABELS=["未读","Unread","No leído","未読"];export function normalizeNotificationsLimit(V){if(V===void 0||V===null||V==="")return NOTIFICATIONS_LIMIT_DEFAULT;const Z=typeof V==="number"?V:Number(V);if(!Number.isFinite(Z)||!Number.isInteger(Z)||Z<1||Z>NOTIFICATIONS_LIMIT_MAX)throw new M(`--limit must be a positive integer in [1, ${NOTIFICATIONS_LIMIT_MAX}], got ${JSON.stringify(V)}`);return Z}export function stripMarkAsReadPrefix(V,Z){if(!V)return null;const W=String(V).trim();if(!W)return null;for(let J=0;J<Z.length;J+=1){const Y=Z[J];if(W.startsWith(Y))return W.slice(Y.length).trim()}return null}export function stripAnchorChrome(V,Z,W){if(!V)return"";let J=String(V).trim();for(let Y=0;Y<W.length;Y+=1){const $=W[Y];if(J.startsWith($)){J=J.slice($.length).trim();break}}if(Z){const Y=String(Z).trim();if(Y&&J.endsWith(Y))J=J.slice(0,J.length-Y.length).trim()}J=J.replace(/[.。]+$/,"").trim();return J}export function parseNotifQuery(V,Z){const W={notif_id:null,notif_type:null};if(!V)return W;let J;try{J=new URL(V,Z)}catch(Y){return W}W.notif_id=J.searchParams.get("notif_id")||null;W.notif_type=J.searchParams.get("notif_t")||null;return W}export function isFacebookAuthRedirectPath(V){return/^\/(?:login|checkpoint)(?:\.php)?(?:\/|$)/i.test(String(V||""))}export function extractNotificationRowsFromDoc(V,Z,W){const J=[],Y=V.querySelectorAll('[role="listitem"]');for(let $=0;$<Y.length&&J.length<Z;$+=1){const Q=Y[$],G=Q.querySelector("a[href]");if(!G)continue;const P=G.href||G.getAttribute("href")||"";if(!P)continue;const U=Q.querySelector("abbr"),B=U?(U.textContent||"").trim()||null:null;let v=!1;const X=Q.querySelectorAll("div");for(let q=0;q<X.length;q+=1){const z=(X[q].textContent||"").trim();if(W.unreadBadges.indexOf(z)!==-1){v=!0;break}}if(!v){const q=(G.textContent||"").trim();for(let z=0;z<W.unreadBadges.length;z+=1)if(q.startsWith(W.unreadBadges[z])){v=!0;break}}let K=null;const j=Q.querySelectorAll("[aria-label]");for(let q=0;q<j.length;q+=1){const z=j[q].getAttribute("aria-label"),y=W.stripMark(z,W.markPrefixes);if(y!==null){K=y.replace(/[.。]+$/,"").trim()||null;break}}if(!K)K=W.stripChrome(G.textContent||"",B,W.unreadBadges)||null;if(!K)continue;const{notif_id:D,notif_type:R}=W.parseQuery(P,W.fbHost);J.push({index:J.length+1,unread:v,text:K,time:B,url:P,notif_id:D,notif_type:R})}return J}export function buildNotificationsScript(V){return`
+(async () => {
+  const FB_HOST = ${JSON.stringify(FB_HOST)};
+  const MARK_AS_READ_PREFIXES = ${JSON.stringify(MARK_AS_READ_PREFIXES)};
+  const UNREAD_BADGE_LABELS = ${JSON.stringify(UNREAD_BADGE_LABELS)};
+  ${isFacebookAuthRedirectPath.toString()}
+  if (isFacebookAuthRedirectPath(window.location.pathname || '')) {
+    throw new Error('AUTH_REQUIRED: facebook.com redirected to login');
+  }
+  ${stripMarkAsReadPrefix.toString()}
+  ${stripAnchorChrome.toString()}
+  ${parseNotifQuery.toString()}
+  ${extractNotificationRowsFromDoc.toString()}
+  // Wait briefly for [role="listitem"] rows to render in case the SPA
+  // is still hydrating. 8s ceiling keeps a slow network from hanging
+  // the command — empty list after that surfaces as EmptyResultError
+  // on the Node side.
+  const start = Date.now();
+  while (document.querySelectorAll('[role="listitem"]').length === 0 && Date.now() - start < 8000) {
+    await new Promise(function(r) { setTimeout(r, 200); });
+  }
+  return extractNotificationRowsFromDoc(document, ${JSON.stringify(V)}, {
+    stripMark: stripMarkAsReadPrefix,
+    stripChrome: stripAnchorChrome,
+    parseQuery: parseNotifQuery,
+    fbHost: FB_HOST,
+    markPrefixes: MARK_AS_READ_PREFIXES,
+    unreadBadges: UNREAD_BADGE_LABELS,
+  });
+})()
+`}async function F(V,Z){const W=normalizeNotificationsLimit(Z.limit);try{await V.goto(`${FB_HOST}/notifications`,{waitUntil:"load",settleMs:3000})}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new C(`Failed to navigate to facebook notifications: ${$}`,"facebook.com may be unreachable")}let J;try{J=await V.evaluate(buildNotificationsScript(W))}catch(Y){const $=Y instanceof Error?Y.message:String(Y);if(/AUTH_REQUIRED/i.test($))throw new k("facebook.com","Open Chrome and log in to Facebook before retrying");throw new C(`Failed to read facebook notifications: ${$}`,"facebook.com page may not have rendered or markup may have changed")}if(!Array.isArray(J)||J.length===0)throw new O("facebook/notifications","No notifications found — login session may have expired or you have no recent notifications");return J}export const notificationsCommand=H({site:"facebook",name:"notifications",access:"read",description:"Get recent Facebook notifications (含 unread / time / url / notif_id / notif_type 列)",domain:"www.facebook.com",strategy:L.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:NOTIFICATIONS_LIMIT_DEFAULT,help:`Number of notifications (1-${NOTIFICATIONS_LIMIT_MAX})`}],columns:["index","unread","text","time","url","notif_id","notif_type"],func:F}),__test__={buildNotificationsScript};

package/clis/facebook/post.js

@@ -0,0 +1,88 @@
+import*as v from"node:fs";import*as H from"node:path";import{ArgumentError as V,AuthRequiredError as A,CommandExecutionError as $}from"@jackwener/opencli/errors";import{cli as N,Strategy as L}from"@jackwener/opencli/registry";import{assertLiteralContent as M}from"../_shared/content-guard.js";const y='[data-lexical-editor="true"][contenteditable="true"]',B='[data-pp-fb-composer="1"]',_='[data-pp-fb-trigger="1"]',U='[data-pp-fb-post="1"]',k="https://www.facebook.com/",I=new Set([".jpg",".jpeg",".png",".gif",".webp"]);function T(z){const J=String(z??"").trim();if(!J)return k;if(/^https?:\/\//i.test(J)){let K;try{K=new URL(J)}catch{throw new V(`Invalid target URL: ${J}`)}if(K.hostname!=="facebook.com"&&!K.hostname.endsWith(".facebook.com"))throw new V("target URL must be on facebook.com.");return K.href}const Q=J.replace(/^@/,"").replace(/^\/+|\/+$/g,"");if(!/^[A-Za-z0-9.\-]+$/.test(Q))throw new V(`Invalid target "${z}" — pass a facebook.com URL or a bare profile/Page vanity.`);return`https://www.facebook.com/${Q}`}function w(z){return String(z).split(",").map((Q)=>Q.trim()).filter(Boolean).map((Q)=>{const K=H.resolve(Q),Y=H.extname(K).toLowerCase();if(!I.has(Y))throw new $(`Unsupported image format "${Y}". Supported: jpg, png, gif, webp`);const Z=v.statSync(K,{throwIfNoEntry:!1});if(!Z||!Z.isFile())throw new $(`Not a valid file: ${K}`);return K})}function R(){return`(() => {
+    const path = location.pathname || '';
+    if (/^\\/(login|checkpoint)(\\/|$|\\.php)/.test(path)) return 'login';
+    // Prefer an already-open editor (dialog first, so we don't grab a
+    // background feed publisher when the modal is up).
+    const dialog = document.querySelector('[role="dialog"]');
+    const scope = dialog || document;
+    const ed = scope.querySelector('${y}') || document.querySelector('${y}');
+    if (ed) {
+      ed.setAttribute('data-pp-fb-composer', '1');
+      ed.scrollIntoView({ block: 'center' });
+      return 'ready';
+    }
+    // No editor yet — look for the composer ENTRY. UNVERIFIED anchor: the feed
+    // publisher entry is a role=button in the primary column that opens the
+    // create-post dialog. We locate it structurally (a role=button that houses
+    // its own contenteditable-less text entry and is not an action bar button),
+    // never by its localized "What's on your mind" text.
+    const main = document.querySelector('[role="main"]') || document;
+    const candidates = [...main.querySelectorAll('[role="button"]')].filter((b) => {
+      if (b.closest('[role="toolbar"]')) return false;
+      // Entry box is a wide, tab-focusable button near the top of the feed with
+      // no icon-only content; heuristic, must be confirmed by live recon.
+      const r = b.getBoundingClientRect();
+      return r.width > 240 && r.height >= 40 && r.top < 700;
+    });
+    const trigger = candidates[0];
+    if (trigger) {
+      trigger.setAttribute('data-pp-fb-trigger', '1');
+      trigger.scrollIntoView({ block: 'center' });
+      return 'trigger';
+    }
+    return 'wait';
+  })()`}function S(){return`(() => {
+    const dialog = document.querySelector('[role="dialog"]') || document;
+    const ed = dialog.querySelector('${B}');
+    const btns = [...dialog.querySelectorAll('[role="button"][tabindex]')].filter((b) => {
+      if (ed && (b === ed || b.contains(ed) || ed.contains(b))) return false;
+      if (b.closest('[role="toolbar"]')) return false;
+      return true;
+    });
+    // The primary submit is the trailing footer button.
+    const submit = btns[btns.length - 1];
+    if (!submit) return { notfound: true };
+    if (submit.getAttribute('aria-disabled') === 'true' || submit.disabled) return { disabled: true };
+    submit.setAttribute('data-pp-fb-post', '1');
+    submit.scrollIntoView({ block: 'center' });
+    return { ok: true };
+  })()`}function O(z){return`(() => {
+    const collapse = (s) => String(s || '').replace(/\\s+/g, ' ').trim();
+    const ed = document.querySelector('${B}');
+    if (!ed) return { ok: true };
+    const remaining = collapse(ed.textContent || '');
+    if (remaining.length === 0) return { ok: true };
+    if (remaining === collapse(${JSON.stringify(z)})) return { ok: false, remaining };
+    return { ok: true };
+  })()`}const D='[role="dialog"] input[type="file"], input[type="file"][accept*="image"]';async function C(z,J){const Q=J.map((Y)=>{const Z=H.extname(Y).toLowerCase(),q=Z===".png"?"image/png":Z===".gif"?"image/gif":Z===".webp"?"image/webp":"image/jpeg";return{name:H.basename(Y),mime:q,base64:v.readFileSync(Y).toString("base64")}}),K=await z.evaluate(`(() => {
+    const input = document.querySelector(${JSON.stringify(D)});
+    if (!input) return { ok: false, error: 'No file input found in composer' };
+    const dt = new DataTransfer();
+    for (const file of ${JSON.stringify(Q)}) {
+      const bin = atob(file.base64);
+      const bytes = new Uint8Array(bin.length);
+      for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+      dt.items.add(new File([bytes], file.name, { type: file.mime }));
+    }
+    let assigned = false;
+    try {
+      Object.defineProperty(input, 'files', { value: dt.files, writable: false, configurable: true });
+      assigned = input.files && input.files.length >= ${JSON.stringify(J.length)};
+    } catch (e) {
+      try {
+        const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'files');
+        if (setter && setter.set) {
+          setter.set.call(input, dt.files);
+          assigned = input.files && input.files.length >= ${JSON.stringify(J.length)};
+        }
+      } catch (e2) { /* ignore */ }
+    }
+    if (!assigned) return { ok: false, error: 'Could not assign files to input' };
+    input.dispatchEvent(new Event('change', { bubbles: true }));
+    input.dispatchEvent(new Event('input', { bubbles: true }));
+    return { ok: true };
+  })()`);if(!K?.ok)throw new $(`Image upload failed: ${K?.error??"unknown error"}`)}async function x(z,J){if(z.setFileInput)try{await z.setFileInput(J,D);return}catch{}await C(z,J)}N({site:"facebook",name:"post",access:"write",description:"Publish a new post to your Facebook feed (or a Page you manage). Pass the post text (multi-line allowed); optionally attach local images and target a Page. Published from your logged-in account — write genuine, on-topic content, not filler.",domain:"facebook.com",strategy:L.UI,browser:!0,args:[{name:"text",type:"string",required:!0,positional:!0,help:"Post text (multi-line allowed)"},{name:"images",type:"string",required:!1,help:"Local image paths, comma-separated (jpg/png/gif/webp)"},{name:"target",type:"string",required:!1,help:"Optional Page/profile to post to: a facebook.com URL or a bare vanity. Omit to post to your own feed."}],columns:["status","target","message"],func:async(z,J)=>{if(!z)throw new $("Browser session required for facebook post");const Q=M(J.text,{label:"帖子正文"});if(!Q)throw new V("Post text cannot be empty.");const K=J.images?w(J.images):[],Y=T(J.target);await z.goto(Y,{waitUntil:"none"});let Z=!1;for(let W=0;W<20;W++){const F=await z.evaluate(R());if(F==="login")throw new A("www.facebook.com","Facebook redirected to login/checkpoint — not signed in");if(F==="ready"){Z=!0;break}if(F==="trigger")await z.click(_);await z.wait(1)}if(!Z)throw new $("Post composer not found — the feed publisher may not have loaded, or you may lack permission to post here.");await z.click(B);await z.wait(1);await z.pressKey("Control+A");await z.pressKey("Delete");if(K.length>0){await x(z,K);await z.wait(2)}const q=Q.split(`
+`);for(let W=0;W<q.length;W++){if(W>0)await z.pressKey("Shift+Enter");if(q[W].length)await z.typeText(B,q[W])}if(await z.evaluate(`(() => !!document.querySelector('[role="listbox"][aria-label], ul[role="listbox"]'))()`))await z.pressKey("Escape");const G=(W)=>String(W||"").replace(/\s+/g," ").trim(),X=await z.evaluate(`(() => {
+      const ed = document.querySelector('${B}');
+      return ed ? (ed.textContent || '') : null;
+    })()`);if(X===null||!G(X).includes(G(Q)))throw new $(`Composed text did not land before publish (got ${JSON.stringify((X||"").slice(0,60))}).`);const j=await z.evaluate(S());if(j?.notfound)throw new $("Post button not found in the composer.");if(j?.disabled)throw new $("Post button is disabled — composer may be empty or the post was rejected.");await z.click(U);await z.wait(2);if(!(await z.evaluate(O(Q)))?.ok)throw new $("Post still in the composer after clicking Post — publish blocked (rate limit, restricted, or no permission). Not confirmed sent; verify before retrying.");const f=K.length>0?` with ${K.length} image(s)`:"";return[{status:"success",target:Y,message:`Post published${f}.`}]}});

package/clis/facebook/profile.js

@@ -0,0 +1,18 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"profile",access:"read",description:"Get Facebook user/page profile info",domain:"www.facebook.com",args:[{name:"username",required:!0,positional:!0,help:"Facebook username or page name"}],columns:["name","username","friends","followers","url"],pipeline:[{navigate:{url:"https://www.facebook.com/${{ args.username }}",settleMs:3000}},{evaluate:`(() => {
+  const h1 = document.querySelector('h1');
+  let name = h1 ? h1.textContent.trim() : '';
+
+  // Find friends/followers links
+  const links = Array.from(document.querySelectorAll('a'));
+  const friendsLink = links.find(a => a.href && a.href.includes('/friends'));
+  const followersLink = links.find(a => a.href && a.href.includes('/followers'));
+
+  return [{
+    name: name,
+    username: \${{ args.username | json }},
+    friends: friendsLink ? friendsLink.textContent.trim() : '-',
+    followers: followersLink ? followersLink.textContent.trim() : '-',
+    url: window.location.href,
+  }];
+})()
+`}]});

package/clis/facebook/search.js

@@ -0,0 +1,22 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"search",access:"read",description:"Search Facebook for people, pages, or posts",domain:"www.facebook.com",args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results"}],columns:["index","title","text","url"],pipeline:[{navigate:"https://www.facebook.com"},{navigate:{url:"https://www.facebook.com/search/top?q=${{ args.query | urlencode }}",settleMs:4000}},{evaluate:`(async () => {
+  const limit = \${{ args.limit }};
+  // Search results are typically in role="article" or role="listitem"
+  let items = document.querySelectorAll('[role="article"]');
+  if (items.length === 0) {
+    items = document.querySelectorAll('[role="listitem"]');
+  }
+  return Array.from(items)
+    .filter(el => el.textContent.trim().length > 20)
+    .slice(0, limit)
+    .map((el, i) => {
+      const link = el.querySelector('a[href*="facebook.com/"]');
+      const heading = el.querySelector('h2, h3, h4, strong');
+      return {
+        index: i + 1,
+        title: heading ? heading.textContent.trim().substring(0, 80) : '',
+        text: el.textContent.trim().replace(/\\s+/g, ' ').substring(0, 150),
+        url: link ? link.href.split('?')[0] : '',
+      };
+    });
+})()
+`}]});

package/clis/flathub/app.js

@@ -0,0 +1 @@
+import{cli as p,Strategy as n}from"@jackwener/opencli/registry";import{EmptyResultError as i}from"@jackwener/opencli/errors";import{FLATHUB_API_BASE as u,FLATHUB_APP_BASE as m,flathubFetch as c,joinList as o,pickLatestRelease as d,requireAppId as g}from"./utils.js";p({site:"flathub",name:"app",access:"read",description:"Full Flathub appstream metadata for an app id (license, categories, latest release)",domain:"flathub.org",strategy:n.PUBLIC,browser:!1,args:[{name:"appId",positional:!0,required:!0,help:'AppStream id (e.g. "org.mozilla.firefox", "org.gnome.Calculator")'}],columns:["appId","name","summary","developer","license","isFreeLicense","isEol","categories","keywords","latestVersion","latestReleaseDate","homepage","bugtracker","donation","url"],func:async(s)=>{const t=g(s.appId),l=`${u}/appstream/${encodeURIComponent(t)}`,e=await c(l,"flathub app");if(!e||typeof e!=="object"||!e.id)throw new i("flathub app",`Flathub app "${t}" returned empty payload.`);const a=e.urls&&typeof e.urls==="object"?e.urls:{},r=d(e.releases);return[{appId:typeof e.id==="string"?e.id:t,name:typeof e.name==="string"?e.name:null,summary:typeof e.summary==="string"?e.summary:null,developer:typeof e.developer_name==="string"?e.developer_name:null,license:typeof e.project_license==="string"?e.project_license:null,isFreeLicense:e.is_free_license===!0,isEol:e.is_eol===!0,categories:o(e.categories),keywords:o(e.keywords,8),latestVersion:r.version,latestReleaseDate:r.date,homepage:typeof a.homepage==="string"?a.homepage:null,bugtracker:typeof a.bugtracker==="string"?a.bugtracker:null,donation:typeof a.donation==="string"?a.donation:null,url:`${m}/${t}`}]}});

package/clis/flathub/search.js

@@ -0,0 +1 @@
+import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{EmptyResultError as W}from"@jackwener/opencli/errors";import{FLATHUB_API_BASE as X,FLATHUB_APP_BASE as Y,flathubFetch as Z,joinList as $,requireBoundedInt as N,requireString as O}from"./utils.js";Q({site:"flathub",name:"search",access:"read",description:"Search Flathub apps by keyword",domain:"flathub.org",strategy:V.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:25,help:"Max apps (1-100)"}],columns:["rank","appId","name","summary","developer","license","isFreeLicense","mainCategories","installsLastMonth","updatedAt","url"],func:async(z)=>{const C=O(z.query,"query"),D=N(z.limit,25,100),K=`${X}/search`,G=await Z(K,"flathub search",{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:C,hitsPerPage:D,page:1})}),J=Array.isArray(G?.hits)?G.hits:[];if(!J.length)throw new W("flathub search",`No Flathub apps matched "${C}".`);return J.slice(0,D).map((v,M)=>{const x=typeof v?.app_id==="string"?v.app_id:null;return{rank:M+1,appId:x,name:typeof v?.name==="string"?v.name:null,summary:typeof v?.summary==="string"?v.summary:null,developer:typeof v?.developer_name==="string"?v.developer_name:null,license:typeof v?.project_license==="string"?v.project_license:null,isFreeLicense:v?.is_free_license===!0,mainCategories:typeof v?.main_categories==="string"?v.main_categories:$(v?.main_categories),installsLastMonth:typeof v?.installs_last_month==="number"?v.installs_last_month:null,updatedAt:typeof v?.updated_at==="number"&&v.updated_at>0?new Date(v.updated_at*1000).toISOString().slice(0,10):typeof v?.updated_at==="string"?v.updated_at:null,url:x?`${Y}/${x}`:""}})}});

package/clis/flathub/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as J,CommandExecutionError as K,EmptyResultError as Q}from"@jackwener/opencli/errors";export const FLATHUB_API_BASE="https://flathub.org/api/v2",FLATHUB_APP_BASE="https://flathub.org/apps";const W="opencli-flathub-adapter/1.0 (+https://github.com/jackwener/opencli; mailto:opencli@example.com)",X=/^[A-Za-z][A-Za-z0-9_-]*(?:\.[A-Za-z0-9_][A-Za-z0-9_-]*){1,}$/;export function requireString(h,z){const q=String(h??"").trim();if(!q)throw new J(`flathub ${z} cannot be empty`);return q}export function requireBoundedInt(h,z,q,G="limit"){const H=h??z,B=typeof H==="number"?H:Number(H);if(!Number.isInteger(B)||B<=0)throw new J(`flathub ${G} must be a positive integer`);if(B>q)throw new J(`flathub ${G} must be <= ${q}`);return B}export function requireAppId(h){const z=String(h??"").trim();if(!z)throw new J('flathub appId is required (e.g. "org.mozilla.firefox")');if(!X.test(z))throw new J(`flathub appId "${h}" is not a valid AppStream identifier`,'AppStream IDs use reverse-DNS like "org.mozilla.firefox" — letters/digits/`._-` with at least one dot.');return z}export async function flathubFetch(h,z,q){let G;try{G=await fetch(h,{method:q?.method??"GET",headers:{"user-agent":W,accept:"application/json",...q?.headers??{}},body:q?.body})}catch(B){throw new K(`${z} request failed: ${B?.message??B}`,"Check that flathub.org is reachable from this network.")}if(G.status===404)throw new Q(z,`Flathub returned 404 for ${h}.`);if(G.status===429)throw new K(`${z} returned HTTP 429 (rate limited)`);if(!G.ok)throw new K(`${z} returned HTTP ${G.status}`);let H;try{H=await G.json()}catch(B){throw new K(`${z} returned malformed JSON: ${B?.message??B}`)}return H}export function joinList(h,z=10){if(!Array.isArray(h))return"";const q=h.filter((G)=>typeof G==="string"&&G.trim());if(q.length===0)return"";if(q.length>z)return[...q.slice(0,z),`(+${q.length-z})`].join(", ");return q.join(", ")}function L(h){if(typeof h==="number"&&Number.isFinite(h))return h;if(typeof h==="string"&&/^\d+$/.test(h.trim()))return Number(h.trim());return 0}export function pickLatestRelease(h){if(!Array.isArray(h)||h.length===0)return{version:null,date:null};const q=[...h].filter((B)=>B&&typeof B==="object").sort((B,M)=>{return L(M?.timestamp)-L(B?.timestamp)})[0];if(!q)return{version:null,date:null};let G=null;const H=L(q.timestamp);if(H>0){const B=new Date(H*1000);if(!Number.isNaN(B.getTime()))G=B.toISOString().slice(0,10)}if(!G&&typeof q.date==="string"&&q.date.trim())G=q.date.trim();return{version:typeof q.version==="string"?q.version:null,date:G}}