publishport-opencli 1.0.20 → 1.0.22

package/clis/notebooklm/utils.js

@@ -1,6 +1,6 @@
-import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionError as A}from"@jackwener/opencli/errors";import{NOTEBOOKLM_DOMAIN as $,NOTEBOOKLM_HOME_URL as P}from"./shared.js";import{callNotebooklmRpc as j,getNotebooklmPageAuth as z,unwrapNotebooklmEvaluateResult as B}from"./rpc.js";export{buildNotebooklmRpcBody,extractNotebooklmRpcResult,fetchNotebooklmInPage,getNotebooklmPageAuth,parseNotebooklmChunkedResponse,stripNotebooklmAntiXssi}from"./rpc.js";const S="wXbhsf",Y="rLM1Ne",y="hPTbtc",b="khqZz";function H(G){let F=G;while(Array.isArray(F)&&F.length===1&&Array.isArray(F[0]))F=F[0];return F}export function isPlainObject(G){return G!==null&&typeof G==="object"&&!Array.isArray(G)}export function parseNotebooklmIdFromUrl(G){return G.match(/\/notebook\/([^/?#]+)/)?.[1]??""}const h=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function N(G){if(!h.test(G))throw new C("NOTEBOOKLM_INVALID_NOTEBOOK",`NotebookLM notebook id "${G}" is not a valid UUID`,"Pass a notebook id from `ppcli notebooklm list` or a full notebook URL like https://notebooklm.google.com/notebook/<uuid>.");return G}export function parseNotebooklmNotebookTarget(G){const F=G.trim();if(!F)throw new C("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook id is required","Pass a notebook id from `ppcli notebooklm list` or a full notebook URL.");if(/^https?:\/\//i.test(F)){let Q;try{Q=new URL(F)}catch{throw new C("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL is invalid","Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.")}if(Q.protocol!=="https:"||Q.hostname!==$||Q.username||Q.password||Q.port)throw new C("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL must be a canonical https://notebooklm.google.com URL","Pass a notebook id from `ppcli notebooklm list` or a full NotebookLM notebook URL.");const V=parseNotebooklmIdFromUrl(F);if(!V)throw new C("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL is invalid","Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.");return N(V)}const J=F.match(/(?:^|\/)notebook\/([^/?#]+)/);if(J?.[1])return N(J[1]);return N(F)}export function getNotebooklmAuthuser(){const G=process.env.OPENCLI_NOTEBOOKLM_AUTHUSER;return typeof G==="string"&&/^\d+$/.test(G)?G:""}export function requireNotebooklmExecute(G,F){if(G!==!0)throw new x(`Refusing to ${F}: pass --execute to perform this NotebookLM write`)}export function buildNotebooklmNotebookUrl(G){const F=new URL(`/notebook/${encodeURIComponent(G)}`,P),J=getNotebooklmAuthuser();if(J)F.searchParams.set("authuser",J);return F.toString()}export function classifyNotebooklmPage(G){try{const F=new URL(G);if(F.hostname!==$)return"unknown";if(/\/notebook\/[^/?#]+/.test(F.pathname))return"notebook";return"home"}catch{return"unknown"}}export function normalizeNotebooklmTitle(G,F=""){if(typeof G!=="string")return F;let J=G.replace(/\s+/g," ").trim();if(/^Untitled\b/i.test(J)&&/otebook$/i.test(J)&&J!=="Untitled notebook")J="Untitled notebook";return J||F}function k(G){if(typeof G!=="string")return null;const F=G.trim();if(!F)return null;const J=Date.parse(F);if(Number.isNaN(J))return F;return new Date(J).toISOString()}function K(G){if(typeof G==="number"&&Number.isFinite(G))try{return new Date(G*1000).toISOString()}catch{return null}if(Array.isArray(G)&&typeof G[0]==="number"&&Number.isFinite(G[0])){const F=G[0],J=typeof G[1]==="number"&&Number.isFinite(G[1])?G[1]:0;try{return new Date(F*1000+Math.floor(J/1e6)).toISOString()}catch{return null}}return null}function O(G){if(typeof G==="number"&&Number.isFinite(G))return G;if(!Array.isArray(G)||typeof G[1]!=="number"||!Number.isFinite(G[1]))return null;return G[1]}function U(G){const F=O(G);if(F===8)return"pasted-text";if(F===9)return"youtube";if(F===2)return"generated-text";if(F===3)return"pdf";if(F===4)return"audio";if(F===5)return"web";if(F===6)return"video";return F==null?null:`type-${F}`}function q(G){if(typeof G==="string"&&G.trim())return G.trim();if(!Array.isArray(G))return null;for(const F of G){const J=q(F);if(J)return J}return null}function _(G){return/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(G)}function M(G,F){if(typeof G==="string"){const J=normalizeNotebooklmTitle(G);if(!J)return F;if(_(J))return F;if(/^[\d\s]+$/.test(J))return F;if(/^(null|undefined)$/i.test(J))return F;F.push(J);return F}if(!Array.isArray(G))return F;for(const J of G)M(J,F);return F}function T(G,F){if(typeof G==="string"){const J=G.trim();if(J)F.push(J);return F}if(!Array.isArray(G))return F;for(const J of G)T(J,F);return F}function R(G,F,J){if(typeof G==="string"){const Q=G.trim();if(_(Q)&&!J.has(Q)){J.add(Q);F.push(Q)}return F}if(!Array.isArray(G))return F;for(const Q of G)R(Q,F,J);return F}export function parseNotebooklmHistoryThreadIdsResult(G){return R(G,[],new Set)}export function extractNotebooklmHistoryPreview(G){const F=M(G,[]);return F.length>0?F[0]:null}export function parseNotebooklmNoteListRawRows(G,F,J){return G.map((V)=>{const W=normalizeNotebooklmTitle(V.title,""),X=String(V.text??"").replace(/\bsticky_note_2\b/g," ").replace(/\bmore_vert\b/g," ").replace(/\s+/g," ").trim();if(!W)return null;const Z=X.startsWith(W)?X.slice(W.length).trim():X.replace(W,"").trim();return{notebook_id:F,title:W,created_at:Z||null,url:J,source:"studio-list"}}).filter((V)=>V!==null)}function I(G,F,J){const Q=normalizeNotebooklmTitle(G?.title,"Untitled Notebook"),V=String(G?.summary??"").trim();if(!V)return null;return{notebook_id:F,title:Q,summary:V,url:J,source:"summary-dom"}}function g(G,F,J){const Q=normalizeNotebooklmTitle(G?.title,""),V=String(G?.content??"").replace(/\r\n/g,`
-`).trim();if(!Q)return null;return{notebook_id:F,id:null,title:Q,content:V,url:J,source:"studio-editor"}}export function parseNotebooklmListResult(G){if(!Array.isArray(G)||G.length===0)return[];const F=Array.isArray(G[0])?G[0]:G;if(!Array.isArray(F))return[];return F.filter((J)=>Array.isArray(J)).map((J)=>{const Q=Array.isArray(J[5])?J[5]:[],V=Array.isArray(Q[5])?Q[5]:[],W=typeof J[2]==="string"?J[2]:"",X=typeof J[0]==="string"?J[0].replace(/^thought\s*\n/,""):"";return{id:W,title:normalizeNotebooklmTitle(X,"Untitled Notebook"),url:`https://${$}/notebook/${W}`,source:"rpc",is_owner:Q.length>1?Q[1]===!1:!0,created_at:V.length>0?K(V[0]):null}}).filter((J)=>J.id)}export function parseNotebooklmNotebookDetailResult(G){const F=H(G);if(!Array.isArray(F)||F.length<3)return null;const J=typeof F[2]==="string"?F[2]:"";if(!J)return null;const Q=normalizeNotebooklmTitle(F[0],"Untitled Notebook"),V=typeof F[3]==="string"?F[3]:null,W=Array.isArray(F[5])?F[5]:[],X=Array.isArray(F[1])?F[1]:[];return{id:J,title:Q,url:`https://${$}/notebook/${J}`,source:"rpc",is_owner:W.length>1?W[1]===!1:!0,created_at:K(W[8]),updated_at:K(W[5]),emoji:V,source_count:X.length}}export function parseNotebooklmSourceListResult(G){const F=H(G),J=parseNotebooklmNotebookDetailResult(F);if(!J||!Array.isArray(F))return[];return(Array.isArray(F[1])?F[1]:[]).filter((V)=>Array.isArray(V)).map((V)=>{const W=q(V[0])??"",X=normalizeNotebooklmTitle(V[1],"Untitled source"),Z=Array.isArray(V[2])?V[2]:[],L=typeof Z[4]==="number"?Z[4]:V[3];return{id:W,notebook_id:J.id,title:X,url:J.url,source:"rpc",type:U(L),type_code:O(L),size:typeof Z[1]==="number"&&Number.isFinite(Z[1])?Z[1]:null,created_at:K(Z[2]),updated_at:K(Z[14])}}).filter((V)=>V.id)}export function parseNotebooklmSourceGuideResult(G,F){if(!Array.isArray(G)||G.length===0||!Array.isArray(G[0]))return null;const J=G[0],Q=Array.isArray(J)&&J.length>0&&Array.isArray(J[0])?J[0]:J;if(!Array.isArray(Q))return null;const V=Array.isArray(Q[1])&&typeof Q[1][0]==="string"?Q[1][0].trim():"",W=Array.isArray(Q[2])&&Array.isArray(Q[2][0])?Q[2][0].filter((X)=>typeof X==="string"&&X.trim().length>0):[];if(!V)return null;return{source_id:F.id,notebook_id:F.notebook_id,title:F.title,type:F.type??null,summary:V,keywords:W,source:"rpc"}}export function parseNotebooklmSourceFulltextResult(G,F,J){if(!Array.isArray(G)||G.length===0||!Array.isArray(G[0]))return null;const Q=G[0],V=q(Q[0])??"",W=normalizeNotebooklmTitle(Q[1],"Untitled source"),X=Array.isArray(Q[2])?Q[2]:[],Z=Array.isArray(X[7])&&typeof X[7][0]==="string"?X[7][0]:J,L=U([null,X[4]]),f=Array.isArray(G[3])&&G[3].length>0?G[3][0]:[],D=T(f,[]).join(`
-`).trim();if(!V||!D)return null;return{source_id:V,notebook_id:F,title:W,kind:L,content:D,char_count:D.length,url:Z,source:"rpc"}}export function findNotebooklmSourceRow(G,F){const J=F.trim().toLowerCase();if(!J)return null;const Q=G.find((X)=>X.id.trim().toLowerCase()===J);if(Q)return Q;const V=G.find((X)=>X.title.trim().toLowerCase()===J);if(V)return V;const W=G.filter((X)=>X.title.trim().toLowerCase().includes(J));if(W.length===1)return W[0];return null}export function findNotebooklmNoteRow(G,F){const J=F.trim().toLowerCase();if(!J)return null;const Q=G.find((W)=>W.title.trim().toLowerCase()===J);if(Q)return Q;const V=G.filter((W)=>W.title.trim().toLowerCase().includes(J));if(V.length===1)return V[0];return null}export async function listNotebooklmViaRpc(G){const F=await j(G,S,[null,1,null,[2]]);return parseNotebooklmListResult(F.result)}export async function getNotebooklmDetailViaRpc(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return null;const J=await j(G,Y,[F.notebookId,null,[2],null,0]);return parseNotebooklmNotebookDetailResult(J.result)}export async function getNotebooklmNotebookDetailById(G,F){const J=await j(G,Y,[F,null,[2],null,0]);return{detail:parseNotebooklmNotebookDetailResult(J.result),sources:parseNotebooklmSourceListResult(J.result)}}export async function verifyNotebooklmNotebookExists(G,F,J){try{const{detail:Q}=await getNotebooklmNotebookDetailById(G,F);if(!Q||Q.id!==F)throw new A(`NotebookLM ${J} succeeded but the notebook ${F} was not found in the post-write verification`);return Q}catch(Q){if(Q instanceof E||Q instanceof A)throw Q;throw new A(`NotebookLM ${J} post-write verification failed: ${Q?.message||Q}`)}}export async function verifyNotebooklmSourceAdded(G,F,J,Q){try{const{detail:V,sources:W}=await getNotebooklmNotebookDetailById(G,F);if(!V||V.id!==F)throw new A(`NotebookLM ${Q} succeeded but the notebook ${F} was not found in the post-write verification`);const X=W.find((Z)=>Z.id===J);if(!X)throw new A(`NotebookLM ${Q} succeeded but source ${J} did not appear in the notebook's source list`);return X}catch(V){if(V instanceof E||V instanceof A)throw V;throw new A(`NotebookLM ${Q} post-write verification failed: ${V?.message||V}`)}}export async function listNotebooklmSourcesViaRpc(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return[];const J=await j(G,Y,[F.notebookId,null,[2],null,0]);return parseNotebooklmSourceListResult(J.result)}export async function listNotebooklmHistoryViaRpc(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return[];const J=await j(G,y,[[],null,F.notebookId,20]),Q=parseNotebooklmHistoryThreadIdsResult(J.result);if(Q.length===0)return[];const V=[];for(const W of Q){const X=await j(G,b,[[],null,null,W,20]);V.push({notebook_id:F.notebookId,thread_id:W,item_count:Array.isArray(X.result)?X.result.length:0,preview:extractNotebooklmHistoryPreview(X.result),url:F.url||`https://${$}/notebook/${F.notebookId}`,source:"rpc"})}return V}export async function listNotebooklmNotesFromPage(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return[];const J=B(await G.evaluate(`(() => {
+import{ArgumentError as T,AuthRequiredError as h,CliError as f,CommandExecutionError as c}from"@jackwener/opencli/errors";import{NOTEBOOKLM_DOMAIN as l,NOTEBOOKLM_HOME_URL as k}from"./shared.js";import{callNotebooklmRpc as u,getNotebooklmPageAuth as S,unwrapNotebooklmEvaluateResult as d}from"./rpc.js";export{buildNotebooklmRpcBody,extractNotebooklmRpcResult,fetchNotebooklmInPage,getNotebooklmPageAuth,parseNotebooklmChunkedResponse,stripNotebooklmAntiXssi}from"./rpc.js";const M="wXbhsf",p="rLM1Ne",C="hPTbtc",E="khqZz";function N(o){let t=o;while(Array.isArray(t)&&t.length===1&&Array.isArray(t[0]))t=t[0];return t}export function isPlainObject(o){return o!==null&&typeof o==="object"&&!Array.isArray(o)}export function parseNotebooklmIdFromUrl(o){return o.match(/\/notebook\/([^/?#]+)/)?.[1]??""}const U=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function w(o){if(!U.test(o))throw new f("NOTEBOOKLM_INVALID_NOTEBOOK",`NotebookLM notebook id "${o}" is not a valid UUID`,"Pass a notebook id from `ppcli notebooklm list` or a full notebook URL like https://notebooklm.google.com/notebook/<uuid>.");return o}export function parseNotebooklmNotebookTarget(o){const t=o.trim();if(!t)throw new f("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook id is required","Pass a notebook id from `ppcli notebooklm list` or a full notebook URL.");if(/^https?:\/\//i.test(t)){let n;try{n=new URL(t)}catch{throw new f("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL is invalid","Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.")}if(n.protocol!=="https:"||n.hostname!==l||n.username||n.password||n.port)throw new f("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL must be a canonical https://notebooklm.google.com URL","Pass a notebook id from `ppcli notebooklm list` or a full NotebookLM notebook URL.");const r=parseNotebooklmIdFromUrl(t);if(!r)throw new f("NOTEBOOKLM_INVALID_NOTEBOOK","NotebookLM notebook URL is invalid","Pass a full NotebookLM notebook URL like https://notebooklm.google.com/notebook/<uuid>.");return w(r)}const e=t.match(/(?:^|\/)notebook\/([^/?#]+)/);if(e?.[1])return w(e[1]);return w(t)}export function getNotebooklmAuthuser(){const o=process.env.OPENCLI_NOTEBOOKLM_AUTHUSER;return typeof o==="string"&&/^\d+$/.test(o)?o:""}export function requireNotebooklmExecute(o,t){if(o!==!0)throw new T(`Refusing to ${t}: pass --execute to perform this NotebookLM write`)}export function buildNotebooklmNotebookUrl(o){const t=new URL(`/notebook/${encodeURIComponent(o)}`,k),e=getNotebooklmAuthuser();if(e)t.searchParams.set("authuser",e);return t.toString()}export function classifyNotebooklmPage(o){try{const t=new URL(o);if(t.hostname!==l)return"unknown";if(/\/notebook\/[^/?#]+/.test(t.pathname))return"notebook";return"home"}catch{return"unknown"}}export function normalizeNotebooklmTitle(o,t=""){if(typeof o!=="string")return t;let e=o.replace(/\s+/g," ").trim();if(/^Untitled\b/i.test(e)&&/otebook$/i.test(e)&&e!=="Untitled notebook")e="Untitled notebook";return e||t}function q(o){if(typeof o!=="string")return null;const t=o.trim();if(!t)return null;const e=Date.parse(t);if(Number.isNaN(e))return t;return new Date(e).toISOString()}function m(o){if(typeof o==="number"&&Number.isFinite(o))try{return new Date(o*1000).toISOString()}catch{return null}if(Array.isArray(o)&&typeof o[0]==="number"&&Number.isFinite(o[0])){const t=o[0],e=typeof o[1]==="number"&&Number.isFinite(o[1])?o[1]:0;try{return new Date(t*1000+Math.floor(e/1e6)).toISOString()}catch{return null}}return null}function g(o){if(typeof o==="number"&&Number.isFinite(o))return o;if(!Array.isArray(o)||typeof o[1]!=="number"||!Number.isFinite(o[1]))return null;return o[1]}function x(o){const t=g(o);if(t===8)return"pasted-text";if(t===9)return"youtube";if(t===2)return"generated-text";if(t===3)return"pdf";if(t===4)return"audio";if(t===5)return"web";if(t===6)return"video";return t==null?null:`type-${t}`}function A(o){if(typeof o==="string"&&o.trim())return o.trim();if(!Array.isArray(o))return null;for(const t of o){const e=A(t);if(e)return e}return null}function L(o){return/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(o)}function _(o,t){if(typeof o==="string"){const e=normalizeNotebooklmTitle(o);if(!e)return t;if(L(e))return t;if(/^[\d\s]+$/.test(e))return t;if(/^(null|undefined)$/i.test(e))return t;t.push(e);return t}if(!Array.isArray(o))return t;for(const e of o)_(e,t);return t}function O(o,t){if(typeof o==="string"){const e=o.trim();if(e)t.push(e);return t}if(!Array.isArray(o))return t;for(const e of o)O(e,t);return t}function I(o,t,e){if(typeof o==="string"){const n=o.trim();if(L(n)&&!e.has(n)){e.add(n);t.push(n)}return t}if(!Array.isArray(o))return t;for(const n of o)I(n,t,e);return t}export function parseNotebooklmHistoryThreadIdsResult(o){return I(o,[],new Set)}export function extractNotebooklmHistoryPreview(o){const t=_(o,[]);return t.length>0?t[0]:null}export function parseNotebooklmNoteListRawRows(o,t,e){return o.map((r)=>{const i=normalizeNotebooklmTitle(r.title,""),a=String(r.text??"").replace(/\bsticky_note_2\b/g," ").replace(/\bmore_vert\b/g," ").replace(/\s+/g," ").trim();if(!i)return null;const s=a.startsWith(i)?a.slice(i.length).trim():a.replace(i,"").trim();return{notebook_id:t,title:i,created_at:s||null,url:e,source:"studio-list"}}).filter((r)=>r!==null)}function B(o,t,e){const n=normalizeNotebooklmTitle(o?.title,"Untitled Notebook"),r=String(o?.summary??"").trim();if(!r)return null;return{notebook_id:t,title:n,summary:r,url:e,source:"summary-dom"}}function P(o,t,e){const n=normalizeNotebooklmTitle(o?.title,""),r=String(o?.content??"").replace(/\r\n/g,`
+`).trim();if(!n)return null;return{notebook_id:t,id:null,title:n,content:r,url:e,source:"studio-editor"}}export function parseNotebooklmListResult(o){if(!Array.isArray(o)||o.length===0)return[];const t=Array.isArray(o[0])?o[0]:o;if(!Array.isArray(t))return[];return t.filter((e)=>Array.isArray(e)).map((e)=>{const n=Array.isArray(e[5])?e[5]:[],r=Array.isArray(n[5])?n[5]:[],i=typeof e[2]==="string"?e[2]:"",a=typeof e[0]==="string"?e[0].replace(/^thought\s*\n/,""):"";return{id:i,title:normalizeNotebooklmTitle(a,"Untitled Notebook"),url:`https://${l}/notebook/${i}`,source:"rpc",is_owner:n.length>1?n[1]===!1:!0,created_at:r.length>0?m(r[0]):null}}).filter((e)=>e.id)}export function parseNotebooklmNotebookDetailResult(o){const t=N(o);if(!Array.isArray(t)||t.length<3)return null;const e=typeof t[2]==="string"?t[2]:"";if(!e)return null;const n=normalizeNotebooklmTitle(t[0],"Untitled Notebook"),r=typeof t[3]==="string"?t[3]:null,i=Array.isArray(t[5])?t[5]:[],a=Array.isArray(t[1])?t[1]:[];return{id:e,title:n,url:`https://${l}/notebook/${e}`,source:"rpc",is_owner:i.length>1?i[1]===!1:!0,created_at:m(i[8]),updated_at:m(i[5]),emoji:r,source_count:a.length}}export function parseNotebooklmSourceListResult(o){const t=N(o),e=parseNotebooklmNotebookDetailResult(t);if(!e||!Array.isArray(t))return[];return(Array.isArray(t[1])?t[1]:[]).filter((r)=>Array.isArray(r)).map((r)=>{const i=A(r[0])??"",a=normalizeNotebooklmTitle(r[1],"Untitled source"),s=Array.isArray(r[2])?r[2]:[],b=typeof s[4]==="number"?s[4]:r[3];return{id:i,notebook_id:e.id,title:a,url:e.url,source:"rpc",type:x(b),type_code:g(b),size:typeof s[1]==="number"&&Number.isFinite(s[1])?s[1]:null,created_at:m(s[2]),updated_at:m(s[14])}}).filter((r)=>r.id)}export function parseNotebooklmSourceGuideResult(o,t){if(!Array.isArray(o)||o.length===0||!Array.isArray(o[0]))return null;const e=o[0],n=Array.isArray(e)&&e.length>0&&Array.isArray(e[0])?e[0]:e;if(!Array.isArray(n))return null;const r=Array.isArray(n[1])&&typeof n[1][0]==="string"?n[1][0].trim():"",i=Array.isArray(n[2])&&Array.isArray(n[2][0])?n[2][0].filter((a)=>typeof a==="string"&&a.trim().length>0):[];if(!r)return null;return{source_id:t.id,notebook_id:t.notebook_id,title:t.title,type:t.type??null,summary:r,keywords:i,source:"rpc"}}export function parseNotebooklmSourceFulltextResult(o,t,e){if(!Array.isArray(o)||o.length===0||!Array.isArray(o[0]))return null;const n=o[0],r=A(n[0])??"",i=normalizeNotebooklmTitle(n[1],"Untitled source"),a=Array.isArray(n[2])?n[2]:[],s=Array.isArray(a[7])&&typeof a[7][0]==="string"?a[7][0]:e,b=x([null,a[4]]),R=Array.isArray(o[3])&&o[3].length>0?o[3][0]:[],y=O(R,[]).join(`
+`).trim();if(!r||!y)return null;return{source_id:r,notebook_id:t,title:i,kind:b,content:y,char_count:y.length,url:s,source:"rpc"}}export function findNotebooklmSourceRow(o,t){const e=t.trim().toLowerCase();if(!e)return null;const n=o.find((a)=>a.id.trim().toLowerCase()===e);if(n)return n;const r=o.find((a)=>a.title.trim().toLowerCase()===e);if(r)return r;const i=o.filter((a)=>a.title.trim().toLowerCase().includes(e));if(i.length===1)return i[0];return null}export function findNotebooklmNoteRow(o,t){const e=t.trim().toLowerCase();if(!e)return null;const n=o.find((i)=>i.title.trim().toLowerCase()===e);if(n)return n;const r=o.filter((i)=>i.title.trim().toLowerCase().includes(e));if(r.length===1)return r[0];return null}export async function listNotebooklmViaRpc(o){const t=await u(o,M,[null,1,null,[2]]);return parseNotebooklmListResult(t.result)}export async function getNotebooklmDetailViaRpc(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return null;const e=await u(o,p,[t.notebookId,null,[2],null,0]);return parseNotebooklmNotebookDetailResult(e.result)}export async function getNotebooklmNotebookDetailById(o,t){const e=await u(o,p,[t,null,[2],null,0]);return{detail:parseNotebooklmNotebookDetailResult(e.result),sources:parseNotebooklmSourceListResult(e.result)}}export async function verifyNotebooklmNotebookExists(o,t,e){try{const{detail:n}=await getNotebooklmNotebookDetailById(o,t);if(!n||n.id!==t)throw new c(`NotebookLM ${e} succeeded but the notebook ${t} was not found in the post-write verification`);return n}catch(n){if(n instanceof h||n instanceof c)throw n;throw new c(`NotebookLM ${e} post-write verification failed: ${n?.message||n}`)}}export async function verifyNotebooklmSourceAdded(o,t,e,n){try{const{detail:r,sources:i}=await getNotebooklmNotebookDetailById(o,t);if(!r||r.id!==t)throw new c(`NotebookLM ${n} succeeded but the notebook ${t} was not found in the post-write verification`);const a=i.find((s)=>s.id===e);if(!a)throw new c(`NotebookLM ${n} succeeded but source ${e} did not appear in the notebook's source list`);return a}catch(r){if(r instanceof h||r instanceof c)throw r;throw new c(`NotebookLM ${n} post-write verification failed: ${r?.message||r}`)}}export async function listNotebooklmSourcesViaRpc(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return[];const e=await u(o,p,[t.notebookId,null,[2],null,0]);return parseNotebooklmSourceListResult(e.result)}export async function listNotebooklmHistoryViaRpc(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return[];const e=await u(o,C,[[],null,t.notebookId,20]),n=parseNotebooklmHistoryThreadIdsResult(e.result);if(n.length===0)return[];const r=[];for(const i of n){const a=await u(o,E,[[],null,null,i,20]);r.push({notebook_id:t.notebookId,thread_id:i,item_count:Array.isArray(a.result)?a.result.length:0,preview:extractNotebooklmHistoryPreview(a.result),url:t.url||`https://${l}/notebook/${t.notebookId}`,source:"rpc"})}return r}export async function listNotebooklmNotesFromPage(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return[];const e=d(await o.evaluate(`(() => {
     return Array.from(document.querySelectorAll('artifact-library-note')).map((node) => {
       const titleNode = node.querySelector('.artifact-title');
       return {
@@ -8,13 +8,13 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
         text: (node.innerText || node.textContent || '').replace(/\\s+/g, ' ').trim(),
       };
     });
-  })()`));if(!Array.isArray(J)||J.length===0)return[];return parseNotebooklmNoteListRawRows(J,F.notebookId,F.url||`https://${$}/notebook/${F.notebookId}`)}export async function readNotebooklmSummaryFromPage(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return null;const J=B(await G.evaluate(`(() => {
+  })()`));if(!Array.isArray(e)||e.length===0)return[];return parseNotebooklmNoteListRawRows(e,t.notebookId,t.url||`https://${l}/notebook/${t.notebookId}`)}export async function readNotebooklmSummaryFromPage(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return null;const e=d(await o.evaluate(`(() => {
     const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
     const title = normalize(document.querySelector('.notebook-title, h1, [data-testid="notebook-title"]')?.textContent || document.title || '');
     const summaryNode = document.querySelector('.notebook-summary, .summary-content, [class*="summary"]');
     const summary = normalize(summaryNode?.textContent || '');
     return { title, summary };
-  })()`));return I(J,F.notebookId,F.url||`https://${$}/notebook/${F.notebookId}`)}export async function getNotebooklmSummaryViaRpc(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return null;const J=await j(G,Y,[F.notebookId,null,[2],null,0]),Q=H(J.result);if(!Array.isArray(Q))return null;const V=normalizeNotebooklmTitle(Q[0],"Untitled Notebook"),W=Q.filter((X,Z)=>Z!==0&&Z!==2&&Z!==3).find((X)=>typeof X==="string"&&X.trim().length>=80);if(typeof W!=="string")return null;return{notebook_id:F.notebookId,title:V,summary:W.trim(),url:F.url||`https://${$}/notebook/${F.notebookId}`,source:"rpc"}}export async function getNotebooklmSourceFulltextViaRpc(G,F){const J=await getNotebooklmPageState(G);if(J.kind!=="notebook"||!J.notebookId||!F)return null;const Q=await j(G,"hizoJc",[[F],[2],[2]]);return parseNotebooklmSourceFulltextResult(Q.result,J.notebookId,J.url||`https://${$}/notebook/${J.notebookId}`)}export async function getNotebooklmSourceGuideViaRpc(G,F){if(!F.id)return null;const J=await j(G,"tr032e",[[[[F.id]]]]);return parseNotebooklmSourceGuideResult(J.result,F)}export async function readNotebooklmVisibleNoteFromPage(G){const F=await getNotebooklmPageState(G);if(F.kind!=="notebook"||!F.notebookId)return null;const J=B(await G.evaluate(`(() => {
+  })()`));return B(e,t.notebookId,t.url||`https://${l}/notebook/${t.notebookId}`)}export async function getNotebooklmSummaryViaRpc(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return null;const e=await u(o,p,[t.notebookId,null,[2],null,0]),n=N(e.result);if(!Array.isArray(n))return null;const r=normalizeNotebooklmTitle(n[0],"Untitled Notebook"),i=n.filter((a,s)=>s!==0&&s!==2&&s!==3).find((a)=>typeof a==="string"&&a.trim().length>=80);if(typeof i!=="string")return null;return{notebook_id:t.notebookId,title:r,summary:i.trim(),url:t.url||`https://${l}/notebook/${t.notebookId}`,source:"rpc"}}export async function getNotebooklmSourceFulltextViaRpc(o,t){const e=await getNotebooklmPageState(o);if(e.kind!=="notebook"||!e.notebookId||!t)return null;const n=await u(o,"hizoJc",[[t],[2],[2]]);return parseNotebooklmSourceFulltextResult(n.result,e.notebookId,e.url||`https://${l}/notebook/${e.notebookId}`)}export async function getNotebooklmSourceGuideViaRpc(o,t){if(!t.id)return null;const e=await u(o,"tr032e",[[[[t.id]]]]);return parseNotebooklmSourceGuideResult(e.result,t)}export async function readNotebooklmVisibleNoteFromPage(o){const t=await getNotebooklmPageState(o);if(t.kind!=="notebook"||!t.notebookId)return null;const e=d(await o.evaluate(`(() => {
     const normalizeText = (value) => (value || '').replace(/\\u00a0/g, ' ').replace(/\\r\\n/g, '\\n').trim();
     const titleNode = document.querySelector('.note-header__editable-title');
     const title = titleNode instanceof HTMLInputElement || titleNode instanceof HTMLTextAreaElement
@@ -31,7 +31,7 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
       title: normalizeText(title),
       content: normalizeText(content),
     };
-  })()`));return g(J,F.notebookId,F.url||`https://${$}/notebook/${F.notebookId}`)}export async function ensureNotebooklmHome(G){const F=G.getCurrentUrl?await G.getCurrentUrl().catch(()=>null):null;if((F?classifyNotebooklmPage(F):"unknown")==="home")return;const Q=getNotebooklmAuthuser(),V=Q?`${P}?authuser=${encodeURIComponent(Q)}`:P;try{await G.goto(V);await G.wait(2)}catch(W){throw new A(`Failed to open NotebookLM home: ${W?.message||W}`)}}export async function getNotebooklmPageState(G){const F=B(await G.evaluate(`(() => {
+  })()`));return P(e,t.notebookId,t.url||`https://${l}/notebook/${t.notebookId}`)}export async function ensureNotebooklmHome(o){const t=o.getCurrentUrl?await o.getCurrentUrl().catch(()=>null):null;if((t?classifyNotebooklmPage(t):"unknown")==="home")return;const n=getNotebooklmAuthuser(),r=n?`${k}?authuser=${encodeURIComponent(n)}`:k;try{await o.goto(r);await o.wait(2)}catch(i){throw new c(`Failed to open NotebookLM home: ${i?.message||i}`)}}export async function getNotebooklmPageState(o){const t=d(await o.evaluate(`(() => {
     const url = window.location.href;
     const title = document.title || '';
     const hostname = window.location.hostname || '';
@@ -58,7 +58,7 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
       .reduce((count, href, index, list) => list.indexOf(href) === index ? count + 1 : count, 0);
 
     return { url, title, hostname, kind, notebookId, loginRequired, notebookCount, path };
-  })()`)),J={url:String(F?.url??""),title:normalizeNotebooklmTitle(F?.title,"NotebookLM"),hostname:String(F?.hostname??""),kind:F?.kind==="notebook"||F?.kind==="home"?F.kind:"unknown",notebookId:String(F?.notebookId??""),loginRequired:Boolean(F?.loginRequired),notebookCount:Number(F?.notebookCount??0)};if(J.hostname===$&&J.loginRequired)try{await z(G);J.loginRequired=!1}catch{}return J}export async function readCurrentNotebooklm(G){const F=B(await G.evaluate(`(() => {
+  })()`)),e={url:String(t?.url??""),title:normalizeNotebooklmTitle(t?.title,"NotebookLM"),hostname:String(t?.hostname??""),kind:t?.kind==="notebook"||t?.kind==="home"?t.kind:"unknown",notebookId:String(t?.notebookId??""),loginRequired:Boolean(t?.loginRequired),notebookCount:Number(t?.notebookCount??0)};if(e.hostname===l&&e.loginRequired)try{await S(o);e.loginRequired=!1}catch{}return e}export async function readCurrentNotebooklm(o){const t=d(await o.evaluate(`(() => {
     const url = window.location.href;
     const match = url.match(/\\/notebook\\/([^/?#]+)/);
     if (!match) return null;
@@ -71,7 +71,7 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
       url,
       source: 'current-page',
     };
-  })()`));if(!F)return null;return{id:String(F.id??""),title:normalizeNotebooklmTitle(F.title,"Untitled Notebook"),url:String(F.url??""),source:"current-page",is_owner:!0,created_at:null}}export async function listNotebooklmLinks(G){const F=B(await G.evaluate(`(() => {
+  })()`));if(!t)return null;return{id:String(t.id??""),title:normalizeNotebooklmTitle(t.title,"Untitled Notebook"),url:String(t.url??""),source:"current-page",is_owner:!0,created_at:null}}export async function listNotebooklmLinks(o){const t=d(await o.evaluate(`(() => {
     const rows = [];
     const seen = new Set();
 
@@ -119,7 +119,7 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
     }
 
     return rows;
-  })()`));if(!Array.isArray(F))return[];return F.map((J)=>({id:String(J.id??""),title:normalizeNotebooklmTitle(J.title,"Untitled Notebook"),url:String(J.url??""),source:"home-links",is_owner:J.is_owner===!1?!1:!0,created_at:k(J.created_at)})).filter((J)=>J.id&&J.url)}export async function listNotebooklmSourcesFromPage(G){const F=B(await G.evaluate(`(() => {
+  })()`));if(!Array.isArray(t))return[];return t.map((e)=>({id:String(e.id??""),title:normalizeNotebooklmTitle(e.title,"Untitled Notebook"),url:String(e.url??""),source:"home-links",is_owner:e.is_owner===!1?!1:!0,created_at:q(e.created_at)})).filter((e)=>e.id&&e.url)}export async function listNotebooklmSourcesFromPage(o){const t=d(await o.evaluate(`(() => {
     const notebookMatch = window.location.href.match(/\\/notebook\\/([^/?#]+)/);
     const notebookId = notebookMatch ? notebookMatch[1] : '';
     if (!notebookId) return [];
@@ -169,4 +169,4 @@ import{ArgumentError as x,AuthRequiredError as E,CliError as C,CommandExecutionE
       });
     }
     return rows;
-  })()`));if(!Array.isArray(F))return[];return F.filter((J)=>J.id&&J.title)}export async function requireNotebooklmSession(G){const F=await getNotebooklmPageState(G);if(F.hostname!==$)throw new C("NOTEBOOKLM_UNAVAILABLE","NotebookLM page is not available in the current browser session",`Open Chrome and navigate to ${P}`);if(F.loginRequired)throw new E($,"NotebookLM requires a logged-in Google session");return F}
+  })()`));if(!Array.isArray(t))return[];return t.filter((e)=>e.id&&e.title)}export async function requireNotebooklmSession(o){const t=await getNotebooklmPageState(o);if(t.hostname!==l)throw new f("NOTEBOOKLM_UNAVAILABLE","NotebookLM page is not available in the current browser session",`Open Chrome and navigate to ${k}`);if(t.loginRequired)throw new h(l,"NotebookLM requires a logged-in Google session");return t}

package/clis/nowcoder/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as F,CommandExecutionError as G}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as Q}from"../_shared/site-auth.js";async function J(D){return(await D.getCookies({url:"https://www.nowcoder.com"})).some((K)=>K.name==="t"&&K.value)}const T=`(async () => {
+import{AuthRequiredError as e,CommandExecutionError as n}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as c}from"../_shared/site-auth.js";async function r(o){return(await o.getCookies({url:"https://www.nowcoder.com"})).some((i)=>i.name==="t"&&i.value)}const d=`(async () => {
   try {
     const link = document.querySelector('a[href*="/users/"]');
     const href = link ? (link.getAttribute('href') || '') : '';
@@ -21,4 +21,4 @@ import{AuthRequiredError as F,CommandExecutionError as G}from"@jackwener/opencli
   } catch (e) {
     return { kind: 'exception', detail: String(e && e.message || e) };
   }
-})()`;async function L(D){if(!await J(D))throw new F("nowcoder.com","Nowcoder t cookie missing (anonymous)");await D.goto("https://www.nowcoder.com/");await D.wait(2);const z=await D.evaluate(T);if(z?.kind==="auth")throw new F("nowcoder.com",z.detail);if(z?.kind==="http")throw new G(`HTTP ${z.httpStatus} from nowcoder profile API`);if(z?.kind==="exception")throw new G(`Nowcoder whoami failed: ${z.detail}`);if(!z?.ok)throw new G(`Unexpected nowcoder probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,nickname:z.nickname}}Q({site:"nowcoder",domain:"nowcoder.com",loginUrl:"https://www.nowcoder.com/login",columns:["user_id","nickname"],quickCheck:J,verify:L,poll:async(D)=>{if(!await J(D))throw new F("nowcoder.com","Waiting for Nowcoder login");return L(D)}});
+})()`;async function a(o){if(!await r(o))throw new e("nowcoder.com","Nowcoder t cookie missing (anonymous)");await o.goto("https://www.nowcoder.com/");await o.wait(2);const t=await o.evaluate(d);if(t?.kind==="auth")throw new e("nowcoder.com",t.detail);if(t?.kind==="http")throw new n(`HTTP ${t.httpStatus} from nowcoder profile API`);if(t?.kind==="exception")throw new n(`Nowcoder whoami failed: ${t.detail}`);if(!t?.ok)throw new n(`Unexpected nowcoder probe: ${JSON.stringify(t)}`);return{user_id:t.user_id,nickname:t.nickname}}c({site:"nowcoder",domain:"nowcoder.com",loginUrl:"https://www.nowcoder.com/login",columns:["user_id","nickname"],quickCheck:r,verify:a,poll:async(o)=>{if(!await r(o))throw new e("nowcoder.com","Waiting for Nowcoder login");return a(o)}});

package/clis/nowcoder/comment.js

@@ -1 +1 @@
-import{cli as m,Strategy as s}from"@jackwener/opencli/registry";import{ArgumentError as d}from"@jackwener/opencli/errors";import{WWW_BASE as c,postForm as u,requireOk as a,resolveMomentId as l}from"./utils.js";import{assertLiteralContent as p}from"../_shared/content-guard.js";m({site:"nowcoder",name:"comment",access:"write",description:"评论帖子;配 --to-user/--to-comment 可定向回复某条评论",domain:"www.nowcoder.com",strategy:s.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"},{name:"content",fromFile:!0,positional:!0,required:!0,help:"评论内容"},{name:"to-user",type:"str",default:"0",help:"帖主/对方 userId(定向回复时必传)"},{name:"to-comment",type:"str",default:"0",help:"定向回复的评论 id(inbox 的 reply_comment_id)"}],columns:["post_id","kind","status"],func:async(n,t)=>{const r=await l(n,t.id),e=String(t.content??"").trim();p(e,{label:"评论内容"});if(!e)throw new d("评论内容不能为空");const i=String(t["to-user"]??"0").trim()||"0",o=String(t["to-comment"]??"0").trim()||"0";a(await u(n,`${c}/comment/create?_=${Date.now()}`,{entityType:"74",entityId:r,commentContent:e,contentV2:JSON.stringify({pureText:e,imgs:[]}),toFeed:"false",toUserId:i,toCommentId:o,entityOwnerId:i,isAnonymousFlag:"false"}),"评论");return[{post_id:r,kind:o!=="0"?`reply-to-${o}`:"comment",status:"ok"}]}});
+import{cli as i,Strategy as s}from"@jackwener/opencli/registry";import{ArgumentError as c}from"@jackwener/opencli/errors";import{WWW_BASE as d,postForm as a,requireOk as u,resolveMomentId as l}from"./utils.js";import{assertLiteralContent as p}from"../_shared/content-guard.js";i({site:"nowcoder",name:"comment",access:"write",description:"评论帖子;配 --to-user/--to-comment 可定向回复某条评论",domain:"www.nowcoder.com",strategy:s.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"},{name:"content",fromFile:!0,positional:!0,required:!0,help:"评论内容"},{name:"to-user",type:"str",default:"0",help:"帖主/对方 userId(定向回复时必传)"},{name:"to-comment",type:"str",default:"0",help:"定向回复的评论 id(inbox 的 reply_comment_id)"}],columns:["post_id","kind","status"],func:async(n,t)=>{const r=await l(n,t.id),e=String(t.content??"").trim();p(e,{label:"评论内容"});if(!e)throw new c("评论内容不能为空");const m=String(t["to-user"]??"0").trim()||"0",o=String(t["to-comment"]??"0").trim()||"0";u(await a(n,`${d}/comment/create?_=${Date.now()}`,{entityType:"74",entityId:r,commentContent:e,contentV2:JSON.stringify({pureText:e,imgs:[]}),toFeed:"false",toUserId:m,toCommentId:o,entityOwnerId:m,isAnonymousFlag:"false"}),"评论");return[{post_id:r,kind:o!=="0"?`reply-to-${o}`:"comment",status:"ok"}]}});

package/clis/nowcoder/comments.js

@@ -1 +1 @@
-import{cli as i,Strategy as m}from"@jackwener/opencli/registry";import{GW_BASE as a,getJson as d,requireOk as c,resolveMomentId as s}from"./utils.js";i({site:"nowcoder",name:"comments",access:"read",description:"某帖的评论列表(评论前先读,避免重复/不合语境)",domain:"www.nowcoder.com",strategy:m.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"},{name:"page",type:"int",default:1,help:"页码"}],columns:["comment_id","user_id","nickname","content"],func:async(t,n)=>{const o=await s(t,n.id),r=`${a}/comment/list-by-page?entityId=${encodeURIComponent(o)}&entityType=74&order=2&pageNo=${n.page}&toCommentId=0&_=${Date.now()}`;return(c(await d(t,r),"评论列表").data?.records??[]).map((e)=>({comment_id:e.id??"",user_id:e.userBrief?.userId??"",nickname:e.userBrief?.nickname??"",content:(e.content??"").trim()}))}});
+import{cli as i,Strategy as a}from"@jackwener/opencli/registry";import{GW_BASE as d,getJson as m,requireOk as c,resolveMomentId as s}from"./utils.js";i({site:"nowcoder",name:"comments",access:"read",description:"某帖的评论列表(评论前先读,避免重复/不合语境)",domain:"www.nowcoder.com",strategy:a.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"},{name:"page",type:"int",default:1,help:"页码"}],columns:["comment_id","user_id","nickname","content"],func:async(t,n)=>{const o=await s(t,n.id),r=`${d}/comment/list-by-page?entityId=${encodeURIComponent(o)}&entityType=74&order=2&pageNo=${n.page}&toCommentId=0&_=${Date.now()}`;return(c(await m(t,r),"评论列表").data?.records??[]).map((e)=>({comment_id:e.id??"",user_id:e.userBrief?.userId??"",nickname:e.userBrief?.nickname??"",content:(e.content??"").trim()}))}});

package/clis/nowcoder/dm-list.js

@@ -1 +1 @@
-import{cli as o,Strategy as r}from"@jackwener/opencli/registry";import{WWW_BASE as i,getJson as d,getSelfUid as c,requireOk as l}from"./utils.js";o({site:"nowcoder",name:"dm-list",access:"read",description:"私信会话列表(conversationId / 最后一条消息 / 未读数)",domain:"www.nowcoder.com",strategy:r.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["conversation_id","target_user_id","target_name","last_content","unread","allow_send","is_official"],func:async(a,t)=>{const n=await c(a),s=`${i}/sns/message/${n}/get-conversation-list?page=${t.page}`;return(l(await d(a,s),"私信会话列表").data?.conversations??[]).map((e)=>({conversation_id:e.conversationId??"",target_user_id:e.targetUserId??"",target_name:e.targetUserName??"",last_content:(e.content??"").replace(/\s+/g," ").slice(0,80),unread:e.unreadMessageCount??0,allow_send:e.allowSendMessage??"",is_official:e.targetIsOfficialAccount??""}))}});
+import{cli as o,Strategy as r}from"@jackwener/opencli/registry";import{WWW_BASE as i,getJson as c,getSelfUid as d,requireOk as l}from"./utils.js";o({site:"nowcoder",name:"dm-list",access:"read",description:"私信会话列表(conversationId / 最后一条消息 / 未读数)",domain:"www.nowcoder.com",strategy:r.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["conversation_id","target_user_id","target_name","last_content","unread","allow_send","is_official"],func:async(a,t)=>{const n=await d(a),s=`${i}/sns/message/${n}/get-conversation-list?page=${t.page}`;return(l(await c(a,s),"私信会话列表").data?.conversations??[]).map((e)=>({conversation_id:e.conversationId??"",target_user_id:e.targetUserId??"",target_name:e.targetUserName??"",last_content:(e.content??"").replace(/\s+/g," ").slice(0,80),unread:e.unreadMessageCount??0,allow_send:e.allowSendMessage??"",is_official:e.targetIsOfficialAccount??""}))}});

package/clis/nowcoder/dm-read.js

@@ -1 +1 @@
-import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{WWW_BASE as d,getJson as m,requireOk as c}from"./utils.js";n({site:"nowcoder",name:"dm-read",access:"read",description:"读某私信会话的消息(target 为 dm-list 的 target_user_id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"target",positional:!0,required:!0,help:"对方 userId(dm-list 的 target_user_id)"},{name:"page",type:"int",default:1,help:"页码"}],columns:["from_user_id","content"],func:async(s,r)=>{const o=String(r.target).trim(),a=`${d}/sns/message/${encodeURIComponent(o)}/get-msg-list?page=${r.page}`,t=c(await m(s,a),"私信读取").data??{};return(t.msgList??t.list??t.records??[]).map((e)=>({from_user_id:e.fromUserId??"",content:(e.content??e.msg??"").trim()}))}});
+import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{WWW_BASE as m,getJson as d,requireOk as c}from"./utils.js";n({site:"nowcoder",name:"dm-read",access:"read",description:"读某私信会话的消息(target 为 dm-list 的 target_user_id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"target",positional:!0,required:!0,help:"对方 userId(dm-list 的 target_user_id)"},{name:"page",type:"int",default:1,help:"页码"}],columns:["from_user_id","content"],func:async(s,r)=>{const a=String(r.target).trim(),o=`${m}/sns/message/${encodeURIComponent(a)}/get-msg-list?page=${r.page}`,t=c(await d(s,o),"私信读取").data??{};return(t.msgList??t.list??t.records??[]).map((e)=>({from_user_id:e.fromUserId??"",content:(e.content??e.msg??"").trim()}))}});

package/clis/nowcoder/dm-send.js

@@ -1 +1 @@
-import{cli as r,Strategy as i}from"@jackwener/opencli/registry";import{ArgumentError as s}from"@jackwener/opencli/errors";import{GW_BASE as a,postJson as c,requireOk as m}from"./utils.js";import{assertLiteralContent as d}from"../_shared/content-guard.js";r({site:"nowcoder",name:"dm-send",access:"write",description:"发私信(conversation 为 dm-list 的 conversation_id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"conversation",positional:!0,required:!0,help:"会话 id(dm-list 的 conversation_id,格式 <我uid>_<对方uid>)"},{name:"content",fromFile:!0,positional:!0,required:!0,help:"私信内容"}],columns:["conversation_id","status"],func:async(n,o)=>{const e=String(o.conversation??"").trim(),t=String(o.content??"").trim();d(t,{label:"私信内容"});if(!t)throw new s("私信内容不能为空");m(await c(n,`${a}/msg/send-msg`,{body:{content:t,sourceType:1200,conversationId:e}}),"私信发送");return[{conversation_id:e,status:"sent"}]}});
+import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{ArgumentError as s}from"@jackwener/opencli/errors";import{GW_BASE as a,postJson as c,requireOk as m}from"./utils.js";import{assertLiteralContent as d}from"../_shared/content-guard.js";n({site:"nowcoder",name:"dm-send",access:"write",description:"发私信(conversation 为 dm-list 的 conversation_id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"conversation",positional:!0,required:!0,help:"会话 id(dm-list 的 conversation_id,格式 <我uid>_<对方uid>)"},{name:"content",fromFile:!0,positional:!0,required:!0,help:"私信内容"}],columns:["conversation_id","status"],func:async(r,o)=>{const e=String(o.conversation??"").trim(),t=String(o.content??"").trim();d(t,{label:"私信内容"});if(!t)throw new s("私信内容不能为空");m(await c(r,`${a}/msg/send-msg`,{body:{content:t,sourceType:1200,conversationId:e}}),"私信发送");return[{conversation_id:e,status:"sent"}]}});

package/clis/nowcoder/drafts.js

@@ -1 +1 @@
-import{cli as i,Strategy as n}from"@jackwener/opencli/registry";import{GW_BASE as c,getJson as s,getSelfUid as d,requireOk as p}from"./utils.js";i({site:"nowcoder",name:"drafts",access:"read",description:"我的草稿列表",domain:"www.nowcoder.com",strategy:n.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["draft_id","title","content"],func:async(e,a)=>{const r=await d(e),o=`${c}/discuss-draft/list?authorId=${r}&pageNo=${a.page}&pageSize=10&entityType=250`;return(p(await s(e,o),"草稿列表").data?.records??[]).map((t)=>({draft_id:t.id??"",title:(t.title??"").trim(),content:(t.content??"").replace(/\s+/g," ").slice(0,120)}))}});
+import{cli as i,Strategy as c}from"@jackwener/opencli/registry";import{GW_BASE as n,getJson as s,getSelfUid as d,requireOk as l}from"./utils.js";i({site:"nowcoder",name:"drafts",access:"read",description:"我的草稿列表",domain:"www.nowcoder.com",strategy:c.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["draft_id","title","content"],func:async(e,a)=>{const r=await d(e),o=`${n}/discuss-draft/list?authorId=${r}&pageNo=${a.page}&pageSize=10&entityType=250`;return(l(await s(e,o),"草稿列表").data?.records??[]).map((t)=>({draft_id:t.id??"",title:(t.title??"").trim(),content:(t.content??"").replace(/\s+/g," ").slice(0,120)}))}});

package/clis/nowcoder/inbox.js

@@ -1 +1 @@
-import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{GW_BASE as m,getJson as c,requireOk as s}from"./utils.js";n({site:"nowcoder",name:"inbox",access:"read",description:"评论回复收件箱(谁回复/@了我们,含定向回复所需的评论 id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["msg_id","from_user_id","from_nickname","reply_content","reply_comment_id","quoted_ours","url","time"],func:async(t,o)=>{const r=`${m}/message/pc/comment/list?page=${o.page}&pageSize=20`;return(s(await c(t,r),"评论收件箱").data?.records??[]).map((e)=>({msg_id:e.id??"",from_user_id:e.user?.userId??"",from_nickname:e.user?.nickname??"",reply_content:(e.triggerEntity?.content??"").trim(),reply_comment_id:e.triggerEntity?.entityId??"",quoted_ours:(e.quote?.content??"").trim(),url:e.pcUrl??"",time:e.createTime??""}))}});
+import{cli as n,Strategy as i}from"@jackwener/opencli/registry";import{GW_BASE as m,getJson as c,requireOk as a}from"./utils.js";n({site:"nowcoder",name:"inbox",access:"read",description:"评论回复收件箱(谁回复/@了我们,含定向回复所需的评论 id)",domain:"www.nowcoder.com",strategy:i.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["msg_id","from_user_id","from_nickname","reply_content","reply_comment_id","quoted_ours","url","time"],func:async(t,r)=>{const o=`${m}/message/pc/comment/list?page=${r.page}&pageSize=20`;return(a(await c(t,o),"评论收件箱").data?.records??[]).map((e)=>({msg_id:e.id??"",from_user_id:e.user?.userId??"",from_nickname:e.user?.nickname??"",reply_content:(e.triggerEntity?.content??"").trim(),reply_comment_id:e.triggerEntity?.entityId??"",quoted_ours:(e.quote?.content??"").trim(),url:e.pcUrl??"",time:e.createTime??""}))}});

package/clis/nowcoder/like.js

@@ -1 +1 @@
-import{cli as r,Strategy as n}from"@jackwener/opencli/registry";import{WWW_BASE as s,postMultipart as a,requireOk as l,resolveMomentId as c}from"./utils.js";r({site:"nowcoder",name:"like",access:"write",description:"点赞帖子(toggle,再次调用取消;有频控,务必低频)",domain:"www.nowcoder.com",strategy:n.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"}],columns:["post_id","status","like_count"],func:async(t,e)=>{const o=await c(t,e.id),i=l(await a(t,`${s}/sns/like?_=${Date.now()}`,{id:o,type:"74"}),"点赞");return[{post_id:o,status:"toggled",like_count:i.count??""}]}});
+import{cli as r,Strategy as s}from"@jackwener/opencli/registry";import{WWW_BASE as n,postMultipart as a,requireOk as c,resolveMomentId as d}from"./utils.js";r({site:"nowcoder",name:"like",access:"write",description:"点赞帖子(toggle,再次调用取消;有频控,务必低频)",domain:"www.nowcoder.com",strategy:s.COOKIE,args:[{name:"id",positional:!0,required:!0,help:"帖子 id(数字 momentId / UUID / 链接均可)"}],columns:["post_id","status","like_count"],func:async(t,o)=>{const e=await d(t,o.id),i=c(await a(t,`${n}/sns/like?_=${Date.now()}`,{id:e,type:"74"}),"点赞");return[{post_id:e,status:"toggled",like_count:i.count??""}]}});

package/clis/nowcoder/my.js

@@ -1 +1 @@
-import{cli as o,Strategy as m}from"@jackwener/opencli/registry";import{WWW_BASE as s,getJson as c,requireOk as i}from"./utils.js";o({site:"nowcoder",name:"my",access:"read",description:"我发布的动态列表(含 momentId,可供 delete 使用)",domain:"www.nowcoder.com",strategy:m.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["moment_id","title","content"],func:async(e,a)=>{const n=`${s}/moment/my-moment?status=1&page=${a.page}`;return(i(await c(e,n),"我的动态").data?.tableData??[]).map((t)=>({moment_id:t.id??"",title:(t.title??"").trim(),content:(t.content??"").replace(/\s+/g," ").slice(0,120)}))}});
+import{cli as o,Strategy as m}from"@jackwener/opencli/registry";import{WWW_BASE as c,getJson as i,requireOk as r}from"./utils.js";o({site:"nowcoder",name:"my",access:"read",description:"我发布的动态列表(含 momentId,可供 delete 使用)",domain:"www.nowcoder.com",strategy:m.COOKIE,args:[{name:"page",type:"int",default:1,help:"页码"}],columns:["moment_id","title","content"],func:async(e,a)=>{const n=`${c}/moment/my-moment?status=1&page=${a.page}`;return(r(await i(e,n),"我的动态").data?.tableData??[]).map((t)=>({moment_id:t.id??"",title:(t.title??"").trim(),content:(t.content??"").replace(/\s+/g," ").slice(0,120)}))}});

package/clis/nowcoder/post.js

@@ -1 +1 @@
-import{cli as i,Strategy as a}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as m}from"@jackwener/opencli/errors";import{GW_BASE as l,postJson as s,requireOk as d}from"./utils.js";import{assertLiteralContent as p}from"../_shared/content-guard.js";i({site:"nowcoder",name:"post",access:"write",description:"发布动态(实名发帖,高风险写操作,务必低频且内容有价值)",domain:"www.nowcoder.com",strategy:a.COOKIE,args:[{name:"content",fromFile:!0,positional:!0,required:!0,help:"正文内容"},{name:"title",type:"str",default:"",help:"标题(可选)"}],columns:["moment_id","content_id","url"],func:async(o,n)=>{const e=String(n.content??"").trim();p(e,{label:"正文内容"});if(!e)throw new c("发帖正文不能为空");const r=d(await s(o,`${l}/moment/create`,{title:String(n.title??""),content:e,type:0,isAnonymousFlag:!1,publicEntrance:"发动态",publicEntrancePage:"首页"}),"发帖"),t=r.data??{};if(!t.id)throw new m(`牛客发帖响应缺少 momentId: ${JSON.stringify(r).slice(0,200)}`);return[{moment_id:t.id,content_id:t.result??"",url:t.result?`https://www.nowcoder.com/feed/main/detail/${t.result}`:""}]}});
+import{cli as i,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as a,CommandExecutionError as c}from"@jackwener/opencli/errors";import{GW_BASE as s,postJson as l,requireOk as d}from"./utils.js";import{assertLiteralContent as u}from"../_shared/content-guard.js";i({site:"nowcoder",name:"post",access:"write",description:"发布动态(实名发帖,高风险写操作,务必低频且内容有价值)",domain:"www.nowcoder.com",strategy:m.COOKIE,args:[{name:"content",fromFile:!0,positional:!0,required:!0,help:"正文内容"},{name:"title",type:"str",default:"",help:"标题(可选)"}],columns:["moment_id","content_id","url"],func:async(o,r)=>{const e=String(r.content??"").trim();u(e,{label:"正文内容"});if(!e)throw new a("发帖正文不能为空");const n=d(await l(o,`${s}/moment/create`,{title:String(r.title??""),content:e,type:0,isAnonymousFlag:!1,publicEntrance:"发动态",publicEntrancePage:"首页"}),"发帖"),t=n.data??{};if(!t.id)throw new c(`牛客发帖响应缺少 momentId: ${JSON.stringify(n).slice(0,200)}`);return[{moment_id:t.id,content_id:t.result??"",url:t.result?`https://www.nowcoder.com/feed/main/detail/${t.result}`:""}]}});

package/clis/nowcoder/utils.js

@@ -1,6 +1,6 @@
-import{AuthRequiredError as Q,CommandExecutionError as M}from"@jackwener/opencli/errors";export const GW_BASE="https://gw-c.nowcoder.com/api/sparta",WWW_BASE="https://www.nowcoder.com";export async function getJson(z,F){const H=JSON.stringify(F);return z.evaluate(`
+import{AuthRequiredError as i,CommandExecutionError as c}from"@jackwener/opencli/errors";export const GW_BASE="https://gw-c.nowcoder.com/api/sparta",WWW_BASE="https://www.nowcoder.com";export async function getJson(t,e){const r=JSON.stringify(e);return t.evaluate(`
     async () => {
-      const res = await fetch(${H}, { credentials: 'include' });
+      const res = await fetch(${r}, { credentials: 'include' });
       const text = await res.text();
       try {
         return JSON.parse(text);
@@ -8,13 +8,13 @@ import{AuthRequiredError as Q,CommandExecutionError as M}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postJson(z,F,H){const K=JSON.stringify(F),L=JSON.stringify(JSON.stringify(H));return z.evaluate(`
+  `)}export async function postJson(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(JSON.stringify(r));return t.evaluate(`
     async () => {
-      const res = await fetch(${K}, {
+      const res = await fetch(${s}, {
         method: 'POST',
         credentials: 'include',
         headers: { 'Content-Type': 'application/json' },
-        body: ${L},
+        body: ${n},
       });
       const text = await res.text();
       try {
@@ -23,10 +23,10 @@ import{AuthRequiredError as Q,CommandExecutionError as M}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postForm(z,F,H){const K=JSON.stringify(F),L=JSON.stringify(H);return z.evaluate(`
+  `)}export async function postForm(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(r);return t.evaluate(`
     async () => {
-      const body = new URLSearchParams(${L});
-      const res = await fetch(${K}, {
+      const body = new URLSearchParams(${n});
+      const res = await fetch(${s}, {
         method: 'POST',
         credentials: 'include',
         headers: {
@@ -42,11 +42,11 @@ import{AuthRequiredError as Q,CommandExecutionError as M}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export async function postMultipart(z,F,H){const K=JSON.stringify(F),L=JSON.stringify(H);return z.evaluate(`
+  `)}export async function postMultipart(t,e,r){const s=JSON.stringify(e),n=JSON.stringify(r);return t.evaluate(`
     async () => {
       const fd = new FormData();
-      for (const [k, v] of Object.entries(${L})) fd.append(k, v);
-      const res = await fetch(${K}, {
+      for (const [k, v] of Object.entries(${n})) fd.append(k, v);
+      const res = await fetch(${s}, {
         method: 'POST',
         credentials: 'include',
         body: fd,
@@ -58,11 +58,11 @@ import{AuthRequiredError as Q,CommandExecutionError as M}from"@jackwener/opencli
         return { code: -1, msg: '非 JSON 响应 (HTTP ' + res.status + '): ' + text.slice(0, 200) };
       }
     }
-  `)}export function requireOk(z,F){if(!z||typeof z!=="object"||Array.isArray(z))throw new M(`牛客 ${F} 接口返回了畸形响应`);if(Object.hasOwn(z,"success")?!!z.success:Object.hasOwn(z,"code")?z.code===0:Object.hasOwn(z,"data"))return z;const K=String(z.msg??z.message??"未知错误");if(/登录|登陆|未授权|token|身份/i.test(K))throw new Q("nowcoder.com",`牛客 ${F} 需要登录: ${K}`);throw new M(`牛客 ${F} 失败: ${K} (code=${z.code??"?"})`)}export async function resolveMomentId(z,F){let H=String(F??"").trim();for(const T of[/detail\/([0-9a-fA-F]{20,})/,/discuss\/(\d+)/]){const P=H.match(T);if(P){H=P[1];break}}if(/^\d+$/.test(H))return H;if(!/^[0-9a-fA-F]{20,}$/.test(H))throw new M(`无法从输入解析牛客帖子 id: ${F}`);const L=requireOk(await getJson(z,`${GW_BASE}/detail/moment-data/detail/${H}`),"帖子解析").data?.id;if(!L)throw new M(`牛客帖子 ${H} 的详情缺少数字 momentId`);return String(L)}export async function getSelfUid(z){const F=await z.evaluate(`
+  `)}export function requireOk(t,e){if(!t||typeof t!=="object"||Array.isArray(t))throw new c(`牛客 ${e} 接口返回了畸形响应`);if(Object.hasOwn(t,"success")?!!t.success:Object.hasOwn(t,"code")?t.code===0:Object.hasOwn(t,"data"))return t;const s=String(t.msg??t.message??"未知错误");if(/登录|登陆|未授权|token|身份/i.test(s))throw new i("nowcoder.com",`牛客 ${e} 需要登录: ${s}`);throw new c(`牛客 ${e} 失败: ${s} (code=${t.code??"?"})`)}export async function resolveMomentId(t,e){let r=String(e??"").trim();for(const a of[/detail\/([0-9a-fA-F]{20,})/,/discuss\/(\d+)/]){const o=r.match(a);if(o){r=o[1];break}}if(/^\d+$/.test(r))return r;if(!/^[0-9a-fA-F]{20,}$/.test(r))throw new c(`无法从输入解析牛客帖子 id: ${e}`);const n=requireOk(await getJson(t,`${GW_BASE}/detail/moment-data/detail/${r}`),"帖子解析").data?.id;if(!n)throw new c(`牛客帖子 ${r} 的详情缺少数字 momentId`);return String(n)}export async function getSelfUid(t){const e=await t.evaluate(`
     async () => {
       const link = document.querySelector('a[href*="/users/"]');
       const href = link ? (link.getAttribute('href') || '') : '';
       const match = href.match(/\\/users\\/(\\d+)/);
       return match ? match[1] : '';
     }
-  `);if(!F)throw new Q("nowcoder.com","导航栏无登录用户链接(未登录)");return F}
+  `);if(!e)throw new i("nowcoder.com","导航栏无登录用户链接(未登录)");return e}

package/clis/npm/downloads.js

@@ -1 +1 @@
-import{cli as i,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as d,EmptyResultError as p}from"@jackwener/opencli/errors";import{NPM_API as w,npmFetch as c,requirePackageName as Y}from"./utils.js";const g=new Set(["last-day","last-week","last-month","last-year"]),u=/^(\d{4}-\d{2}-\d{2}):(\d{4}-\d{2}-\d{2})$/;function y(e){const a=String(e??"last-week").trim();if(g.has(a))return a;const n=u.exec(a);if(n){const[,t,o]=n;if(new Date(t)>new Date(o))throw new d(`npm downloads period start ${t} is after end ${o}`);return`${t}:${o}`}throw new d(`npm downloads period "${e}" is invalid`,"Use last-day / last-week (default) / last-month / last-year, or YYYY-MM-DD:YYYY-MM-DD.")}i({site:"npm",name:"downloads",access:"read",description:"Daily download counts for an npm package over a window",domain:"api.npmjs.org",strategy:m.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'npm package name (e.g. "react", "@vercel/og")'},{name:"period",default:"last-week",help:"last-day / last-week / last-month / last-year, or YYYY-MM-DD:YYYY-MM-DD"}],columns:["rank","package","day","downloads"],func:async(e)=>{const a=Y(e.name),n=y(e.period),t=`${w}/downloads/range/${n}/${a}`,o=await c(t,`npm downloads ${a}`),s=Array.isArray(o?.downloads)?o.downloads:[];if(!s.length)throw new p("npm downloads",`npm has no download stats for "${a}" in window ${n}.`);return s.map((r,l)=>({rank:l+1,package:String(o.package??a),day:String(r.day??""),downloads:r.downloads!=null?Number(r.downloads):null}))}});
+import{cli as i,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as d,EmptyResultError as w}from"@jackwener/opencli/errors";import{NPM_API as p,npmFetch as c,requirePackageName as u}from"./utils.js";const y=new Set(["last-day","last-week","last-month","last-year"]),g=/^(\d{4}-\d{2}-\d{2}):(\d{4}-\d{2}-\d{2})$/;function Y(n){const a=String(n??"last-week").trim();if(y.has(a))return a;const o=g.exec(a);if(o){const[,t,e]=o;if(new Date(t)>new Date(e))throw new d(`npm downloads period start ${t} is after end ${e}`);return`${t}:${e}`}throw new d(`npm downloads period "${n}" is invalid`,"Use last-day / last-week (default) / last-month / last-year, or YYYY-MM-DD:YYYY-MM-DD.")}i({site:"npm",name:"downloads",access:"read",description:"Daily download counts for an npm package over a window",domain:"api.npmjs.org",strategy:m.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'npm package name (e.g. "react", "@vercel/og")'},{name:"period",default:"last-week",help:"last-day / last-week / last-month / last-year, or YYYY-MM-DD:YYYY-MM-DD"}],columns:["rank","package","day","downloads"],func:async(n)=>{const a=u(n.name),o=Y(n.period),t=`${p}/downloads/range/${o}/${a}`,e=await c(t,`npm downloads ${a}`),s=Array.isArray(e?.downloads)?e.downloads:[];if(!s.length)throw new w("npm downloads",`npm has no download stats for "${a}" in window ${o}.`);return s.map((r,l)=>({rank:l+1,package:String(e.package??a),day:String(r.day??""),downloads:r.downloads!=null?Number(r.downloads):null}))}});

package/clis/npm/package.js

@@ -1 +1 @@
-import{cli as p,Strategy as m}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{NPM_REGISTRY as l,npmFetch as g,requirePackageName as d}from"./utils.js";function f(e){if(!e)return"";if(typeof e==="string")return e;if(typeof e==="object"&&typeof e.url==="string")return e.url.replace(/^git\+/,"").replace(/\.git$/,"");return""}function y(e){if(!e)return"";if(typeof e==="string")return e;if(typeof e==="object"&&typeof e.url==="string")return e.url;return""}p({site:"npm",name:"package",access:"read",description:"Single npm package metadata (latest version, license, homepage, repository). Use `npm downloads` for stats.",domain:"registry.npmjs.org",strategy:m.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'npm package name (e.g. "react", "@vercel/og")'}],columns:["name","latestVersion","description","license","homepage","repository","bugs","maintainers","keywords","created","modified","url"],func:async(e)=>{const n=d(e.name),r=await g(`${l}/${n.split("/").map(encodeURIComponent).join("/")}`,`npm package ${n}`),a=r?.["dist-tags"]?.latest;if(!a)throw new c("npm package",`npm registry has no latest version for "${n}".`);const t=r?.versions?.[a]??{},s=Array.isArray(r.maintainers)?r.maintainers.map((i)=>typeof i==="object"&&i?i.name||i.email||"":String(i)).filter(Boolean).join(", "):"",o=Array.isArray(t.keywords)?t.keywords.join(", "):"";return[{name:String(r.name??n),latestVersion:String(a),description:String(t.description??r.description??""),license:typeof t.license==="string"?t.license:t.license?.type??"",homepage:String(t.homepage??""),repository:f(t.repository),bugs:y(t.bugs),maintainers:s,keywords:o,created:String(r.time?.created??"").slice(0,10),modified:String(r.time?.modified??"").slice(0,10),url:`https://www.npmjs.com/package/${n}`}]}});
+import{cli as c,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{NPM_REGISTRY as l,npmFetch as g,requirePackageName as f}from"./utils.js";function y(e){if(!e)return"";if(typeof e==="string")return e;if(typeof e==="object"&&typeof e.url==="string")return e.url.replace(/^git\+/,"").replace(/\.git$/,"");return""}function d(e){if(!e)return"";if(typeof e==="string")return e;if(typeof e==="object"&&typeof e.url==="string")return e.url;return""}c({site:"npm",name:"package",access:"read",description:"Single npm package metadata (latest version, license, homepage, repository). Use `npm downloads` for stats.",domain:"registry.npmjs.org",strategy:p.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'npm package name (e.g. "react", "@vercel/og")'}],columns:["name","latestVersion","description","license","homepage","repository","bugs","maintainers","keywords","created","modified","url"],func:async(e)=>{const n=f(e.name),t=await g(`${l}/${n.split("/").map(encodeURIComponent).join("/")}`,`npm package ${n}`),a=t?.["dist-tags"]?.latest;if(!a)throw new m("npm package",`npm registry has no latest version for "${n}".`);const r=t?.versions?.[a]??{},o=Array.isArray(t.maintainers)?t.maintainers.map((i)=>typeof i==="object"&&i?i.name||i.email||"":String(i)).filter(Boolean).join(", "):"",s=Array.isArray(r.keywords)?r.keywords.join(", "):"";return[{name:String(t.name??n),latestVersion:String(a),description:String(r.description??t.description??""),license:typeof r.license==="string"?r.license:r.license?.type??"",homepage:String(r.homepage??""),repository:y(r.repository),bugs:d(r.bugs),maintainers:o,keywords:s,created:String(t.time?.created??"").slice(0,10),modified:String(t.time?.modified??"").slice(0,10),url:`https://www.npmjs.com/package/${n}`}]}});

package/clis/npm/search.js

@@ -1 +1 @@
-import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{NPM_REGISTRY as u,npmFetch as y,requireBoundedInt as g,requireString as h}from"./utils.js";c({site:"npm",name:"search",access:"read",description:"Search the public npm registry by keyword",domain:"registry.npmjs.org",strategy:d.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "react", "graphql client")'},{name:"limit",type:"int",default:20,help:"Max results (1-250)"}],columns:["rank","name","version","description","weeklyDownloads","dependents","license","publisher","updated","url"],func:async(r)=>{const t=h(r.query,"query"),s=g(r.limit,20,250),p=`${u}/-/v1/search?text=${encodeURIComponent(t)}&size=${s}`,i=await y(p,"npm search"),a=Array.isArray(i?.objects)?i.objects:[];if(!a.length)throw new m("npm search",`No npm packages matched "${t}".`);return a.slice(0,s).map((n,l)=>{const e=n?.package??{},o=n?.downloads??{};return{rank:l+1,name:String(e.name??""),version:String(e.version??""),description:String(e.description??""),weeklyDownloads:o.weekly!=null?Number(o.weekly):null,dependents:n.dependents!=null?Number(n.dependents):null,license:String(e.license??""),publisher:String(e.publisher?.username??""),updated:String(n.updated??"").slice(0,10),url:e.links?.npm?String(e.links.npm):e.name?`https://www.npmjs.com/package/${e.name}`:""}})}});
+import{cli as p,Strategy as m}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{NPM_REGISTRY as u,npmFetch as y,requireBoundedInt as g,requireString as h}from"./utils.js";p({site:"npm",name:"search",access:"read",description:"Search the public npm registry by keyword",domain:"registry.npmjs.org",strategy:m.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "react", "graphql client")'},{name:"limit",type:"int",default:20,help:"Max results (1-250)"}],columns:["rank","name","version","description","weeklyDownloads","dependents","license","publisher","updated","url"],func:async(r)=>{const t=h(r.query,"query"),s=g(r.limit,20,250),o=`${u}/-/v1/search?text=${encodeURIComponent(t)}&size=${s}`,i=await y(o,"npm search"),a=Array.isArray(i?.objects)?i.objects:[];if(!a.length)throw new d("npm search",`No npm packages matched "${t}".`);return a.slice(0,s).map((n,c)=>{const e=n?.package??{},l=n?.downloads??{};return{rank:c+1,name:String(e.name??""),version:String(e.version??""),description:String(e.description??""),weeklyDownloads:l.weekly!=null?Number(l.weekly):null,dependents:n.dependents!=null?Number(n.dependents):null,license:String(e.license??""),publisher:String(e.publisher?.username??""),updated:String(n.updated??"").slice(0,10),url:e.links?.npm?String(e.links.npm):e.name?`https://www.npmjs.com/package/${e.name}`:""}})}});

package/clis/npm/utils.js

@@ -1 +1 @@
-import{ArgumentError as F,CommandExecutionError as J,EmptyResultError as L}from"@jackwener/opencli/errors";export const NPM_REGISTRY="https://registry.npmjs.org",NPM_API="https://api.npmjs.org";const O="opencli-npm-adapter (+https://github.com/jackwener/OpenCLI)",Q=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i;export function requireString(B,q){const z=String(B??"").trim();if(!z)throw new F(`npm ${q} cannot be empty`);return z}export function requirePackageName(B){const q=String(B??"").trim();if(!q)throw new F('npm package name is required (e.g. "react", "@vercel/og")');if(q.length>214)throw new F(`npm package name "${B}" is too long (max 214 chars)`);if(!Q.test(q))throw new F(`npm package name "${B}" is not a valid registry name`,'Names are 1–214 chars of lowercase a-z / 0-9 / "-._" (scoped form: "@scope/name").');return q}export function requireBoundedInt(B,q,z,H="limit"){const D=B??q,I=typeof D==="number"?D:Number(D);if(!Number.isInteger(I)||I<=0)throw new F(`npm ${H} must be a positive integer`);if(I>z)throw new F(`npm ${H} must be <= ${z}`);return I}export async function npmFetch(B,q){let z;try{z=await fetch(B,{headers:{"user-agent":O,accept:"application/json"}})}catch(D){throw new J(`${q} request failed: ${D?.message??D}`,"Check that registry.npmjs.org / api.npmjs.org are reachable from this network.")}if(z.status===404)throw new L(q,`npm registry returned 404 for ${B}.`);if(z.status===429)throw new J(`${q} returned HTTP 429 (rate limited)`,"npm throttles unauthenticated bursts; wait a few seconds and retry.");if(!z.ok)throw new J(`${q} returned HTTP ${z.status}`);let H;try{H=await z.json()}catch(D){throw new J(`${q} returned malformed JSON: ${D?.message??D}`)}return H}
+import{ArgumentError as o,CommandExecutionError as i,EmptyResultError as m}from"@jackwener/opencli/errors";export const NPM_REGISTRY="https://registry.npmjs.org",NPM_API="https://api.npmjs.org";const c="opencli-npm-adapter (+https://github.com/jackwener/OpenCLI)",p=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i;export function requireString(r,e){const t=String(r??"").trim();if(!t)throw new o(`npm ${e} cannot be empty`);return t}export function requirePackageName(r){const e=String(r??"").trim();if(!e)throw new o('npm package name is required (e.g. "react", "@vercel/og")');if(e.length>214)throw new o(`npm package name "${r}" is too long (max 214 chars)`);if(!p.test(e))throw new o(`npm package name "${r}" is not a valid registry name`,'Names are 1–214 chars of lowercase a-z / 0-9 / "-._" (scoped form: "@scope/name").');return e}export function requireBoundedInt(r,e,t,s="limit"){const n=r??e,a=typeof n==="number"?n:Number(n);if(!Number.isInteger(a)||a<=0)throw new o(`npm ${s} must be a positive integer`);if(a>t)throw new o(`npm ${s} must be <= ${t}`);return a}export async function npmFetch(r,e){let t;try{t=await fetch(r,{headers:{"user-agent":c,accept:"application/json"}})}catch(n){throw new i(`${e} request failed: ${n?.message??n}`,"Check that registry.npmjs.org / api.npmjs.org are reachable from this network.")}if(t.status===404)throw new m(e,`npm registry returned 404 for ${r}.`);if(t.status===429)throw new i(`${e} returned HTTP 429 (rate limited)`,"npm throttles unauthenticated bursts; wait a few seconds and retry.");if(!t.ok)throw new i(`${e} returned HTTP ${t.status}`);let s;try{s=await t.json()}catch(n){throw new i(`${e} returned malformed JSON: ${n?.message??n}`)}return s}

package/clis/nuget/package.js

@@ -1 +1 @@
-import{cli as $,Strategy as q}from"@jackwener/opencli/registry";import{CommandExecutionError as Q,EmptyResultError as B}from"@jackwener/opencli/errors";import{NUGET_REGISTRATION_BASE as O,joinAuthors as P,joinTags as f,nugetFetch as W,requirePackageId as v}from"./utils.js";$({site:"nuget",name:"package",access:"read",description:"Full NuGet package version history (catalogEntry per release)",domain:"api.nuget.org",strategy:q.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'NuGet package id (e.g. "Newtonsoft.Json", case-insensitive)'}],columns:["rank","id","version","title","authors","tags","language","licenseExpression","projectUrl","published","listed","url"],func:async(X)=>{const K=v(X.id),Y=`${O}/${encodeURIComponent(K.toLowerCase())}/index.json`,V=await W(Y,"nuget package"),Z=Array.isArray(V?.items)?V.items:[],M=[];for(const[J,H]of Z.entries()){let z=Array.isArray(H?.items)?H.items:null;if(!z){const D=typeof H?.["@id"]==="string"?H["@id"]:null;if(!D)throw new Q(`nuget package registration page ${J+1} is missing @id for package "${K}"`);const L=await W(D,"nuget package page");if(!Array.isArray(L?.items))throw new Q(`nuget package registration leaf ${D} did not include an items array`);z=L.items}for(const D of z){if(!D||typeof D!=="object"||!D.catalogEntry||typeof D.catalogEntry!=="object")throw new Q(`nuget package registration page ${J+1} contains a malformed version entry`);M.push(D)}}if(!M.length)throw new B("nuget package",`No published versions found for NuGet package "${K}".`);return[...M].sort((J,H)=>{const z=J?.catalogEntry?.published??"",D=H?.catalogEntry?.published??"";if(z!==D)return D.localeCompare(z);const L=J?.catalogEntry?.version??"";return(H?.catalogEntry?.version??"").localeCompare(L)}).map((J,H)=>{const z=J?.catalogEntry??{};return{rank:H+1,id:typeof z?.id==="string"?z.id:K,version:typeof z?.version==="string"?z.version:null,title:typeof z?.title==="string"?z.title:null,authors:P(z?.authors),tags:f(z?.tags),language:typeof z?.language==="string"?z.language:null,licenseExpression:typeof z?.licenseExpression==="string"?z.licenseExpression:null,projectUrl:typeof z?.projectUrl==="string"?z.projectUrl:null,published:typeof z?.published==="string"?z.published:null,listed:typeof z?.listed==="boolean"?z.listed:null,url:typeof z?.id==="string"&&typeof z?.version==="string"?`https://www.nuget.org/packages/${z.id}/${z.version}`:""}})}});
+import{cli as d,Strategy as f}from"@jackwener/opencli/registry";import{CommandExecutionError as i,EmptyResultError as y}from"@jackwener/opencli/errors";import{NUGET_REGISTRATION_BASE as m,joinAuthors as h,joinTags as E,nugetFetch as g,requirePackageId as w}from"./utils.js";d({site:"nuget",name:"package",access:"read",description:"Full NuGet package version history (catalogEntry per release)",domain:"api.nuget.org",strategy:f.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'NuGet package id (e.g. "Newtonsoft.Json", case-insensitive)'}],columns:["rank","id","version","title","authors","tags","language","licenseExpression","projectUrl","published","listed","url"],func:async(p)=>{const o=w(p.id),c=`${m}/${encodeURIComponent(o.toLowerCase())}/index.json`,l=await g(c,"nuget package"),u=Array.isArray(l?.items)?l.items:[],a=[];for(const[n,r]of u.entries()){let e=Array.isArray(r?.items)?r.items:null;if(!e){const t=typeof r?.["@id"]==="string"?r["@id"]:null;if(!t)throw new i(`nuget package registration page ${n+1} is missing @id for package "${o}"`);const s=await g(t,"nuget package page");if(!Array.isArray(s?.items))throw new i(`nuget package registration leaf ${t} did not include an items array`);e=s.items}for(const t of e){if(!t||typeof t!=="object"||!t.catalogEntry||typeof t.catalogEntry!=="object")throw new i(`nuget package registration page ${n+1} contains a malformed version entry`);a.push(t)}}if(!a.length)throw new y("nuget package",`No published versions found for NuGet package "${o}".`);return[...a].sort((n,r)=>{const e=n?.catalogEntry?.published??"",t=r?.catalogEntry?.published??"";if(e!==t)return t.localeCompare(e);const s=n?.catalogEntry?.version??"";return(r?.catalogEntry?.version??"").localeCompare(s)}).map((n,r)=>{const e=n?.catalogEntry??{};return{rank:r+1,id:typeof e?.id==="string"?e.id:o,version:typeof e?.version==="string"?e.version:null,title:typeof e?.title==="string"?e.title:null,authors:h(e?.authors),tags:E(e?.tags),language:typeof e?.language==="string"?e.language:null,licenseExpression:typeof e?.licenseExpression==="string"?e.licenseExpression:null,projectUrl:typeof e?.projectUrl==="string"?e.projectUrl:null,published:typeof e?.published==="string"?e.published:null,listed:typeof e?.listed==="boolean"?e.listed:null,url:typeof e?.id==="string"&&typeof e?.version==="string"?`https://www.nuget.org/packages/${e.id}/${e.version}`:""}})}});

package/clis/nuget/search.js

@@ -1 +1 @@
-import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as p}from"@jackwener/opencli/errors";import{NUGET_SEARCH_BASE as y,joinAuthors as f,joinTags as h,nugetFetch as m,requireBoundedInt as g,requireString as w}from"./utils.js";c({site:"nuget",name:"search",access:"read",description:"Search NuGet packages by keyword",domain:"api.nuget.org",strategy:d.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Max packages (1-1000)"},{name:"prerelease",type:"boolean",default:!1,help:"Include prerelease versions"}],columns:["rank","id","version","title","description","authors","tags","totalDownloads","verified","projectUrl","url"],func:async(t)=>{const o=w(t.query,"query"),a=g(t.limit,20,1000),i=t.prerelease===!0?"true":"false",l=`${y}/query?q=${encodeURIComponent(o)}&take=${a}&prerelease=${i}`,n=await m(l,"nuget search"),s=Array.isArray(n?.data)?n.data:[];if(!s.length)throw new p("nuget search",`No NuGet packages matched "${o}".`);return s.slice(0,a).map((e,u)=>{const r=typeof e?.id==="string"?e.id:"";return{rank:u+1,id:r,version:typeof e?.version==="string"?e.version:null,title:typeof e?.title==="string"?e.title:null,description:typeof e?.description==="string"?e.description:null,authors:f(e?.authors),tags:h(e?.tags),totalDownloads:typeof e?.totalDownloads==="number"?e.totalDownloads:null,verified:e?.verified===!0,projectUrl:typeof e?.projectUrl==="string"?e.projectUrl:null,url:r?`https://www.nuget.org/packages/${r}`:""}})}});
+import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as p}from"@jackwener/opencli/errors";import{NUGET_SEARCH_BASE as y,joinAuthors as m,joinTags as f,nugetFetch as h,requireBoundedInt as w,requireString as g}from"./utils.js";c({site:"nuget",name:"search",access:"read",description:"Search NuGet packages by keyword",domain:"api.nuget.org",strategy:d.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Max packages (1-1000)"},{name:"prerelease",type:"boolean",default:!1,help:"Include prerelease versions"}],columns:["rank","id","version","title","description","authors","tags","totalDownloads","verified","projectUrl","url"],func:async(t)=>{const o=g(t.query,"query"),a=w(t.limit,20,1000),i=t.prerelease===!0?"true":"false",l=`${y}/query?q=${encodeURIComponent(o)}&take=${a}&prerelease=${i}`,n=await h(l,"nuget search"),s=Array.isArray(n?.data)?n.data:[];if(!s.length)throw new p("nuget search",`No NuGet packages matched "${o}".`);return s.slice(0,a).map((e,u)=>{const r=typeof e?.id==="string"?e.id:"";return{rank:u+1,id:r,version:typeof e?.version==="string"?e.version:null,title:typeof e?.title==="string"?e.title:null,description:typeof e?.description==="string"?e.description:null,authors:m(e?.authors),tags:f(e?.tags),totalDownloads:typeof e?.totalDownloads==="number"?e.totalDownloads:null,verified:e?.verified===!0,projectUrl:typeof e?.projectUrl==="string"?e.projectUrl:null,url:r?`https://www.nuget.org/packages/${r}`:""}})}});

package/clis/nuget/utils.js

@@ -1 +1 @@
-import{ArgumentError as J,CommandExecutionError as M,EmptyResultError as O}from"@jackwener/opencli/errors";export const NUGET_SEARCH_BASE="https://azuresearch-usnc.nuget.org",NUGET_REGISTRATION_BASE="https://api.nuget.org/v3/registration5-semver1";const Q="opencli-nuget-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",S=/^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,99})$/;export function requireString(z,q){const B=String(z??"").trim();if(!B)throw new J(`nuget ${q} cannot be empty`);return B}export function requireBoundedInt(z,q,B,H="limit"){const F=z??q,L=typeof F==="number"?F:Number(F);if(!Number.isInteger(L)||L<=0)throw new J(`nuget ${H} must be a positive integer`);if(L>B)throw new J(`nuget ${H} must be <= ${B}`);return L}export function requirePackageId(z){const q=String(z??"").trim();if(!q)throw new J('nuget package id is required (e.g. "Newtonsoft.Json")');if(!S.test(q))throw new J(`nuget package id "${z}" is not a valid NuGet identifier`,"NuGet IDs are 1-100 chars: letters/digits/`.`/`_`/`-`, starting with letter or digit.");return q}export async function nugetFetch(z,q){let B;try{B=await fetch(z,{headers:{"user-agent":Q,accept:"application/json"}})}catch(F){throw new M(`${q} request failed: ${F?.message??F}`,"Check that api.nuget.org is reachable from this network.")}if(B.status===404)throw new O(q,`NuGet returned 404 for ${z}.`);if(B.status===429)throw new M(`${q} returned HTTP 429 (rate limited)`);if(!B.ok)throw new M(`${q} returned HTTP ${B.status}`);let H;try{H=await B.json()}catch(F){throw new M(`${q} returned malformed JSON: ${F?.message??F}`)}return H}export function joinTags(z){if(!Array.isArray(z))return"";return z.filter((q)=>typeof q==="string"&&q.trim()).join(", ")}export function joinAuthors(z){if(Array.isArray(z))return z.filter((q)=>typeof q==="string"&&q.trim()).join(", ");if(typeof z==="string")return z.trim();return""}
+import{ArgumentError as o,CommandExecutionError as u,EmptyResultError as a}from"@jackwener/opencli/errors";export const NUGET_SEARCH_BASE="https://azuresearch-usnc.nuget.org",NUGET_REGISTRATION_BASE="https://api.nuget.org/v3/registration5-semver1";const c="opencli-nuget-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",g=/^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,99})$/;export function requireString(e,t){const r=String(e??"").trim();if(!r)throw new o(`nuget ${t} cannot be empty`);return r}export function requireBoundedInt(e,t,r,i="limit"){const n=e??t,s=typeof n==="number"?n:Number(n);if(!Number.isInteger(s)||s<=0)throw new o(`nuget ${i} must be a positive integer`);if(s>r)throw new o(`nuget ${i} must be <= ${r}`);return s}export function requirePackageId(e){const t=String(e??"").trim();if(!t)throw new o('nuget package id is required (e.g. "Newtonsoft.Json")');if(!g.test(t))throw new o(`nuget package id "${e}" is not a valid NuGet identifier`,"NuGet IDs are 1-100 chars: letters/digits/`.`/`_`/`-`, starting with letter or digit.");return t}export async function nugetFetch(e,t){let r;try{r=await fetch(e,{headers:{"user-agent":c,accept:"application/json"}})}catch(n){throw new u(`${t} request failed: ${n?.message??n}`,"Check that api.nuget.org is reachable from this network.")}if(r.status===404)throw new a(t,`NuGet returned 404 for ${e}.`);if(r.status===429)throw new u(`${t} returned HTTP 429 (rate limited)`);if(!r.ok)throw new u(`${t} returned HTTP ${r.status}`);let i;try{i=await r.json()}catch(n){throw new u(`${t} returned malformed JSON: ${n?.message??n}`)}return i}export function joinTags(e){if(!Array.isArray(e))return"";return e.filter((t)=>typeof t==="string"&&t.trim()).join(", ")}export function joinAuthors(e){if(Array.isArray(e))return e.filter((t)=>typeof t==="string"&&t.trim()).join(", ");if(typeof e==="string")return e.trim();return""}

package/clis/nvd/cve.js

@@ -1 +1 @@
-import{cli as l,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as v,CommandExecutionError as a,EmptyResultError as f}from"@jackwener/opencli/errors";const p="https://services.nvd.nist.gov/rest/json/cves/2.0",g="opencli-nvd-adapter (+https://github.com/jackwener/OpenCLI)",h=/^CVE-\d{4}-\d{4,}$/i;function y(e){const t=String(e??"").trim().toUpperCase();if(!t)throw new v('nvd CVE id is required (e.g. "CVE-2021-44228")');if(!h.test(t))throw new v(`nvd CVE id "${e}" is not a valid CVE identifier`,'Expected the form "CVE-YYYY-N..." with at least 4 sequence digits.');return t}function V(e){if(!Array.isArray(e))return"";const t=e.find((s)=>s?.lang==="en");return String(t?.value??e[0]?.value??"").trim()}function S(e){if(!e||typeof e!=="object")return null;const t=[...Array.isArray(e.cvssMetricV31)?e.cvssMetricV31:[],...Array.isArray(e.cvssMetricV30)?e.cvssMetricV30:[],...Array.isArray(e.cvssMetricV2)?e.cvssMetricV2:[]];return t.find((s)=>s?.type==="Primary")||t[0]||null}function w(e){if(!Array.isArray(e))return"";const t=new Set;for(const s of e)for(const i of s?.description??[])if(i?.value)t.add(String(i.value));return[...t].join(", ")}l({site:"nvd",name:"cve",access:"read",description:"NIST NVD CVE detail (description, CVSS, CWE, KEV flag)",domain:"services.nvd.nist.gov",strategy:u.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'CVE identifier (e.g. "CVE-2021-44228")'}],columns:["id","published","lastModified","vulnStatus","baseScore","severity","attackVector","cwe","kevAdded","description","url"],func:async(e)=>{const t=y(e.id),s=`${p}?cveId=${encodeURIComponent(t)}`;let i;try{i=await fetch(s,{headers:{"user-agent":g,accept:"application/json"}})}catch(n){throw new a(`nvd cve request failed: ${n?.message??n}`)}if(i.status===403)throw new a("nvd cve returned HTTP 403","NVD enforces aggressive rate limits without an API key. Wait, then retry or set NVD_API_KEY (not yet wired).");if(i.status===429)throw new a("nvd cve returned HTTP 429 (rate limited)","NVD throttles unauthenticated traffic; wait several seconds before retry.");if(!i.ok)throw new a(`nvd cve returned HTTP ${i.status}`);let c;try{c=await i.json()}catch(n){throw new a(`nvd cve returned malformed JSON: ${n?.message??n}`)}const r=(Array.isArray(c?.vulnerabilities)?c.vulnerabilities:[])[0]?.cve;if(!r||!r.id)throw new f("nvd cve",`NVD has no record for "${t}".`);const d=S(r.metrics),o=d?.cvssData??{};return[{id:String(r.id),published:String(r.published??"").slice(0,10),lastModified:String(r.lastModified??"").slice(0,10),vulnStatus:String(r.vulnStatus??""),baseScore:o.baseScore!=null?Number(o.baseScore):null,severity:String(o.baseSeverity??d?.baseSeverity??""),attackVector:String(o.attackVector??""),cwe:w(r.weaknesses),kevAdded:r.cisaExploitAdd?String(r.cisaExploitAdd).slice(0,10):"",description:V(r.descriptions),url:`https://nvd.nist.gov/vuln/detail/${r.id}`}]}});
+import{cli as l,Strategy as v}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as a,EmptyResultError as f}from"@jackwener/opencli/errors";const p="https://services.nvd.nist.gov/rest/json/cves/2.0",y="opencli-nvd-adapter (+https://github.com/jackwener/OpenCLI)",g=/^CVE-\d{4}-\d{4,}$/i;function w(e){const t=String(e??"").trim().toUpperCase();if(!t)throw new u('nvd CVE id is required (e.g. "CVE-2021-44228")');if(!g.test(t))throw new u(`nvd CVE id "${e}" is not a valid CVE identifier`,'Expected the form "CVE-YYYY-N..." with at least 4 sequence digits.');return t}function h(e){if(!Array.isArray(e))return"";const t=e.find((s)=>s?.lang==="en");return String(t?.value??e[0]?.value??"").trim()}function V(e){if(!e||typeof e!=="object")return null;const t=[...Array.isArray(e.cvssMetricV31)?e.cvssMetricV31:[],...Array.isArray(e.cvssMetricV30)?e.cvssMetricV30:[],...Array.isArray(e.cvssMetricV2)?e.cvssMetricV2:[]];return t.find((s)=>s?.type==="Primary")||t[0]||null}function S(e){if(!Array.isArray(e))return"";const t=new Set;for(const s of e)for(const i of s?.description??[])if(i?.value)t.add(String(i.value));return[...t].join(", ")}l({site:"nvd",name:"cve",access:"read",description:"NIST NVD CVE detail (description, CVSS, CWE, KEV flag)",domain:"services.nvd.nist.gov",strategy:v.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'CVE identifier (e.g. "CVE-2021-44228")'}],columns:["id","published","lastModified","vulnStatus","baseScore","severity","attackVector","cwe","kevAdded","description","url"],func:async(e)=>{const t=w(e.id),s=`${p}?cveId=${encodeURIComponent(t)}`;let i;try{i=await fetch(s,{headers:{"user-agent":y,accept:"application/json"}})}catch(n){throw new a(`nvd cve request failed: ${n?.message??n}`)}if(i.status===403)throw new a("nvd cve returned HTTP 403","NVD enforces aggressive rate limits without an API key. Wait, then retry or set NVD_API_KEY (not yet wired).");if(i.status===429)throw new a("nvd cve returned HTTP 429 (rate limited)","NVD throttles unauthenticated traffic; wait several seconds before retry.");if(!i.ok)throw new a(`nvd cve returned HTTP ${i.status}`);let o;try{o=await i.json()}catch(n){throw new a(`nvd cve returned malformed JSON: ${n?.message??n}`)}const r=(Array.isArray(o?.vulnerabilities)?o.vulnerabilities:[])[0]?.cve;if(!r||!r.id)throw new f("nvd cve",`NVD has no record for "${t}".`);const d=V(r.metrics),c=d?.cvssData??{};return[{id:String(r.id),published:String(r.published??"").slice(0,10),lastModified:String(r.lastModified??"").slice(0,10),vulnStatus:String(r.vulnStatus??""),baseScore:c.baseScore!=null?Number(c.baseScore):null,severity:String(c.baseSeverity??d?.baseSeverity??""),attackVector:String(c.attackVector??""),cwe:S(r.weaknesses),kevAdded:r.cisaExploitAdd?String(r.cisaExploitAdd).slice(0,10):"",description:h(r.descriptions),url:`https://nvd.nist.gov/vuln/detail/${r.id}`}]}});

package/clis/oeis/search.js

@@ -1 +1 @@
-import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{EmptyResultError as $}from"@jackwener/opencli/errors";import{OEIS_BASE as V,formatId as h,oeisFetch as x,previewTerms as C,requireBoundedInt as F,requireString as P}from"./utils.js";Y({site:"oeis",name:"search",access:"read",description:"Search OEIS sequences by keyword or numeric pattern",domain:"oeis.org",strategy:Z.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword or comma-separated terms (e.g. "fibonacci", "1,1,2,3,5,8")'},{name:"limit",type:"int",default:10,help:"Max sequences (1-100)"}],columns:["rank","id","name","keywords","preview","author","created","url"],func:async(N)=>{const Q=P(N.query,"query"),J=F(N.limit,10,100),H=[];let U=0;const K=10,W=Math.ceil(J/K)+1;for(let D=0;D<W&&H.length<J;D++){const L=`${V}/search?q=${encodeURIComponent(Q)}&fmt=json&start=${U}`,G=await x(L,"oeis search"),M=Array.isArray(G)?G:[];if(!M.length)break;for(const X of M){if(H.length>=J)break;H.push(X)}if(M.length<K)break;U+=K}if(!H.length)throw new $("oeis search",`No OEIS sequences matched "${Q}".`);return H.map((D,L)=>{const G=h(D?.number);return{rank:L+1,id:G,name:typeof D?.name==="string"?D.name:null,keywords:typeof D?.keyword==="string"?D.keyword:null,preview:C(D?.data),author:typeof D?.author==="string"?D.author:null,created:typeof D?.created==="string"?D.created:null,url:G?`${V}/${G}`:""}})}});
+import{cli as p,Strategy as y}from"@jackwener/opencli/registry";import{EmptyResultError as h}from"@jackwener/opencli/errors";import{OEIS_BASE as u,formatId as f,oeisFetch as g,previewTerms as w,requireBoundedInt as k,requireString as q}from"./utils.js";p({site:"oeis",name:"search",access:"read",description:"Search OEIS sequences by keyword or numeric pattern",domain:"oeis.org",strategy:y.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword or comma-separated terms (e.g. "fibonacci", "1,1,2,3,5,8")'},{name:"limit",type:"int",default:10,help:"Max sequences (1-100)"}],columns:["rank","id","name","keywords","preview","author","created","url"],func:async(i)=>{const c=q(i.query,"query"),o=k(i.limit,10,100),t=[];let l=0;const a=10,m=Math.ceil(o/a)+1;for(let e=0;e<m&&t.length<o;e++){const n=`${u}/search?q=${encodeURIComponent(c)}&fmt=json&start=${l}`,r=await g(n,"oeis search"),s=Array.isArray(r)?r:[];if(!s.length)break;for(const d of s){if(t.length>=o)break;t.push(d)}if(s.length<a)break;l+=a}if(!t.length)throw new h("oeis search",`No OEIS sequences matched "${c}".`);return t.map((e,n)=>{const r=f(e?.number);return{rank:n+1,id:r,name:typeof e?.name==="string"?e.name:null,keywords:typeof e?.keyword==="string"?e.keyword:null,preview:w(e?.data),author:typeof e?.author==="string"?e.author:null,created:typeof e?.created==="string"?e.created:null,url:r?`${u}/${r}`:""}})}});

package/clis/oeis/sequence.js

@@ -1 +1 @@
-import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{OEIS_BASE as u,formatId as a,oeisFetch as p,previewTerms as y,requireSequenceId as g}from"./utils.js";function n(r){return Array.isArray(r)?r:[]}c({site:"oeis",name:"sequence",access:"read",description:"Full OEIS sequence detail by A-number (terms, name, keywords, formula counts)",domain:"oeis.org",strategy:m.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'OEIS sequence id (e.g. "A000045" for Fibonacci)'}],columns:["id","name","keywords","preview","termCount","offset","author","created","revision","commentCount","formulaCount","referenceCount","xrefCount","linkCount","url"],func:async(r)=>{const t=g(r.id),l=`${u}/search?q=id:${encodeURIComponent(t)}&fmt=json`,s=await p(l,"oeis sequence"),i=Array.isArray(s)?s:[];if(!i.length)throw new d("oeis sequence",`OEIS sequence "${t}" not found.`);const e=i[0],o=typeof e?.data==="string"?e.data:"",f=o?o.split(",").filter(Boolean).length:0;return[{id:a(e?.number)??t,name:typeof e?.name==="string"?e.name:null,keywords:typeof e?.keyword==="string"?e.keyword:null,preview:y(o),termCount:f,offset:typeof e?.offset==="string"?e.offset:null,author:typeof e?.author==="string"?e.author:null,created:typeof e?.created==="string"?e.created:null,revision:typeof e?.revision==="number"?e.revision:null,commentCount:n(e?.comment).length,formulaCount:n(e?.formula).length,referenceCount:n(e?.reference).length,xrefCount:n(e?.xref).length,linkCount:n(e?.link).length,url:`${u}/${a(e?.number)??t}`}]}});
+import{cli as f,Strategy as m}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{OEIS_BASE as u,formatId as a,oeisFetch as y,previewTerms as p,requireSequenceId as g}from"./utils.js";function r(n){return Array.isArray(n)?n:[]}f({site:"oeis",name:"sequence",access:"read",description:"Full OEIS sequence detail by A-number (terms, name, keywords, formula counts)",domain:"oeis.org",strategy:m.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'OEIS sequence id (e.g. "A000045" for Fibonacci)'}],columns:["id","name","keywords","preview","termCount","offset","author","created","revision","commentCount","formulaCount","referenceCount","xrefCount","linkCount","url"],func:async(n)=>{const t=g(n.id),l=`${u}/search?q=id:${encodeURIComponent(t)}&fmt=json`,s=await y(l,"oeis sequence"),i=Array.isArray(s)?s:[];if(!i.length)throw new d("oeis sequence",`OEIS sequence "${t}" not found.`);const e=i[0],o=typeof e?.data==="string"?e.data:"",c=o?o.split(",").filter(Boolean).length:0;return[{id:a(e?.number)??t,name:typeof e?.name==="string"?e.name:null,keywords:typeof e?.keyword==="string"?e.keyword:null,preview:p(o),termCount:c,offset:typeof e?.offset==="string"?e.offset:null,author:typeof e?.author==="string"?e.author:null,created:typeof e?.created==="string"?e.created:null,revision:typeof e?.revision==="number"?e.revision:null,commentCount:r(e?.comment).length,formulaCount:r(e?.formula).length,referenceCount:r(e?.reference).length,xrefCount:r(e?.xref).length,linkCount:r(e?.link).length,url:`${u}/${a(e?.number)??t}`}]}});

package/clis/oeis/utils.js

@@ -1 +1 @@
-import{ArgumentError as H,CommandExecutionError as K,EmptyResultError as L}from"@jackwener/opencli/errors";export const OEIS_BASE="https://oeis.org";const M="opencli-oeis-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",W=/^A\d{1,7}$/;export function requireString(z,B){const q=String(z??"").trim();if(!q)throw new H(`oeis ${B} cannot be empty`);return q}export function requireBoundedInt(z,B,q,G="limit"){const F=z??B,J=typeof F==="number"?F:Number(F);if(!Number.isInteger(J)||J<=0)throw new H(`oeis ${G} must be a positive integer`);if(J>q)throw new H(`oeis ${G} must be <= ${q}`);return J}export function requireSequenceId(z){const B=String(z??"").trim().toUpperCase();if(!B)throw new H('oeis sequence id is required (e.g. "A000045" for Fibonacci)');const q=B.replace(/^HTTPS?:\/\/(?:WWW\.)?OEIS\.ORG\//,"").replace(/\/.*$/,"");if(!W.test(q))throw new H(`oeis sequence id "${z}" is not a valid A-number`,'Expected format: "A" + digits (e.g. "A000045").');return q}export async function oeisFetch(z,B){let q;try{q=await fetch(z,{headers:{"user-agent":M,accept:"application/json"}})}catch(F){throw new K(`${B} request failed: ${F?.message??F}`,"Check that oeis.org is reachable from this network.")}if(q.status===404)throw new L(B,`OEIS returned 404 for ${z}.`);if(q.status===429)throw new K(`${B} returned HTTP 429 (rate limited)`);if(!q.ok)throw new K(`${B} returned HTTP ${q.status}`);let G;try{G=await q.json()}catch(F){throw new K(`${B} returned malformed JSON: ${F?.message??F}`)}return G}export function formatId(z){if(typeof z!=="number"||!Number.isInteger(z)||z<0)return null;return`A${String(z).padStart(6,"0")}`}export function previewTerms(z,B=12){if(typeof z!=="string")return"";const q=z.split(",").map((G)=>G.trim()).filter(Boolean);if(q.length<=B)return q.join(", ");return[...q.slice(0,B),`(+${q.length-B})`].join(", ")}
+import{ArgumentError as i,CommandExecutionError as c,EmptyResultError as u}from"@jackwener/opencli/errors";export const OEIS_BASE="https://oeis.org";const p="opencli-oeis-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",a=/^A\d{1,7}$/;export function requireString(t,r){const e=String(t??"").trim();if(!e)throw new i(`oeis ${r} cannot be empty`);return e}export function requireBoundedInt(t,r,e,o="limit"){const n=t??r,s=typeof n==="number"?n:Number(n);if(!Number.isInteger(s)||s<=0)throw new i(`oeis ${o} must be a positive integer`);if(s>e)throw new i(`oeis ${o} must be <= ${e}`);return s}export function requireSequenceId(t){const r=String(t??"").trim().toUpperCase();if(!r)throw new i('oeis sequence id is required (e.g. "A000045" for Fibonacci)');const e=r.replace(/^HTTPS?:\/\/(?:WWW\.)?OEIS\.ORG\//,"").replace(/\/.*$/,"");if(!a.test(e))throw new i(`oeis sequence id "${t}" is not a valid A-number`,'Expected format: "A" + digits (e.g. "A000045").');return e}export async function oeisFetch(t,r){let e;try{e=await fetch(t,{headers:{"user-agent":p,accept:"application/json"}})}catch(n){throw new c(`${r} request failed: ${n?.message??n}`,"Check that oeis.org is reachable from this network.")}if(e.status===404)throw new u(r,`OEIS returned 404 for ${t}.`);if(e.status===429)throw new c(`${r} returned HTTP 429 (rate limited)`);if(!e.ok)throw new c(`${r} returned HTTP ${e.status}`);let o;try{o=await e.json()}catch(n){throw new c(`${r} returned malformed JSON: ${n?.message??n}`)}return o}export function formatId(t){if(typeof t!=="number"||!Number.isInteger(t)||t<0)return null;return`A${String(t).padStart(6,"0")}`}export function previewTerms(t,r=12){if(typeof t!=="string")return"";const e=t.split(",").map((o)=>o.trim()).filter(Boolean);if(e.length<=r)return e.join(", ");return[...e.slice(0,r),`(+${e.length-r})`].join(", ")}