publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/nowcoder/suggest.js

@@ -1,18 +1,4 @@
-import { cli } from '@jackwener/opencli/registry';
-
-cli({
-    site: 'nowcoder',
-    name: 'suggest',
-    access: 'read',
-    description: 'Search suggestions',
-    domain: 'www.nowcoder.com',
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword' },
-    ],
-    columns: ['rank', 'suggestion', 'type'],
-    pipeline: [
-        { navigate: 'https://www.nowcoder.com' },
-        { evaluate: `(async () => {
+import{cli as e}from"@jackwener/opencli/registry";e({site:"nowcoder",name:"suggest",access:"read",description:"Search suggestions",domain:"www.nowcoder.com",args:[{name:"query",positional:!0,required:!0,help:"Search keyword"}],columns:["rank","suggestion","type"],pipeline:[{navigate:"https://www.nowcoder.com"},{evaluate:`(async () => {
   const query = \${{ args.query | json }};
   const r = await fetch('https://gw-c.nowcoder.com/api/sparta/search/suggest', {
     method: 'POST',
@@ -28,7 +14,4 @@ cli({
     type: item.typeName || 'general',
   }));
 })()
-` },
-        { limit: '10' },
-    ],
-});
+`},{limit:"10"}]});

package/clis/nowcoder/topics.js

@@ -1,28 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-
-cli({
-    site: 'nowcoder',
-    name: 'topics',
-    access: 'read',
-    description: 'Hot discussion topics',
-    domain: 'www.nowcoder.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 10, help: 'Number of items' },
-    ],
-    columns: ['rank', 'topic', 'views', 'posts', 'heat', 'id'],
-    pipeline: [
-        { fetch: { url: 'https://gw-c.nowcoder.com/api/sparta/subject/hot-subject' } },
-        { select: 'data.result' },
-        { map: {
-                rank: '${{ index + 1 }}',
-                topic: '${{ item.content }}',
-                views: '${{ item.viewCount }}',
-                posts: '${{ item.momentCount }}',
-                heat: '${{ item.hotValue }}',
-                id: '${{ item.uuid || item.id || "" }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"nowcoder",name:"topics",access:"read",description:"Hot discussion topics",domain:"www.nowcoder.com",strategy:e.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Number of items"}],columns:["rank","topic","views","posts","heat","id"],pipeline:[{fetch:{url:"https://gw-c.nowcoder.com/api/sparta/subject/hot-subject"}},{select:"data.result"},{map:{rank:"${{ index + 1 }}",topic:"${{ item.content }}",views:"${{ item.viewCount }}",posts:"${{ item.momentCount }}",heat:"${{ item.hotValue }}",id:'${{ item.uuid || item.id || "" }}'}},{limit:"${{ args.limit }}"}]});

package/clis/nowcoder/trending.js

@@ -1,26 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-
-cli({
-    site: 'nowcoder',
-    name: 'trending',
-    access: 'read',
-    description: 'Trending posts',
-    domain: 'www.nowcoder.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 10, help: 'Number of items' },
-    ],
-    columns: ['rank', 'title', 'heat', 'id'],
-    pipeline: [
-        { fetch: { url: 'https://gw-c.nowcoder.com/api/sparta/hot-search/top-hot-pc' } },
-        { select: 'data.result' },
-        { map: {
-                rank: '${{ index + 1 }}',
-                title: '${{ item.title }}',
-                heat: '${{ item.hotValueFromDolphin }}',
-                id: '${{ item.uuid || item.id || "" }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"nowcoder",name:"trending",access:"read",description:"Trending posts",domain:"www.nowcoder.com",strategy:e.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Number of items"}],columns:["rank","title","heat","id"],pipeline:[{fetch:{url:"https://gw-c.nowcoder.com/api/sparta/hot-search/top-hot-pc"}},{select:"data.result"},{map:{rank:"${{ index + 1 }}",title:"${{ item.title }}",heat:"${{ item.hotValueFromDolphin }}",id:'${{ item.uuid || item.id || "" }}'}},{limit:"${{ args.limit }}"}]});

package/clis/nowcoder/utils.js

@@ -0,0 +1,68 @@
+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(`
+    async () => {
+      const res = await fetch(${H}, { credentials: 'include' });
+      const text = await res.text();
+      try {
+        return JSON.parse(text);
+      } catch {
+        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(`
+    async () => {
+      const res = await fetch(${K}, {
+        method: 'POST',
+        credentials: 'include',
+        headers: { 'Content-Type': 'application/json' },
+        body: ${L},
+      });
+      const text = await res.text();
+      try {
+        return JSON.parse(text);
+      } catch {
+        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(`
+    async () => {
+      const body = new URLSearchParams(${L});
+      const res = await fetch(${K}, {
+        method: 'POST',
+        credentials: 'include',
+        headers: {
+          'Content-Type': 'application/x-www-form-urlencoded',
+          'x-requested-with': 'XMLHttpRequest',
+        },
+        body: body.toString(),
+      });
+      const text = await res.text();
+      try {
+        return JSON.parse(text);
+      } catch {
+        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(`
+    async () => {
+      const fd = new FormData();
+      for (const [k, v] of Object.entries(${L})) fd.append(k, v);
+      const res = await fetch(${K}, {
+        method: 'POST',
+        credentials: 'include',
+        body: fd,
+      });
+      const text = await res.text();
+      try {
+        return JSON.parse(text);
+      } catch {
+        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(`
+    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}

package/clis/npm/downloads.js

@@ -1,59 +1 @@
-// npm downloads — fetch download counts for a single npm package over a window.
-//
-// Hits `api.npmjs.org/downloads/range/<period>/<pkg>`. Default window is the
-// last 7 days (one row per day). Use `--period last-month` for 30 days, or
-// pass a custom `YYYY-MM-DD:YYYY-MM-DD` range.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import { NPM_API, npmFetch, requirePackageName } from './utils.js';
-
-const FIXED_PERIODS = new Set(['last-day', 'last-week', 'last-month', 'last-year']);
-const RANGE_PATTERN = /^(\d{4}-\d{2}-\d{2}):(\d{4}-\d{2}-\d{2})$/;
-
-function requirePeriod(value) {
-    const s = String(value ?? 'last-week').trim();
-    if (FIXED_PERIODS.has(s)) return s;
-    const m = RANGE_PATTERN.exec(s);
-    if (m) {
-        const [, start, end] = m;
-        if (new Date(start) > new Date(end)) {
-            throw new ArgumentError(`npm downloads period start ${start} is after end ${end}`);
-        }
-        return `${start}:${end}`;
-    }
-    throw new ArgumentError(
-        `npm downloads period "${value}" is invalid`,
-        'Use last-day / last-week (default) / last-month / last-year, or YYYY-MM-DD:YYYY-MM-DD.',
-    );
-}
-
-cli({
-    site: 'npm',
-    name: 'downloads',
-    access: 'read',
-    description: 'Daily download counts for an npm package over a window',
-    domain: 'api.npmjs.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'name', positional: true, required: true, 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 (args) => {
-        const name = requirePackageName(args.name);
-        const period = requirePeriod(args.period);
-        const url = `${NPM_API}/downloads/range/${period}/${name}`;
-        const body = await npmFetch(url, `npm downloads ${name}`);
-        const days = Array.isArray(body?.downloads) ? body.downloads : [];
-        if (!days.length) {
-            throw new EmptyResultError('npm downloads', `npm has no download stats for "${name}" in window ${period}.`);
-        }
-        return days.map((row, i) => ({
-            rank: i + 1,
-            package: String(body.package ?? name),
-            day: String(row.day ?? ''),
-            downloads: row.downloads != null ? Number(row.downloads) : null,
-        }));
-    },
-});
+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}))}});

package/clis/npm/package.js

@@ -1,70 +1 @@
-// npm package — fetch a single package's registry metadata.
-//
-// Hits `https://registry.npmjs.org/<pkg>` and projects the fields most useful
-// for an agent: name, latest version, description, license, homepage,
-// repository, bug tracker, maintainers, last-modified time. Download stats
-// are intentionally separate (see `npm downloads`) so failure modes don't get
-// silently folded into a registry-metadata response.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { NPM_REGISTRY, npmFetch, requirePackageName } from './utils.js';
-
-function repoUrl(repo) {
-    if (!repo) return '';
-    if (typeof repo === 'string') return repo;
-    if (typeof repo === 'object' && typeof repo.url === 'string') {
-        return repo.url.replace(/^git\+/, '').replace(/\.git$/, '');
-    }
-    return '';
-}
-
-function bugUrl(bugs) {
-    if (!bugs) return '';
-    if (typeof bugs === 'string') return bugs;
-    if (typeof bugs === 'object' && typeof bugs.url === 'string') return bugs.url;
-    return '';
-}
-
-cli({
-    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: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'name', positional: true, required: true, help: 'npm package name (e.g. "react", "@vercel/og")' },
-    ],
-    columns: [
-        'name', 'latestVersion', 'description', 'license', 'homepage', 'repository',
-        'bugs', 'maintainers', 'keywords', 'created', 'modified', 'url',
-    ],
-    func: async (args) => {
-        const name = requirePackageName(args.name);
-        const body = await npmFetch(`${NPM_REGISTRY}/${name.split('/').map(encodeURIComponent).join('/')}`, `npm package ${name}`);
-        const latest = body?.['dist-tags']?.latest;
-        if (!latest) {
-            throw new EmptyResultError('npm package', `npm registry has no latest version for "${name}".`);
-        }
-        const v = body?.versions?.[latest] ?? {};
-        const maintainers = Array.isArray(body.maintainers)
-            ? body.maintainers.map((m) => (typeof m === 'object' && m ? m.name || m.email || '' : String(m))).filter(Boolean).join(', ')
-            : '';
-        const keywords = Array.isArray(v.keywords) ? v.keywords.join(', ') : '';
-        return [{
-            name: String(body.name ?? name),
-            latestVersion: String(latest),
-            description: String(v.description ?? body.description ?? ''),
-            license: typeof v.license === 'string' ? v.license : (v.license?.type ?? ''),
-            homepage: String(v.homepage ?? ''),
-            repository: repoUrl(v.repository),
-            bugs: bugUrl(v.bugs),
-            maintainers,
-            keywords,
-            created: String(body.time?.created ?? '').slice(0, 10),
-            modified: String(body.time?.modified ?? '').slice(0, 10),
-            url: `https://www.npmjs.com/package/${name}`,
-        }];
-    },
-});
+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}`}]}});

package/clis/npm/search.js

@@ -1,49 +1 @@
-// npm search — search the public npm registry by free-text query.
-//
-// Hits `https://registry.npmjs.org/-/v1/search?text=…`. Returns enough per-row
-// to feed back into `npm package` / `npm downloads`: name (round-trips as id),
-// description, version, weekly downloads, dependents count, license, links.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { NPM_REGISTRY, npmFetch, requireBoundedInt, requireString } from './utils.js';
-
-cli({
-    site: 'npm',
-    name: 'search',
-    access: 'read',
-    description: 'Search the public npm registry by keyword',
-    domain: 'registry.npmjs.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, 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 (args) => {
-        const query = requireString(args.query, 'query');
-        const limit = requireBoundedInt(args.limit, 20, 250);
-        const url = `${NPM_REGISTRY}/-/v1/search?text=${encodeURIComponent(query)}&size=${limit}`;
-        const body = await npmFetch(url, 'npm search');
-        const objects = Array.isArray(body?.objects) ? body.objects : [];
-        if (!objects.length) {
-            throw new EmptyResultError('npm search', `No npm packages matched "${query}".`);
-        }
-        return objects.slice(0, limit).map((obj, i) => {
-            const pkg = obj?.package ?? {};
-            const dl = obj?.downloads ?? {};
-            return {
-                rank: i + 1,
-                name: String(pkg.name ?? ''),
-                version: String(pkg.version ?? ''),
-                description: String(pkg.description ?? ''),
-                weeklyDownloads: dl.weekly != null ? Number(dl.weekly) : null,
-                dependents: obj.dependents != null ? Number(obj.dependents) : null,
-                license: String(pkg.license ?? ''),
-                publisher: String(pkg.publisher?.username ?? ''),
-                updated: String(obj.updated ?? '').slice(0, 10),
-                url: pkg.links?.npm ? String(pkg.links.npm) : (pkg.name ? `https://www.npmjs.com/package/${pkg.name}` : ''),
-            };
-        });
-    },
-});
+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}`:""}})}});

package/clis/npm/utils.js

@@ -1,76 +1 @@
-// Shared helpers for the npm adapters that hit the public npm registry
-// (registry.npmjs.org) and download stats API (api.npmjs.org).
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-export const NPM_REGISTRY = 'https://registry.npmjs.org';
-export const NPM_API = 'https://api.npmjs.org';
-const UA = 'opencli-npm-adapter (+https://github.com/jackwener/opencli)';
-
-// npm package names: 1-214 chars, lowercase letters/numbers/-._ , scoped form `@scope/name`.
-const PKG_NAME = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i;
-
-export function requireString(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError(`npm ${label} cannot be empty`);
-    return s;
-}
-
-export function requirePackageName(value) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError('npm package name is required (e.g. "react", "@vercel/og")');
-    if (s.length > 214) {
-        throw new ArgumentError(`npm package name "${value}" is too long (max 214 chars)`);
-    }
-    if (!PKG_NAME.test(s)) {
-        throw new ArgumentError(
-            `npm package name "${value}" is not a valid registry name`,
-            'Names are 1–214 chars of lowercase a-z / 0-9 / "-._" (scoped form: "@scope/name").',
-        );
-    }
-    return s;
-}
-
-export function requireBoundedInt(value, defaultValue, maxValue, label = 'limit') {
-    const raw = value ?? defaultValue;
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`npm ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`npm ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-export async function npmFetch(url, label) {
-    let resp;
-    try {
-        resp = await fetch(url, { headers: { 'user-agent': UA, accept: 'application/json' } });
-    }
-    catch (err) {
-        throw new CommandExecutionError(
-            `${label} request failed: ${err?.message ?? err}`,
-            'Check that registry.npmjs.org / api.npmjs.org are reachable from this network.',
-        );
-    }
-    if (resp.status === 404) {
-        throw new EmptyResultError(label, `npm registry returned 404 for ${url}.`);
-    }
-    if (resp.status === 429) {
-        throw new CommandExecutionError(
-            `${label} returned HTTP 429 (rate limited)`,
-            'npm throttles unauthenticated bursts; wait a few seconds and retry.',
-        );
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`${label} returned HTTP ${resp.status}`);
-    }
-    let body;
-    try {
-        body = await resp.json();
-    }
-    catch (err) {
-        throw new CommandExecutionError(`${label} returned malformed JSON: ${err?.message ?? err}`);
-    }
-    return body;
-}
+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}

package/clis/nuget/package.js

@@ -1,101 +1 @@
-// nuget package — full version history for a NuGet package id.
-//
-// Hits the registration index `api.nuget.org/v3/registration5-semver1/<id>/index.json`.
-// The id path segment must be lowercase per NuGet's CDN routing.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { NUGET_REGISTRATION_BASE, joinAuthors, joinTags, nugetFetch, requirePackageId } from './utils.js';
-
-cli({
-    site: 'nuget',
-    name: 'package',
-    access: 'read',
-    description: 'Full NuGet package version history (catalogEntry per release)',
-    domain: 'api.nuget.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, 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 (args) => {
-        const id = requirePackageId(args.id);
-        const url = `${NUGET_REGISTRATION_BASE}/${encodeURIComponent(id.toLowerCase())}/index.json`;
-        const body = await nugetFetch(url, 'nuget package');
-        const pages = Array.isArray(body?.items) ? body.items : [];
-        // Each page can be inline (with `items`) or a stub that needs another fetch
-        // for older packages. Inline is the common case for everything published in
-        // the last few years. We follow stub pages once each — at most ~5 round-trips.
-        const allEntries = [];
-        for (const [pageIndex, page] of pages.entries()) {
-            let pageItems = Array.isArray(page?.items) ? page.items : null;
-            if (!pageItems) {
-                // Stub page → fetch the leaf.
-                const pageUrl = typeof page?.['@id'] === 'string' ? page['@id'] : null;
-                if (!pageUrl) {
-                    throw new CommandExecutionError(
-                        `nuget package registration page ${pageIndex + 1} is missing @id for package "${id}"`,
-                    );
-                }
-                const leaf = await nugetFetch(pageUrl, 'nuget package page');
-                if (!Array.isArray(leaf?.items)) {
-                    throw new CommandExecutionError(
-                        `nuget package registration leaf ${pageUrl} did not include an items array`,
-                    );
-                }
-                pageItems = leaf.items;
-            }
-            for (const it of pageItems) {
-                if (!it || typeof it !== 'object' || !it.catalogEntry || typeof it.catalogEntry !== 'object') {
-                    throw new CommandExecutionError(
-                        `nuget package registration page ${pageIndex + 1} contains a malformed version entry`,
-                    );
-                }
-                allEntries.push(it);
-            }
-        }
-        if (!allEntries.length) {
-            throw new EmptyResultError('nuget package', `No published versions found for NuGet package "${id}".`);
-        }
-        // Sort by published desc; ties broken by version string descending.
-        const sorted = [...allEntries].sort((a, b) => {
-            const ap = a?.catalogEntry?.published ?? '';
-            const bp = b?.catalogEntry?.published ?? '';
-            if (ap !== bp) return bp.localeCompare(ap);
-            const av = a?.catalogEntry?.version ?? '';
-            const bv = b?.catalogEntry?.version ?? '';
-            return bv.localeCompare(av);
-        });
-        return sorted.map((entry, i) => {
-            const cat = entry?.catalogEntry ?? {};
-            return {
-                rank: i + 1,
-                id: typeof cat?.id === 'string' ? cat.id : id,
-                version: typeof cat?.version === 'string' ? cat.version : null,
-                title: typeof cat?.title === 'string' ? cat.title : null,
-                authors: joinAuthors(cat?.authors),
-                tags: joinTags(cat?.tags),
-                language: typeof cat?.language === 'string' ? cat.language : null,
-                licenseExpression: typeof cat?.licenseExpression === 'string' ? cat.licenseExpression : null,
-                projectUrl: typeof cat?.projectUrl === 'string' ? cat.projectUrl : null,
-                published: typeof cat?.published === 'string' ? cat.published : null,
-                listed: typeof cat?.listed === 'boolean' ? cat.listed : null,
-                url: typeof cat?.id === 'string' && typeof cat?.version === 'string'
-                    ? `https://www.nuget.org/packages/${cat.id}/${cat.version}` : '',
-            };
-        });
-    },
-});
+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}`:""}})}});

package/clis/nuget/search.js

@@ -1,69 +1 @@
-// nuget search — full-text search the NuGet package index.
-//
-// Hits `azuresearch-usnc.nuget.org/query?q=…&take=…&prerelease=false`. The `id`
-// column round-trips into `nuget package` for full version history.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    NUGET_SEARCH_BASE,
-    joinAuthors,
-    joinTags,
-    nugetFetch,
-    requireBoundedInt,
-    requireString,
-} from './utils.js';
-
-cli({
-    site: 'nuget',
-    name: 'search',
-    access: 'read',
-    description: 'Search NuGet packages by keyword',
-    domain: 'api.nuget.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max packages (1-1000)' },
-        { name: 'prerelease', type: 'boolean', default: false, help: 'Include prerelease versions' },
-    ],
-    columns: [
-        'rank',
-        'id',
-        'version',
-        'title',
-        'description',
-        'authors',
-        'tags',
-        'totalDownloads',
-        'verified',
-        'projectUrl',
-        'url',
-    ],
-    func: async (args) => {
-        const query = requireString(args.query, 'query');
-        const limit = requireBoundedInt(args.limit, 20, 1000);
-        const prerelease = args.prerelease === true ? 'true' : 'false';
-        const url = `${NUGET_SEARCH_BASE}/query?q=${encodeURIComponent(query)}&take=${limit}&prerelease=${prerelease}`;
-        const body = await nugetFetch(url, 'nuget search');
-        const list = Array.isArray(body?.data) ? body.data : [];
-        if (!list.length) {
-            throw new EmptyResultError('nuget search', `No NuGet packages matched "${query}".`);
-        }
-        return list.slice(0, limit).map((pkg, i) => {
-            const id = typeof pkg?.id === 'string' ? pkg.id : '';
-            return {
-                rank: i + 1,
-                id,
-                version: typeof pkg?.version === 'string' ? pkg.version : null,
-                title: typeof pkg?.title === 'string' ? pkg.title : null,
-                description: typeof pkg?.description === 'string' ? pkg.description : null,
-                authors: joinAuthors(pkg?.authors),
-                tags: joinTags(pkg?.tags),
-                totalDownloads: typeof pkg?.totalDownloads === 'number' ? pkg.totalDownloads : null,
-                verified: pkg?.verified === true,
-                projectUrl: typeof pkg?.projectUrl === 'string' ? pkg.projectUrl : null,
-                url: id ? `https://www.nuget.org/packages/${id}` : '',
-            };
-        });
-    },
-});
+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}`:""}})}});