publishport-opencli 1.0.0

package/clis/pinterest/api.js

@@ -0,0 +1 @@
+import{CommandExecutionError as G}from"@jackwener/opencli/errors";export function pinUrlEncode(q){return encodeURIComponent(String(q))}export function encodeResourceBody({options:q,context:A=null,sourceUrl:z},B=Date.now()){const D=JSON.stringify({options:q??{},context:A});return`source_url=${pinUrlEncode(z)}&data=${pinUrlEncode(D)}&_=${B}`}export function csrfTokenFromCookies(q){const A=(q||[]).find((z)=>z&&z.name==="csrftoken");return A?A.value:""}export function writeHeaders(q){return{"X-Requested-With":"XMLHttpRequest","Content-Type":"application/x-www-form-urlencoded; charset=UTF-8",...q?{"X-CSRFToken":q}:{}}}export function parseResourceData(q,A="resource"){const z=q&&q.resource_response,B=z&&z.data;if(B===void 0||B===null){const D=z&&(z.error||z.message);throw new G(`Pinterest ${A} returned no data${D?": "+JSON.stringify(D):""}`)}return B}export function buildBoardsOptions(q){return{page_size:50,privacy_filter:"all",sort:"custom",username:q,isPrefetch:!1,include_archived:!0,field_set_key:"profile_grid_item",group_by:"visibility"}}export function buildCreateBoardOptions(q,{description:A="",privacy:z="public"}={}){return{name:String(q),description:String(A||""),category:"other",privacy:z==="secret"||z==="private"?"secret":"public",layout:"default"}}export function selectBoardByName(q,A){const z=String(A??"").trim().toLowerCase();return(q||[]).find((B)=>B&&String(B.name??"").toLowerCase()===z)||null}export function buildPinOptions({boardId:q,imageUrl:A,title:z="",description:B="",link:D="",altText:F=""}){return{board_id:String(q),image_url:A,title:String(z||""),description:String(B||""),link:D?String(D):A,alt_text:String(F||""),method:"uploaded",scrape_metric:{source:"www_url_scrape"},section:null}}

package/clis/pinterest/auth.js

@@ -0,0 +1 @@
+import{AuthRequiredError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as n}from"../_shared/site-auth.js";import{resolvePinterestUser as a}from"./client.js";async function i(e){return(await e.getCookies({url:"https://www.pinterest.com"})).some((o)=>o.name==="_pinterest_sess")}async function r(e){if(!await i(e))throw new s("www.pinterest.com","Pinterest _pinterest_sess cookie missing");const t=await a(e);return{username:t,url:`https://www.pinterest.com/${t}/`}}n({site:"pinterest",domain:"www.pinterest.com",loginUrl:"https://www.pinterest.com/login/",columns:["username","url"],quickCheck:i,verify:r,poll:async(e)=>{if(!await i(e))throw new s("www.pinterest.com","Waiting for Pinterest session cookie");return r(e)}});

package/clis/pinterest/boards.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as i}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as a}from"@jackwener/opencli/errors";import{buildBoardsOptions as p,buildCreateBoardOptions as w,csrfTokenFromCookies as l}from"./api.js";import{pinGet as b,pinCreate as f,resolvePinterestUser as n}from"./client.js";function d(r,e){return{id:String(r?.id??""),name:r?.name??e??"",url:r?.url?`https://www.pinterest.com${r.url}`:""}}s({site:"pinterest",name:"boards",access:"read",description:"List your Pinterest boards",domain:"www.pinterest.com",strategy:i.COOKIE,browser:!0,args:[],columns:["id","name","url"],func:async(r)=>{if(!r)throw new a("Browser session required for pinterest boards");const e=await n(r),t=await b(r,{resource:"BoardsResource",sourceUrl:`/${e}/boards/`,options:p(e),label:"boards"});return(Array.isArray(t)?t:[]).map((o)=>d(o))}});s({site:"pinterest",name:"board-create",access:"write",description:"Create a new Pinterest board",domain:"www.pinterest.com",strategy:i.COOKIE,browser:!0,args:[{name:"name",type:"string",required:!0,positional:!0,help:"Board name"},{name:"description",type:"string",help:"Board description"},{name:"privacy",type:"string",default:"public",help:"public | secret"}],columns:["id","name","url"],func:async(r,e)=>{if(!r)throw new a("Browser session required for pinterest board-create");const t=String(e.name??"").trim();if(!t)throw new u("board name is required");const o=await n(r),c=l(await r.getCookies({url:"https://www.pinterest.com"})),m=await f(r,{resource:"BoardResource",sourceUrl:`/${o}/boards/`,options:w(t,{description:e.description,privacy:e.privacy}),csrf:c,label:"board-create"});return d(m,t)}});

package/clis/pinterest/client.js

@@ -0,0 +1,20 @@
+import{AuthRequiredError as Y,CommandExecutionError as $}from"@jackwener/opencli/errors";import{encodeResourceBody as k,writeHeaders as L,parseResourceData as H}from"./api.js";const Z="https://www.pinterest.com";export function unwrap(z){if(z&&typeof z==="object"&&!Array.isArray(z)&&"session"in z&&"data"in z)return z.data;return z}export async function pageFetch(z,{url:G,method:V="GET",headers:X={},body:K=null}){const M=`(async () => {
+    try {
+      const opts = { method: ${JSON.stringify(V)}, credentials: 'include', headers: ${JSON.stringify(X)} };
+      ${K!=null?`opts.body = ${JSON.stringify(K)};`:""}
+      const res = await fetch(${JSON.stringify(G)}, opts);
+      const text = await res.text();
+      let data = null; try { data = JSON.parse(text); } catch {}
+      return { ok: res.ok, status: res.status, data, text: text.slice(0, 300) };
+    } catch (e) { return { ok: false, status: 0, data: null, text: String(e && e.message || e) }; }
+  })()`;return unwrap(await z.evaluate(M))}export async function pinGet(z,{resource:G,sourceUrl:V,options:X,label:K}){const M=k({options:X,sourceUrl:V}),J=await pageFetch(z,{url:`${Z}/resource/${G}/get/?${M}`,headers:{Accept:"application/json"}});if(J.status===401||J.status===403)throw new Y("www.pinterest.com",`${K||G} HTTP ${J.status}`);if(!J.ok)throw new $(`Pinterest ${K||G} failed: HTTP ${J.status} ${J.text}`);return H(J.data,K||G)}export async function pinCreate(z,{resource:G,sourceUrl:V,options:X,csrf:K,label:M}){const J=k({options:X,sourceUrl:V}),Q=await pageFetch(z,{url:`${Z}/resource/${G}/create/`,method:"POST",headers:{Accept:"application/json",...L(K)},body:J});if(Q.status===401||Q.status===403)throw new Y("www.pinterest.com",`${M||G} HTTP ${Q.status}`);if(!Q.ok)throw new $(`Pinterest ${M||G} failed: HTTP ${Q.status} ${Q.text}`);return H(Q.data,M||G)}export async function resolvePinterestUser(z){await z.goto(`${Z}/`);const G=unwrap(await z.evaluate(`(() => {
+    try {
+      const p = window.__PWS_INITIAL_PROPS__ || window.__PWS_DATA__ || {};
+      const rs = p.initialReduxState || p.reduxState || {};
+      const sess = rs.session || {};
+      const viewer = rs.viewer || (p.context && p.context.viewer) || sess;
+      let u = (viewer && viewer.username) || null;
+      if (!u && sess.userId && rs.users && rs.users[sess.userId]) u = rs.users[sess.userId].username;
+      return u || null;
+    } catch (e) { return null; }
+  })()`));if(!G)throw new Y("www.pinterest.com","Could not resolve Pinterest username — not logged in?");return String(G)}

package/clis/pinterest/publish.js

@@ -0,0 +1,13 @@
+import*as g from"node:fs";import*as u from"node:path";import{cli as U,Strategy as O}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as b}from"@jackwener/opencli/errors";import{buildBoardsOptions as R,buildCreateBoardOptions as C,buildPinOptions as I,selectBoardByName as $,csrfTokenFromCookies as T}from"./api.js";import{pinGet as N,pinCreate as h,resolvePinterestUser as _,pageFetch}from"./client.js";const v=new Set([".jpg",".jpeg",".png",".gif",".webp"]);async function w(r,t,s){const i=u.resolve(t);if(!v.has(u.extname(i).toLowerCase()))throw new o(`Unsupported image (jpg/png/gif/webp): ${t}`);const l=g.statSync(i,{throwIfNoEntry:!1});if(!l||!l.isFile())throw new o(`Not a file: ${i}`);const c=g.readFileSync(i).toString("base64"),p=u.basename(i),d={"X-Requested-With":"XMLHttpRequest","X-UPLOAD-SOURCE":"pinner_uploader",...s?{"X-CSRFToken":s}:{}},a=await r.evaluate(`(async () => {
+    try {
+      const bin = atob(${JSON.stringify(c)});
+      const arr = new Uint8Array(bin.length);
+      for (let i = 0; i < bin.length; i++) arr[i] = bin.charCodeAt(i);
+      const fd = new FormData();
+      fd.append('img', new Blob([arr]), ${JSON.stringify(p)});
+      const res = await fetch('https://www.pinterest.com/upload-image/', { method: 'POST', credentials: 'include', headers: ${JSON.stringify(d)}, body: fd });
+      const text = await res.text();
+      let data = null; try { data = JSON.parse(text); } catch {}
+      return { ok: res.ok, status: res.status, data, text: text.slice(0, 300) };
+    } catch (e) { return { ok: false, status: 0, data: null, text: String(e && e.message || e) }; }
+  })()`),e=a&&typeof a==="object"&&"session"in a&&"data"in a?a.data:a,n=e&&e.data&&(e.data.image_url||e.data.url||e.data.success&&e.data.success.image_url);if(!e||!e.ok||!n)throw new b(`Pinterest image upload failed (best-effort): HTTP ${e?e.status:"?"} ${e?e.text:""}. Prefer --image-url.`);return n}U({site:"pinterest",name:"pin",access:"write",description:"Create a pin on a board with an optional destination link",domain:"www.pinterest.com",strategy:O.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Pin title"},{name:"image-url",type:"string",help:"Image URL to pin (required unless --image)"},{name:"image",type:"string",help:"(best-effort) local image file to upload"},{name:"board",type:"string",required:!0,help:"Target board name"},{name:"description",type:"string",help:"Pin description"},{name:"link",type:"string",help:"Destination/landing URL (defaults to the image URL)"},{name:"create-board",type:"boolean",default:!1,help:"Create the board if it does not exist"}],columns:["status","pin_id","url"],func:async(r,t)=>{if(!r)throw new b("Browser session required for pinterest pin");const s=String(t.title??"").trim();if(!s)throw new o("pin title is required");const i=String(t.board??"").trim();if(!i)throw new o("--board is required");const l=t["image-url"]?String(t["image-url"]):"",c=t.image?String(t.image):"";if(!l&&!c)throw new o("provide --image-url (or --image local file)");const p=await _(r),d=T(await r.getCookies({url:"https://www.pinterest.com"})),a=await N(r,{resource:"BoardsResource",sourceUrl:`/${p}/boards/`,options:R(p),label:"boards"}),e=Array.isArray(a)?a:[];let n=$(e,i);if(!n){if(!t["create-board"]){const P=e.map((x)=>x.name).join(", ")||"(none)";throw new o(`Board "${i}" not found. Available: ${P} (use --create-board to create it)`)}n=await h(r,{resource:"BoardResource",sourceUrl:`/${p}/boards/`,options:C(i,{}),csrf:d,label:"board-create"})}const f=l||await w(r,c,d),y=I({boardId:String(n.id),imageUrl:f,title:s,description:t.description,link:t.link}),S=await h(r,{resource:"PinResource",sourceUrl:`/pin/find/?url=${encodeURIComponent(f)}`,options:y,csrf:d,label:"pin"}),m=String(S.id??"");return{status:"published",pin_id:m,url:m?`https://www.pinterest.com/pin/${m}/`:""}}});export const __test__={uploadLocalImage:w};export{pageFetch};

package/clis/pixiv/auth.js

@@ -0,0 +1,17 @@
+import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";async function G(B){return(await B.getCookies({url:"https://www.pixiv.net"})).some((H)=>H.name==="PHPSESSID"&&/^\d+_/.test(H.value||""))}async function J(B){if(!await G(B))throw new D("pixiv.net","Pixiv PHPSESSID cookie missing");await B.goto("https://www.pixiv.net/");await B.wait(2);const z=await B.evaluate(`(async () => {
+    try {
+      const r = await fetch('/touch/ajax/user/self/status', { credentials: 'include', headers: { Accept: 'application/json' } });
+      if (r.status === 401 || r.status === 403) {
+        return { kind: 'auth', detail: 'Pixiv self/status HTTP ' + r.status };
+      }
+      if (!r.ok) return { kind: 'http', httpStatus: r.status };
+      const d = await r.json().catch(() => null);
+      const u = d?.body?.user_status;
+      if (d?.error || !u || u.is_loggedin === false || !u.user_id) {
+        return { kind: 'auth', detail: 'Pixiv self/status reports anonymous' };
+      }
+      return { ok: true, user_id: String(u.user_id), name: String(u.user_name || u.user_account || '') };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(z?.kind==="auth")throw new D("pixiv.net",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from Pixiv ajax`);if(z?.kind==="exception")throw new F(`Pixiv whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected Pixiv probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,name:z.name}}K({site:"pixiv",domain:"pixiv.net",loginUrl:"https://accounts.pixiv.net/login",columns:["user_id","name"],quickCheck:G,verify:J,poll:async(B)=>{if(!await G(B))throw new D("pixiv.net","Waiting for Pixiv PHPSESSID cookie");return J(B)}});

package/clis/pixiv/detail.js

@@ -0,0 +1 @@
+import{cli as n,Strategy as o}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as a}from"@jackwener/opencli/errors";import{pixivFetch as d}from"./utils.js";function m(i,r){if(!i||Array.isArray(i)||typeof i!=="object")throw new a(`Pixiv illustration ${r} returned malformed detail payload`);const e=String(i.illustId??"").trim(),l=String(i.illustTitle??"").trim(),t=String(i.userName??"").trim(),s=String(i.userId??"").trim();if(!/^\d+$/.test(e)||e!==r||!l||!t||!/^\d+$/.test(s))throw new a(`Pixiv illustration ${r} returned malformed detail payload`);return{...i,illustId:e,illustTitle:l,userName:t,userId:s}}n({site:"pixiv",name:"detail",access:"read",description:"View illustration details (tags, stats, URLs)",domain:"www.pixiv.net",strategy:o.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Illustration ID"}],columns:["illust_id","title","author","type","pages","bookmarks","likes","views","tags","created","url"],func:async(i,r)=>{const e=String(r.id??"");if(!/^\d+$/.test(e))throw new u(`Invalid illustration ID: ${e}`,"Example: opencli pixiv detail 123456");const l=await d(i,`/ajax/illust/${e}`,{notFoundMsg:`Illustration not found: ${e}`}),t=m(l,e);return[{illust_id:t.illustId,title:t.illustTitle,author:t.userName,user_id:t.userId,type:t.illustType===0?"illust":t.illustType===1?"manga":t.illustType===2?"ugoira":String(t.illustType),pages:t.pageCount,bookmarks:t.bookmarkCount,likes:t.likeCount,views:t.viewCount,tags:(t.tags?.tags||[]).map((s)=>s.tag).join(", "),created:t.createDate?.split("T")[0]||"",url:`https://www.pixiv.net/artworks/${t.illustId}`}]}});

package/clis/pixiv/download.js

@@ -0,0 +1 @@
+import*as Z from"node:fs";import*as L from"node:path";import{cli as _,Strategy as $}from"@jackwener/opencli/registry";import{formatCookieHeader as v,httpDownload as B}from"@jackwener/opencli/download";import{formatBytes as F}from"@jackwener/opencli/download/progress";import{CommandExecutionError as U,EmptyResultError as H,getErrorMessage as M}from"@jackwener/opencli/errors";import{pixivFetch as P}from"./utils.js";_({site:"pixiv",name:"download",access:"read",description:"Download illustration images from Pixiv",domain:"www.pixiv.net",strategy:$.COOKIE,args:[{name:"illust-id",positional:!0,required:!0,help:"Illustration ID"},{name:"output",default:"./pixiv-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(N,O)=>{const b=String(O["illust-id"]??""),V=String(O.output??"./pixiv-downloads");if(!/^\d+$/.test(b))throw new U(`Invalid illustration ID: ${b}`);const z=await P(N,`/ajax/illust/${b}/pages`,{notFoundMsg:`Illustration not found: ${b}`});if(!Array.isArray(z))throw new U("Pixiv pages API returned malformed payload");if(z.length===0)throw new H("pixiv download",`No images found for illustration ${b}.`);const W=v(await N.getCookies({domain:"pixiv.net"})),Q=L.join(V,b);Z.mkdirSync(Q,{recursive:!0});const A=[];for(let q=0;q<z.length;q++){const T=z[q],J=T.urls?.original||T.urls?.regular||"";if(!J){A.push({index:q+1,type:"image",status:"failed",size:"No URL"});continue}try{const K=L.extname(new URL(J).pathname)||".jpg",X=`${b}_p${q}${K}`,Y=L.join(Q,X),G=await B(J,Y,{cookies:W,headers:{Referer:"https://www.pixiv.net/"},timeout:60000});A.push({index:q+1,type:"image",status:G.success?"success":"failed",size:G.success?F(G.size):G.error||"unknown error"})}catch(K){A.push({index:q+1,type:"image",status:"failed",size:M(K)})}}return A}});

package/clis/pixiv/illusts.js

@@ -0,0 +1 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{CommandExecutionError as $}from"@jackwener/opencli/errors";import{pixivFetch as N,BATCH_SIZE as O}from"./utils.js";X({site:"pixiv",name:"illusts",access:"read",description:"List a Pixiv artist's illustrations",domain:"www.pixiv.net",strategy:Y.COOKIE,args:[{name:"user-id",positional:!0,required:!0,help:"Pixiv user ID"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","illust_id","pages","bookmarks","tags","created","url"],func:async(K,L)=>{const D=String(L["user-id"]??""),Q=Number(L.limit)||20;if(!/^\d+$/.test(D))throw new $(`Invalid user ID: ${D}`);const R=await N(K,`/ajax/user/${D}/profile/all`,{notFoundMsg:`User not found: ${D}`}),G=Object.keys(R?.illusts||{}).sort((z,J)=>Number(J)-Number(z)).slice(0,Q);if(G.length===0)return[];const M={};for(let z=0;z<G.length;z+=O){const q=G.slice(z,z+O).map((V)=>`ids[]=${V}`).join("&"),U=await N(K,`/ajax/user/${D}/profile/illusts?${q}&work_category=illustManga&is_first_page=${z===0?1:0}`);Object.assign(M,U?.works||{})}return G.map((z,J)=>{const q=M[z];if(!q)return null;return{rank:J+1,title:q.title||"",illust_id:q.id,pages:q.pageCount||1,bookmarks:q.bookmarkCount||0,tags:(q.tags||[]).slice(0,5).join(", "),created:(q.createDate||"").split("T")[0],url:"https://www.pixiv.net/artworks/"+q.id}}).filter(Boolean)}});

package/clis/pixiv/ranking.js

@@ -0,0 +1,26 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"pixiv",name:"ranking",access:"read",description:"Pixiv illustration rankings (daily/weekly/monthly)",domain:"www.pixiv.net",strategy:t.COOKIE,browser:!0,args:[{name:"mode",default:"daily",help:"Ranking mode",choices:["daily","weekly","monthly","rookie","original","male","female","daily_r18","weekly_r18"]},{name:"page",type:"int",default:1,help:"Page number"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","author","user_id","illust_id","pages","bookmarks","url"],pipeline:[{navigate:"https://www.pixiv.net"},{evaluate:`(async () => {
+  const mode = \${{ args.mode | json }};
+  const page = \${{ args.page | json }};
+  const limit = \${{ args.limit | json }};
+  const res = await fetch(
+    'https://www.pixiv.net/ranking.php?mode=' + mode + '&p=' + page + '&format=json',
+    { credentials: 'include' }
+  );
+  if (!res.ok) {
+    if (res.status === 401 || res.status === 403) throw new Error('Authentication required — please log in to Pixiv in Chrome');
+    throw new Error('Pixiv request failed (HTTP ' + res.status + ')');
+  }
+  const data = await res.json();
+  const items = (data?.contents || []).slice(0, limit);
+  return items.map((item, i) => ({
+    rank: item.rank,
+    title: item.title,
+    author: item.user_name,
+    user_id: item.user_id,
+    illust_id: item.illust_id,
+    pages: item.illust_page_count,
+    bookmarks: item.illust_bookmark_count,
+    url: 'https://www.pixiv.net/artworks/' + item.illust_id
+  }));
+})()
+`}]});

package/clis/pixiv/search.js

@@ -0,0 +1 @@
+import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{pixivFetch as W}from"./utils.js";Q({site:"pixiv",name:"search",access:"read",description:"Search Pixiv illustrations by keyword",domain:"www.pixiv.net",strategy:V.COOKIE,args:[{name:"query",positional:!0,required:!0,help:"Search keyword or tag"},{name:"limit",type:"int",default:20,help:"Number of results"},{name:"order",type:"str",default:"date_d",help:"Sort order",choices:["date_d","date","popular_d","popular_male_d","popular_female_d"]},{name:"mode",type:"str",default:"all",help:"Search mode",choices:["all","safe","r18"]},{name:"page",type:"int",default:1,help:"Page number"}],columns:["rank","title","author","user_id","illust_id","pages","bookmarks","tags","url"],func:async(z,C)=>{const{query:f,limit:D=20,order:E="date_d",mode:G="all",page:J=1}=C,K=encodeURIComponent(f);return((await W(z,`/ajax/search/illustrations/${K}`,{params:{word:f,order:E,mode:G,p:J,s_mode:"s_tag_full",type:"illust_and_ugoira"}}))?.illust?.data||[]).filter((b)=>b.id).slice(0,Number(D)).map((b,M)=>({rank:M+1,title:b.title||"",author:b.userName||"",user_id:b.userId||"",illust_id:b.id,pages:b.pageCount||1,bookmarks:b.bookmarkCount||0,tags:(b.tags||[]).slice(0,5).join(", "),url:"https://www.pixiv.net/artworks/"+b.id}))}});

package/clis/pixiv/user.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as a}from"@jackwener/opencli/registry";import{ArgumentError as l,CommandExecutionError as n}from"@jackwener/opencli/errors";import{pixivFetch as m}from"./utils.js";function u(i,t){if(!i||Array.isArray(i)||typeof i!=="object")throw new n(`Pixiv user ${t} returned malformed profile payload`);const r=String(i.name??"").trim();if(!r)throw new n(`Pixiv user ${t} returned malformed profile payload`);return{...i,name:r}}s({site:"pixiv",name:"user",access:"read",description:"View Pixiv artist profile",domain:"www.pixiv.net",strategy:a.COOKIE,args:[{name:"uid",required:!0,positional:!0,help:"Pixiv user ID"}],columns:["user_id","name","premium","following","illusts","manga","novels","comment","url"],func:async(i,t)=>{const r=String(t.uid??"");if(!/^\d+$/.test(r))throw new l(`Invalid user ID: ${r}`,"Example: opencli pixiv user 123456");const o=await m(i,`/ajax/user/${r}`,{params:{full:1},notFoundMsg:`User not found: ${r}`}),e=u(o,r);return[{user_id:r,name:e.name,premium:e.premium?"Yes":"No",following:e.following,illusts:typeof e.illusts==="object"?Object.keys(e.illusts).length:e.illusts||0,manga:typeof e.manga==="object"?Object.keys(e.manga).length:e.manga||0,novels:typeof e.novels==="object"?Object.keys(e.novels).length:e.novels||0,comment:(e.comment||"").slice(0,80),url:`https://www.pixiv.net/users/${r}`}]}});

package/clis/pixiv/utils.js

@@ -0,0 +1,18 @@
+import{AuthRequiredError as U,CommandExecutionError as G}from"@jackwener/opencli/errors";const L="www.pixiv.net";function W(z){if(z&&!Array.isArray(z)&&typeof z==="object"&&"session"in z&&"data"in z)return z.data;return z}function S(z){if(!z||typeof z!=="object")return"";const H=[z.message,z.errorMessage,z.error?.message,z.error].find((K)=>typeof K==="string"&&K.trim());return H?H.trim():""}export async function pixivFetch(z,Q,H={}){try{await z.goto(`https://${L}`)}catch(B){throw new G(`Pixiv navigation failed: ${B instanceof Error?B.message:String(B)}`)}const K=H.params?"?"+Object.entries(H.params).map(([B,J])=>`${B}=${encodeURIComponent(J)}`).join("&"):"",T=`https://${L}${Q}${K}`;let F;try{F=W(await z.evaluate(`
+    (async () => {
+      const res = await fetch(${JSON.stringify(T)}, { credentials: 'include' });
+      const text = await res.text();
+      let json = null;
+      if (text) {
+        try { json = JSON.parse(text); } catch {}
+      }
+      if (!res.ok) {
+        return {
+          __httpError: res.status,
+          message: json?.message || json?.errorMessage || json?.error?.message || (typeof json?.error === 'string' ? json.error : '') || text.slice(0, 200),
+        };
+      }
+      if (!json) return { __malformed: true, message: 'invalid JSON' };
+      return json;
+    })()
+  `))}catch(B){throw new G(`Pixiv request failed: ${B instanceof Error?B.message:String(B)}`)}if(F?.__httpError){const B=F.__httpError;if(B===401||B===403)throw new U(L,"Authentication required — please log in to Pixiv in Chrome");const J=S(F);if(B===404)throw new G(J||H.notFoundMsg||"Pixiv resource not found (HTTP 404)");throw new G(J?`Pixiv request failed (HTTP ${B}): ${J}`:`Pixiv request failed (HTTP ${B})`)}if(!F||Array.isArray(F)||typeof F!=="object"||F.__malformed)throw new G("Pixiv request returned malformed JSON payload");if(F.error===!0)throw new G(S(F)||"Pixiv API returned an error");if(!("body"in F))throw new G("Pixiv request returned malformed API payload");return F?.body}export const BATCH_SIZE=48;

package/clis/powerchina/auth.js

@@ -0,0 +1,17 @@
+import{AuthRequiredError as D,CommandExecutionError as J}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";async function F(z){return(await z.getCookies({url:"https://zhaopin.powerchina.cn"})).some((G)=>/^(Admin-Token|access_token)$/i.test(G.name)&&G.value)}async function H(z){if(!await F(z))throw new D("powerchina.cn","Powerchina session cookies missing — anonymous");await z.goto("https://zhaopin.powerchina.cn/index");await z.wait(3);const B=await z.evaluate(`
+    (() => {
+      if (/\\/login(\\b|$|\\?)/.test(location.pathname)) {
+        return { kind: 'auth', detail: 'Powerchina redirected to /login — anonymous' };
+      }
+      const bodyText = document.body?.innerText || '';
+      if (/欢迎登录.*【登录】|请登录|您未登录/.test(bodyText)) {
+        return { kind: 'auth', detail: 'Powerchina shows 欢迎登录 prompt — anonymous' };
+      }
+      const el = document.querySelector('.user-info, .userName, .personalCenter [class*=name]');
+      const userName = (el?.innerText || '').trim();
+      if (!userName) {
+        return { kind: 'auth', detail: 'Powerchina no user name DOM — anonymous or layout changed' };
+      }
+      return { ok: true, name: userName };
+    })()
+  `);if(B?.kind==="auth")throw new D("powerchina.cn",B.detail);if(!B?.ok)throw new J(`Unexpected Powerchina probe: ${JSON.stringify(B)}`);return{name:B.name}}K({site:"powerchina",domain:"powerchina.cn",loginUrl:"https://zhaopin.powerchina.cn/login",columns:["name"],quickCheck:F,verify:H,poll:async(z)=>{if(!await F(z))throw new D("powerchina.cn","Waiting for Powerchina session cookies");return H(z)}});

package/clis/powerchina/search.js

@@ -0,0 +1 @@
+import{cli as P,Strategy as q}from"@jackwener/opencli/registry";import{AuthRequiredError as D,EmptyResultError as Y}from"@jackwener/opencli/errors";import{cleanText as X,normalizeDate as j,toProcurementSearchRecords as U}from"../jianyu/shared/procurement-contract.js";import{searchRowsFromEntries as z}from"../jianyu/shared/china-bid-search.js";const b=["https://bid.powerchina.cn/search","https://bid.powerchina.cn/"],L="https://bid.powerchina.cn/newcbs/recpro-newmember/BidAnnouncementSummary/list",C="https://bid.powerchina.cn/newcbs/recpro-newmember/BidAnnouncementSummary/getInfo",S="招采公告",k=/(公告|招标|采购|中标|成交|项目|notice|tender|bidding)/i,_=/^(english|中文|chinese|language|home|首页|搜索|search)$/i,g=/(detached while handling command|execution context was destroyed|target closed|cannot find context with specified id)/i;export function buildSearchCandidates(K){const Q=K.trim();if(!Q)return[...b];const J=encodeURIComponent(Q);return[`https://bid.powerchina.cn/search?keyword=${J}`,`https://bid.powerchina.cn/search?keywords=${J}`,`https://bid.powerchina.cn/search?q=${J}`,...b]}function M(K){const Q=[],J=new Set;for(const W of K){const $=`${W.title}	${W.url}`;if(J.has($))continue;J.add($);Q.push(W)}return Q}function v(K){const Q=X(K);if(!Q)return!0;try{const J=new URL(Q),W=J.pathname.toLowerCase().replace(/\/+$/,"")||"/",$=X(J.hash).toLowerCase();if(W==="/"||W==="/index")return!0;if(W==="/search")return!0;if(W==="/old"||W.startsWith("/old/"))return!0;if(W==="/en"||W.startsWith("/en/"))return!0;if(W==="/zh"||W.startsWith("/zh/"))return!0;if($==="#/"||$==="#/index"||$.startsWith("#/search"))return!0;return!1}catch{return!0}}function F(K){const Q=X(K);if(!Q)return!0;const J=Q.toLowerCase();if(_.test(J))return!0;if(J.length<=10&&(J==="en"||J==="zh"||J.includes("english")))return!0;return!1}function H(K){return K.filter((Q)=>{const J=X(Q.title),W=X(Q.url);if(!W||!J)return!1;if(v(W))return!1;if(F(J)&&!k.test(J))return!1;return!0})}export function buildApiDetailUrl(K){const Q=X(K);if(!Q)return"";return`${C}/${encodeURIComponent(Q)}`}function O(K){const Q=X(K.id),J=X(K.title);if(!Q||!J)return null;const W=buildApiDetailUrl(Q);if(!W)return null;const $=X([K.announcementType,K.titleTypeName,K.source,K.publishTime,K.registrationDeadline,K.submissionDeadline,K.bidOpenTime].filter(Boolean).join(" | ")),B=j(X(K.publishTime||K.bidOpenTime||K.submissionDeadline||""));return{title:J,url:W,date:B,contextText:$}}async function A(K,Q){const J=X(K),$={pageNum:1,pageSize:Math.max(20,Math.min(100,Math.max(Q*3,Q))),announcementType:S,companyType:"3",time:Date.now()};if(J)$.keyWords=J;const B=await fetch(L,{method:"POST",headers:{"Content-Type":"application/json;charset=utf-8"},body:JSON.stringify($)});if(!B.ok)throw Error(`[taxonomy=relay_unavailable] site=powerchina command=search api HTTP ${B.status}`);const G=await B.json();if((G.code??200)!==200)throw Error(`[taxonomy=relay_unavailable] site=powerchina command=search api code=${G.code??"unknown"} msg=${X(G.msg)}`);const Z=(Array.isArray(G.rows)?G.rows:[]).map((f)=>O(f)).filter(Boolean);return M(Z).slice(0,Q)}P({site:"powerchina",name:"search",access:"read",description:"搜索中国电建阳光采购公告",domain:"bid.powerchina.cn",strategy:q.COOKIE,browser:!0,args:[{name:"query",required:!0,positional:!0,help:'Search keyword, e.g. "procurement"'},{name:"limit",type:"int",default:20,help:"Number of results (max 50)"}],columns:["rank","content_type","title","publish_time","project_code","budget_or_limit","url"],func:async(K,Q)=>{const J=X(Q.query),W=Math.max(1,Math.min(Number(Q.limit)||20,50));let $=[],B=null,G=!1;try{$=await A(J,W);G=!0}catch(Z){B=X(Z instanceof Error?Z.message:String(Z||""))}if(G&&$.length===0)return[];if(!G)try{$=await z(K,{query:J,candidateUrls:buildSearchCandidates(J),allowedHostFragments:["bid.powerchina.cn","powerchina.cn"],limit:W})}catch(Z){const f=X(Z instanceof Error?Z.message:String(Z||""));if(g.test(f))throw Error(`[taxonomy=relay_unavailable] site=powerchina command=search detached browser context: ${f}`);throw Z}const V=H(M($).map((Z)=>({title:X(Z.title),url:X(Z.url),date:j(X(Z.date)),contextText:X(Z.contextText)})));if(V.length===0&&$.length>0)throw new Y("powerchina search","extracted only navigation/portal rows, no bid entries matched");if(V.length===0){const Z=X(await K.evaluate('document.body ? document.body.innerText : ""'));if(/(请先登录|未登录|登录后|验证码|人机验证)/.test(Z))throw new D("bid.powerchina.cn","[taxonomy=selector_drift] site=powerchina command=search login required or human verification");if(B)throw new Y("powerchina search",`api/dom yielded no result: ${B}`)}return U(V,{site:"powerchina",query:J,limit:W})}});export const __test__={buildSearchCandidates,normalizeDate:j,dedupeCandidates:M,filterNavigationRows:H,isLikelyNavigationUrl:v,isLikelyNavigationTitle:F,buildApiDetailUrl,toApiCandidate:O};

package/clis/producthunt/browse.js

@@ -0,0 +1,54 @@
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{CliError as u}from"@jackwener/opencli/errors";import{PRODUCTHUNT_CATEGORY_SLUGS as d}from"./utils.js";c({site:"producthunt",name:"browse",access:"read",description:"Best products in a Product Hunt category",domain:"www.producthunt.com",strategy:l.INTERCEPT,args:[{name:"category",type:"string",positional:!0,required:!0,help:"Category slug, e.g. vibe-coding, ai-agents, developer-tools"},{name:"limit",type:"int",default:20,help:"Number of results (max 50)"}],columns:["rank","name","tagline","reviews","url"],func:async(e,r)=>{const s=Math.min(Number(r.limit)||20,50),n=String(r.category||"").trim().toLowerCase();await e.installInterceptor("producthunt.com");await e.goto(`https://www.producthunt.com/categories/${n}`);await e.waitForCapture(5);const a=await e.evaluate(`
+      (() => {
+        const seen = new Set();
+        const results = [];
+
+        // Card links: <a class="...flex-col" href="/products/<slug>"> (not review links)
+        const cardLinks = Array.from(document.querySelectorAll('a[href^="/products/"]')).filter(a => {
+          const href = a.getAttribute('href') || '';
+          const cls = a.className || '';
+          return cls.includes('flex-col') && !href.includes('/reviews');
+        });
+
+        for (const cardLink of cardLinks) {
+          const href = cardLink.getAttribute('href');
+          if (!href || seen.has(href)) continue;
+
+          // Child 0: div with name (strip "Launched this month/week/year" noise)
+          const nameDiv = cardLink.querySelector('div');
+          const rawName = nameDiv?.textContent?.trim() || '';
+          const name = rawName
+            .replace(/\\s*Launched\\s+this\\s+(month|week|year|day)\\s*/gi, '')
+            .replace(/\\s*Featured\\s*/gi, '')
+            .trim();
+
+          // Child 1: span.text-secondary — tagline
+          const taglineEl = cardLink.querySelector('span.text-secondary, span[class*="text-secondary"]');
+          const tagline = taglineEl?.textContent?.trim() || '';
+
+          if (!name) continue;
+
+          // Find reviews count from sibling /reviews link
+          let reviews = '';
+          let container = cardLink.parentElement;
+          for (let i = 0; i < 5 && container; i++) {
+            const reviewLink = container.querySelector('a[href="' + href + '/reviews"]');
+            if (reviewLink) {
+              reviews = (reviewLink.textContent?.trim() || '').replace(/\\s*reviews?\\s*/i, '').trim();
+              break;
+            }
+            container = container.parentElement;
+          }
+
+          seen.add(href);
+          results.push({
+            name,
+            tagline: tagline.slice(0, 120),
+            reviews: reviews || '0',
+            url: 'https://www.producthunt.com' + href,
+          });
+        }
+
+        return results;
+      })()
+    `),i=Array.isArray(a)?a:[];if(i.length===0)throw new u("NO_DATA",`No products found for category "${n}"`,"Check the category slug or try: "+d.slice(0,5).join(", "));return i.slice(0,s).map((t,o)=>({rank:o+1,name:t.name,tagline:t.tagline,reviews:t.reviews,url:t.url}))}});

package/clis/producthunt/hot.js

@@ -0,0 +1,64 @@
+import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{CliError as s}from"@jackwener/opencli/errors";import{pickVoteCount as d}from"./utils.js";u({site:"producthunt",name:"hot",access:"read",description:"Today's top Product Hunt launches with vote counts",domain:"www.producthunt.com",strategy:l.INTERCEPT,args:[{name:"limit",type:"int",default:20,help:"Number of results (max 50)"}],columns:["rank","name","votes","url"],func:async(e,i)=>{const c=Math.min(Number(i.limit)||20,50);await e.installInterceptor("producthunt.com");await e.goto("https://www.producthunt.com");await e.waitForCapture(5);const o=await e.evaluate(`
+      (() => {
+        const seen = new Set();
+        const results = [];
+
+        const cardLinks = Array.from(document.querySelectorAll('a[href^="/products/"]')).filter((el) => {
+          const href = el.getAttribute('href') || '';
+          const text = el.textContent?.trim() || '';
+          return href && !href.includes('/reviews') && text.length > 0 && text.length < 120;
+        });
+
+        const normalizeName = (text) => text
+          .replace(/^\\d+\\.\\s*/, '')
+          .replace(/\\s*Launched\\s+this\\s+(month|week|year|day)\\s*/gi, '')
+          .replace(/\\s*Featured\\s*/gi, '')
+          .trim();
+
+        for (const cardLink of cardLinks) {
+          const href = cardLink.getAttribute('href') || '';
+          if (!href || seen.has(href)) continue;
+
+          let card = cardLink;
+          let node = cardLink.parentElement;
+          for (let i = 0; i < 6 && node; i++) {
+            const hasReviewLink = !!node.querySelector('a[href="' + href + '/reviews"]');
+            const hasNumericNode = Array.from(node.querySelectorAll('button, [role="button"], p, span, div'))
+              .some((el) => /^\\d+$/.test(el.textContent?.trim() || ''));
+            if (hasReviewLink || hasNumericNode) {
+              card = node;
+              break;
+            }
+            node = node.parentElement;
+          }
+
+          const name = normalizeName(cardLink.textContent?.trim() || '');
+          if (!name) continue;
+
+          const voteCandidates = Array.from(card.querySelectorAll('button, [role="button"], a, p, span, div'))
+            .map((el) => {
+              const reviewLink = el.closest('a[href="' + href + '/reviews"]');
+              return {
+                text: el.textContent?.trim() || '',
+                tagName: el.tagName,
+                className: el.className || '',
+                role: el.getAttribute('role') || '',
+                inButton: !!el.closest('button, [role="button"]'),
+                inReviewLink: !!reviewLink,
+              };
+            })
+            .filter((candidate) => /^\\d+$/.test(candidate.text));
+
+          if (voteCandidates.length === 0) continue;
+
+          seen.add(href);
+          results.push({
+            name,
+            voteCandidates,
+            url: 'https://www.producthunt.com' + href,
+          });
+        }
+
+        return results;
+      })()
+    `),a=Array.isArray(o)?o:[];if(a.length===0)throw new s("NO_DATA","Could not retrieve Product Hunt top posts","Product Hunt may have changed its layout");const r=a.map((t)=>({name:t.name,url:t.url,votes:d(Array.isArray(t.voteCandidates)?t.voteCandidates:[])})).filter((t)=>t.name&&t.url&&t.votes);if(r.length===0)throw new s("NO_DATA","Could not retrieve Product Hunt vote counts","Product Hunt may have changed its vote button structure");r.sort((t,n)=>parseInt(n.votes,10)-parseInt(t.votes,10));return r.slice(0,c).map((t,n)=>({rank:n+1,name:t.name,votes:t.votes,url:t.url}))}});

package/clis/producthunt/posts.js

@@ -0,0 +1 @@
+import{cli as r,Strategy as n}from"@jackwener/opencli/registry";import{fetchFeed as a,PRODUCTHUNT_CATEGORY_SLUGS as s}from"./utils.js";r({site:"producthunt",name:"posts",access:"read",description:"Latest Product Hunt launches (optional category filter)",domain:"www.producthunt.com",strategy:n.PUBLIC,args:[{name:"limit",type:"int",default:20,help:"Number of results (max 50)"},{name:"category",type:"string",default:"",help:`Category filter: ${s.join(", ")}`}],columns:["rank","name","tagline","author","date","url"],func:async(t)=>{const e=Math.min(Number(t.limit)||20,50),o=String(t.category??"").trim()||void 0;return(await a(o)).slice(0,e)}});

package/clis/producthunt/today.js

@@ -0,0 +1 @@
+import{cli as B,Strategy as C}from"@jackwener/opencli/registry";import{fetchFeed as E}from"./utils.js";B({site:"producthunt",name:"today",access:"read",description:"Today's Product Hunt launches (most recent day in feed)",domain:"www.producthunt.com",strategy:C.PUBLIC,args:[{name:"limit",type:"int",default:20,help:"Max results"}],columns:["rank","name","tagline","author","url"],func:async(v)=>{const x=Math.min(Number(v.limit)||20,50),q=await E();if(q.length===0)return[];const z=q.map((m)=>m.date).sort().reverse()[0];return q.filter((m)=>m.date===z).slice(0,x).map((m,A)=>({rank:A+1,name:m.name,tagline:m.tagline,author:m.author,url:m.url}))}});

package/clis/producthunt/utils.js

@@ -0,0 +1 @@
+export const PRODUCTHUNT_CATEGORY_SLUGS=["ai-agents","ai-coding-agents","ai-code-editors","ai-chatbots","ai-workflow-automation","vibe-coding","developer-tools","productivity","design-creative","marketing-sales","no-code-platforms","llms","finance","social-community","engineering-development"];const K="Mozilla/5.0 (compatible; opencli/1.0)";export async function fetchFeed(w){const B=w?`https://www.producthunt.com/feed?category=${encodeURIComponent(w)}`:"https://www.producthunt.com/feed",f=await fetch(B,{headers:{"User-Agent":K}});if(!f.ok)return[];const j=await f.text();return parseFeed(j)}export function parseFeed(w){const B=[],f=/<entry>([\s\S]*?)<\/entry>/g;let j,C=1;while(j=f.exec(w)){const q=j[1],z=q.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim()??"",E=q.match(/<name>([\s\S]*?)<\/name>/)?.[1]?.trim()??"",G=(q.match(/<published>(.*?)<\/published>/)?.[1]?.trim()??"").slice(0,10),H=q.match(/<link[^>]*href="([^"]+)"/)?.[1]?.trim()??"",J=(q.match(/<content[^>]*>([\s\S]*?)<\/content>/)?.[1]??"").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&amp;/g,"&").replace(/&quot;/g,'"').replace(/<[^>]+>/g," ").replace(/\s+/g," ").replace(/\s*Discussion\s*\|?\s*/gi,"").replace(/\s*\|?\s*Link\s*$/gi,"").trim().slice(0,120);if(z)B.push({rank:C++,name:z,tagline:J,author:E,date:G,url:H})}return B}export function pickVoteCount(w){return w.map((f)=>{const j=String(f.text??"").trim();if(!/^\d+$/.test(j))return null;if(f.inReviewLink)return null;const C=parseInt(j,10);if(!Number.isFinite(C)||C<=0)return null;const q=`${f.tagName??""} ${f.className??""} ${f.role??""}`.toLowerCase();let z=0;if(f.inButton)z+=4;if(q.includes("vote")||q.includes("upvote"))z+=3;if(q.includes("button"))z+=1;return{text:j,score:z,value:C}}).filter((f)=>Boolean(f)).sort((f,j)=>{if(j.score!==f.score)return j.score-f.score;if(j.value!==f.value)return j.value-f.value;return f.text.localeCompare(j.text)})[0]?.text??""}export function toDate(w){return w.slice(0,10)}

package/clis/pubmed/article.js

@@ -0,0 +1 @@
+import{cli as i,Strategy as n}from"@jackwener/opencli/registry";import{CommandExecutionError as o,EmptyResultError as s}from"@jackwener/opencli/errors";import{eutilsFetch as u,parseArticleXml as c,requirePmid as m,truncateText as d}from"./utils.js";i({site:"pubmed",name:"article",aliases:["paper","read"],access:"read",description:"Get detailed information for a PubMed article by PMID",domain:"pubmed.ncbi.nlm.nih.gov",strategy:n.PUBLIC,browser:!1,defaultFormat:"plain",args:[{name:"pmid",positional:!0,required:!0,help:"PubMed ID, e.g. 37780221"},{name:"full-abstract",type:"boolean",default:!1,help:"Do not truncate the abstract in table output"}],columns:["pmid","title","authors","journal","year","date","article_type","language","doi","pmc","affiliations","grants","mesh_terms","keywords","abstract","url"],func:async(a)=>{const e=m(a.pmid),r=await u("efetch",{id:e,rettype:"abstract"},{retmode:"xml",label:"pubmed article"}),t=c(r,e);if(!t)throw new s("pubmed article",`No article found for PMID ${e}.`);if(!t.title)throw new o(`pubmed article ${e} did not include a title`,"PubMed EFetch response shape may have changed.");const l=a["full-abstract"]?t.abstract:d(t.abstract,500);return[{pmid:t.pmid,title:t.title,authors:t.authors.join(", "),journal:t.journal,year:t.year,date:t.date||null,article_type:t.article_type,language:t.language||null,doi:t.doi||null,pmc:t.pmc||null,affiliations:t.affiliations||null,grants:t.grants||null,mesh_terms:t.mesh_terms||null,keywords:t.keywords||null,abstract:l||null,url:t.url}]}});

package/clis/pubmed/author.js

@@ -0,0 +1 @@
+import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as y,CommandExecutionError as b,EmptyResultError as w}from"@jackwener/opencli/errors";import{LINK_COLUMNS as A,eutilsFetch as S,fetchSummaryRows as E,requireBoundedInt as F,requireChoice as m,requireText as l,requireYear as h}from"./utils.js";p({site:"pubmed",name:"author",access:"read",description:"Search PubMed articles by author name and optional affiliation",domain:"pubmed.ncbi.nlm.nih.gov",strategy:d.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Author name, e.g. "Smith J"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"affiliation",help:"Filter by author affiliation"},{name:"position",default:"any",choices:["any","first","last"],help:"Author position: any, first, or last"},{name:"year-from",type:"int",help:"Filter publication year from"},{name:"year-to",type:"int",help:"Filter publication year to"},{name:"sort",default:"date",choices:["date","relevance"],help:"Sort by date or relevance"}],columns:A,func:async(e)=>{const r=l(e.name,"author"),c=F(e.limit,20,100),o=m(e.position,["any","first","last"],"position","any"),f=m(e.sort,["date","relevance"],"sort","date"),i=h(e["year-from"],"year-from"),n=h(e["year-to"],"year-to"),t=[`${r}[${o==="first"?"1au":o==="last"?"lastau":"au"}]`];if(e.affiliation)t.push(`${l(e.affiliation,"affiliation")}[ad]`);if(i||n){const s=i||1800,u=n||new Date().getFullYear();if(s>u)throw new y("pubmed year-from must be <= year-to");t.push(`${s}:${u}[PDAT]`)}const a=(await S("esearch",{term:t.join(" AND "),retmax:c,usehistory:"y",sort:f==="date"?"pub_date":""},{label:"pubmed author"}))?.esearchresult?.idlist;if(!Array.isArray(a))throw new b("pubmed author did not return an id list","PubMed ESearch response shape may have changed.");if(a.length===0)throw new w("pubmed author",`No articles found for author "${r}".`);return E(a,"pubmed author summary")}});

package/clis/pubmed/citations.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as o}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{LINK_COLUMNS as d,eutilsFetch as m,fetchSummaryRows as a,requireBoundedInt as l,requireChoice as u,requirePmid as p}from"./utils.js";s({site:"pubmed",name:"citations",access:"read",description:"Get PubMed citation relationships for an article",domain:"pubmed.ncbi.nlm.nih.gov",strategy:o.PUBLIC,browser:!1,args:[{name:"pmid",positional:!0,required:!0,help:"PubMed ID, e.g. 37780221"},{name:"direction",default:"citedby",choices:["citedby","references"],help:"citedby or references"},{name:"limit",type:"int",default:20,help:"Max results (1-100)"}],columns:d,func:async(e)=>{const t=p(e.pmid),r=u(e.direction,["citedby","references"],"direction","citedby"),n=l(e.limit,20,100),i=(await m("elink",{id:t,dbfrom:"pubmed",cmd:"neighbor",linkname:r==="citedby"?"pubmed_pubmed_citedin":"pubmed_pubmed_refs"},{label:"pubmed citations"}))?.linksets?.[0]?.linksetdbs?.[0]?.links;if(!Array.isArray(i)||i.length===0)throw new c("pubmed citations",`No ${r} links found for PMID ${t}.`);return a(i.slice(0,n).map(String),"pubmed citations summary")}});

package/clis/pubmed/clinical-trial.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as s}from"@jackwener/opencli/registry";import{CommandExecutionError as m,EmptyResultError as y}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as d,buildSearchQuery as p,eutilsFetch as h,fetchSummaryRows as f,requireBoundedInt as b,requireChoice as q,requireText as w,requireYear as a}from"./utils.js";u({site:"pubmed",name:"clinical-trial",access:"read",description:"Search PubMed clinical trials with a trial-study preset",domain:"pubmed.ncbi.nlm.nih.gov",strategy:s.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Clinical topic query, e.g. "breast cancer"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"year-from",type:"int",help:"Filter publication year from"},{name:"year-to",type:"int",help:"Filter publication year to"},{name:"free-full-text",type:"boolean",default:!1,help:"Only include free full text articles"},{name:"sort",default:"date",choices:["date","relevance"],help:"Sort by date or relevance"}],columns:d,func:async(e)=>{const t=w(e.query,"query"),i=b(e.limit,20,100),l=a(e["year-from"],"year-from"),c=a(e["year-to"],"year-to"),n=q(e.sort,["date","relevance"],"sort","date"),o=p(t,{yearFrom:l,yearTo:c,articleType:"Clinical Trial",hasFullText:e["free-full-text"],humanOnly:!0}),r=(await h("esearch",{term:o,retmax:i,usehistory:"y",sort:n==="date"?"pub_date":""},{label:"pubmed clinical-trial"}))?.esearchresult?.idlist;if(!Array.isArray(r))throw new m("pubmed clinical-trial did not return an id list","PubMed ESearch response shape may have changed.");if(r.length===0)throw new y("pubmed clinical-trial",`No clinical trial articles matched "${t}".`);return f(r,"pubmed clinical-trial summary")}});

package/clis/pubmed/journal.js

@@ -0,0 +1 @@
+import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as p,CommandExecutionError as y,EmptyResultError as h}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as f,eutilsFetch as b,fetchSummaryRows as j,requireBoundedInt as w,requireChoice as v,requireText as E,requireYear as l}from"./utils.js";c({site:"pubmed",name:"journal",access:"read",description:"Search PubMed articles by journal name",domain:"pubmed.ncbi.nlm.nih.gov",strategy:d.PUBLIC,browser:!1,args:[{name:"journal",positional:!0,required:!0,help:'Journal name, e.g. "Nature" or "The Lancet"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"year-from",type:"int",help:"Filter publication year from"},{name:"year-to",type:"int",help:"Filter publication year to"},{name:"sort",default:"relevance",choices:["relevance","date"],help:"Sort by relevance or date"}],columns:f,func:async(e)=>{const t=E(e.journal,"journal"),m=w(e.limit,20,100),a=l(e["year-from"],"year-from"),o=l(e["year-to"],"year-to"),s=v(e.sort,["relevance","date"],"sort","relevance"),n=[`${t}[Journal]`];if(a||o){const u=a||1800,i=o||new Date().getFullYear();if(u>i)throw new p("pubmed year-from must be <= year-to");n.push(`${u}:${i}[PDAT]`)}const r=(await b("esearch",{term:n.join(" AND "),retmax:m,usehistory:"y",sort:s==="date"?"pub_date":""},{label:"pubmed journal"}))?.esearchresult?.idlist;if(!Array.isArray(r))throw new y("pubmed journal did not return an id list","PubMed ESearch response shape may have changed.");if(r.length===0)throw new h("pubmed journal",`No articles found for journal "${t}".`);return j(r,"pubmed journal summary")}});

package/clis/pubmed/mesh.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as i}from"@jackwener/opencli/registry";import{CommandExecutionError as n,EmptyResultError as c}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as l,eutilsFetch as u,fetchSummaryRows as d,requireBoundedInt as h,requireChoice as p,requireText as y}from"./utils.js";o({site:"pubmed",name:"mesh",access:"read",description:"Search PubMed articles by MeSH term",domain:"pubmed.ncbi.nlm.nih.gov",strategy:i.PUBLIC,browser:!1,args:[{name:"term",positional:!0,required:!0,help:'MeSH term, e.g. "Neoplasms" or "Machine Learning"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"major",type:"boolean",default:!1,help:"Only include articles where this is a major MeSH topic"},{name:"sort",default:"relevance",choices:["relevance","date"],help:"Sort by relevance or date"}],columns:l,func:async(e)=>{const t=y(e.term,"term"),a=h(e.limit,20,100),s=p(e.sort,["relevance","date"],"sort","relevance"),m=e.major?"Majr":"MeSH Terms",r=(await u("esearch",{term:`${t}[${m}]`,retmax:a,usehistory:"y",sort:s==="date"?"pub_date":""},{label:"pubmed mesh"}))?.esearchresult?.idlist;if(!Array.isArray(r))throw new n("pubmed mesh did not return an id list","PubMed ESearch response shape may have changed.");if(r.length===0)throw new c("pubmed mesh",`No articles found for MeSH term "${t}".`);return d(r,"pubmed mesh summary")}});

package/clis/pubmed/related.js

@@ -0,0 +1 @@
+import{cli as d,Strategy as m}from"@jackwener/opencli/registry";import{EmptyResultError as o}from"@jackwener/opencli/errors";import{RELATED_COLUMNS as n,eutilsFetch as u,fetchSummaryRows as c,requireBoundedInt as p,requirePmid as b}from"./utils.js";d({site:"pubmed",name:"related",access:"read",description:"Find articles related to a PubMed article",domain:"pubmed.ncbi.nlm.nih.gov",strategy:m.PUBLIC,browser:!1,args:[{name:"pmid",positional:!0,required:!0,help:"PubMed ID, e.g. 37780221"},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"score",type:"boolean",default:!1,help:"Show similarity scores when available"}],columns:n,func:async(t)=>{const r=b(t.pmid),l=p(t.limit,20,100),i=(await u("elink",{id:r,dbfrom:"pubmed",cmd:"neighbor_score",linkname:"pubmed_pubmed"},{label:"pubmed related"}))?.linksets?.[0]?.linksetdbs?.[0]?.links;if(!Array.isArray(i)||i.length===0)throw new o("pubmed related",`No related articles found for PMID ${r}.`);const s=i.map((e)=>typeof e==="string"?{id:e,score:null}:{id:String(e?.id??""),score:Number.isFinite(Number(e?.score))?Number(e.score):null}).filter((e)=>e.id&&e.id!==r).slice(0,l);if(s.length===0)throw new o("pubmed related",`No related articles found for PMID ${r}.`);return(await c(s.map((e)=>e.id),"pubmed related summary")).map((e,a)=>({...e,score:t.score?s[a].score:null}))}});

package/clis/pubmed/review.js

@@ -0,0 +1 @@
+import{cli as m,Strategy as u}from"@jackwener/opencli/registry";import{CommandExecutionError as l,EmptyResultError as y}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as d,buildSearchQuery as h,eutilsFetch as p,fetchSummaryRows as b,requireBoundedInt as w,requireChoice as f,requireText as v,requireYear as a}from"./utils.js";m({site:"pubmed",name:"review",access:"read",description:"Search PubMed review articles with a review preset",domain:"pubmed.ncbi.nlm.nih.gov",strategy:u.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Review topic query, e.g. "immunotherapy"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"year-from",type:"int",help:"Filter publication year from"},{name:"year-to",type:"int",help:"Filter publication year to"},{name:"has-abstract",type:"boolean",default:!1,help:"Only include articles with abstracts"},{name:"sort",default:"date",choices:["date","relevance"],help:"Sort by date or relevance"}],columns:d,func:async(e)=>{const t=v(e.query,"query"),i=w(e.limit,20,100),o=a(e["year-from"],"year-from"),s=a(e["year-to"],"year-to"),n=f(e.sort,["date","relevance"],"sort","date"),c=h(t,{yearFrom:o,yearTo:s,articleType:"Review",hasAbstract:e["has-abstract"]}),r=(await p("esearch",{term:c,retmax:i,usehistory:"y",sort:n==="date"?"pub_date":""},{label:"pubmed review"}))?.esearchresult?.idlist;if(!Array.isArray(r))throw new l("pubmed review did not return an id list","PubMed ESearch response shape may have changed.");if(r.length===0)throw new y("pubmed review",`No review articles matched "${t}".`);return b(r,"pubmed review summary")}});

package/clis/pubmed/search.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as h}from"@jackwener/opencli/registry";import{CommandExecutionError as m,EmptyResultError as y}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as p,buildSearchQuery as d,eutilsFetch as f,fetchSummaryRows as b,requireBoundedInt as q,requireChoice as v,requireText as w,requireYear as t}from"./utils.js";s({site:"pubmed",name:"search",access:"read",description:"Search PubMed articles with advanced filters",domain:"pubmed.ncbi.nlm.nih.gov",strategy:h.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search query, e.g. "machine learning cancer"'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"},{name:"author",help:"Filter by author name"},{name:"journal",help:"Filter by journal name"},{name:"year-from",type:"int",help:"Filter publication year from"},{name:"year-to",type:"int",help:"Filter publication year to"},{name:"article-type",help:"Filter by publication type, e.g. Review or Clinical Trial"},{name:"has-abstract",type:"boolean",default:!1,help:"Only include articles with abstracts"},{name:"free-full-text",type:"boolean",default:!1,help:"Only include free full text articles"},{name:"humans-only",type:"boolean",default:!1,help:"Only include human studies"},{name:"english-only",type:"boolean",default:!1,help:"Only include English articles"},{name:"sort",default:"relevance",choices:["relevance","date","author","journal"],help:"Sort by relevance, date, author, or journal"}],columns:p,func:async(e)=>{const a=w(e.query,"query"),l=q(e.limit,20,100),n=t(e["year-from"],"year-from"),o=t(e["year-to"],"year-to"),i=v(e.sort,["relevance","date","author","journal"],"sort","relevance"),u={relevance:"",date:"pub_date",author:"Author",journal:"JournalName"},c=d(a,{author:e.author,journal:e.journal,yearFrom:n,yearTo:o,articleType:e["article-type"],hasAbstract:e["has-abstract"],hasFullText:e["free-full-text"],humanOnly:e["humans-only"],englishOnly:e["english-only"]}),r=(await f("esearch",{term:c,retmax:l,usehistory:"y",sort:u[i]},{label:"pubmed search"}))?.esearchresult?.idlist;if(!Array.isArray(r))throw new m("pubmed search did not return an id list","PubMed ESearch response shape may have changed.");if(r.length===0)throw new y("pubmed search",`No articles matched "${a}".`);return b(r,"pubmed search summary")}});

package/clis/pubmed/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as l,CommandExecutionError as u}from"@jackwener/opencli/errors";export const EUTILS_BASE="https://eutils.ncbi.nlm.nih.gov/entrez/eutils",SEARCH_COLUMNS=["rank","pmid","title","authors","journal","year","article_type","doi","url"],LINK_COLUMNS=["rank","pmid","title","authors","journal","year","article_type","doi","url"],RELATED_COLUMNS=["rank","pmid","title","authors","journal","year","article_type","score","doi","url"];let m=0;export function requireText(r,t){const e=String(r??"").trim();if(!e)throw new l(`pubmed ${t} cannot be empty`);return e}export function requirePmid(r,t="pmid"){const e=requireText(r,t);if(!/^\d+$/.test(e))throw new l(`pubmed ${t} must be a numeric PMID`,"Example: 37780221");return e}export function requireBoundedInt(r,t,e,n="limit"){const a=String(r??t).trim();if(!/^\d+$/.test(a))throw new l(`pubmed ${n} must be a positive integer`);const i=Number(a);if(!Number.isSafeInteger(i)||i<1)throw new l(`pubmed ${n} must be a positive integer`);if(i>e)throw new l(`pubmed ${n} must be <= ${e}`);return i}export function requireYear(r,t){if(r===void 0||r===null||r==="")return;const e=requireBoundedInt(r,1900,3000,t);if(e<1800)throw new l(`pubmed ${t} must be >= 1800`);return e}export function requireChoice(r,t,e,n){const o=String(r??n).trim();if(!t.includes(o))throw new l(`pubmed ${e} must be one of: ${t.join(", ")}`);return o}export function buildEutilsUrl(r,t={}){const e=new URLSearchParams;e.set("db","pubmed");if(!t.retmode)e.set("retmode","json");if(process.env.NCBI_API_KEY)e.set("api_key",process.env.NCBI_API_KEY);if(process.env.NCBI_EMAIL)e.set("email",process.env.NCBI_EMAIL);for(const[n,o]of Object.entries(t))if(o!==void 0&&o!==null&&o!=="")e.set(n,String(o));return`${EUTILS_BASE}/${r}.fcgi?${e.toString()}`}async function I(){const r=process.env.NCBI_API_KEY?110:360,t=Date.now(),e=Math.max(0,m+r-t);if(e>0)await new Promise((n)=>setTimeout(n,e));m=Date.now()}export async function eutilsFetch(r,t={},{retmode:e="json",label:n="PubMed E-utilities"}={}){const o=buildEutilsUrl(r,{...t,retmode:e});await I();let a;try{a=await fetch(o)}catch(i){const c=i instanceof Error?i.message:String(i);throw new u(`${n} request failed`,c)}if(!a.ok)throw new u(`${n} HTTP ${a.status}`,"Check NCBI availability, request parameters, and optional NCBI_API_KEY.");if(e==="xml")return a.text();try{const i=await a.json();assertNoEutilsError(i,n);return i}catch(i){if(i instanceof u)throw i;const c=i instanceof Error?i.message:String(i);throw new u(`${n} returned invalid JSON`,c)}}export function assertNoEutilsError(r,t="PubMed E-utilities"){const e=r?.error||r?.esearchresult?.errorlist?.phrasesnotfound?.join(", ")||r?.esearchresult?.errorlist?.fieldsnotfound?.join(", ");if(e)throw new u(`${t} returned an error`,String(e))}export function buildPubMedUrl(r){return`https://pubmed.ncbi.nlm.nih.gov/${r}/`}export function decodeXmlEntities(r){return String(r??"").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&quot;/g,'"').replace(/&apos;/g,"'").replace(/&#39;/g,"'").replace(/&#x([0-9a-f]+);/gi,(t,e)=>String.fromCodePoint(Number.parseInt(e,16))).replace(/&#(\d+);/g,(t,e)=>String.fromCodePoint(Number.parseInt(e,10)))}export function cleanText(r){return decodeXmlEntities(r).replace(/\s+/g," ").trim()}export function truncateText(r,t){const e=cleanText(r);if(!e||e.length<=t)return e;return`${e.slice(0,t-3)}...`}export function extractFirst(r,t){const e=String(r??"").match(new RegExp(`<${t}\\b[^>]*>([\\s\\S]*?)<\\/${t}>`,"i"));return e?cleanText(e[1].replace(/<[^>]+>/g," ")):""}export function extractAll(r,t){const e=new RegExp(`<${t}\\b[^>]*>([\\s\\S]*?)<\\/${t}>`,"gi"),n=[];let o;while((o=e.exec(String(r??"")))!==null)n.push(cleanText(o[1].replace(/<[^>]+>/g," ")));return n}export function extractAttribute(r,t,e){const n=String(r??"").match(new RegExp(`<${t}\\b[^>]*\\b${e}="([^"]*)"`,"i"));return n?decodeXmlEntities(n[1]):""}export function extractAuthors(r,t=3){if(!Array.isArray(r)||r.length===0)return"";const e=r.map((o)=>o?.name||o?.collectivename||[o?.lastname,o?.initials].filter(Boolean).join(" ")).filter(Boolean),n=e.slice(0,t);if(e.length>t)n.push("et al.");return n.join(", ")}export function extractDoi(r){if(!Array.isArray(r))return"";const t=r.find((e)=>String(e?.idtype??"").toLowerCase()==="doi");return String(t?.value??"").trim()}export function articleTypeFromList(r){const t=Array.isArray(r)?r.map((n)=>typeof n==="string"?n:n?.value).filter(Boolean):[],e=["Systematic Review","Meta-Analysis","Review","Randomized Controlled Trial","Clinical Trial","Case Reports","Journal Article"];for(const n of e){const o=t.find((a)=>a.toLowerCase()===n.toLowerCase());if(o)return o}return t[0]||"Journal Article"}export function summaryToRow(r,t,e=r?.uid){const n=String(e??r?.uid??"").trim();return{rank:t,pmid:n,title:truncateText(String(r?.title??"").replace(/\.$/,""),120),authors:extractAuthors(r?.authors,3),journal:truncateText(r?.fulljournalname||r?.source||"",60),year:String(r?.pubdate??"").split(" ")[0]||"",article_type:articleTypeFromList(r?.pubtype),doi:extractDoi(r?.articleids),url:buildPubMedUrl(n)}}export function ensureCompleteSummaryRows(r,t,e){if(!t||typeof t!=="object"||!t.result||typeof t.result!=="object")throw new u(`${e} returned an unreadable summary payload`);const n=r.map((o,a)=>{const i=t.result[o];if(!i)return null;return summaryToRow(i,a+1,o)});if(n.some((o)=>o===null))throw new u(`${e} omitted summaries for one or more PMIDs`,"Refusing to return a partial result set.");return n}export function buildSearchQuery(r,t={}){const e=[requireText(r,"query")];if(t.author)e.push(`${requireText(t.author,"author")}[Author]`);if(t.journal)e.push(`${requireText(t.journal,"journal")}[Journal]`);if(t.yearFrom||t.yearTo){const n=t.yearFrom||1800,o=t.yearTo||new Date().getFullYear();if(n>o)throw new l("pubmed year-from must be <= year-to");e.push(`${n}:${o}[PDAT]`)}if(t.articleType)e.push(`${requireText(t.articleType,"article-type")}[PT]`);if(t.hasAbstract)e.push("hasabstract[text]");if(t.hasFullText)e.push("free full text[sb]");if(t.humanOnly)e.push("humans[mesh]");if(t.englishOnly)e.push("english[lang]");return e.join(" AND ")}export function parseArticleXml(r,t){const e=String(r??"");if(!e||/<ERROR\b/i.test(e)||!/<PubmedArticle\b/i.test(e))return null;const n=extractFirst(e,"PMID");if(!n)throw new u("pubmed article response did not include a PMID","PubMed EFetch response shape may have changed.");if(n!==t)throw new u(`pubmed article response PMID ${n} did not match requested PMID ${t}`,"Refusing to return metadata for a different article.");const o=e.match(/<Article\b[^>]*>([\s\S]*?)<\/Article>/i)?.[1]||e,a=o.match(/<Journal\b[^>]*>([\s\S]*?)<\/Journal>/i)?.[1]||"",c=(a.match(/<JournalIssue\b[^>]*>([\s\S]*?)<\/JournalIssue>/i)?.[1]||"").match(/<PubDate\b[^>]*>([\s\S]*?)<\/PubDate>/i)?.[1]||"",f=[...e.matchAll(/<Author\b[^>]*>([\s\S]*?)<\/Author>/gi)].map((s)=>s[1]).map((s)=>{return extractFirst(s,"CollectiveName")||[extractFirst(s,"LastName"),extractFirst(s,"ForeName")||extractFirst(s,"Initials")].filter(Boolean).join(" ")}).filter(Boolean),d=extractAll(o,"AbstractText").join(" "),h=extractAll(o,"PublicationType"),g=extractAll(e,"DescriptorName"),w=extractAll(e,"Keyword"),y=extractAll(e,"Affiliation"),b=[...e.matchAll(/<Grant\b[^>]*>([\s\S]*?)<\/Grant>/gi)].map((s)=>s[1]).map((s)=>{const p=extractFirst(s,"GrantID"),A=extractFirst(s,"Agency");return[p,A].filter(Boolean).join(": ")}).filter(Boolean),x=e.match(/<ArticleId\b[^>]*IdType="doi"[^>]*>([\s\S]*?)<\/ArticleId>/i)?.[1]||"",S=e.match(/<ArticleId\b[^>]*IdType="pmc"[^>]*>([\s\S]*?)<\/ArticleId>/i)?.[1]||"";return{pmid:t,title:extractFirst(o,"ArticleTitle"),abstract:d,authors:f,journal:extractFirst(a,"Title")||extractFirst(a,"ISOAbbreviation"),year:extractFirst(c,"Year")||extractFirst(e,"MedlineDate").slice(0,4),date:[extractFirst(c,"Year"),extractFirst(c,"Month"),extractFirst(c,"Day")].filter(Boolean).join(" "),doi:cleanText(x),pmc:cleanText(S),article_type:articleTypeFromList(h),language:extractFirst(o,"Language"),affiliations:y.slice(0,10).join(" | "),grants:b.slice(0,10).join(" | "),mesh_terms:g.slice(0,10).join(", "),keywords:w.slice(0,10).join(", "),url:buildPubMedUrl(t)}}export async function fetchSummaryRows(r,t){const e=await eutilsFetch("esummary",{id:r.join(",")},{label:t});return ensureCompleteSummaryRows(r,e,t)}

package/clis/pypi/downloads.js

@@ -0,0 +1 @@
+import{cli as i,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as c,EmptyResultError as l}from"@jackwener/opencli/errors";import{PYPISTATS_BASE as s,pypiFetch as d,requirePackageName as y}from"./utils.js";const w=new Set(["recent","overall"]);function u(t){const a=String(t??"recent").trim().toLowerCase();if(!w.has(a))throw new c(`pypi downloads period "${t}" is invalid`,"Allowed values: recent (default — last day/week/month totals) or overall (full daily history).");return a}i({site:"pypi",name:"downloads",access:"read",description:"PyPI download stats for a package (recent totals or full daily history)",domain:"pypistats.org",strategy:p.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'PyPI package name (e.g. "requests", "pandas")'},{name:"period",default:"recent",help:"recent (default — 1 row, last day/week/month) or overall (1 row per day)"}],columns:["rank","package","period","date","downloads"],func:async(t)=>{const a=y(t.name);if(u(t.period)==="recent"){const o=await d(`${s}/api/packages/${encodeURIComponent(a)}/recent`,`pypi downloads ${a}`),e=o?.data;if(!e||e.last_day==null&&e.last_week==null&&e.last_month==null)throw new l("pypi downloads",`pypistats has no recent download data for "${a}".`);return[{rank:1,package:String(o.package??a),period:"last_day",date:"",downloads:e.last_day!=null?Number(e.last_day):null},{rank:2,package:String(o.package??a),period:"last_week",date:"",downloads:e.last_week!=null?Number(e.last_week):null},{rank:3,package:String(o.package??a),period:"last_month",date:"",downloads:e.last_month!=null?Number(e.last_month):null}]}const r=await d(`${s}/api/packages/${encodeURIComponent(a)}/overall?mirrors=false`,`pypi downloads ${a}`),n=Array.isArray(r?.data)?r.data:[];if(!n.length)throw new l("pypi downloads",`pypistats has no overall download history for "${a}".`);return n.map((o,e)=>({rank:e+1,package:String(r.package??a),period:"daily",date:String(o.date??""),downloads:o.downloads!=null?Number(o.downloads):null}))}});

package/clis/pypi/package.js

@@ -0,0 +1 @@
+import{cli as U,Strategy as W}from"@jackwener/opencli/registry";import{EmptyResultError as X}from"@jackwener/opencli/errors";import{PYPI_BASE as Q,pypiFetch as Z,requirePackageName as $}from"./utils.js";function q(C){if(C.home_page)return String(C.home_page);const x=C.project_urls;if(x&&typeof x==="object")return String(x.Homepage||x.homepage||x.Documentation||x.Source||x["Source Code"]||"");return""}function F(C){const x=C.project_urls;if(x&&typeof x==="object")return String(x.Source||x["Source Code"]||x.Repository||x.repository||"");return""}U({site:"pypi",name:"package",access:"read",description:"Single PyPI package metadata (latest version, license, homepage, classifiers)",domain:"pypi.org",strategy:W.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'PyPI package name (e.g. "requests", "pandas")'}],columns:["name","latestVersion","summary","author","license","homepage","repository","requiresPython","keywords","releases","firstReleased","lastReleased","url"],func:async(C)=>{const x=$(C.name),M=await Z(`${Q}/pypi/${encodeURIComponent(x)}/json`,`pypi package ${x}`),z=M?.info;if(!z||!z.name)throw new X("pypi package",`PyPI returned no metadata for "${x}".`);const G=M?.releases??{},O=Object.keys(G).filter((L)=>Array.isArray(G[L])&&G[L].length>0);let J="",K="";for(const L of O)for(const T of G[L]){const D=String(T?.upload_time??"").slice(0,10);if(!D)continue;if(!J||D<J)J=D;if(!K||D>K)K=D}return[{name:String(z.name),latestVersion:String(z.version??""),summary:String(z.summary??""),author:String(z.author??z.author_email??""),license:String(z.license_expression??z.license??""),homepage:q(z),repository:F(z),requiresPython:String(z.requires_python??""),keywords:String(z.keywords??""),releases:O.length,firstReleased:J,lastReleased:K,url:String(z.package_url??`${Q}/project/${z.name}/`)}]}});

package/clis/pypi/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as J,CommandExecutionError as F,EmptyResultError as L}from"@jackwener/opencli/errors";export const PYPI_BASE="https://pypi.org",PYPISTATS_BASE="https://pypistats.org";const O="opencli-pypi-adapter (+https://github.com/jackwener/opencli)",Q=/^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$/;export function requirePackageName(B){const f=String(B??"").trim();if(!f)throw new J('pypi package name is required (e.g. "requests", "pandas")');if(!Q.test(f))throw new J(`pypi package name "${B}" is not a valid distribution name`,'PyPI accepts ASCII letters / digits / "._-" with no leading or trailing separator.');return f}export async function pypiFetch(B,f){let q;try{q=await fetch(B,{headers:{"user-agent":O,accept:"application/json"}})}catch(D){throw new F(`${f} request failed: ${D?.message??D}`,"Check that pypi.org / pypistats.org are reachable from this network.")}if(q.status===404)throw new L(f,`PyPI returned 404 for ${B}.`);if(q.status===429)throw new F(`${f} returned HTTP 429 (rate limited)`,"PyPI throttles unauthenticated bursts; wait a few seconds and retry.");if(!q.ok)throw new F(`${f} returned HTTP ${q.status}`);let H;try{H=await q.json()}catch(D){throw new F(`${f} returned malformed JSON: ${D?.message??D}`)}return H}

package/clis/qiita/auth.js

@@ -0,0 +1 @@
+import{AuthRequiredError as D}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as F}from"../_shared/site-auth.js";import{qiitaViewer as I}from"./gql.js";const y="https://qiita.com";async function z(b){return(await b.getCookies({url:y})).some((x)=>x.name==="_qiita_login_session"&&x.value)}async function B(b){await b.goto(`${y}/`);const f=await I(b);return{url_name:f.urlName,name:f.name||"",user_id:String(f.originalId??"")}}F({site:"qiita",domain:"qiita.com",loginUrl:"https://qiita.com/login",columns:["url_name","name","user_id"],loginDescription:"打开 Qiita 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:z,verify:B,poll:async(b)=>{if(!await z(b))throw new D("qiita.com","Waiting for Qiita session cookie");return B(b)}});

package/clis/qiita/gql.js

@@ -0,0 +1,32 @@
+import{AuthRequiredError as K,CommandExecutionError as H}from"@jackwener/opencli/errors";const Q="https://qiita.com/graphql";export async function qiitaGql(F,z,B={}){const f=await F.evaluate(`(async () => {
+    try {
+      var csrf = (document.querySelector('meta[name="csrf-token"]') || {}).content;
+      if (!csrf) return { kind: 'auth', detail: 'no csrf-token meta — not logged in?' };
+      var r = await fetch(${JSON.stringify(Q)}, {
+        method: 'POST',
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json', 'X-CSRF-Token': csrf, 'X-Requested-With': 'XMLHttpRequest' },
+        body: JSON.stringify({ query: ${JSON.stringify(z)}, variables: ${JSON.stringify(B)} }),
+      });
+      var text = await r.text();
+      var data = null; try { data = JSON.parse(text); } catch (e) {}
+      if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'HTTP ' + r.status };
+      if (!r.ok) return { kind: 'http', status: r.status, detail: text.slice(0, 300) };
+      return { kind: 'ok', body: data };
+    } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
+  })()`);if(f?.kind==="auth")throw new K("qiita.com",`Not logged in (${f.detail}). Run \`opencli qiita login\`.`);if(f?.kind==="http")throw new H(`Qiita GraphQL failed: HTTP ${f.status} ${f.detail}`);if(f?.kind==="exception")throw new H(`Qiita GraphQL error: ${f.detail}`);if(f?.kind!=="ok"||!f.body)throw new H(`Unexpected Qiita response: ${JSON.stringify(f)}`);const J=f.body;if(Array.isArray(J.errors)&&J.errors.length){const L=J.errors.map((M)=>M.message).join("; ");if(/login required|unauthor|not authenticated/i.test(L))throw new K("qiita.com",`Qiita auth error: ${L}`);throw new H(`Qiita GraphQL error: ${L}`)}return J.data||{}}export async function qiitaDeleteByForm(F,z){const B=await F.evaluate(`(async () => {
+    try {
+      var meta = document.querySelector('meta[name="csrf-token"]');
+      var token = meta && meta.content;
+      if (!token) return { kind: 'auth' };
+      var r = await fetch(${JSON.stringify(z)}, {
+        method: 'POST', credentials: 'include',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: '_method=delete&authenticity_token=' + encodeURIComponent(token),
+        redirect: 'manual',
+      });
+      // 302 跳转 = 删除成功；opaqueredirect(status 0)/2xx/3xx 都视为成功，4xx/5xx 视为失败。
+      var ok = r.type === 'opaqueredirect' || r.status === 0 || (r.status >= 200 && r.status < 400);
+      return { kind: 'done', ok: ok, status: r.status };
+    } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
+  })()`);if(B?.kind==="auth")throw new K("qiita.com","Not logged in. Run `opencli qiita login`.");if(B?.kind==="exception")throw new H(`Qiita delete error: ${B.detail}`);return{ok:!!B?.ok,status:B?.status??-1}}export async function qiitaViewer(F){const z=await qiitaGql(F,"{ viewer { urlName name originalId } }");if(!z.viewer||!z.viewer.urlName)throw new K("qiita.com","Qiita viewer empty — not logged in");return z.viewer}

package/clis/qiita/publish.js

@@ -0,0 +1,7 @@
+import*as V from"node:fs";import{cli as v,Strategy as F}from"@jackwener/opencli/registry";import{ArgumentError as X,CommandExecutionError as Y}from"@jackwener/opencli/errors";import{qiitaGql as Z,qiitaDeleteByForm as R}from"./gql.js";import{assertLiteralContent as h}from"../_shared/content-guard.js";export function resolveBody(z){if(z["body-file"]){const J=String(z["body-file"]);if(!V.statSync(J,{throwIfNoEntry:!1})?.isFile())throw new X(`--body-file not found: ${J}`);return V.readFileSync(J,"utf8")}if(z.body!==void 0&&z.body!==null){h(String(z.body),{fileFlag:"--body-file"});return String(z.body)}return}export function assertNoLocalImages(z){const J=[],M=(K)=>{const O=String(K??"").trim();if(!O)return;if(/^(https?:)?\/\//i.test(O))return;J.push(O.length>80?O.slice(0,80)+"…":O)};for(const K of z.matchAll(/!\[[^\]]*\]\(\s*<?([^)\s>]+)/g))M(K[1]);for(const K of z.matchAll(/<img\b[^>]*\bsrc\s*=\s*["']([^"']+)["']/gi))M(K[1]);if(J.length)throw new X(`正文里有 ${J.length} 张非公网 URL 的图片（${J.slice(0,3).join("、")}）。`+"Qiita 不转存本机图片，发出去会是裂图——请改用公网可直接访问的 http(s) 图片 URL，或移除这些图。")}export function resolveTagNames(z){return String(z??"").split(",").map((J)=>J.trim()).filter(Boolean)}const G=`mutation($input: SaveCreatingArticleInput!) {
+  saveCreatingArticle(input: $input) { draftItem { uuid } }
+}`,P=`mutation($input: PublishPublicArticleInput!) {
+  publishPublicArticle(input: $input) { article { uuid linkUrl encryptedId isSecret } }
+}`,T=`mutation($input: PublishSecretArticleInput!) {
+  publishSecretArticle(input: $input) { article { uuid linkUrl encryptedId isSecret } }
+}`;v({site:"qiita",name:"publish",access:"write",description:"Publish a Qiita article (markdown). Tags required. Public by default; --draft or --secret to change.",domain:"qiita.com",strategy:F.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!1,help:"Article title (required)"},{name:"body",type:"string",required:!1,help:"Article body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"tags",type:"string",required:!1,help:"Comma-separated tags (REQUIRED, at least 1)"},{name:"draft",type:"boolean",required:!1,default:!1,help:"Save as draft only (do not publish)"},{name:"secret",type:"boolean",required:!1,default:!1,help:"Publish as limited-public (secret) instead of public"},{name:"tweet-share",type:"boolean",required:!1,default:!1,help:"Also share to X/Twitter on publish (public only)"}],columns:["status","uuid","url"],func:async(z,J)=>{if(!z)throw new Y("Browser session required for qiita publish");const M=String(J.title??"").trim(),K=resolveBody(J),O=resolveTagNames(J.tags);if(!M)throw new X("--title is required");if(K===void 0)throw new X("--body or --body-file is required");if(O.length===0)throw new X("--tags is required (Qiita articles need at least one tag)");assertNoLocalImages(K);await z.goto("https://qiita.com/drafts/new");await z.wait({time:2});const $=await Z(z,G,{input:{uuid:"",title:M,rawBody:K,tagNames:O,slide:!1,organizationId:null}}),W=$?.saveCreatingArticle?.draftItem?.uuid;if(!W)throw new Y(`Qiita saveCreatingArticle returned no uuid: ${JSON.stringify($)}`);if(J.draft)return[{status:"draft",uuid:W,url:`https://qiita.com/drafts/${W}/edit`}];let Q;if(J.secret)Q=(await Z(z,T,{input:{uuid:W,title:M,rawBody:K,tagNames:O,slide:!1}}))?.publishSecretArticle?.article;else Q=(await Z(z,P,{input:{uuid:W,title:M,rawBody:K,tagNames:O,slide:!1,tweetShare:!!J["tweet-share"],adventCalendarItems:[]}}))?.publishPublicArticle?.article;if(!Q||!Q.linkUrl)throw new Y(`Qiita publish returned no article: ${JSON.stringify(Q)}`);return[{status:J.secret?"published-secret":"published",uuid:Q.uuid||W,url:Q.linkUrl}]}});v({site:"qiita",name:"delete",access:"write",description:"Delete a Qiita article or draft by its URL (article linkUrl, or https://qiita.com/drafts/<uuid>).",domain:"qiita.com",strategy:F.COOKIE,browser:!0,args:[{name:"url",type:"string",required:!1,help:"Article URL (e.g. https://qiita.com/<urlName>/items/<uuid>) or draft URL (https://qiita.com/drafts/<uuid>)"}],columns:["status","url"],func:async(z,J)=>{if(!z)throw new Y("Browser session required for qiita delete");const M=String(J.url??"").trim();if(!/^https:\/\/qiita\.com\/.+/.test(M))throw new X("--url is required (a https://qiita.com/... article or draft URL)");await z.goto("https://qiita.com/");await z.wait({time:1});const K=await R(z,M);if(!K.ok)throw new Y(`Qiita delete failed (HTTP ${K.status}) for ${M}`);return[{status:"deleted",url:M}]}});

package/clis/qiita/stats.js

@@ -0,0 +1,37 @@
+import{cli as F,Strategy as G}from"@jackwener/opencli/registry";import{EmptyResultError as I,AuthRequiredError as J}from"@jackwener/opencli/errors";import{qiitaViewer as K}from"./gql.js";const L="https://qiita.com/";F({site:"qiita",name:"stats",access:"read",description:"Qiita 文章数据（每篇浏览/点赞/收藏/评论等运营指标）。逐篇补浏览数、篇数多时偏慢，客户端超时属正常，重试一次即可",domain:"qiita.com",strategy:G.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","published_at","views","likes","comments","collects","shares","tags","extra"],func:async(v,B)=>{const C=Math.max(1,Number(B.limit)||20);await v.goto(L);const x=(await K(v))?.urlName;if(!x)throw new J("qiita.com","未登录 Qiita：请先在 Chrome 里登录 qiita.com 再运行 qiita stats");const f=await v.evaluate(`(async () => {
+      try {
+        const limit = ${JSON.stringify(C)};
+        const urlName = ${JSON.stringify(x)};
+        const items = [];
+        for (let pageNo = 1; items.length < limit && pageNo <= 100; pageNo++) {
+          const resp = await fetch('/api/v2/users/' + encodeURIComponent(urlName) + '/items?per_page=100&page=' + pageNo, {
+            headers: { accept: 'application/json' },
+          });
+          if (!resp.ok) return { error: 'Qiita 接口 HTTP ' + resp.status + '（/api/v2/users/' + urlName + '/items 第 ' + pageNo + ' 页）' };
+          const batch = await resp.json();
+          if (!Array.isArray(batch) || batch.length === 0) break;
+          for (const it of batch) { delete it.body; delete it.rendered_body; delete it.user; }
+          items.push(...batch);
+          if (batch.length < 100) break;
+        }
+        const picked = items.slice(0, limit);
+        // 逐篇带 cookie 拉文章页 HTML，抠作者可见的「N views」（SSR 渲染，含千分位/k 缩写）
+        for (const it of picked) {
+          try {
+            const r = await fetch(it.url, { credentials: 'include' });
+            if (!r.ok) { it.__views = null; continue; }
+            const html = await r.text();
+            const m = html.match(/aria-hidden="true">([0-9.,]+[kKmM]?)\\s*views</);
+            if (!m) { it.__views = null; continue; }
+            let v = m[1].replace(/,/g, '');
+            let mul = 1;
+            if (/k$/i.test(v)) { mul = 1000; v = v.slice(0, -1); }
+            else if (/m$/i.test(v)) { mul = 1000000; v = v.slice(0, -1); }
+            it.__views = Math.round(parseFloat(v) * mul);
+          } catch (e) { it.__views = null; }
+        }
+        return { items: picked };
+      } catch (e) {
+        return { error: String((e && e.message) || e) };
+      }
+    })()`);if(!f||f.error)throw Error(f?.error||"qiita stats：evaluate 无返回（浏览器会话异常）");const z=Array.isArray(f.items)?f.items:[];if(z.length===0)throw new I("qiita stats","该 Qiita 账号没有任何公开文章。");return z.map((b)=>({id:b.id||"",type:"article",title:b.title||"",url:b.url||"",published_at:b.created_at||"",views:b.__views??"",likes:b.likes_count??0,comments:b.comments_count??0,collects:b.stocks_count??0,shares:"",tags:Array.isArray(b.tags)?b.tags.map((D)=>D.name||"").filter(Boolean).join("|"):"",extra:JSON.stringify({reactions:b.reactions_count??null,private:b.private??null,updated_at:b.updated_at||"",organization:b.organization_url_name||""})}))}});