publishport-opencli 1.0.19 → 1.0.21

package/clis/sohu/categories.js

@@ -1 +1 @@
-import{cli as G,Strategy as K}from"@jackwener/opencli/registry";import{CliError as L,CommandExecutionError as Q}from"@jackwener/opencli/errors";import{gotoWritePage as T}from"../_shared/article/publish.js";import{sohuProfile as V}from"./article.js";import{SOHU_MPBP_HEADERS_JS as X}from"./mpbp.js";G({site:"sohu",name:"categories",access:"read",description:"列出某个搜狐号频道下的分类（id + 名称），供 `sohu article --category` 取合法分类名。须用 --channel 指定频道名。",domain:"mp.sohu.com",strategy:K.COOKIE,browser:!0,args:[{name:"channel",required:!0,help:"频道名（精确匹配），合法值用 `sohu channels` 列举"}],columns:["category_id","category_name"],func:async(q,F)=>{if(!q)throw new Q("搜狐号分类列举需要浏览器会话");const v=String(F.channel??"").trim();if(!v)throw new L("INVALID_INPUT","请用 --channel 指定频道名");await T(q,V.home);const z=await q.evaluate("(async () => {"+X+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const cr = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const cj = await cr.json();"+"if (!cj || cj.success === false) throw new Error('频道列举失败：' + ((cj && cj.msg) || '未登录或无权限'));"+"const channels = Array.isArray(cj) ? cj : ((cj && cj.data) || []);const ch = channels.find(c => String(c.name) === "+JSON.stringify(v)+");"+"if (!ch) throw new Error('未找到频道「"+v.replace(/"/g,"\\\"")+"」，可选：' + (channels.map(c => c.name).join(' / ') || '（空）'));"+"const channelId = ch.id != null ? ch.id : ch.channelId;const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels/' + channelId + '/categories?accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('分类列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ category_id: String(c.id), category_name: c.name || '' }));})()");return Array.isArray(z)?z:[]}});
+import{cli as r,Strategy as o}from"@jackwener/opencli/registry";import{CliError as e,CommandExecutionError as s}from"@jackwener/opencli/errors";import{gotoWritePage as i}from"../_shared/article/publish.js";import{sohuProfile as h}from"./article.js";import{SOHU_MPBP_HEADERS_JS as d}from"./mpbp.js";r({site:"sohu",name:"categories",access:"read",description:"列出某个搜狐号频道下的分类（id + 名称），供 `sohu article --category` 取合法分类名。须用 --channel 指定频道名。",domain:"mp.sohu.com",strategy:o.COOKIE,browser:!0,args:[{name:"channel",required:!0,help:"频道名（精确匹配），合法值用 `sohu channels` 列举"}],columns:["category_id","category_name"],func:async(a,n)=>{if(!a)throw new s("搜狐号分类列举需要浏览器会话");const c=String(n.channel??"").trim();if(!c)throw new e("INVALID_INPUT","请用 --channel 指定频道名");await i(a,h.home);const t=await a.evaluate("(async () => {"+d+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const cr = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const cj = await cr.json();"+"if (!cj || cj.success === false) throw new Error('频道列举失败：' + ((cj && cj.msg) || '未登录或无权限'));"+"const channels = Array.isArray(cj) ? cj : ((cj && cj.data) || []);const ch = channels.find(c => String(c.name) === "+JSON.stringify(c)+");"+"if (!ch) throw new Error('未找到频道「"+c.replace(/"/g,"\\\"")+"」，可选：' + (channels.map(c => c.name).join(' / ') || '（空）'));"+"const channelId = ch.id != null ? ch.id : ch.channelId;const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels/' + channelId + '/categories?accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('分类列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ category_id: String(c.id), category_name: c.name || '' }));})()");return Array.isArray(t)?t:[]}});

package/clis/sohu/channels.js

@@ -1 +1 @@
-import{cli as z,Strategy as F}from"@jackwener/opencli/registry";import{CommandExecutionError as G}from"@jackwener/opencli/errors";import{gotoWritePage as I}from"../_shared/article/publish.js";import{sohuProfile as K}from"./article.js";import{SOHU_MPBP_HEADERS_JS as L}from"./mpbp.js";z({site:"sohu",name:"channels",access:"read",description:"列出当前搜狐号可发布的频道（id + 名称），供 `sohu article --channel` 取合法频道名。",domain:"mp.sohu.com",strategy:F.COOKIE,browser:!0,columns:["channel_id","channel_name"],func:async(q)=>{if(!q)throw new G("搜狐号频道列举需要浏览器会话");await I(q,K.home);const v=await q.evaluate("(async () => {"+L+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('频道列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ channel_id: String(c.id != null ? c.id : c.channelId), channel_name: c.name || '' }));})()");return Array.isArray(v)?v:[]}});
+import{cli as n,Strategy as o}from"@jackwener/opencli/registry";import{CommandExecutionError as c}from"@jackwener/opencli/errors";import{gotoWritePage as r}from"../_shared/article/publish.js";import{sohuProfile as e}from"./article.js";import{SOHU_MPBP_HEADERS_JS as s}from"./mpbp.js";n({site:"sohu",name:"channels",access:"read",description:"列出当前搜狐号可发布的频道（id + 名称），供 `sohu article --channel` 取合法频道名。",domain:"mp.sohu.com",strategy:o.COOKIE,browser:!0,columns:["channel_id","channel_name"],func:async(a)=>{if(!a)throw new c("搜狐号频道列举需要浏览器会话");await r(a,e.home);const t=await a.evaluate("(async () => {"+s+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/common/channels-data-api?status=1&accountId=' + accountId, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('频道列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(c => ({ channel_id: String(c.id != null ? c.id : c.channelId), channel_name: c.name || '' }));})()");return Array.isArray(t)?t:[]}});

package/clis/sohu/columns.js

@@ -1 +1 @@
-import{cli as z,Strategy as F}from"@jackwener/opencli/registry";import{CommandExecutionError as G}from"@jackwener/opencli/errors";import{gotoWritePage as I}from"../_shared/article/publish.js";import{sohuProfile as K}from"./article.js";import{SOHU_MPBP_HEADERS_JS as L}from"./mpbp.js";z({site:"sohu",name:"columns",access:"read",description:"列出当前搜狐号的专栏（id + 名称），供 `sohu article --column` 取合法专栏名。",domain:"mp.sohu.com",strategy:F.COOKIE,browser:!0,columns:["column_id","column_name"],func:async(q)=>{if(!q)throw new G("搜狐号专栏列举需要浏览器会话");await I(q,K.home);const v=await q.evaluate("(async () => {"+L+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/column/v2/list?accountId=' + accountId + '&page=1&size=100', { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('专栏列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const raw = Array.isArray(j) ? j : ((j && j.data) || []);const list = Array.isArray(raw) ? raw : (Array.isArray(raw.data) ? raw.data : []);return list.map(c => ({ column_id: String(c.id), column_name: c.name || '' }));})()");return Array.isArray(v)?v:[]}});
+import{cli as r,Strategy as o}from"@jackwener/opencli/registry";import{CommandExecutionError as c}from"@jackwener/opencli/errors";import{gotoWritePage as n}from"../_shared/article/publish.js";import{sohuProfile as s}from"./article.js";import{SOHU_MPBP_HEADERS_JS as e}from"./mpbp.js";r({site:"sohu",name:"columns",access:"read",description:"列出当前搜狐号的专栏（id + 名称），供 `sohu article --column` 取合法专栏名。",domain:"mp.sohu.com",strategy:o.COOKIE,browser:!0,columns:["column_id","column_name"],func:async(a)=>{if(!a)throw new c("搜狐号专栏列举需要浏览器会话");await n(a,s.home);const t=await a.evaluate("(async () => {"+e+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const r = await fetch('https://mp.sohu.com/mpbp/bp/account/column/v2/list?accountId=' + accountId + '&page=1&size=100', { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('专栏列举失败：' + ((j && j.msg) || '未登录或无权限'));"+"const raw = Array.isArray(j) ? j : ((j && j.data) || []);const list = Array.isArray(raw) ? raw : (Array.isArray(raw.data) ? raw.data : []);return list.map(c => ({ column_id: String(c.id), column_name: c.name || '' }));})()");return Array.isArray(t)?t:[]}});

package/clis/sohu/login.js

@@ -1 +1 @@
-import{registerArticleLogin as k}from"../_shared/article/login.js";import{sohuAuthProfile as b}from"./article.js";k({site:"sohu",domain:"mp.sohu.com",profile:{home:b.home,checkAuth:b.checkAuth},loginDescription:"打开搜狐号登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});
+import{registerArticleLogin as i}from"../_shared/article/login.js";import{sohuAuthProfile as o}from"./article.js";i({site:"sohu",domain:"mp.sohu.com",profile:{home:o.home,checkAuth:o.checkAuth},loginDescription:"打开搜狐号登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});

package/clis/sohu/stats.js

@@ -1,5 +1,5 @@
-import{cli as C,Strategy as G}from"@jackwener/opencli/registry";import{CommandExecutionError as R,EmptyResultError as P}from"@jackwener/opencli/errors";import{gotoWritePage as T}from"../_shared/article/publish.js";const _="https://mp.sohu.com/mpfe/v4/contentManagement/news/articlelist",v=10;function W(O){if(!O)return"";const H=new Date(O+28800000),J=(Q)=>String(Q).padStart(2,"0");return`${H.getUTCFullYear()}-${J(H.getUTCMonth()+1)}-${J(H.getUTCDate())} ${J(H.getUTCHours())}:${J(H.getUTCMinutes())}`}function Z(O){const H=new Date(Date.now()+28800000-O*86400000),J=(Q)=>String(Q).padStart(2,"0");return`${H.getUTCFullYear()}-${J(H.getUTCMonth()+1)}-${J(H.getUTCDate())}`}C({site:"sohu",name:"stats",access:"read",description:"搜狐号文章数据（每篇阅读/评论/播放等全量运营指标；点赞/分享/投票仅覆盖最近30天已发布内容）",domain:"mp.sohu.com",strategy:G.COOKIE,browser:!0,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","public_url","published_at","status","views","likes","comments","collects","shares","video_plays","votes","extra"],func:async(O,H)=>{if(!O)throw new R("搜狐号文章数据需要浏览器会话");const J=Number(H.limit)>0?Math.floor(Number(H.limit)):20;await T(O,_);const Q={limit:J,pageSize:v,startDate:Z(30),endDate:Z(0)},z=await O.evaluate(`(async () => {
-            const P = ${JSON.stringify(Q)};
+import{cli as I,Strategy as b}from"@jackwener/opencli/registry";import{CommandExecutionError as g,EmptyResultError as S}from"@jackwener/opencli/errors";import{gotoWritePage as j}from"../_shared/article/publish.js";const v="https://mp.sohu.com/mpfe/v4/contentManagement/news/articlelist",C=10;function f(c){if(!c)return"";const a=new Date(c+28800000),n=(i)=>String(i).padStart(2,"0");return`${a.getUTCFullYear()}-${n(a.getUTCMonth()+1)}-${n(a.getUTCDate())} ${n(a.getUTCHours())}:${n(a.getUTCMinutes())}`}function w(c){const a=new Date(Date.now()+28800000-c*86400000),n=(i)=>String(i).padStart(2,"0");return`${a.getUTCFullYear()}-${n(a.getUTCMonth()+1)}-${n(a.getUTCDate())}`}I({site:"sohu",name:"stats",access:"read",description:"搜狐号文章数据（每篇阅读/评论/播放等全量运营指标；点赞/分享/投票仅覆盖最近30天已发布内容）",domain:"mp.sohu.com",strategy:b.COOKIE,browser:!0,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","public_url","published_at","status","views","likes","comments","collects","shares","video_plays","votes","extra"],func:async(c,a)=>{if(!c)throw new g("搜狐号文章数据需要浏览器会话");const n=Number(a.limit)>0?Math.floor(Number(a.limit)):20;await j(c,v);const i={limit:n,pageSize:C,startDate:w(30),endDate:w(0)},e=await c.evaluate(`(async () => {
+            const P = ${JSON.stringify(i)};
 
             // ── 请求头：dv-id / sp-cm 优先取页面自己存的值，逐字复刻 ──
             let dvId = '', spCm = '';
@@ -105,4 +105,4 @@ import{cli as C,Strategy as G}from"@jackwener/opencli/registry";import{CommandEx
             }
 
             return { accountId, news: news.slice(0, P.limit), totalCount: total, publishedIds, statRows, statError, channelMap };
-        })()`);if(!z||z.err)throw new R(z&&z.err||"搜狐号文章数据获取失败：页面未返回任何数据（请确认已登录 mp.sohu.com）");const X=Array.isArray(z.news)?z.news:[];if(!X.length)throw new P("sohu stats","该搜狐号名下没有任何内容（或列表接口返回为空）。请先在 mp.sohu.com 发布内容后再查数据。");const Y=new Map,$=new Map;for(const q of Array.isArray(z.statRows)?z.statRows:[]){if(q&&q.id!=null)Y.set(String(q.id),q);if(q&&typeof q.title==="string"&&q.title)$.set(q.title,q)}const U=(q,K)=>{if(!q)return"";for(const M of K)if(typeof q[M]==="number")return q[M];return""},A=new Set(Array.isArray(z.publishedIds)?z.publishedIds:[]);return X.map((q)=>{const K=q.id!=null?String(q.id):"",M=Y.get(K)||$.get(q.title||"")||null,V=A.has(K),F={};if(q.auditStatus!=null)F.audit_status=q.auditStatus;if(q.status!=null)F.status_raw=q.status;if(q.rejectReason)F.reject_reason=q.rejectReason;if(q.original!=null)F.original=q.original;if(q.star!=null)F.star=q.star;if(q.secureScore!=null)F.secure_score=q.secureScore;if(q.channelId!=null){const L=z.channelMap&&z.channelMap[String(q.channelId)]||"";F.display_channel=L?L+"("+q.channelId+")":String(q.channelId);F.display_channel_note="搜狐后台按内容自动归类的展示频道，可能与发布时 --channel 所选不同"}if(q.modifiedTime)F.modified_at=W(q.modifiedTime);if(q.brief)F.brief=String(q.brief).slice(0,80);if(M)F.stat=M;if(z.statError)F.stat_error="单篇统计接口失败："+z.statError;return{id:K,type:q.type!=null?String(q.type):"",title:q.title||q.mobileTitle||"",url:K?"https://mp.sohu.com/mpfe/v4/contentManagement/news/addarticle?spm=smmp.articlelist.0.0&contentStatus="+(V?1:2)+"&id="+K:"",public_url:K&&V&&z.accountId?"https://www.sohu.com/a/"+K+"_"+z.accountId:"",published_at:W(q.postTime||q.createdTime),status:V?"已发布":"未发布",views:typeof q.pv==="number"?q.pv:"",likes:U(M,["digg","diggCount","like","likeCount","praise","zan"]),comments:typeof q.cmt==="number"?q.cmt:U(M,["cmt","comment","commentCount"]),collects:"",shares:U(M,["share","shareCount","forward","forwardCount"]),video_plays:typeof q.videoPlayPv==="number"?q.videoPlayPv:"",votes:U(M,["vote","voteCount"]),extra:Object.keys(F).length?JSON.stringify(F):""}})}});
+        })()`);if(!e||e.err)throw new g(e&&e.err||"搜狐号文章数据获取失败：页面未返回任何数据（请确认已登录 mp.sohu.com）");const d=Array.isArray(e.news)?e.news:[];if(!d.length)throw new S("sohu stats","该搜狐号名下没有任何内容（或列表接口返回为空）。请先在 mp.sohu.com 发布内容后再查数据。");const p=new Map,m=new Map;for(const t of Array.isArray(e.statRows)?e.statRows:[]){if(t&&t.id!=null)p.set(String(t.id),t);if(t&&typeof t.title==="string"&&t.title)m.set(t.title,t)}const l=(t,o)=>{if(!t)return"";for(const r of o)if(typeof t[r]==="number")return t[r];return""},y=new Set(Array.isArray(e.publishedIds)?e.publishedIds:[]);return d.map((t)=>{const o=t.id!=null?String(t.id):"",r=p.get(o)||m.get(t.title||"")||null,u=y.has(o),s={};if(t.auditStatus!=null)s.audit_status=t.auditStatus;if(t.status!=null)s.status_raw=t.status;if(t.rejectReason)s.reject_reason=t.rejectReason;if(t.original!=null)s.original=t.original;if(t.star!=null)s.star=t.star;if(t.secureScore!=null)s.secure_score=t.secureScore;if(t.channelId!=null){const h=e.channelMap&&e.channelMap[String(t.channelId)]||"";s.display_channel=h?h+"("+t.channelId+")":String(t.channelId);s.display_channel_note="搜狐后台按内容自动归类的展示频道，可能与发布时 --channel 所选不同"}if(t.modifiedTime)s.modified_at=f(t.modifiedTime);if(t.brief)s.brief=String(t.brief).slice(0,80);if(r)s.stat=r;if(e.statError)s.stat_error="单篇统计接口失败："+e.statError;return{id:o,type:t.type!=null?String(t.type):"",title:t.title||t.mobileTitle||"",url:o?"https://mp.sohu.com/mpfe/v4/contentManagement/news/addarticle?spm=smmp.articlelist.0.0&contentStatus="+(u?1:2)+"&id="+o:"",public_url:o&&u&&e.accountId?"https://www.sohu.com/a/"+o+"_"+e.accountId:"",published_at:f(t.postTime||t.createdTime),status:u?"已发布":"未发布",views:typeof t.pv==="number"?t.pv:"",likes:l(r,["digg","diggCount","like","likeCount","praise","zan"]),comments:typeof t.cmt==="number"?t.cmt:l(r,["cmt","comment","commentCount"]),collects:"",shares:l(r,["share","shareCount","forward","forwardCount"]),video_plays:typeof t.videoPlayPv==="number"?t.videoPlayPv:"",votes:l(r,["vote","voteCount"]),extra:Object.keys(s).length?JSON.stringify(s):""}})}});

package/clis/sohu/topics.js

@@ -1 +1 @@
-import{cli as G,Strategy as I}from"@jackwener/opencli/registry";import{CommandExecutionError as K}from"@jackwener/opencli/errors";import{gotoWritePage as L}from"../_shared/article/publish.js";import{sohuProfile as N}from"./article.js";import{SOHU_MPBP_HEADERS_JS as Q}from"./mpbp.js";G({site:"sohu",name:"topics",access:"read",description:"列举/搜索搜狐号话题（id + 名称 + 类型），供 `sohu article --topics` 取确切话题名。不传 --keyword 为推荐话题，传则按关键词搜索。",domain:"mp.sohu.com",strategy:I.COOKIE,browser:!0,args:[{name:"keyword",help:"搜索关键词；不传则返回推荐话题列表"}],columns:["topic_id","topic_name","topic_type"],func:async(q,v)=>{if(!q)throw new K("搜狐号话题列举需要浏览器会话");const F=typeof v.keyword==="string"?v.keyword.trim():"";await L(q,N.home);const z=await q.evaluate("(async () => {"+Q+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const kw = "+JSON.stringify(F)+";const url = kw  ? 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/search?accountId=' + accountId + '&keyword=' + encodeURIComponent(kw)  : 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/list?accountId=' + accountId;const r = await fetch(url, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('话题接口失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(t => ({ topic_id: String(t.id), topic_name: t.name || '', topic_type: t.type != null ? String(t.type) : '' }));})()");return Array.isArray(z)?z:[]}});
+import{cli as c,Strategy as e}from"@jackwener/opencli/registry";import{CommandExecutionError as n}from"@jackwener/opencli/errors";import{gotoWritePage as i}from"../_shared/article/publish.js";import{sohuProfile as s}from"./article.js";import{SOHU_MPBP_HEADERS_JS as d}from"./mpbp.js";c({site:"sohu",name:"topics",access:"read",description:"列举/搜索搜狐号话题（id + 名称 + 类型），供 `sohu article --topics` 取确切话题名。不传 --keyword 为推荐话题，传则按关键词搜索。",domain:"mp.sohu.com",strategy:e.COOKIE,browser:!0,args:[{name:"keyword",help:"搜索关键词；不传则返回推荐话题列表"}],columns:["topic_id","topic_name","topic_type"],func:async(t,o)=>{if(!t)throw new n("搜狐号话题列举需要浏览器会话");const r=typeof o.keyword==="string"?o.keyword.trim():"";await i(t,s.home);const a=await t.evaluate("(async () => {"+d+"const ar = await fetch('https://mp.sohu.com/mpbp/bp/account/list?_=' + Date.now(), { method: 'GET', credentials: 'include', headers: HDRS });const aj = await ar.json();"+"if (!aj || aj.code !== 2000000 || !(aj.data && aj.data.data && aj.data.data.length)) throw new Error('获取搜狐账号失败，请确认已登录搜狐号');"+"let accountId = '';for (const g of aj.data.data) { if (g.accounts && g.accounts.length) { accountId = String(g.accounts[0].id); break; } }"+"if (!accountId) throw new Error('搜狐号子账号列表为空');"+"const kw = "+JSON.stringify(r)+";const url = kw  ? 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/search?accountId=' + accountId + '&keyword=' + encodeURIComponent(kw)  : 'https://mp.sohu.com/mpbp/bp/news/v4/label/topic/list?accountId=' + accountId;const r = await fetch(url, { method: 'GET', credentials: 'include', headers: HDRS });const j = await r.json();"+"if (!j || j.success === false) throw new Error('话题接口失败：' + ((j && j.msg) || '未登录或无权限'));"+"const list = Array.isArray(j) ? j : ((j && j.data) || []);return list.map(t => ({ topic_id: String(t.id), topic_name: t.name || '', topic_type: t.type != null ? String(t.type) : '' }));})()");return Array.isArray(a)?a:[]}});

package/clis/sohu/whoami.js

@@ -1 +1 @@
-import{cli as q,Strategy as v}from"@jackwener/opencli/registry";import{checkLogin as x,cookieQuickCheck as z}from"../_shared/article/auth.js";import{sohuAuthProfile as B}from"./article.js";q({site:"sohu",name:"whoami",access:"read",description:"查看当前搜狐号登录账号信息（用户名、用户 ID）。",domain:"mp.sohu.com",strategy:v.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:z("https://mp.sohu.com",["pprdig"])},func:async(m)=>{const b=await x(m,B);return[{logged_in:b.isAuthenticated,user_id:b.userId||"",username:b.username||""}]}});
+import{cli as r,Strategy as i}from"@jackwener/opencli/registry";import{checkLogin as s,cookieQuickCheck as t}from"../_shared/article/auth.js";import{sohuAuthProfile as u}from"./article.js";r({site:"sohu",name:"whoami",access:"read",description:"查看当前搜狐号登录账号信息（用户名、用户 ID）。",domain:"mp.sohu.com",strategy:i.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:t("https://mp.sohu.com",["pprdig"])},func:async(o)=>{const e=await s(o,u);return[{logged_in:e.isAuthenticated,user_id:e.userId||"",username:e.username||""}]}});

package/clis/spotify/spotify.js

@@ -1 +1 @@
-import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{CliError as Z}from"@jackwener/opencli/errors";import{readFileSync as q,writeFileSync as j,mkdirSync as R,existsSync as f}from"fs";import{createServer as h}from"http";import{homedir as P}from"os";import{join as x}from"path";import{exec as m}from"child_process";import{assertSpotifyCredentialsConfigured as I,getFirstSpotifyTrack as v,mapSpotifyTrackResults as p,parseDotEnv as u,resolveSpotifyCredentials as C}from"./utils.js";const K=x(P(),".ppcli","spotify.env");function w(){if(!f(K))return{};return u(q(K,"utf-8"))}const T=w(),O=C(T),V=O.clientId,D=O.clientSecret,U="http://127.0.0.1:8888/callback",S=["user-read-playback-state","user-modify-playback-state","user-read-currently-playing","playlist-read-private"].join(" "),F=x(P(),".ppcli","spotify-tokens.json");function y(){try{return JSON.parse(q(F,"utf-8"))}catch{return null}}function L(z){R(x(P(),".ppcli"),{recursive:!0});j(F,JSON.stringify(z,null,2))}async function E(z){const G=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${V}:${D}`).toString("base64")},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:z})});if(!G.ok){const J=await G.json().catch(()=>({}));throw new Z("REFRESH_FAILED",J?.error_description||`Token refresh failed (${G.status})`)}const H=await G.json(),M={access_token:H.access_token,refresh_token:H.refresh_token||z,expires_at:Date.now()+H.expires_in*1000};L(M);return M.access_token}async function g(){const z=y();if(!z)throw new Z("AUTH_REQUIRED","Not authenticated. Run: ppcli spotify auth");if(!z.access_token||!z.refresh_token||!(z.expires_at>0))throw new Z("AUTH_CORRUPTED","Token file is corrupted. Run: ppcli spotify auth");if(Date.now()>z.expires_at-60000)return E(z.refresh_token);return z.access_token}async function Q(z,G,H){const M=await g(),J=await fetch(`https://api.spotify.com/v1${G}`,{method:z,headers:{Authorization:`Bearer ${M}`,"Content-Type":"application/json"},body:H?JSON.stringify(H):void 0});if(J.status===204||J.status===202)return null;if(!J.ok){const W=await J.json().catch(()=>({}));throw new Z("API_ERROR",W?.error?.message||`Spotify API error ${J.status}`)}return J.json()}async function N(z){const G=await Q("GET",`/search?q=${encodeURIComponent(z)}&type=track&limit=1`),H=v(G);if(!H)throw new Z("EMPTY_RESULT",`No track found for: ${z}`);return H}function d(z){const G=process.platform==="win32"?`start "" "${z}"`:process.platform==="darwin"?`open "${z}"`:`xdg-open "${z}"`;m(G)}X({site:"spotify",name:"auth",access:"write",description:"Authenticate with Spotify (OAuth — run once)",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{I(O,K);return new Promise((z,G)=>{const H=h(async(J,W)=>{try{const $=new URL(J.url,"http://localhost:8888");if($.pathname!=="/callback"){W.end();return}const b=$.searchParams.get("code");if(!b){W.end("Missing code");return}const A=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${V}:${D}`).toString("base64")},body:new URLSearchParams({grant_type:"authorization_code",code:b,redirect_uri:U})});if(!A.ok){const _=await A.json().catch(()=>({}));H.close();G(new Z("AUTH_FAILED",_?.error_description||`Token exchange failed (${A.status})`));return}const B=await A.json();L({access_token:B.access_token,refresh_token:B.refresh_token,expires_at:Date.now()+B.expires_in*1000});W.writeHead(200,{"Content-Type":"text/html"});W.end("<h2>Spotify authenticated! You can close this tab.</h2>");H.close();z([{status:"Authenticated successfully"}])}catch($){H.close();G($)}});H.on("error",(J)=>{if(J.code==="EADDRINUSE")G(new Z("PORT_IN_USE","Port 8888 is already in use. Stop the other process and retry."));else G(J)});const M=setTimeout(()=>{H.close();G(new Z("AUTH_TIMEOUT","Authentication timed out after 5 minutes"))},300000);H.listen(8888,()=>{const J=`https://accounts.spotify.com/authorize?${new URLSearchParams({client_id:V,response_type:"code",redirect_uri:U,scope:S})}`;console.log("Opening browser for Spotify login...");console.log("If it does not open, visit:",J);d(J)});H.on("close",()=>clearTimeout(M))})}});X({site:"spotify",name:"status",access:"read",description:"Show current playback status",strategy:Y.PUBLIC,browser:!1,args:[],columns:["track","artist","album","status","progress"],func:async()=>{const z=await Q("GET","/me/player");if(!z||!z.item)return[{track:"Nothing playing",artist:"",album:"",status:"",progress:""}];const G=z.item;if(G.type!=="track")return[{track:G.name,artist:"",album:G.show?.name??"",status:z.is_playing?"playing":"paused",progress:""}];const H=(z.progress_ms??0)/1000|0,M=G.duration_ms/1000|0,J=(W)=>`${W/60|0}:${String(W%60).padStart(2,"0")}`;return[{track:G.name,artist:G.artists.map((W)=>W.name).join(", "),album:G.album.name,status:z.is_playing?"playing":"paused",progress:`${J(H)} / ${J(M)}`}]}});X({site:"spotify",name:"play",access:"write",description:"Resume playback or search and play a track/artist",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",default:"",positional:!0,help:"Track or artist to play (optional)"}],columns:["track","artist","status"],func:async(z)=>{if(z.query){const{uri:G,name:H,artist:M}=await N(z.query);await Q("PUT","/me/player/play",{uris:[G]});return[{track:H,artist:M,status:"playing"}]}await Q("PUT","/me/player/play");return[{track:"",artist:"",status:"resumed"}]}});X({site:"spotify",name:"pause",access:"write",description:"Pause playback",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("PUT","/me/player/pause");return[{status:"paused"}]}});X({site:"spotify",name:"next",access:"write",description:"Skip to next track",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("POST","/me/player/next");return[{status:"skipped to next"}]}});X({site:"spotify",name:"prev",access:"write",description:"Skip to previous track",strategy:Y.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await Q("POST","/me/player/previous");return[{status:"skipped to previous"}]}});X({site:"spotify",name:"volume",access:"write",description:"Set playback volume (0-100)",strategy:Y.PUBLIC,browser:!1,args:[{name:"level",type:"int",default:50,positional:!0,required:!0,help:"Volume 0–100"}],columns:["volume"],func:async(z)=>{const G=Math.round(z.level);if(G<0||G>100)throw new Z("INVALID_ARGS","Volume must be between 0 and 100");await Q("PUT",`/me/player/volume?volume_percent=${G}`);return[{volume:`${G}%`}]}});X({site:"spotify",name:"search",access:"read",description:"Search for tracks",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (default: 10)"}],columns:["track","artist","album","uri"],func:async(z)=>{const G=Math.min(50,Math.max(1,Math.round(z.limit))),H=await Q("GET",`/search?q=${encodeURIComponent(z.query)}&type=track&limit=${G}`),M=p(H);if(!M.length)throw new Z("EMPTY_RESULT",`No results found for: ${z.query}`);return M}});X({site:"spotify",name:"queue",access:"write",description:"Add a track to the playback queue",strategy:Y.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Track to add to queue"}],columns:["track","artist","status"],func:async(z)=>{const{uri:G,name:H,artist:M}=await N(z.query);await Q("POST",`/me/player/queue?uri=${encodeURIComponent(G)}`);return[{track:H,artist:M,status:"added to queue"}]}});X({site:"spotify",name:"shuffle",access:"write",description:"Toggle shuffle on/off",strategy:Y.PUBLIC,browser:!1,args:[{name:"state",type:"str",default:"on",positional:!0,choices:["on","off"],help:"on or off"}],columns:["shuffle"],func:async(z)=>{await Q("PUT",`/me/player/shuffle?state=${z.state==="on"}`);return[{shuffle:z.state}]}});X({site:"spotify",name:"repeat",access:"write",description:"Set repeat mode (off / track / context)",strategy:Y.PUBLIC,browser:!1,args:[{name:"mode",type:"str",default:"context",positional:!0,choices:["off","track","context"],help:"off / track / context"}],columns:["repeat"],func:async(z)=>{await Q("PUT",`/me/player/repeat?state=${z.mode}`);return[{repeat:z.mode}]}});
+import{cli as i,Strategy as c}from"@jackwener/opencli/registry";import{CliError as u}from"@jackwener/opencli/errors";import{readFileSync as g,writeFileSync as E,mkdirSync as I,existsSync as R}from"fs";import{createServer as C}from"http";import{homedir as m}from"os";import{join as y}from"path";import{exec as v}from"child_process";import{assertSpotifyCredentialsConfigured as L,getFirstSpotifyTrack as x,mapSpotifyTrackResults as A,parseDotEnv as q,resolveSpotifyCredentials as B}from"./utils.js";const d=y(m(),".ppcli","spotify.env");function O(){if(!R(d))return{};return q(g(d,"utf-8"))}const N=O(),h=B(N),w=h.clientId,_=h.clientSecret,T="http://127.0.0.1:8888/callback",D=["user-read-playback-state","user-modify-playback-state","user-read-currently-playing","playlist-read-private"].join(" "),S=y(m(),".ppcli","spotify-tokens.json");function F(){try{return JSON.parse(g(S,"utf-8"))}catch{return null}}function U(t){I(y(m(),".ppcli"),{recursive:!0});E(S,JSON.stringify(t,null,2))}async function M(t){const e=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${w}:${_}`).toString("base64")},body:new URLSearchParams({grant_type:"refresh_token",refresh_token:t})});if(!e.ok){const r=await e.json().catch(()=>({}));throw new u("REFRESH_FAILED",r?.error_description||`Token refresh failed (${e.status})`)}const s=await e.json(),a={access_token:s.access_token,refresh_token:s.refresh_token||t,expires_at:Date.now()+s.expires_in*1000};U(a);return a.access_token}async function j(){const t=F();if(!t)throw new u("AUTH_REQUIRED","Not authenticated. Run: ppcli spotify auth");if(!t.access_token||!t.refresh_token||!(t.expires_at>0))throw new u("AUTH_CORRUPTED","Token file is corrupted. Run: ppcli spotify auth");if(Date.now()>t.expires_at-60000)return M(t.refresh_token);return t.access_token}async function o(t,e,s){const a=await j(),r=await fetch(`https://api.spotify.com/v1${e}`,{method:t,headers:{Authorization:`Bearer ${a}`,"Content-Type":"application/json"},body:s?JSON.stringify(s):void 0});if(r.status===204||r.status===202)return null;if(!r.ok){const n=await r.json().catch(()=>({}));throw new u("API_ERROR",n?.error?.message||`Spotify API error ${r.status}`)}return r.json()}async function P(t){const e=await o("GET",`/search?q=${encodeURIComponent(t)}&type=track&limit=1`),s=x(e);if(!s)throw new u("EMPTY_RESULT",`No track found for: ${t}`);return s}function H(t){const e=process.platform==="win32"?`start "" "${t}"`:process.platform==="darwin"?`open "${t}"`:`xdg-open "${t}"`;v(e)}i({site:"spotify",name:"auth",access:"write",description:"Authenticate with Spotify (OAuth — run once)",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{L(h,d);return new Promise((t,e)=>{const s=C(async(r,n)=>{try{const p=new URL(r.url,"http://localhost:8888");if(p.pathname!=="/callback"){n.end();return}const k=p.searchParams.get("code");if(!k){n.end("Missing code");return}const l=await fetch("https://accounts.spotify.com/api/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded",Authorization:"Basic "+Buffer.from(`${w}:${_}`).toString("base64")},body:new URLSearchParams({grant_type:"authorization_code",code:k,redirect_uri:T})});if(!l.ok){const b=await l.json().catch(()=>({}));s.close();e(new u("AUTH_FAILED",b?.error_description||`Token exchange failed (${l.status})`));return}const f=await l.json();U({access_token:f.access_token,refresh_token:f.refresh_token,expires_at:Date.now()+f.expires_in*1000});n.writeHead(200,{"Content-Type":"text/html"});n.end("<h2>Spotify authenticated! You can close this tab.</h2>");s.close();t([{status:"Authenticated successfully"}])}catch(p){s.close();e(p)}});s.on("error",(r)=>{if(r.code==="EADDRINUSE")e(new u("PORT_IN_USE","Port 8888 is already in use. Stop the other process and retry."));else e(r)});const a=setTimeout(()=>{s.close();e(new u("AUTH_TIMEOUT","Authentication timed out after 5 minutes"))},300000);s.listen(8888,()=>{const r=`https://accounts.spotify.com/authorize?${new URLSearchParams({client_id:w,response_type:"code",redirect_uri:T,scope:D})}`;console.log("Opening browser for Spotify login...");console.log("If it does not open, visit:",r);H(r)});s.on("close",()=>clearTimeout(a))})}});i({site:"spotify",name:"status",access:"read",description:"Show current playback status",strategy:c.PUBLIC,browser:!1,args:[],columns:["track","artist","album","status","progress"],func:async()=>{const t=await o("GET","/me/player");if(!t||!t.item)return[{track:"Nothing playing",artist:"",album:"",status:"",progress:""}];const e=t.item;if(e.type!=="track")return[{track:e.name,artist:"",album:e.show?.name??"",status:t.is_playing?"playing":"paused",progress:""}];const s=(t.progress_ms??0)/1000|0,a=e.duration_ms/1000|0,r=(n)=>`${n/60|0}:${String(n%60).padStart(2,"0")}`;return[{track:e.name,artist:e.artists.map((n)=>n.name).join(", "),album:e.album.name,status:t.is_playing?"playing":"paused",progress:`${r(s)} / ${r(a)}`}]}});i({site:"spotify",name:"play",access:"write",description:"Resume playback or search and play a track/artist",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",default:"",positional:!0,help:"Track or artist to play (optional)"}],columns:["track","artist","status"],func:async(t)=>{if(t.query){const{uri:e,name:s,artist:a}=await P(t.query);await o("PUT","/me/player/play",{uris:[e]});return[{track:s,artist:a,status:"playing"}]}await o("PUT","/me/player/play");return[{track:"",artist:"",status:"resumed"}]}});i({site:"spotify",name:"pause",access:"write",description:"Pause playback",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("PUT","/me/player/pause");return[{status:"paused"}]}});i({site:"spotify",name:"next",access:"write",description:"Skip to next track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/next");return[{status:"skipped to next"}]}});i({site:"spotify",name:"prev",access:"write",description:"Skip to previous track",strategy:c.PUBLIC,browser:!1,args:[],columns:["status"],func:async()=>{await o("POST","/me/player/previous");return[{status:"skipped to previous"}]}});i({site:"spotify",name:"volume",access:"write",description:"Set playback volume (0-100)",strategy:c.PUBLIC,browser:!1,args:[{name:"level",type:"int",default:50,positional:!0,required:!0,help:"Volume 0–100"}],columns:["volume"],func:async(t)=>{const e=Math.round(t.level);if(e<0||e>100)throw new u("INVALID_ARGS","Volume must be between 0 and 100");await o("PUT",`/me/player/volume?volume_percent=${e}`);return[{volume:`${e}%`}]}});i({site:"spotify",name:"search",access:"read",description:"Search for tracks",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (default: 10)"}],columns:["track","artist","album","uri"],func:async(t)=>{const e=Math.min(50,Math.max(1,Math.round(t.limit))),s=await o("GET",`/search?q=${encodeURIComponent(t.query)}&type=track&limit=${e}`),a=A(s);if(!a.length)throw new u("EMPTY_RESULT",`No results found for: ${t.query}`);return a}});i({site:"spotify",name:"queue",access:"write",description:"Add a track to the playback queue",strategy:c.PUBLIC,browser:!1,args:[{name:"query",type:"str",required:!0,positional:!0,help:"Track to add to queue"}],columns:["track","artist","status"],func:async(t)=>{const{uri:e,name:s,artist:a}=await P(t.query);await o("POST",`/me/player/queue?uri=${encodeURIComponent(e)}`);return[{track:s,artist:a,status:"added to queue"}]}});i({site:"spotify",name:"shuffle",access:"write",description:"Toggle shuffle on/off",strategy:c.PUBLIC,browser:!1,args:[{name:"state",type:"str",default:"on",positional:!0,choices:["on","off"],help:"on or off"}],columns:["shuffle"],func:async(t)=>{await o("PUT",`/me/player/shuffle?state=${t.state==="on"}`);return[{shuffle:t.state}]}});i({site:"spotify",name:"repeat",access:"write",description:"Set repeat mode (off / track / context)",strategy:c.PUBLIC,browser:!1,args:[{name:"mode",type:"str",default:"context",positional:!0,choices:["off","track","context"],help:"off / track / context"}],columns:["repeat"],func:async(t)=>{await o("PUT",`/me/player/repeat?state=${t.mode}`);return[{repeat:t.mode}]}});

package/clis/stackoverflow/read.js

@@ -1,13 +1,13 @@
-import{cli as h,Strategy as x}from"@jackwener/opencli/registry";import{ArgumentError as f,CommandExecutionError as G,EmptyResultError as B}from"@jackwener/opencli/errors";const O="https://api.stackexchange.com/2.3",R="stackoverflow",M=100;async function X(F,H){let V;try{V=await fetch(F)}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new G(`Network failure fetching ${H}: ${$}`,"Check connectivity to api.stackexchange.com")}if(V.status===404)throw new B(H,`${H} not found`);if(!V.ok)throw new G(`Stack Exchange API HTTP ${V.status} for ${H}`,"Check the question id and quota (300/day per IP)");let K;try{K=await V.json()}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new G(`Malformed JSON from Stack Exchange API for ${H}: ${$}`,"The API returned a non-JSON body — likely a transient outage")}if(K&&K.error_id)throw new G(`Stack Exchange API error ${K.error_id} (${K.error_name}) for ${H}: ${K.error_message||""}`,"Common causes: invalid filter, throttled, or quota exhausted");return K}function v(F){if(F===void 0||F===null||F==="")return NaN;const H=typeof F==="number"?F:Number(F);return Number.isFinite(H)&&Number.isInteger(H)?H:NaN}function A(F,H,V){const K=v(F);if(!Number.isInteger(K)||K<H)throw new f(`${V} must be an integer >= ${H}, got ${JSON.stringify(F)}`);return K}function C(F,H,V,K){const Y=v(F);if(!Number.isInteger(Y)||Y<H||Y>V)throw new f(`${K} must be an integer between ${H} and ${V}, got ${JSON.stringify(F)}`);return Y}function E(F,H){const V=F.accepted_answer_id;return H.slice().sort((K,Y)=>{const $=K.is_accepted||V&&K.answer_id===V,W=Y.is_accepted||V&&Y.answer_id===V;if($!==W)return $?-1:1;return(Y.score??0)-(K.score??0)})}async function u(F,H,V){const K=F.accepted_answer_id;if(!K||H.some((W)=>W.answer_id===K))return H;const $=((await X(`${O}/answers/${K}?site=${R}&filter=withbody`,`${V}/accepted-answer`)).items||[])[0];return $?H.concat($):H}async function w(F,H,V){const K=new Map;if(F.length===0)return K;const Y=F.map((Q)=>Q.answer_id).join(";"),$=Math.min(M,F.length*H),W=await X(`${O}/answers/${Y}/comments?site=${R}&filter=withbody&order=asc&sort=creation&pagesize=${$}`,`${V}/answer-comments`);for(const Q of W.items||[]){if(!Q.post_id)continue;if(!K.has(Q.post_id))K.set(Q.post_id,[]);K.get(Q.post_id).push(Q)}if(W.has_more){if(F.some((z)=>{return(K.get(z.answer_id)||[]).length<H}))throw new G(`Stack Exchange answer comments for ${V} exceed one API page`,"Lower --answers-limit or --comments-limit; refusing to return a partial answer-comment set.")}return K}const d={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",hellip:"…",mdash:"—",ndash:"–",laquo:"«",raquo:"»",copy:"©",reg:"®",trade:"™",euro:"€",pound:"£",yen:"¥",rsquo:"’",lsquo:"‘",rdquo:"”",ldquo:"“"};function L(F){if(!F)return"";return String(F).replace(/&#x([0-9a-fA-F]+);/g,(H,V)=>{const K=parseInt(V,16);return Number.isFinite(K)?String.fromCodePoint(K):""}).replace(/&#(\d+);/g,(H,V)=>{const K=parseInt(V,10);return Number.isFinite(K)?String.fromCodePoint(K):""}).replace(/&([a-zA-Z]+);/g,(H,V)=>d[V]??H)}function Z(F){if(!F)return"";const H=String(F).replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi,`
+import{cli as v,Strategy as F}from"@jackwener/opencli/registry";import{ArgumentError as _,CommandExecutionError as u,EmptyResultError as E}from"@jackwener/opencli/errors";const p="https://api.stackexchange.com/2.3",f="stackoverflow",A=100;async function w(e,t){let r;try{r=await fetch(e)}catch(o){const s=o instanceof Error?o.message:String(o);throw new u(`Network failure fetching ${t}: ${s}`,"Check connectivity to api.stackexchange.com")}if(r.status===404)throw new E(t,`${t} not found`);if(!r.ok)throw new u(`Stack Exchange API HTTP ${r.status} for ${t}`,"Check the question id and quota (300/day per IP)");let n;try{n=await r.json()}catch(o){const s=o instanceof Error?o.message:String(o);throw new u(`Malformed JSON from Stack Exchange API for ${t}: ${s}`,"The API returned a non-JSON body — likely a transient outage")}if(n&&n.error_id)throw new u(`Stack Exchange API error ${n.error_id} (${n.error_name}) for ${t}: ${n.error_message||""}`,"Common causes: invalid filter, throttled, or quota exhausted");return n}function k(e){if(e===void 0||e===null||e==="")return NaN;const t=typeof e==="number"?e:Number(e);return Number.isFinite(t)&&Number.isInteger(t)?t:NaN}function j(e,t,r){const n=k(e);if(!Number.isInteger(n)||n<t)throw new _(`${r} must be an integer >= ${t}, got ${JSON.stringify(e)}`);return n}function N(e,t,r,n){const o=k(e);if(!Number.isInteger(o)||o<t||o>r)throw new _(`${n} must be an integer between ${t} and ${r}, got ${JSON.stringify(e)}`);return o}function z(e,t){const r=e.accepted_answer_id;return t.slice().sort((n,o)=>{const s=n.is_accepted||r&&n.answer_id===r,d=o.is_accepted||r&&o.answer_id===r;if(s!==d)return s?-1:1;return(o.score??0)-(n.score??0)})}async function J(e,t,r){const n=e.accepted_answer_id;if(!n||t.some((d)=>d.answer_id===n))return t;const s=((await w(`${p}/answers/${n}?site=${f}&filter=withbody`,`${r}/accepted-answer`)).items||[])[0];return s?t.concat(s):t}async function L(e,t,r){const n=new Map;if(e.length===0)return n;const o=e.map((i)=>i.answer_id).join(";"),s=Math.min(A,e.length*t),d=await w(`${p}/answers/${o}/comments?site=${f}&filter=withbody&order=asc&sort=creation&pagesize=${s}`,`${r}/answer-comments`);for(const i of d.items||[]){if(!i.post_id)continue;if(!n.has(i.post_id))n.set(i.post_id,[]);n.get(i.post_id).push(i)}if(d.has_more){if(e.some((c)=>{return(n.get(c.answer_id)||[]).length<t}))throw new u(`Stack Exchange answer comments for ${r} exceed one API page`,"Lower --answers-limit or --comments-limit; refusing to return a partial answer-comment set.")}return n}const R={amp:"&",lt:"<",gt:">",quot:'"',apos:"'",nbsp:" ",hellip:"…",mdash:"—",ndash:"–",laquo:"«",raquo:"»",copy:"©",reg:"®",trade:"™",euro:"€",pound:"£",yen:"¥",rsquo:"’",lsquo:"‘",rdquo:"”",ldquo:"“"};function b(e){if(!e)return"";return String(e).replace(/&#x([0-9a-fA-F]+);/g,(t,r)=>{const n=parseInt(r,16);return Number.isFinite(n)?String.fromCodePoint(n):""}).replace(/&#(\d+);/g,(t,r)=>{const n=parseInt(r,10);return Number.isFinite(n)?String.fromCodePoint(n):""}).replace(/&([a-zA-Z]+);/g,(t,r)=>R[r]??t)}function l(e){if(!e)return"";const t=String(e).replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi,`
 $1
 `).replace(/<code[^>]*>(.*?)<\/code>/gi,"`$1`").replace(/<p[^>]*>/gi,`
 
 `).replace(/<\/p>/gi,"").replace(/<br\s*\/?>/gi,`
 `).replace(/<li[^>]*>/gi,`
-- `).replace(/<\/li>/gi,"").replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi,"$2 ($1)").replace(/<[^>]+>/g,"");return L(H).replace(/\n{3,}/g,`
+- `).replace(/<\/li>/gi,"").replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi,"$2 ($1)").replace(/<[^>]+>/g,"");return b(t).replace(/\n{3,}/g,`
 
-`).trim()}function J(F){return L(F?.display_name||"")||"[deleted]"}function D(F,H){if(!F||F.length<=H)return F||"";return F.slice(0,H)+" ... [truncated]"}function T(F,H){if(H===0)return F;const K=`${"  ".repeat(H)}> `;return F.split(`
-`).map((Y)=>K+Y).join(`
-`)}h({site:"stackoverflow",name:"read",access:"read",description:"Read a Stack Overflow question with answers and comments",domain:"stackoverflow.com",strategy:x.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"Stack Overflow question id (numeric, e.g. 79935770)"},{name:"answers-limit",type:"int",default:10,help:"Max answers to include (1-100; accepted answer always included first)"},{name:"comments-limit",type:"int",default:5,help:"Max comments per question/answer (1-100)"},{name:"max-length",type:"int",default:4000,help:"Max characters per body / answer / comment (min 100)"}],columns:["type","author","score","accepted","text"],func:async(F)=>{const H=String(F.id||"").trim();if(!/^\d+$/.test(H))throw new f(`Invalid Stack Overflow question id: ${F.id}`,"Pass a numeric id like 79935770");const V=C(F["answers-limit"]??10,1,M,"stackoverflow read --answers-limit"),K=C(F["comments-limit"]??5,1,M,"stackoverflow read --comments-limit"),Y=A(F["max-length"]??4000,100,"stackoverflow read --max-length"),$=`stackoverflow/${H}`,W=`${O}/questions/${H}?site=${R}&filter=withbody`,z=((await X(W,$)).items||[])[0];if(!z)throw new B($,"Question not found");const[P,q]=await Promise.all([X(`${O}/questions/${H}/comments?site=${R}&filter=withbody&order=asc&sort=creation&pagesize=${K}`,`${$}/comments`),X(`${O}/questions/${H}/answers?site=${R}&filter=withbody&order=desc&sort=votes&pagesize=${V}`,`${$}/answers`)]),g=await u(z,q.items||[],$),y=E(z,g).slice(0,V),_=await w(y,K,$),k=[],p=Z(z.body||""),S=[z.title||"",p,z.link||""].filter(Boolean);k.push({type:"POST",author:J(z.owner),score:z.score??0,accepted:"",text:D(S.join(`
+`).trim()}function h(e){return b(e?.display_name||"")||"[deleted]"}function g(e,t){if(!e||e.length<=t)return e||"";return e.slice(0,t)+" ... [truncated]"}function x(e,t){if(t===0)return e;const n=`${"  ".repeat(t)}> `;return e.split(`
+`).map((o)=>n+o).join(`
+`)}v({site:"stackoverflow",name:"read",access:"read",description:"Read a Stack Overflow question with answers and comments",domain:"stackoverflow.com",strategy:F.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"Stack Overflow question id (numeric, e.g. 79935770)"},{name:"answers-limit",type:"int",default:10,help:"Max answers to include (1-100; accepted answer always included first)"},{name:"comments-limit",type:"int",default:5,help:"Max comments per question/answer (1-100)"},{name:"max-length",type:"int",default:4000,help:"Max characters per body / answer / comment (min 100)"}],columns:["type","author","score","accepted","text"],func:async(e)=>{const t=String(e.id||"").trim();if(!/^\d+$/.test(t))throw new _(`Invalid Stack Overflow question id: ${e.id}`,"Pass a numeric id like 79935770");const r=N(e["answers-limit"]??10,1,A,"stackoverflow read --answers-limit"),n=N(e["comments-limit"]??5,1,A,"stackoverflow read --comments-limit"),o=j(e["max-length"]??4000,100,"stackoverflow read --max-length"),s=`stackoverflow/${t}`,d=`${p}/questions/${t}?site=${f}&filter=withbody`,c=((await w(d,s)).items||[])[0];if(!c)throw new E(s,"Question not found");const[q,C]=await Promise.all([w(`${p}/questions/${t}/comments?site=${f}&filter=withbody&order=asc&sort=creation&pagesize=${n}`,`${s}/comments`),w(`${p}/questions/${t}/answers?site=${f}&filter=withbody&order=desc&sort=votes&pagesize=${r}`,`${s}/answers`)]),P=await J(c,C.items||[],s),I=z(c,P).slice(0,r),M=await L(I,n,s),m=[],T=l(c.body||""),O=[c.title||"",T,c.link||""].filter(Boolean);m.push({type:"POST",author:h(c.owner),score:c.score??0,accepted:"",text:g(O.join(`
 
-`),Y)});const I=(P.items||[]).slice(0,K);for(const U of I){const j=T(Z(U.body||""),1);k.push({type:"Q-COMMENT",author:J(U.owner),score:U.score??0,accepted:"",text:D(j,Y)})}for(const U of y){k.push({type:"ANSWER",author:J(U.owner),score:U.score??0,accepted:U.is_accepted?"true":"",text:D(Z(U.body||""),Y)});const j=(_.get(U.answer_id)||[]).slice(0,K);for(const N of j){const b=T(Z(N.body||""),1);k.push({type:"A-COMMENT",author:J(N.owner),score:N.score??0,accepted:"",text:D(b,Y)})}}return k}});
+`),o)});const D=(q.items||[]).slice(0,n);for(const a of D){const y=x(l(a.body||""),1);m.push({type:"Q-COMMENT",author:h(a.owner),score:a.score??0,accepted:"",text:g(y,o)})}for(const a of I){m.push({type:"ANSWER",author:h(a.owner),score:a.score??0,accepted:a.is_accepted?"true":"",text:g(l(a.body||""),o)});const y=(M.get(a.answer_id)||[]).slice(0,n);for(const S of y){const B=x(l(S.body||""),1);m.push({type:"A-COMMENT",author:h(S.owner),score:S.score??0,accepted:"",text:g(B,o)})}}return m}});

package/clis/stackoverflow/related.js

@@ -1 +1 @@
-import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as a}from"@jackwener/opencli/errors";import{seFetch as w,normalizeLimit as f,epochToDate as n,ensureItems as p,decodeHtmlEntities as l}from"./utils.js";const r=["rank","activity","votes","creation"];u({site:"stackoverflow",name:"related",access:"read",description:"List Stack Overflow questions related to a given question id.",domain:"stackoverflow.com",strategy:m.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,type:"string",help:"Stack Overflow question id (numeric, e.g. 79935770)."},{name:"sort",type:"string",default:"rank",help:`Sort key: ${r.join(", ")} (rank = SO relevance default).`},{name:"limit",type:"int",default:20,help:"Max related questions (1-100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(t)=>{const i=String(t.id??"").trim();if(!/^\d+$/.test(i))throw new a(`stackoverflow related id must be a numeric question id, got ${JSON.stringify(t.id)}`);const s=String(t.sort??"rank").toLowerCase();if(!r.includes(s))throw new a(`stackoverflow related sort must be one of ${r.join(", ")}`);const o=f(t.limit,20,100,"limit"),c=await w(`/questions/${encodeURIComponent(i)}/related`,{searchParams:{order:"desc",sort:s,pagesize:o}});return p(c,`stackoverflow related ${i}`).slice(0,o).map((e,d)=>({rank:d+1,id:e.question_id,title:l(e.title||""),score:e.score??0,answers:e.answer_count??0,views:e.view_count??0,isAnswered:Boolean(e.is_answered),tags:Array.isArray(e.tags)?e.tags.join(", "):"",author:l(e.owner?.display_name||""),createdAt:n(e.creation_date),lastActivityAt:n(e.last_activity_date),url:e.link||(e.question_id?`https://stackoverflow.com/questions/${e.question_id}`:"")}))}});
+import{cli as m,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as a}from"@jackwener/opencli/errors";import{seFetch as w,normalizeLimit as f,epochToDate as n,ensureItems as v,decodeHtmlEntities as c}from"./utils.js";const r=["rank","activity","votes","creation"];m({site:"stackoverflow",name:"related",access:"read",description:"List Stack Overflow questions related to a given question id.",domain:"stackoverflow.com",strategy:u.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,type:"string",help:"Stack Overflow question id (numeric, e.g. 79935770)."},{name:"sort",type:"string",default:"rank",help:`Sort key: ${r.join(", ")} (rank = SO relevance default).`},{name:"limit",type:"int",default:20,help:"Max related questions (1-100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(t)=>{const i=String(t.id??"").trim();if(!/^\d+$/.test(i))throw new a(`stackoverflow related id must be a numeric question id, got ${JSON.stringify(t.id)}`);const s=String(t.sort??"rank").toLowerCase();if(!r.includes(s))throw new a(`stackoverflow related sort must be one of ${r.join(", ")}`);const o=f(t.limit,20,100,"limit"),l=await w(`/questions/${encodeURIComponent(i)}/related`,{searchParams:{order:"desc",sort:s,pagesize:o}});return v(l,`stackoverflow related ${i}`).slice(0,o).map((e,d)=>({rank:d+1,id:e.question_id,title:c(e.title||""),score:e.score??0,answers:e.answer_count??0,views:e.view_count??0,isAnswered:Boolean(e.is_answered),tags:Array.isArray(e.tags)?e.tags.join(", "):"",author:c(e.owner?.display_name||""),createdAt:n(e.creation_date),lastActivityAt:n(e.last_activity_date),url:e.link||(e.question_id?`https://stackoverflow.com/questions/${e.question_id}`:"")}))}});

package/clis/stackoverflow/tag.js

@@ -1 +1 @@
-import{cli as m,Strategy as g}from"@jackwener/opencli/registry";import{ArgumentError as u}from"@jackwener/opencli/errors";import{seFetch as d,normalizeLimit as w,requireString as v,epochToDate as r,ensureItems as p,decodeHtmlEntities as n}from"./utils.js";const i=["activity","votes","creation","hot","week","month"];m({site:"stackoverflow",name:"tag",access:"read",description:"List Stack Overflow questions tagged with a given tag (most active first).",domain:"stackoverflow.com",strategy:g.PUBLIC,browser:!1,args:[{name:"tag",positional:!0,required:!0,type:"string",help:"Tag slug (e.g. python, rust, typescript)."},{name:"sort",type:"string",default:"activity",help:`Sort key: ${i.join(", ")}`},{name:"limit",type:"int",default:20,help:"Max questions to return (max 100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(e)=>{const s=v(e.tag,"tag").toLowerCase(),a=String(e.sort??"activity").toLowerCase();if(!i.includes(a))throw new u(`sort must be one of ${i.join(", ")}`);const o=w(e.limit,20,100,"limit"),c=await d("/questions",{searchParams:{tagged:s,order:"desc",sort:a,pagesize:o}});return p(c,`stackoverflow tag "${s}"`).slice(0,o).map((t,l)=>({rank:l+1,id:t.question_id,title:n(t.title||""),score:t.score??0,answers:t.answer_count??0,views:t.view_count??0,isAnswered:Boolean(t.is_answered),tags:Array.isArray(t.tags)?t.tags.join(", "):"",author:n(t.owner?.display_name||""),createdAt:r(t.creation_date),lastActivityAt:r(t.last_activity_date),url:t.link||(t.question_id?`https://stackoverflow.com/questions/${t.question_id}`:"")}))}});
+import{cli as m,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as d}from"@jackwener/opencli/errors";import{seFetch as g,normalizeLimit as w,requireString as p,epochToDate as r,ensureItems as y,decodeHtmlEntities as n}from"./utils.js";const i=["activity","votes","creation","hot","week","month"];m({site:"stackoverflow",name:"tag",access:"read",description:"List Stack Overflow questions tagged with a given tag (most active first).",domain:"stackoverflow.com",strategy:u.PUBLIC,browser:!1,args:[{name:"tag",positional:!0,required:!0,type:"string",help:"Tag slug (e.g. python, rust, typescript)."},{name:"sort",type:"string",default:"activity",help:`Sort key: ${i.join(", ")}`},{name:"limit",type:"int",default:20,help:"Max questions to return (max 100)."}],columns:["rank","id","title","score","answers","views","isAnswered","tags","author","createdAt","lastActivityAt","url"],func:async(e)=>{const s=p(e.tag,"tag").toLowerCase(),a=String(e.sort??"activity").toLowerCase();if(!i.includes(a))throw new d(`sort must be one of ${i.join(", ")}`);const o=w(e.limit,20,100,"limit"),c=await g("/questions",{searchParams:{tagged:s,order:"desc",sort:a,pagesize:o}});return y(c,`stackoverflow tag "${s}"`).slice(0,o).map((t,l)=>({rank:l+1,id:t.question_id,title:n(t.title||""),score:t.score??0,answers:t.answer_count??0,views:t.view_count??0,isAnswered:Boolean(t.is_answered),tags:Array.isArray(t.tags)?t.tags.join(", "):"",author:n(t.owner?.display_name||""),createdAt:r(t.creation_date),lastActivityAt:r(t.last_activity_date),url:t.link||(t.question_id?`https://stackoverflow.com/questions/${t.question_id}`:"")}))}});

package/clis/stackoverflow/user.js

@@ -1 +1 @@
-import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{seFetch as l,normalizeLimit as d,requireString as m,epochToDate as a,ensureItems as u,decodeHtmlEntities as r}from"./utils.js";n({site:"stackoverflow",name:"user",access:"read",description:"Find Stack Overflow users by display name (highest reputation first).",domain:"stackoverflow.com",strategy:c.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,type:"string",help:"Display name (or substring) to search."},{name:"limit",type:"int",default:10,help:"Max users to return (max 100)."}],columns:["userId","displayName","reputation","goldBadges","silverBadges","bronzeBadges","location","createdAt","lastAccessAt","url"],func:async(s)=>{const i=m(s.name,"name"),t=d(s.limit,10,100,"limit"),o=await l("/users",{searchParams:{inname:i,order:"desc",sort:"reputation",pagesize:t}});return u(o,"stackoverflow user").slice(0,t).map((e)=>({userId:e.user_id,displayName:r(e.display_name||""),reputation:e.reputation??0,goldBadges:e.badge_counts?.gold??0,silverBadges:e.badge_counts?.silver??0,bronzeBadges:e.badge_counts?.bronze??0,location:r(e.location||""),createdAt:a(e.creation_date),lastAccessAt:a(e.last_access_date),url:e.link||(e.user_id?`https://stackoverflow.com/users/${e.user_id}`:"")}))}});
+import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{seFetch as l,normalizeLimit as d,requireString as m,epochToDate as a,ensureItems as p,decodeHtmlEntities as r}from"./utils.js";n({site:"stackoverflow",name:"user",access:"read",description:"Find Stack Overflow users by display name (highest reputation first).",domain:"stackoverflow.com",strategy:c.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,type:"string",help:"Display name (or substring) to search."},{name:"limit",type:"int",default:10,help:"Max users to return (max 100)."}],columns:["userId","displayName","reputation","goldBadges","silverBadges","bronzeBadges","location","createdAt","lastAccessAt","url"],func:async(t)=>{const i=m(t.name,"name"),s=d(t.limit,10,100,"limit"),o=await l("/users",{searchParams:{inname:i,order:"desc",sort:"reputation",pagesize:s}});return p(o,"stackoverflow user").slice(0,s).map((e)=>({userId:e.user_id,displayName:r(e.display_name||""),reputation:e.reputation??0,goldBadges:e.badge_counts?.gold??0,silverBadges:e.badge_counts?.silver??0,bronzeBadges:e.badge_counts?.bronze??0,location:r(e.location||""),createdAt:a(e.creation_date),lastAccessAt:a(e.last_access_date),url:e.link||(e.user_id?`https://stackoverflow.com/users/${e.user_id}`:"")}))}});

package/clis/stackoverflow/utils.js

@@ -1 +1 @@
-import{ArgumentError as W,CommandExecutionError as O,EmptyResultError as X}from"@jackwener/opencli/errors";export const SE_API="https://api.stackexchange.com/2.3",SE_SITE="stackoverflow";const Z="opencli-stackoverflow (+https://github.com/jackwener/OpenCLI)";export function normalizeLimit(q,z,B,G="limit"){const F=Number(q??z);if(!Number.isInteger(F)||F<=0)throw new W(`${G} must be a positive integer`);if(F>B)throw new W(`${G} must be <= ${B}`);return F}export function requireString(q,z){const B=String(q??"").trim();if(!B)throw new W(`${z} cannot be empty`);return B}export async function seFetch(q,{searchParams:z}={}){const B=new URL(q.startsWith("http")?q:`${SE_API}${q.startsWith("/")?"":"/"}${q}`);if(z)for(const[F,Q]of Object.entries(z)){if(Q==null||Q==="")continue;B.searchParams.set(F,String(Q))}if(!B.searchParams.has("site"))B.searchParams.set("site",SE_SITE);let G;try{G=await fetch(B,{headers:{Accept:"application/json","Accept-Encoding":"gzip","User-Agent":Z}})}catch(F){throw new O(`stack exchange request failed: ${F?.message||F}`)}if(G.status===429)throw new O("stack exchange returned HTTP 429 (rate limited)","Wait a few seconds and retry, or lower --limit.");if(!G.ok){let F="";try{F=(await G.json())?.error_message||""}catch{}throw new O(`stack exchange HTTP ${G.status}: ${F||G.statusText}`)}let K;try{K=await G.json()}catch(F){throw new O(`stack exchange returned malformed JSON: ${F?.message||F}`)}if(K?.error_id)throw new O(`stack exchange API error: ${K.error_message||K.error_name}`,"Inspect the URL in a browser for the canonical error context.");return K}export function epochToDate(q){if(q==null||q==="")return"";const z=Number(q);if(!Number.isFinite(z)||z<=0)return"";return new Date(z*1000).toISOString().slice(0,10)}export function ensureItems(q,z){const B=Array.isArray(q?.items)?q.items:[];if(B.length===0)throw new X(z,`${z} returned no items.`);return B}const $={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&apos;":"'","&nbsp;":" "};export function decodeHtmlEntities(q){if(q==null)return"";return String(q).replace(/&#x([0-9a-fA-F]+);/g,(z,B)=>String.fromCodePoint(parseInt(B,16))).replace(/&#(\d+);/g,(z,B)=>String.fromCodePoint(parseInt(B,10))).replace(/&(amp|lt|gt|quot|#39|apos|nbsp);/g,(z)=>$[z]||z)}
+import{ArgumentError as a,CommandExecutionError as i,EmptyResultError as m}from"@jackwener/opencli/errors";export const SE_API="https://api.stackexchange.com/2.3",SE_SITE="stackoverflow";const u="opencli-stackoverflow (+https://github.com/jackwener/OpenCLI)";export function normalizeLimit(t,e,r,o="limit"){const n=Number(t??e);if(!Number.isInteger(n)||n<=0)throw new a(`${o} must be a positive integer`);if(n>r)throw new a(`${o} must be <= ${r}`);return n}export function requireString(t,e){const r=String(t??"").trim();if(!r)throw new a(`${e} cannot be empty`);return r}export async function seFetch(t,{searchParams:e}={}){const r=new URL(t.startsWith("http")?t:`${SE_API}${t.startsWith("/")?"":"/"}${t}`);if(e)for(const[n,c]of Object.entries(e)){if(c==null||c==="")continue;r.searchParams.set(n,String(c))}if(!r.searchParams.has("site"))r.searchParams.set("site",SE_SITE);let o;try{o=await fetch(r,{headers:{Accept:"application/json","Accept-Encoding":"gzip","User-Agent":u}})}catch(n){throw new i(`stack exchange request failed: ${n?.message||n}`)}if(o.status===429)throw new i("stack exchange returned HTTP 429 (rate limited)","Wait a few seconds and retry, or lower --limit.");if(!o.ok){let n="";try{n=(await o.json())?.error_message||""}catch{}throw new i(`stack exchange HTTP ${o.status}: ${n||o.statusText}`)}let s;try{s=await o.json()}catch(n){throw new i(`stack exchange returned malformed JSON: ${n?.message||n}`)}if(s?.error_id)throw new i(`stack exchange API error: ${s.error_message||s.error_name}`,"Inspect the URL in a browser for the canonical error context.");return s}export function epochToDate(t){if(t==null||t==="")return"";const e=Number(t);if(!Number.isFinite(e)||e<=0)return"";return new Date(e*1000).toISOString().slice(0,10)}export function ensureItems(t,e){const r=Array.isArray(t?.items)?t.items:[];if(r.length===0)throw new m(e,`${e} returned no items.`);return r}const p={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&apos;":"'","&nbsp;":" "};export function decodeHtmlEntities(t){if(t==null)return"";return String(t).replace(/&#x([0-9a-fA-F]+);/g,(e,r)=>String.fromCodePoint(parseInt(r,16))).replace(/&#(\d+);/g,(e,r)=>String.fromCodePoint(parseInt(r,10))).replace(/&(amp|lt|gt|quot|#39|apos|nbsp);/g,(e)=>p[e]||e)}

package/clis/steam/app.js

@@ -1 +1 @@
-import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as u}from"@jackwener/opencli/errors";import{STEAM_STORE as s,decodeHtmlEntities as o,priceCents as f,requireAppId as g,requireCountryCode as y,steamFetch as b}from"./utils.js";function n(t){if(!Array.isArray(t))return"";return t.map((r)=>r&&typeof r==="object"?r.description??r.name??"":String(r)).filter(Boolean).join(", ")}d({site:"steam",name:"app",access:"read",description:"Steam storefront detail for a single app id",domain:"store.steampowered.com",strategy:l.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'Numeric Steam app id (e.g. "620" for Portal 2)'},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["id","name","type","isFree","releaseDate","developers","publishers","price","currency","metacritic","recommendations","genres","categories","shortDescription","website","url"],func:async(t)=>{const r=g(t.id),p=y(t.currency),c=`${s}/api/appdetails?appids=${r}&l=en&cc=${encodeURIComponent(p)}`,a=(await b(c,`steam app ${r}`))?.[r];if(!a||a.success!==!0||!a.data)throw new u("steam app",`Steam app id ${r} returned no data (may be region-locked or removed).`);const e=a.data,i=e.is_free===!0,m=f(e?.price_overview?.final??null);return[{id:String(e.steam_appid??r),name:o(e.name??""),type:String(e.type??""),isFree:i,releaseDate:String(e?.release_date?.date??""),developers:Array.isArray(e.developers)?e.developers.join(", "):"",publishers:Array.isArray(e.publishers)?e.publishers.join(", "):"",price:i?0:m,currency:String(e?.price_overview?.currency??"").toUpperCase(),metacritic:e?.metacritic?.score!=null?Number(e.metacritic.score):null,recommendations:e?.recommendations?.total!=null?Number(e.recommendations.total):null,genres:n(e.genres),categories:n(e.categories),shortDescription:o(e.short_description??""),website:String(e.website??""),url:`${s}/app/${e.steam_appid??r}/`}]}});
+import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as u}from"@jackwener/opencli/errors";import{STEAM_STORE as o,decodeHtmlEntities as s,priceCents as y,requireAppId as g,requireCountryCode as f,steamFetch as b}from"./utils.js";function n(t){if(!Array.isArray(t))return"";return t.map((r)=>r&&typeof r==="object"?r.description??r.name??"":String(r)).filter(Boolean).join(", ")}d({site:"steam",name:"app",access:"read",description:"Steam storefront detail for a single app id",domain:"store.steampowered.com",strategy:l.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'Numeric Steam app id (e.g. "620" for Portal 2)'},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["id","name","type","isFree","releaseDate","developers","publishers","price","currency","metacritic","recommendations","genres","categories","shortDescription","website","url"],func:async(t)=>{const r=g(t.id),c=f(t.currency),p=`${o}/api/appdetails?appids=${r}&l=en&cc=${encodeURIComponent(c)}`,i=(await b(p,`steam app ${r}`))?.[r];if(!i||i.success!==!0||!i.data)throw new u("steam app",`Steam app id ${r} returned no data (may be region-locked or removed).`);const e=i.data,a=e.is_free===!0,m=y(e?.price_overview?.final??null);return[{id:String(e.steam_appid??r),name:s(e.name??""),type:String(e.type??""),isFree:a,releaseDate:String(e?.release_date?.date??""),developers:Array.isArray(e.developers)?e.developers.join(", "):"",publishers:Array.isArray(e.publishers)?e.publishers.join(", "):"",price:a?0:m,currency:String(e?.price_overview?.currency??"").toUpperCase(),metacritic:e?.metacritic?.score!=null?Number(e.metacritic.score):null,recommendations:e?.recommendations?.total!=null?Number(e.recommendations.total):null,genres:n(e.genres),categories:n(e.categories),shortDescription:s(e.short_description??""),website:String(e.website??""),url:`${o}/app/${e.steam_appid??r}/`}]}});

package/clis/steam/search.js

@@ -1 +1 @@
-import{cli as u,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{STEAM_STORE as s,decodeHtmlEntities as d,priceCents as h,requireBoundedInt as y,requireCountryCode as f,requireString as w,steamFetch as S}from"./utils.js";function g(r){if(!r||typeof r!=="object")return"";return["windows","mac","linux"].filter((t)=>r[t]).join(",")}u({site:"steam",name:"search",access:"read",description:"Search the Steam storefront by name keyword",domain:"store.steampowered.com",strategy:p.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "portal", "stardew")'},{name:"limit",type:"int",default:20,help:"Max results (1-50)"},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["rank","id","name","price","currency","metascore","platforms","url"],func:async(r)=>{const t=w(r.query,"query"),n=y(r.limit,20,50),c=f(r.currency),i=`${s}/api/storesearch/?term=${encodeURIComponent(t)}&l=en&cc=${encodeURIComponent(c)}`,o=await S(i,"steam search"),a=Array.isArray(o?.items)?o.items:[];if(!a.length)throw new l("steam search",`No Steam results matched "${t}".`);return a.slice(0,n).map((e,m)=>({rank:m+1,id:String(e.id??""),name:d(e.name??""),price:h(e?.price?.final??null),currency:String(e?.price?.currency??"").toUpperCase(),metascore:e.metascore!=null&&e.metascore!==""?Number(e.metascore):null,platforms:g(e.platforms),url:e.id?`${s}/app/${e.id}/`:""}))}});
+import{cli as m,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as p}from"@jackwener/opencli/errors";import{STEAM_STORE as c,decodeHtmlEntities as d,priceCents as y,requireBoundedInt as f,requireCountryCode as h,requireString as S,steamFetch as w}from"./utils.js";function q(r){if(!r||typeof r!=="object")return"";return["windows","mac","linux"].filter((t)=>r[t]).join(",")}m({site:"steam",name:"search",access:"read",description:"Search the Steam storefront by name keyword",domain:"store.steampowered.com",strategy:l.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "portal", "stardew")'},{name:"limit",type:"int",default:20,help:"Max results (1-50)"},{name:"currency",default:"us",help:"Storefront country code (e.g. us / cn / jp / de)"}],columns:["rank","id","name","price","currency","metascore","platforms","url"],func:async(r)=>{const t=S(r.query,"query"),a=f(r.limit,20,50),s=h(r.currency),i=`${c}/api/storesearch/?term=${encodeURIComponent(t)}&l=en&cc=${encodeURIComponent(s)}`,n=await w(i,"steam search"),o=Array.isArray(n?.items)?n.items:[];if(!o.length)throw new p("steam search",`No Steam results matched "${t}".`);return o.slice(0,a).map((e,u)=>({rank:u+1,id:String(e.id??""),name:d(e.name??""),price:y(e?.price?.final??null),currency:String(e?.price?.currency??"").toUpperCase(),metascore:e.metascore!=null&&e.metascore!==""?Number(e.metascore):null,platforms:q(e.platforms),url:e.id?`${c}/app/${e.id}/`:""}))}});

package/clis/steam/utils.js

@@ -1 +1 @@
-import{ArgumentError as s,CommandExecutionError as a,EmptyResultError as u}from"@jackwener/opencli/errors";export const STEAM_STORE="https://store.steampowered.com";const c="opencli-steam-adapter (+https://github.com/jackwener/OpenCLI)";export function requireString(e,t){const r=String(e??"").trim();if(!r)throw new s(`steam ${t} cannot be empty`);return r}export function requireCountryCode(e,t="us"){const o=String(e===void 0||e===null?t:e).trim().toLowerCase();if(!/^[a-z]{2}$/.test(o))throw new s(`steam currency must be a two-letter storefront country code (got "${e}")`,"Examples: us, cn, jp, de. This controls Steam regional pricing and availability.");return o}export function requireBoundedInt(e,t,r,o="limit"){const n=e??t,i=typeof n==="number"?n:Number(n);if(!Number.isInteger(i)||i<=0)throw new s(`steam ${o} must be a positive integer`);if(i>r)throw new s(`steam ${o} must be <= ${r}`);return i}export function requireAppId(e){const t=String(e??"").trim();if(!t)throw new s('steam app id is required (e.g. "620" for Portal 2)');if(!/^\d+$/.test(t))throw new s(`steam app id "${e}" must be a positive integer`,"Copy the numeric id from `steam search` or the URL `store.steampowered.com/app/<id>/`.");return t}export async function steamFetch(e,t){let r;try{r=await fetch(e,{headers:{"user-agent":c,accept:"application/json"}})}catch(n){throw new a(`${t} request failed: ${n?.message??n}`,"Check that store.steampowered.com is reachable from this network.")}if(r.status===429)throw new a(`${t} returned HTTP 429 (rate limited)`,"Steam throttles bursty traffic; wait a few seconds and retry.");if(r.status===404)throw new u(t,"Steam returned 404 — the resource does not exist.");if(!r.ok)throw new a(`${t} returned HTTP ${r.status}`);let o;try{o=await r.json()}catch(n){throw new a(`${t} returned malformed JSON: ${n?.message??n}`)}return o}export function asString(e){return e==null?"":String(e)}const m={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&apos;":"'","&#39;":"'","&nbsp;":" "};export function decodeHtmlEntities(e){return String(e??"").replace(/&#x([0-9a-fA-F]+);/g,(t,r)=>String.fromCodePoint(parseInt(r,16))).replace(/&#(\d+);/g,(t,r)=>String.fromCodePoint(parseInt(r,10))).replace(/&(amp|lt|gt|quot|apos|#39|nbsp);/g,(t)=>m[t]||t)}export function priceCents(e){if(e==null||e==="")return null;const t=Number(e);if(!Number.isFinite(t))return null;return Number((t/100).toFixed(2))}
+import{ArgumentError as i,CommandExecutionError as a,EmptyResultError as u}from"@jackwener/opencli/errors";export const STEAM_STORE="https://store.steampowered.com";const c="opencli-steam-adapter (+https://github.com/jackwener/OpenCLI)";export function requireString(e,t){const r=String(e??"").trim();if(!r)throw new i(`steam ${t} cannot be empty`);return r}export function requireCountryCode(e,t="us"){const o=String(e===void 0||e===null?t:e).trim().toLowerCase();if(!/^[a-z]{2}$/.test(o))throw new i(`steam currency must be a two-letter storefront country code (got "${e}")`,"Examples: us, cn, jp, de. This controls Steam regional pricing and availability.");return o}export function requireBoundedInt(e,t,r,o="limit"){const n=e??t,s=typeof n==="number"?n:Number(n);if(!Number.isInteger(s)||s<=0)throw new i(`steam ${o} must be a positive integer`);if(s>r)throw new i(`steam ${o} must be <= ${r}`);return s}export function requireAppId(e){const t=String(e??"").trim();if(!t)throw new i('steam app id is required (e.g. "620" for Portal 2)');if(!/^\d+$/.test(t))throw new i(`steam app id "${e}" must be a positive integer`,"Copy the numeric id from `steam search` or the URL `store.steampowered.com/app/<id>/`.");return t}export async function steamFetch(e,t){let r;try{r=await fetch(e,{headers:{"user-agent":c,accept:"application/json"}})}catch(n){throw new a(`${t} request failed: ${n?.message??n}`,"Check that store.steampowered.com is reachable from this network.")}if(r.status===429)throw new a(`${t} returned HTTP 429 (rate limited)`,"Steam throttles bursty traffic; wait a few seconds and retry.");if(r.status===404)throw new u(t,"Steam returned 404 — the resource does not exist.");if(!r.ok)throw new a(`${t} returned HTTP ${r.status}`);let o;try{o=await r.json()}catch(n){throw new a(`${t} returned malformed JSON: ${n?.message??n}`)}return o}export function asString(e){return e==null?"":String(e)}const m={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&apos;":"'","&#39;":"'","&nbsp;":" "};export function decodeHtmlEntities(e){return String(e??"").replace(/&#x([0-9a-fA-F]+);/g,(t,r)=>String.fromCodePoint(parseInt(r,16))).replace(/&#(\d+);/g,(t,r)=>String.fromCodePoint(parseInt(r,10))).replace(/&(amp|lt|gt|quot|apos|#39|nbsp);/g,(t)=>m[t]||t)}export function priceCents(e){if(e==null||e==="")return null;const t=Number(e);if(!Number.isFinite(t))return null;return Number((t/100).toFixed(2))}

package/clis/substack/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as i,CommandExecutionError as o}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as n}from"../_shared/site-auth.js";import{publicationContext as c}from"./post-utils.js";async function a(s){return(await s.getCookies({url:"https://substack.com"})).some((e)=>e.name==="substack.sid"||e.name==="connect.sid")}async function r(s){if(!await a(s))throw new i("substack.com","Substack session cookie missing");await s.goto("https://substack.com/");const t=await s.evaluate(`(async () => {
+import{AuthRequiredError as i,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as n}from"../_shared/site-auth.js";import{publicationContext as c}from"./post-utils.js";async function o(e){return(await e.getCookies({url:"https://substack.com"})).some((s)=>s.name==="substack.sid"||s.name==="connect.sid")}async function r(e){if(!await o(e))throw new i("substack.com","Substack session cookie missing");await e.goto("https://substack.com/");const t=await e.evaluate(`(async () => {
     try {
       const res = await fetch('/api/v1/user/profile/self', { credentials: 'include', headers: { 'Accept': 'application/json' } });
       if (res.status === 401 || res.status === 403) return { kind: 'auth', detail: 'profile/self HTTP ' + res.status };
@@ -8,4 +8,4 @@ import{AuthRequiredError as i,CommandExecutionError as o}from"@jackwener/opencli
       if (!data || data.id == null) return { kind: 'auth', detail: 'profile/self returned no user — anonymous' };
       return { ok: true, profile: data };
     } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
-  })()`);if(t?.kind==="auth")throw new i("substack.com",t.detail);if(t?.kind==="http")throw new o(`HTTP ${t.httpStatus} from profile/self`);if(t?.kind==="exception")throw new o(`Substack whoami failed: ${t.detail}`);if(!t?.ok)throw new o(`Unexpected Substack probe: ${JSON.stringify(t)}`);const e=c(t.profile);return{user_id:String(e.userId),publication:e.publication,url:e.host}}n({site:"substack",domain:"substack.com",loginUrl:"https://substack.com/sign-in",columns:["user_id","publication","url"],quickCheck:a,verify:r,poll:async(s)=>{if(!await a(s))throw new i("substack.com","Waiting for Substack session cookie");return r(s)}});
+  })()`);if(t?.kind==="auth")throw new i("substack.com",t.detail);if(t?.kind==="http")throw new a(`HTTP ${t.httpStatus} from profile/self`);if(t?.kind==="exception")throw new a(`Substack whoami failed: ${t.detail}`);if(!t?.ok)throw new a(`Unexpected Substack probe: ${JSON.stringify(t)}`);const s=c(t.profile);return{user_id:String(s.userId),publication:s.publication,url:s.host}}n({site:"substack",domain:"substack.com",loginUrl:"https://substack.com/sign-in",columns:["user_id","publication","url"],quickCheck:o,verify:r,poll:async(e)=>{if(!await o(e))throw new i("substack.com","Waiting for Substack session cookie");return r(e)}});

package/clis/substack/post-utils.js

@@ -1,2 +1,2 @@
-import{AuthRequiredError as P,ArgumentError as M,CommandExecutionError as Q}from"@jackwener/opencli/errors";const O=new Set(["everyone","only_paid"]);export function publicationContext(z){if(!z||z.id==null)throw new P("substack.com","Not logged in to Substack (profile has no id)");const F=Array.isArray(z.publicationUsers)?z.publicationUsers:[],H=F.find((K)=>K&&K.is_primary)||F[0],G=H&&H.publication;if(!G||!G.subdomain)throw new Q("Substack account has no publication to publish to");return{host:G.custom_domain&&!G.custom_domain_optional?`https://${G.custom_domain}`:`https://${G.subdomain}.substack.com`,userId:z.id,publication:G.name||G.subdomain,subdomain:G.subdomain}}export function validateAudience(z){const F=String(z??"everyone");if(!O.has(F))throw new M(`Invalid --audience "${F}" (allowed: everyone, only_paid)`);return F}export function imageDataUri(z,F){return`data:image/${F||"jpeg"};base64,${z}`}export function textToParagraphs(z){const F=String(z??"").replace(/\r\n/g,`
-`).trim();if(!F)return[];return F.split(/\n{2,}/).map((H)=>H.trim()).filter(Boolean)}export function paragraphNode(z){return{type:"paragraph",content:String(z??"").length?[{type:"text",text:String(z)}]:[]}}export function imageBlock(z,{width:F=1456,height:H=819}={}){return{type:"captionedImage",content:[{type:"image2",attrs:{src:z,fullscreen:!1,imageSize:"normal",height:H,width:F,resizeWidth:Math.round(F/2),bytes:null,alt:null,title:null,type:null,href:null,belowTheFold:!1,internalRedirect:null}}]}}export function buildDraftBody(z){return{type:"doc",content:Array.isArray(z)?z:[]}}export function buildDraftPayload({title:z,subtitle:F="",bodyDoc:H,userId:G,audience:J="everyone",sectionId:K=null}){return{draft_title:String(z??""),draft_subtitle:String(F??""),draft_body:JSON.stringify(H??buildDraftBody([])),draft_bylines:[{id:G,is_guest:!1}],audience:J,draft_section_id:K,section_chosen:K!=null,write_comment_permissions:"everyone"}}export function collectSections(z){const F=z&&Array.isArray(z.publications)?z.publications:[],H=[];for(const G of F)for(const J of Array.isArray(G?.sections)?G.sections:[])if(J&&J.id!=null&&J.name)H.push({id:J.id,name:String(J.name)});return H}export function resolveSectionId(z,F){const H=String(F??"").trim().toLowerCase(),G=(z||[]).find((J)=>String(J.name).toLowerCase()===H);if(!G){const J=(z||[]).map((K)=>K.name).join(", ")||"(none)";throw new M(`Substack section "${F}" not found. Available: ${J}`)}return G.id}export function classifyImages(z){if(!z)return[];return String(z).split(",").map((F)=>F.trim()).filter(Boolean).map((F)=>({kind:/^https?:\/\//i.test(F)?"url":"path",value:F}))}export const __test__={VALID_AUDIENCES:O};
+import{AuthRequiredError as u,ArgumentError as a,CommandExecutionError as c}from"@jackwener/opencli/errors";const s=new Set(["everyone","only_paid"]);export function publicationContext(t){if(!t||t.id==null)throw new u("substack.com","Not logged in to Substack (profile has no id)");const n=Array.isArray(t.publicationUsers)?t.publicationUsers:[],o=n.find((i)=>i&&i.is_primary)||n[0],e=o&&o.publication;if(!e||!e.subdomain)throw new c("Substack account has no publication to publish to");return{host:e.custom_domain&&!e.custom_domain_optional?`https://${e.custom_domain}`:`https://${e.subdomain}.substack.com`,userId:t.id,publication:e.name||e.subdomain,subdomain:e.subdomain}}export function validateAudience(t){const n=String(t??"everyone");if(!s.has(n))throw new a(`Invalid --audience "${n}" (allowed: everyone, only_paid)`);return n}export function imageDataUri(t,n){return`data:image/${n||"jpeg"};base64,${t}`}export function textToParagraphs(t){const n=String(t??"").replace(/\r\n/g,`
+`).trim();if(!n)return[];return n.split(/\n{2,}/).map((o)=>o.trim()).filter(Boolean)}export function paragraphNode(t){return{type:"paragraph",content:String(t??"").length?[{type:"text",text:String(t)}]:[]}}export function imageBlock(t,{width:n=1456,height:o=819}={}){return{type:"captionedImage",content:[{type:"image2",attrs:{src:t,fullscreen:!1,imageSize:"normal",height:o,width:n,resizeWidth:Math.round(n/2),bytes:null,alt:null,title:null,type:null,href:null,belowTheFold:!1,internalRedirect:null}}]}}export function buildDraftBody(t){return{type:"doc",content:Array.isArray(t)?t:[]}}export function buildDraftPayload({title:t,subtitle:n="",bodyDoc:o,userId:e,audience:r="everyone",sectionId:i=null}){return{draft_title:String(t??""),draft_subtitle:String(n??""),draft_body:JSON.stringify(o??buildDraftBody([])),draft_bylines:[{id:e,is_guest:!1}],audience:r,draft_section_id:i,section_chosen:i!=null,write_comment_permissions:"everyone"}}export function collectSections(t){const n=t&&Array.isArray(t.publications)?t.publications:[],o=[];for(const e of n)for(const r of Array.isArray(e?.sections)?e.sections:[])if(r&&r.id!=null&&r.name)o.push({id:r.id,name:String(r.name)});return o}export function resolveSectionId(t,n){const o=String(n??"").trim().toLowerCase(),e=(t||[]).find((r)=>String(r.name).toLowerCase()===o);if(!e){const r=(t||[]).map((i)=>i.name).join(", ")||"(none)";throw new a(`Substack section "${n}" not found. Available: ${r}`)}return e.id}export function classifyImages(t){if(!t)return[];return String(t).split(",").map((n)=>n.trim()).filter(Boolean).map((n)=>({kind:/^https?:\/\//i.test(n)?"url":"path",value:n}))}export const __test__={VALID_AUDIENCES:s};

package/clis/substack/publish.js

@@ -1,10 +1,10 @@
-import*as T from"node:fs";import*as A from"node:path";import{cli as f,Strategy as E}from"@jackwener/opencli/registry";import{AuthRequiredError as w,ArgumentError as N,CommandExecutionError as $}from"@jackwener/opencli/errors";import{publicationContext as b,validateAudience as k,imageDataUri as h,textToParagraphs as m,paragraphNode as D,imageBlock as y,buildDraftBody as u,buildDraftPayload as n,collectSections as c,resolveSectionId as i,classifyImages as l}from"./post-utils.js";const P={".jpg":"jpeg",".jpeg":"jpeg",".png":"png",".gif":"gif",".webp":"webp"};function d(z){if(z&&typeof z==="object"&&!Array.isArray(z)&&"session"in z&&"data"in z)return z.data;return z}async function V(z,{url:G,method:H="GET",headers:L={},body:O=null}){const J=`(async () => {
+import*as x from"node:fs";import*as P from"node:path";import{cli as C,Strategy as A}from"@jackwener/opencli/registry";import{AuthRequiredError as J,ArgumentError as b,CommandExecutionError as d}from"@jackwener/opencli/errors";import{publicationContext as H,validateAudience as q,imageDataUri as B,textToParagraphs as D,paragraphNode as O,imageBlock as F,buildDraftBody as U,buildDraftPayload as M,collectSections as R,resolveSectionId as G,classifyImages as K}from"./post-utils.js";const g={".jpg":"jpeg",".jpeg":"jpeg",".png":"png",".gif":"gif",".webp":"webp"};function L(t){if(t&&typeof t==="object"&&!Array.isArray(t)&&"session"in t&&"data"in t)return t.data;return t}async function l(t,{url:e,method:s="GET",headers:o={},body:r=null}){const a=`(async () => {
     try {
-      const opts = { method: ${JSON.stringify(H)}, credentials: 'include', headers: ${JSON.stringify({Accept:"application/json",...L})} };
-      ${O!=null?`opts.body = ${JSON.stringify(O)};`:""}
-      const res = await fetch(${JSON.stringify(G)}, opts);
+      const opts = { method: ${JSON.stringify(s)}, credentials: 'include', headers: ${JSON.stringify({Accept:"application/json",...o})} };
+      ${r!=null?`opts.body = ${JSON.stringify(r)};`:""}
+      const res = await fetch(${JSON.stringify(e)}, 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 d(await z.evaluate(J))}function F(z){return l(z).map((G)=>{if(G.kind==="url")return G;const H=A.resolve(G.value),L=A.extname(H).toLowerCase();if(!P[L])throw new N(`Unsupported image "${L}" (jpg/png/gif/webp): ${G.value}`);const O=T.statSync(H,{throwIfNoEntry:!1});if(!O||!O.isFile())throw new N(`Not a file: ${H}`);return{kind:"path",value:H,mime:P[L]}})}f({site:"substack",name:"publish",access:"write",description:"Publish a post to your Substack publication (or save a draft with --draft)",domain:"substack.com",strategy:E.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Post title"},{name:"body",fromFile:!0,type:"string",help:"Post body text (blank lines split paragraphs)"},{name:"subtitle",type:"string",help:"Optional subtitle"},{name:"images",type:"string",help:"Images: comma-separated local paths and/or http(s) urls"},{name:"audience",type:"string",default:"everyone",help:"Visibility: everyone | only_paid"},{name:"section",type:"string",help:"Section name to file the post under"},{name:"send",type:"boolean",default:!1,help:"Also email subscribers on publish"},{name:"draft",type:"boolean",default:!1,help:"Create the draft but do not publish"}],columns:["status","publication","draft_id","url"],func:async(z,G)=>{if(!z)throw new $("Browser session required for substack publish");const H=String(G.title??"").trim();if(!H)throw new N("substack publish: title is required");const L=k(G.audience),O=F(G.images);await z.goto("https://substack.com/");const J=await V(z,{url:"https://substack.com/api/v1/user/profile/self"});if(J.status===401||J.status===403||!J.data||J.data.id==null)throw new w("substack.com",`Not logged in (profile/self HTTP ${J.status})`);const{host:K,userId:M,publication:S}=b(J.data);await z.goto(`${K}/`);const U=[];for(const Q of O){let B=Q.value;if(Q.kind==="path"){const I=T.readFileSync(Q.value).toString("base64"),Z=await V(z,{url:`${K}/api/v1/image`,method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:`image=${encodeURIComponent(h(I,Q.mime))}`});if(!Z.ok||!Z.data?.url)throw new $(`Substack image upload failed: HTTP ${Z.status} ${Z.text}`);B=Z.data.url}U.push(y(B))}const R=[...m(G.body).map(D),...U];if(!R.length)R.push(D(""));const C=u(R);let X=null;if(G.section){const Q=await V(z,{url:`${K}/api/v1/subscriptions`});X=i(c(Q.data),G.section)}const x=n({title:H,subtitle:G.subtitle,bodyDoc:C,userId:M,audience:L,sectionId:X}),W=await V(z,{url:`${K}/api/v1/drafts`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(x)});if(!W.ok||W.data?.id==null)throw new $(`Substack create-draft failed: HTTP ${W.status} ${W.text}`);const Y=W.data.id,_=`${K}/publish/post/${Y}`;if(G.draft)return{status:"draft",publication:S,draft_id:String(Y),url:_};const j=await V(z,{url:`${K}/api/v1/drafts/${Y}/prepublish`});if(!j.ok)throw new $(`Substack prepublish failed: HTTP ${j.status} ${j.text}`);const q=await V(z,{url:`${K}/api/v1/drafts/${Y}/publish`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({send:!!G.send,share_automatically:!1})});if(!q.ok)throw new $(`Substack publish failed: HTTP ${q.status} ${q.text}`);const v=q.data?.slug;return{status:"published",publication:S,draft_id:String(Y),url:v?`${K}/p/${v}`:_}}});export const __test__={resolveImageEntries:F,EXT_MIME:P};
+  })()`;return L(await t.evaluate(a))}function I(t){return K(t).map((e)=>{if(e.kind==="url")return e;const s=P.resolve(e.value),o=P.extname(s).toLowerCase();if(!g[o])throw new b(`Unsupported image "${o}" (jpg/png/gif/webp): ${e.value}`);const r=x.statSync(s,{throwIfNoEntry:!1});if(!r||!r.isFile())throw new b(`Not a file: ${s}`);return{kind:"path",value:s,mime:g[o]}})}C({site:"substack",name:"publish",access:"write",description:"Publish a post to your Substack publication (or save a draft with --draft)",domain:"substack.com",strategy:A.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!0,positional:!0,help:"Post title"},{name:"body",fromFile:!0,type:"string",help:"Post body text (blank lines split paragraphs)"},{name:"subtitle",type:"string",help:"Optional subtitle"},{name:"images",type:"string",help:"Images: comma-separated local paths and/or http(s) urls"},{name:"audience",type:"string",default:"everyone",help:"Visibility: everyone | only_paid"},{name:"section",type:"string",help:"Section name to file the post under"},{name:"send",type:"boolean",default:!1,help:"Also email subscribers on publish"},{name:"draft",type:"boolean",default:!1,help:"Create the draft but do not publish"}],columns:["status","publication","draft_id","url"],func:async(t,e)=>{if(!t)throw new d("Browser session required for substack publish");const s=String(e.title??"").trim();if(!s)throw new b("substack publish: title is required");const o=q(e.audience),r=I(e.images);await t.goto("https://substack.com/");const a=await l(t,{url:"https://substack.com/api/v1/user/profile/self"});if(a.status===401||a.status===403||!a.data||a.data.id==null)throw new J("substack.com",`Not logged in (profile/self HTTP ${a.status})`);const{host:i,userId:N,publication:y}=H(a.data);await t.goto(`${i}/`);const w=[];for(const n of r){let k=n.value;if(n.kind==="path"){const j=x.readFileSync(n.value).toString("base64"),p=await l(t,{url:`${i}/api/v1/image`,method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:`image=${encodeURIComponent(B(j,n.mime))}`});if(!p.ok||!p.data?.url)throw new d(`Substack image upload failed: HTTP ${p.status} ${p.text}`);k=p.data.url}w.push(F(k))}const m=[...D(e.body).map(O),...w];if(!m.length)m.push(O(""));const E=U(m);let S=null;if(e.section){const n=await l(t,{url:`${i}/api/v1/subscriptions`});S=G(R(n.data),e.section)}const _=M({title:s,subtitle:e.subtitle,bodyDoc:E,userId:N,audience:o,sectionId:S}),u=await l(t,{url:`${i}/api/v1/drafts`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(_)});if(!u.ok||u.data?.id==null)throw new d(`Substack create-draft failed: HTTP ${u.status} ${u.text}`);const c=u.data.id,v=`${i}/publish/post/${c}`;if(e.draft)return{status:"draft",publication:y,draft_id:String(c),url:v};const h=await l(t,{url:`${i}/api/v1/drafts/${c}/prepublish`});if(!h.ok)throw new d(`Substack prepublish failed: HTTP ${h.status} ${h.text}`);const f=await l(t,{url:`${i}/api/v1/drafts/${c}/publish`,method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({send:!!e.send,share_automatically:!1})});if(!f.ok)throw new d(`Substack publish failed: HTTP ${f.status} ${f.text}`);const T=f.data?.slug;return{status:"published",publication:y,draft_id:String(c),url:T?`${i}/p/${T}`:v}}});export const __test__={resolveImageEntries:I,EXT_MIME:g};

package/clis/suno/auth.js

@@ -1,4 +1,4 @@
-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://clerk.suno.com"})).some((H)=>H.name==="__session"&&H.value)}async function J(B){if(!await G(B))throw new D("suno.com","Suno Clerk __session/__client cookie missing");await B.goto("https://suno.com/");await B.wait(2);const z=await B.evaluate(`(async () => {
+import{AuthRequiredError as o,CommandExecutionError as n}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";async function s(i){return(await i.getCookies({url:"https://clerk.suno.com"})).some((r)=>r.name==="__session"&&r.value)}async function t(i){if(!await s(i))throw new o("suno.com","Suno Clerk __session/__client cookie missing");await i.goto("https://suno.com/");await i.wait(2);const e=await i.evaluate(`(async () => {
     try {
       for (let i = 0; i < 20; i += 1) {
         if (window.Clerk && window.Clerk.loaded) break;
@@ -18,4 +18,4 @@ import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli
     } catch (e) {
       return { kind: 'exception', detail: String(e && e.message || e) };
     }
-  })()`);if(z?.kind==="auth")throw new D("suno.com",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from clerk.suno.com`);if(z?.kind==="exception")throw new F(`Suno whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected Suno probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,name:z.name}}K({site:"suno",domain:"suno.com",loginUrl:"https://suno.com/?sign-in=true",columns:["user_id","name"],quickCheck:G,verify:J,poll:async(B)=>{if(!await G(B))throw new D("suno.com","Waiting for Suno Clerk __session/__client cookie");return J(B)}});
+  })()`);if(e?.kind==="auth")throw new o("suno.com",e.detail);if(e?.kind==="http")throw new n(`HTTP ${e.httpStatus} from clerk.suno.com`);if(e?.kind==="exception")throw new n(`Suno whoami failed: ${e.detail}`);if(!e?.ok)throw new n(`Unexpected Suno probe: ${JSON.stringify(e)}`);return{user_id:e.user_id,name:e.name}}u({site:"suno",domain:"suno.com",loginUrl:"https://suno.com/?sign-in=true",columns:["user_id","name"],quickCheck:s,verify:t,poll:async(i)=>{if(!await s(i))throw new o("suno.com","Waiting for Suno Clerk __session/__client cookie");return t(i)}});

package/clis/suno/download.js

@@ -1,17 +1,17 @@
-import{cli as N,Strategy as D}from"@jackwener/opencli/registry";import{ArgumentError as b,CommandExecutionError as Y,EmptyResultError as C}from"@jackwener/opencli/errors";import{STUDIO_API as U,SUNO_DOMAIN as v,SUNO_URL as B,downloadSunoClip as y,ensureSunoSession as A,normalizeBooleanFlag as O,parseFormats as _,resolveSunoOutputDir as R,unwrapEvaluateResult as I}from"./utils.js";import*as S from"node:os";function E(J){if(!J)return"-";const H=S.homedir();return J.startsWith(H)?`~${J.slice(H.length)}`:J}function k(J){const H=String(J||"").trim();if(!H)throw new b("clip-id required (UUID or /song/<id> URL)");if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(H))return H.toLowerCase();try{const V=new URL(H),W=V.pathname.match(/^\/song\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);if(V.protocol==="https:"&&V.hostname==="suno.com"&&W)return W[1].toLowerCase()}catch{}throw new b(`Invalid clip-id: ${H}`,"Pass a UUID or a https://suno.com/song/<uuid> URL.")}export const downloadCommand=N({site:"suno",name:"download",access:"write",description:"Download an existing Suno clip (MP3 + optional WAV/M4A/video) by id",domain:v,strategy:D.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"clip",positional:!0,required:!0,help:"Clip UUID or https://suno.com/song/<id> URL"},{name:"formats",help:"Comma-separated formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(J,H)=>{const K=k(H.clip),V=_(H.formats),W=O(H["confirm-paid"]),L=new Set(["wav"]),Z=[],q=V.filter((G)=>{if(L.has(G)&&!W){Z.push(G);return!1}return!0});if(!q.length)throw new b("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const T=R(H.op),z=(await A(J)).deviceId,X=I(await J.evaluate(`(async () => {
+import{cli as v,Strategy as A}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as l,EmptyResultError as C}from"@jackwener/opencli/errors";import{STUDIO_API as O,SUNO_DOMAIN as U,SUNO_URL as f,downloadSunoClip as I,ensureSunoSession as D,normalizeBooleanFlag as R,parseFormats as T,resolveSunoOutputDir as b,unwrapEvaluateResult as P}from"./utils.js";import*as E from"node:os";function F(e){if(!e)return"-";const t=E.homedir();return e.startsWith(t)?`~${e.slice(t.length)}`:e}function L(e){const t=String(e||"").trim();if(!t)throw new u("clip-id required (UUID or /song/<id> URL)");if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(t))return t.toLowerCase();try{const i=new URL(t),n=i.pathname.match(/^\/song\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);if(i.protocol==="https:"&&i.hostname==="suno.com"&&n)return n[1].toLowerCase()}catch{}throw new u(`Invalid clip-id: ${t}`,"Pass a UUID or a https://suno.com/song/<uuid> URL.")}export const downloadCommand=v({site:"suno",name:"download",access:"write",description:"Download an existing Suno clip (MP3 + optional WAV/M4A/video) by id",domain:U,strategy:A.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"clip",positional:!0,required:!0,help:"Clip UUID or https://suno.com/song/<id> URL"},{name:"formats",help:"Comma-separated formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(e,t)=>{const a=L(t.clip),i=T(t.formats),n=R(t["confirm-paid"]),w=new Set(["wav"]),d=[],c=i.filter((o)=>{if(w.has(o)&&!n){d.push(o);return!1}return!0});if(!c.length)throw new u("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const h=b(t.op),m=(await D(e)).deviceId,s=P(await e.evaluate(`(async () => {
             const browserToken = JSON.stringify({ token: btoa(JSON.stringify({ timestamp: Date.now() })) });
-            const res = await fetch('${U}/api/feed/v3', {
+            const res = await fetch('${O}/api/feed/v3', {
                 method: 'POST',
                 headers: {
                     'Authorization': 'Bearer ' + (await window.Clerk.session.getToken()),
                     'browser-token': browserToken,
-                    'device-id': ${JSON.stringify(z)},
+                    'device-id': ${JSON.stringify(m)},
                     'Content-Type': 'application/json',
                 },
-                body: JSON.stringify({ clip_ids: ['${K}'] }),
+                body: JSON.stringify({ clip_ids: ['${a}'] }),
             });
             if (!res.ok) return { ok: false, error: 'HTTP ' + res.status };
             const payload = await res.json().catch(() => null);
             if (!payload || !Array.isArray(payload.clips)) return { ok: false, error: 'malformed clips payload' };
             return { ok: true, clips: payload.clips };
-        })()`));if(!X?.ok)throw new Y(`Suno feed lookup failed: ${X?.error||"unknown"}`);if(!Array.isArray(X.clips))throw new Y("Suno feed lookup returned malformed clips payload");const Q=X.clips.find((G)=>G.id===K);if(!Q)throw new C("suno download",`Clip ${K} not found in your account. Confirm at ${B}/song/${K}.`);if(Q.status!=="complete")throw new Y(`Clip ${K} status is "${Q.status}" — not complete yet. Retry once generation finishes.`);const $=await y(J,Q,T,q,z);if(!$.written.some((G)=>G.ok))throw new Y(`Suno download wrote no files for clip ${K}`);const j=`${B}/song/${Q.id}`,x=$.written.map((G)=>G.ok?`${G.format}:${E(G.file)}`:`${G.format}:✗(${G.reason})`).join(" | "),F=Z.length?` | skipped(needs --confirm-paid):${Z.join(",")}`:"",M=`${x}${F}`;return[{status:$.written.some((G)=>!G.ok)?"⚠ partial":"✅ saved",clip:Q.id.slice(0,8),title:Q.title||"(untitled)",files:`\uD83D\uDCC1 ${M}`,link:`\uD83D\uDD17 ${j}`}]}});
+        })()`));if(!s?.ok)throw new l(`Suno feed lookup failed: ${s?.error||"unknown"}`);if(!Array.isArray(s.clips))throw new l("Suno feed lookup returned malformed clips payload");const r=s.clips.find((o)=>o.id===a);if(!r)throw new C("suno download",`Clip ${a} not found in your account. Confirm at ${f}/song/${a}.`);if(r.status!=="complete")throw new l(`Clip ${a} status is "${r.status}" — not complete yet. Retry once generation finishes.`);const p=await I(e,r,h,c,m);if(!p.written.some((o)=>o.ok))throw new l(`Suno download wrote no files for clip ${a}`);const y=`${f}/song/${r.id}`,S=p.written.map((o)=>o.ok?`${o.format}:${F(o.file)}`:`${o.format}:✗(${o.reason})`).join(" | "),k=d.length?` | skipped(needs --confirm-paid):${d.join(",")}`:"",g=`${S}${k}`;return[{status:p.written.some((o)=>!o.ok)?"⚠ partial":"✅ saved",clip:r.id.slice(0,8),title:r.title||"(untitled)",files:`\uD83D\uDCC1 ${g}`,link:`\uD83D\uDD17 ${y}`}]}});

package/clis/suno/generate.js

@@ -1,4 +1,4 @@
-import{cli as c,Strategy as n}from"@jackwener/opencli/registry";import{ArgumentError as z,CommandExecutionError as V}from"@jackwener/opencli/errors";import{DEFAULT_SUNO_MODEL as y,SUNO_DOMAIN as t,SUNO_MODELS as v,SUNO_URL as Z,checkSunoCaptcha as o,clampSlider as _,downloadSunoClip as i,ensureSunoSession as e,normalizeBooleanFlag as A,parseFormats as a,pollSunoClips as s,requirePositiveInt as r,resolveSunoOutputDir as HH,submitSunoGeneration as JH}from"./utils.js";import*as C from"node:crypto";import*as KH from"node:os";function QH(K){if(!K)return"-";const J=KH.homedir();return K.startsWith(J)?`~${K.slice(J.length)}`:K}export const generateCommand=c({site:"suno",name:"generate",access:"write",description:"Generate music with Suno (V5.5 chirp-fenix by default) and download clips locally",domain:t,strategy:n.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"prompt",fromFile:!0,positional:!0,required:!1,help:"Simple-mode description (ignored when --lyrics is provided)"},{name:"lyrics",help:"Custom-mode lyrics (with [Verse]/[Chorus] metatags). Triggers Custom mode."},{name:"tags",help:"Custom-mode style tags (genre, BPM, instruments...). Used with --lyrics."},{name:"negative-tags",help:'Custom-mode style exclusions (e.g. "no vocals, no autotune"). Used with --lyrics.'},{name:"title",help:"Song title (default: auto-derived from prompt)"},{name:"instrumental",type:"boolean",default:!1,help:"No vocals"},{name:"model",help:`Model id: ${v.join(", ")}. Default: ${y}`},{name:"weirdness",help:"Creative weirdness slider (0..1). Default: 0.5"},{name:"style-weight",help:"Style adherence slider (0..1). Default: 0.5"},{name:"formats",help:"Comma-separated download formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"timeout",type:"int",default:300,help:"Max seconds to wait for clips to finish (default: 300)"},{name:"sd",type:"boolean",default:!1,help:"Skip download; only print clip ids and Suno URLs"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(K,J)=>{const B=J.lyrics?String(J.lyrics):"",M=J.tags?String(J.tags):"",D=J["negative-tags"]?String(J["negative-tags"]):"",R=J.prompt?String(J.prompt):"",P=J.title?String(J.title):"",T=J.model?String(J.model).trim():y;if(!v.includes(T))throw new z(`Unsupported --model "${T}"`,`Choices: ${v.join(", ")}`);const $=B.trim()!=="";if(!$&&!R.trim())throw new z("Either provide a Simple-mode prompt as the positional argument, or pass --lyrics for Custom mode.",`Examples:
+import{cli as H,Strategy as K}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as n}from"@jackwener/opencli/errors";import{DEFAULT_SUNO_MODEL as I,SUNO_DOMAIN as z,SUNO_MODELS as C,SUNO_URL as a,checkSunoCaptcha as J,clampSlider as T,downloadSunoClip as Q,ensureSunoSession as X,normalizeBooleanFlag as b,parseFormats as Y,pollSunoClips as Z,requirePositiveInt as ee,resolveSunoOutputDir as te,submitSunoGeneration as oe}from"./utils.js";import*as q from"node:crypto";import*as ie from"node:os";function ne(o){if(!o)return"-";const t=ie.homedir();return o.startsWith(t)?`~${o.slice(t.length)}`:o}export const generateCommand=H({site:"suno",name:"generate",access:"write",description:"Generate music with Suno (V5.5 chirp-fenix by default) and download clips locally",domain:z,strategy:K.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"prompt",fromFile:!0,positional:!0,required:!1,help:"Simple-mode description (ignored when --lyrics is provided)"},{name:"lyrics",help:"Custom-mode lyrics (with [Verse]/[Chorus] metatags). Triggers Custom mode."},{name:"tags",help:"Custom-mode style tags (genre, BPM, instruments...). Used with --lyrics."},{name:"negative-tags",help:'Custom-mode style exclusions (e.g. "no vocals, no autotune"). Used with --lyrics.'},{name:"title",help:"Song title (default: auto-derived from prompt)"},{name:"instrumental",type:"boolean",default:!1,help:"No vocals"},{name:"model",help:`Model id: ${C.join(", ")}. Default: ${I}`},{name:"weirdness",help:"Creative weirdness slider (0..1). Default: 0.5"},{name:"style-weight",help:"Style adherence slider (0..1). Default: 0.5"},{name:"formats",help:"Comma-separated download formats: mp3, m4a, wav, video, cover, metadata. Default: mp3,metadata"},{name:"op",help:"Output directory (default: ~/Music/suno)"},{name:"timeout",type:"int",default:300,help:"Max seconds to wait for clips to finish (default: 300)"},{name:"sd",type:"boolean",default:!1,help:"Skip download; only print clip ids and Suno URLs"},{name:"confirm-paid",type:"boolean",default:!1,help:"Required to allow paid downloads (wav). Without it, paid formats are skipped with a warning."}],columns:["status","clip","title","files","link"],func:async(o,t)=>{const f=t.lyrics?String(t.lyrics):"",h=t.tags?String(t.tags):"",U=t["negative-tags"]?String(t["negative-tags"]):"",y=t.prompt?String(t.prompt):"",E=t.title?String(t.title):"",w=t.model?String(t.model).trim():I;if(!C.includes(w))throw new u(`Unsupported --model "${w}"`,`Choices: ${C.join(", ")}`);const l=f.trim()!=="";if(!l&&!y.trim())throw new u("Either provide a Simple-mode prompt as the positional argument, or pass --lyrics for Custom mode.",`Examples:
   ppcli suno generate "lo-fi study beat, 80 bpm"
-  ppcli suno generate --lyrics "[Verse]\\n..." --tags "synthwave, 120 bpm"`);if(!$&&(M||D))throw new z("--tags and --negative-tags only apply in Custom mode (alongside --lyrics).");const f=a(J.formats),h=A(J["confirm-paid"]),I=A(J.sd),O=new Set(["wav"]),b=[],L=f.filter((H)=>{if(O.has(H)&&!h){b.push(H);return!1}return!0});if(!I&&!L.length)throw new z("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const U=HH(J.op),E=r(J.timeout,"--timeout"),S=A(J.instrumental),u=_(J.weirdness,"--weirdness",0.5),m=_(J["style-weight"],"--style-weight",0.5),d=(P||($?M||B.split(`
-`)[0]:R)).replace(/\s+/g," ").trim().slice(0,60)||"Untitled",X=await e(K);if(!X.planId)throw new V(`Suno generation needs a resolved plan id for the user_tier field, but billing/info did not surface one for this account (subscription_type=${X.planKey}). Verify the account is active at ${Z}/account, then retry.`);const G=X.deviceId,W=await o(K,G);if(!W?.ok)throw new V(`Suno captcha pre-flight failed${W?.status?` (HTTP ${W.status})`:""}.`,`Open ${Z}/create in Chrome and verify the account is ready, then retry.`);if(W?.required)throw new V("Suno requires a CAPTCHA challenge for this account/IP right now.",`Open ${Z}/create in Chrome, solve a Create challenge once, then retry.`);if(X.totalCreditsAvailable<10){const H=X.breakdown;throw new V(`Suno generation needs ~10 credits; you have ${X.totalCreditsAvailable} (monthly ${H.monthlyRemaining}/${H.monthlyLimit} + packs ${H.purchasedPacks} + leftover ${H.pack}). Top up at ${Z}/account.`)}const k=C.randomUUID(),p=C.randomUUID(),N=await JH(K,{mode:$?"custom":"simple",model:T,title:d,lyrics:B,tags:M,negativeTags:D,description:R,makeInstrumental:S,weirdness:u,styleWeight:m,userTier:X.planId,createSessionToken:p,transactionUuid:k,deviceId:G});if(!Array.isArray(N.clips))throw new V("Suno generation returned malformed clips payload.");const j=N.clips.map((H)=>H?.id);if(j.some((H)=>!H))throw new V("Suno generation returned malformed clip identity.");if(!j.length)throw new V("Suno accepted the request but returned no clip ids.");const x=await s(K,j,E,G);if(!x.filter((H)=>H.status==="complete").length){const H=x.map((Y)=>`${Y.id.slice(0,8)}:${Y.status}`).join(", ");throw new V(`All Suno clips failed (${H}). Open ${Z}/song/${j[0]} to inspect.`)}const q=[];for(const H of x){const Y=`${Z}/song/${H.id}`;if(H.status!=="complete"){q.push({status:`❌ ${H.status}`,clip:H.id.slice(0,8),title:H.title||"(untitled)",files:"-",link:`\uD83D\uDD17 ${Y}`});continue}if(I){q.push({status:"\uD83C\uDFB5 generated",clip:H.id.slice(0,8),title:H.title||"(untitled)",files:"\uD83D\uDCC1 -",link:`\uD83D\uDD17 ${Y}`});continue}const F=await i(K,H,U,L,G);if(!F.written.some((Q)=>Q.ok))throw new V(`Suno download wrote no files for clip ${H.id}`);const w=F.written.map((Q)=>Q.ok?`${Q.format}:${QH(Q.file)}`:`${Q.format}:✗(${Q.reason})`).join(" | "),g=b.length?` | skipped(needs --confirm-paid):${b.join(",")}`:"",l=F.written.some((Q)=>!Q.ok);q.push({status:l?"⚠ partial":"✅ saved",clip:H.id.slice(0,8),title:H.title||"(untitled)",files:`\uD83D\uDCC1 ${w}${g}`,link:`\uD83D\uDD17 ${Y}`})}return q}});
+  ppcli suno generate --lyrics "[Verse]\\n..." --tags "synthwave, 120 bpm"`);if(!l&&(h||U))throw new u("--tags and --negative-tags only apply in Custom mode (alongside --lyrics).");const F=Y(t.formats),M=b(t["confirm-paid"]),A=b(t.sd),_=new Set(["wav"]),g=[],O=F.filter((e)=>{if(_.has(e)&&!M){g.push(e);return!1}return!0});if(!A&&!O.length)throw new u("All requested formats require --confirm-paid true","Add --confirm-paid true or include a free format such as mp3 or metadata.");const P=te(t.op),x=ee(t.timeout,"--timeout"),L=b(t.instrumental),N=T(t.weirdness,"--weirdness",0.5),j=T(t["style-weight"],"--style-weight",0.5),R=(E||(l?h||f.split(`
+`)[0]:y)).replace(/\s+/g," ").trim().slice(0,60)||"Untitled",s=await X(o);if(!s.planId)throw new n(`Suno generation needs a resolved plan id for the user_tier field, but billing/info did not surface one for this account (subscription_type=${s.planKey}). Verify the account is active at ${a}/account, then retry.`);const c=s.deviceId,d=await J(o,c);if(!d?.ok)throw new n(`Suno captcha pre-flight failed${d?.status?` (HTTP ${d.status})`:""}.`,`Open ${a}/create in Chrome and verify the account is ready, then retry.`);if(d?.required)throw new n("Suno requires a CAPTCHA challenge for this account/IP right now.",`Open ${a}/create in Chrome, solve a Create challenge once, then retry.`);if(s.totalCreditsAvailable<10){const e=s.breakdown;throw new n(`Suno generation needs ~10 credits; you have ${s.totalCreditsAvailable} (monthly ${e.monthlyRemaining}/${e.monthlyLimit} + packs ${e.purchasedPacks} + leftover ${e.pack}). Top up at ${a}/account.`)}const V=q.randomUUID(),k=q.randomUUID(),D=await oe(o,{mode:l?"custom":"simple",model:w,title:R,lyrics:f,tags:h,negativeTags:U,description:y,makeInstrumental:L,weirdness:N,styleWeight:j,userTier:s.planId,createSessionToken:k,transactionUuid:V,deviceId:c});if(!Array.isArray(D.clips))throw new n("Suno generation returned malformed clips payload.");const m=D.clips.map((e)=>e?.id);if(m.some((e)=>!e))throw new n("Suno generation returned malformed clip identity.");if(!m.length)throw new n("Suno accepted the request but returned no clip ids.");const S=await Z(o,m,x,c);if(!S.filter((e)=>e.status==="complete").length){const e=S.map((r)=>`${r.id.slice(0,8)}:${r.status}`).join(", ");throw new n(`All Suno clips failed (${e}). Open ${a}/song/${m[0]} to inspect.`)}const p=[];for(const e of S){const r=`${a}/song/${e.id}`;if(e.status!=="complete"){p.push({status:`❌ ${e.status}`,clip:e.id.slice(0,8),title:e.title||"(untitled)",files:"-",link:`\uD83D\uDD17 ${r}`});continue}if(A){p.push({status:"\uD83C\uDFB5 generated",clip:e.id.slice(0,8),title:e.title||"(untitled)",files:"\uD83D\uDCC1 -",link:`\uD83D\uDD17 ${r}`});continue}const v=await Q(o,e,P,O,c);if(!v.written.some((i)=>i.ok))throw new n(`Suno download wrote no files for clip ${e.id}`);const B=v.written.map((i)=>i.ok?`${i.format}:${ne(i.file)}`:`${i.format}:✗(${i.reason})`).join(" | "),W=g.length?` | skipped(needs --confirm-paid):${g.join(",")}`:"",G=v.written.some((i)=>!i.ok);p.push({status:G?"⚠ partial":"✅ saved",clip:e.id.slice(0,8),title:e.title||"(untitled)",files:`\uD83D\uDCC1 ${B}${W}`,link:`\uD83D\uDD17 ${r}`})}return p}});