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

package/clis/producthunt/browse.js

@@ -1,37 +1,4 @@
-/**
- * Product Hunt category browse — INTERCEPT strategy.
- *
- * Navigates to a Product Hunt category page and scrapes the top-rated products.
- * Shows all-time best products for a category (ranked by review score, not daily votes).
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-import { PRODUCTHUNT_CATEGORY_SLUGS } from './utils.js';
-cli({
-    site: 'producthunt',
-    name: 'browse',
-    access: 'read',
-    description: 'Best products in a Product Hunt category',
-    domain: 'www.producthunt.com',
-    strategy: Strategy.INTERCEPT,
-    args: [
-        {
-            name: 'category',
-            type: 'string',
-            positional: true,
-            required: true,
-            help: `Category slug, e.g. vibe-coding, ai-agents, developer-tools`,
-        },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results (max 50)' },
-    ],
-    columns: ['rank', 'name', 'tagline', 'reviews', 'url'],
-    func: async (page, args) => {
-        const count = Math.min(Number(args.limit) || 20, 50);
-        const slug = String(args.category || '').trim().toLowerCase();
-        await page.installInterceptor('producthunt.com');
-        await page.goto(`https://www.producthunt.com/categories/${slug}`);
-        await page.waitForCapture(5);
-        const domItems = await page.evaluate(`
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{CliError as u}from"@jackwener/opencli/errors";import{PRODUCTHUNT_CATEGORY_SLUGS as d}from"./utils.js";c({site:"producthunt",name:"browse",access:"read",description:"Best products in a Product Hunt category",domain:"www.producthunt.com",strategy:l.INTERCEPT,args:[{name:"category",type:"string",positional:!0,required:!0,help:"Category slug, e.g. vibe-coding, ai-agents, developer-tools"},{name:"limit",type:"int",default:20,help:"Number of results (max 50)"}],columns:["rank","name","tagline","reviews","url"],func:async(e,r)=>{const s=Math.min(Number(r.limit)||20,50),n=String(r.category||"").trim().toLowerCase();await e.installInterceptor("producthunt.com");await e.goto(`https://www.producthunt.com/categories/${n}`);await e.waitForCapture(5);const a=await e.evaluate(`
       (() => {
         const seen = new Set();
         const results = [];
@@ -84,17 +51,4 @@ cli({
 
         return results;
       })()
-    `);
-        const items = Array.isArray(domItems) ? domItems : [];
-        if (items.length === 0) {
-            throw new CliError('NO_DATA', `No products found for category "${slug}"`, 'Check the category slug or try: ' + PRODUCTHUNT_CATEGORY_SLUGS.slice(0, 5).join(', '));
-        }
-        return items.slice(0, count).map((item, i) => ({
-            rank: i + 1,
-            name: item.name,
-            tagline: item.tagline,
-            reviews: item.reviews,
-            url: item.url,
-        }));
-    },
-});
+    `),i=Array.isArray(a)?a:[];if(i.length===0)throw new u("NO_DATA",`No products found for category "${n}"`,"Check the category slug or try: "+d.slice(0,5).join(", "));return i.slice(0,s).map((t,o)=>({rank:o+1,name:t.name,tagline:t.tagline,reviews:t.reviews,url:t.url}))}});

package/clis/producthunt/hot.js

@@ -1,28 +1,4 @@
-/**
- * Product Hunt top posts with vote counts — INTERCEPT strategy.
- *
- * Navigates to the Product Hunt homepage and scrapes rendered product cards.
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-import { pickVoteCount } from './utils.js';
-cli({
-    site: 'producthunt',
-    name: 'hot',
-    access: 'read',
-    description: "Today's top Product Hunt launches with vote counts",
-    domain: 'www.producthunt.com',
-    strategy: Strategy.INTERCEPT,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results (max 50)' },
-    ],
-    columns: ['rank', 'name', 'votes', 'url'],
-    func: async (page, args) => {
-        const count = Math.min(Number(args.limit) || 20, 50);
-        await page.installInterceptor('producthunt.com');
-        await page.goto('https://www.producthunt.com');
-        await page.waitForCapture(5);
-        const domItems = await page.evaluate(`
+import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{CliError as s}from"@jackwener/opencli/errors";import{pickVoteCount as d}from"./utils.js";u({site:"producthunt",name:"hot",access:"read",description:"Today's top Product Hunt launches with vote counts",domain:"www.producthunt.com",strategy:l.INTERCEPT,args:[{name:"limit",type:"int",default:20,help:"Number of results (max 50)"}],columns:["rank","name","votes","url"],func:async(e,i)=>{const c=Math.min(Number(i.limit)||20,50);await e.installInterceptor("producthunt.com");await e.goto("https://www.producthunt.com");await e.waitForCapture(5);const o=await e.evaluate(`
       (() => {
         const seen = new Set();
         const results = [];
@@ -85,27 +61,4 @@ cli({
 
         return results;
       })()
-    `);
-        const items = Array.isArray(domItems) ? domItems : [];
-        if (items.length === 0) {
-            throw new CliError('NO_DATA', 'Could not retrieve Product Hunt top posts', 'Product Hunt may have changed its layout');
-        }
-        const rankedItems = items
-            .map((item) => ({
-            name: item.name,
-            url: item.url,
-            votes: pickVoteCount(Array.isArray(item.voteCandidates) ? item.voteCandidates : []),
-        }))
-            .filter((item) => item.name && item.url && item.votes);
-        if (rankedItems.length === 0) {
-            throw new CliError('NO_DATA', 'Could not retrieve Product Hunt vote counts', 'Product Hunt may have changed its vote button structure');
-        }
-        rankedItems.sort((a, b) => parseInt(b.votes, 10) - parseInt(a.votes, 10));
-        return rankedItems.slice(0, count).map((item, i) => ({
-            rank: i + 1,
-            name: item.name,
-            votes: item.votes,
-            url: item.url,
-        }));
-    },
-});
+    `),a=Array.isArray(o)?o:[];if(a.length===0)throw new s("NO_DATA","Could not retrieve Product Hunt top posts","Product Hunt may have changed its layout");const r=a.map((t)=>({name:t.name,url:t.url,votes:d(Array.isArray(t.voteCandidates)?t.voteCandidates:[])})).filter((t)=>t.name&&t.url&&t.votes);if(r.length===0)throw new s("NO_DATA","Could not retrieve Product Hunt vote counts","Product Hunt may have changed its vote button structure");r.sort((t,n)=>parseInt(n.votes,10)-parseInt(t.votes,10));return r.slice(0,c).map((t,n)=>({rank:n+1,name:t.name,votes:t.votes,url:t.url}))}});

package/clis/producthunt/posts.js

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

package/clis/producthunt/today.js

@@ -1,36 +1 @@
-/**
- * Product Hunt today's top launches — filtered from public Atom feed.
- *
- * Shows the most recently published day's products (Product Hunt runs on
- * Pacific Time; the feed date may differ from UTC local date by up to 1 day).
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { fetchFeed } from './utils.js';
-cli({
-    site: 'producthunt',
-    name: 'today',
-    access: 'read',
-    description: "Today's Product Hunt launches (most recent day in feed)",
-    domain: 'www.producthunt.com',
-    strategy: Strategy.PUBLIC,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Max results' },
-    ],
-    columns: ['rank', 'name', 'tagline', 'author', 'url'],
-    func: async (args) => {
-        const count = Math.min(Number(args.limit) || 20, 50);
-        const posts = await fetchFeed();
-        if (posts.length === 0)
-            return [];
-        // Use the latest date in the feed (Product Hunt is PST-based)
-        const latestDate = posts.map(p => p.date).sort().reverse()[0];
-        const todayPosts = posts.filter(p => p.date === latestDate);
-        return todayPosts.slice(0, count).map((p, i) => ({
-            rank: i + 1,
-            name: p.name,
-            tagline: p.tagline,
-            author: p.author,
-            url: p.url,
-        }));
-    },
-});
+import{cli as B,Strategy as C}from"@jackwener/opencli/registry";import{fetchFeed as E}from"./utils.js";B({site:"producthunt",name:"today",access:"read",description:"Today's Product Hunt launches (most recent day in feed)",domain:"www.producthunt.com",strategy:C.PUBLIC,args:[{name:"limit",type:"int",default:20,help:"Max results"}],columns:["rank","name","tagline","author","url"],func:async(v)=>{const x=Math.min(Number(v.limit)||20,50),q=await E();if(q.length===0)return[];const z=q.map((m)=>m.date).sort().reverse()[0];return q.filter((m)=>m.date===z).slice(0,x).map((m,A)=>({rank:A+1,name:m.name,tagline:m.tagline,author:m.author,url:m.url}))}});

package/clis/producthunt/utils.js

@@ -1,99 +1 @@
-/**
- * Product Hunt shared helpers.
- */
-export const PRODUCTHUNT_CATEGORY_SLUGS = [
-    'ai-agents',
-    'ai-coding-agents',
-    'ai-code-editors',
-    'ai-chatbots',
-    'ai-workflow-automation',
-    'vibe-coding',
-    'developer-tools',
-    'productivity',
-    'design-creative',
-    'marketing-sales',
-    'no-code-platforms',
-    'llms',
-    'finance',
-    'social-community',
-    'engineering-development',
-];
-const UA = 'Mozilla/5.0 (compatible; opencli/1.0)';
-/**
- * Fetch Product Hunt Atom RSS feed.
- * @param category  Optional category slug (e.g. "ai", "developer-tools")
- */
-export async function fetchFeed(category) {
-    const url = category
-        ? `https://www.producthunt.com/feed?category=${encodeURIComponent(category)}`
-        : 'https://www.producthunt.com/feed';
-    const resp = await fetch(url, { headers: { 'User-Agent': UA } });
-    if (!resp.ok)
-        return [];
-    const xml = await resp.text();
-    return parseFeed(xml);
-}
-export function parseFeed(xml) {
-    const posts = [];
-    const entryRegex = /<entry>([\s\S]*?)<\/entry>/g;
-    let match;
-    let rank = 1;
-    while ((match = entryRegex.exec(xml))) {
-        const block = match[1];
-        const name = block.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim() ?? '';
-        const author = block.match(/<name>([\s\S]*?)<\/name>/)?.[1]?.trim() ?? '';
-        const pubRaw = block.match(/<published>(.*?)<\/published>/)?.[1]?.trim() ?? '';
-        const date = pubRaw.slice(0, 10);
-        const link = block.match(/<link[^>]*href="([^"]+)"/)?.[1]?.trim() ?? '';
-        // Extract tagline from HTML content (first <p> text)
-        const contentRaw = block.match(/<content[^>]*>([\s\S]*?)<\/content>/)?.[1] ?? '';
-        const contentDecoded = contentRaw
-            .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').replace(/&quot;/g, '"');
-        const tagline = contentDecoded
-            .replace(/<[^>]+>/g, ' ')
-            .replace(/\s+/g, ' ')
-            .replace(/\s*Discussion\s*\|?\s*/gi, '')
-            .replace(/\s*\|?\s*Link\s*$/gi, '')
-            .trim()
-            .slice(0, 120);
-        if (name) {
-            posts.push({ rank: rank++, name, tagline, author, date, url: link });
-        }
-    }
-    return posts;
-}
-export function pickVoteCount(candidates) {
-    const scored = candidates
-        .map((candidate) => {
-        const text = String(candidate.text ?? '').trim();
-        if (!/^\d+$/.test(text))
-            return null;
-        if (candidate.inReviewLink)
-            return null;
-        const value = parseInt(text, 10);
-        if (!Number.isFinite(value) || value <= 0)
-            return null;
-        const signal = `${candidate.tagName ?? ''} ${candidate.className ?? ''} ${candidate.role ?? ''}`.toLowerCase();
-        let score = 0;
-        if (candidate.inButton)
-            score += 4;
-        if (signal.includes('vote') || signal.includes('upvote'))
-            score += 3;
-        if (signal.includes('button'))
-            score += 1;
-        return { text, score, value };
-    })
-        .filter((candidate) => Boolean(candidate))
-        .sort((a, b) => {
-        if (b.score !== a.score)
-            return b.score - a.score;
-        if (b.value !== a.value)
-            return b.value - a.value;
-        return a.text.localeCompare(b.text);
-    });
-    return scored[0]?.text ?? '';
-}
-/** Format ISO date string to YYYY-MM-DD */
-export function toDate(iso) {
-    return iso.slice(0, 10);
-}
+export const PRODUCTHUNT_CATEGORY_SLUGS=["ai-agents","ai-coding-agents","ai-code-editors","ai-chatbots","ai-workflow-automation","vibe-coding","developer-tools","productivity","design-creative","marketing-sales","no-code-platforms","llms","finance","social-community","engineering-development"];const K="Mozilla/5.0 (compatible; opencli/1.0)";export async function fetchFeed(w){const B=w?`https://www.producthunt.com/feed?category=${encodeURIComponent(w)}`:"https://www.producthunt.com/feed",f=await fetch(B,{headers:{"User-Agent":K}});if(!f.ok)return[];const j=await f.text();return parseFeed(j)}export function parseFeed(w){const B=[],f=/<entry>([\s\S]*?)<\/entry>/g;let j,C=1;while(j=f.exec(w)){const q=j[1],z=q.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim()??"",E=q.match(/<name>([\s\S]*?)<\/name>/)?.[1]?.trim()??"",G=(q.match(/<published>(.*?)<\/published>/)?.[1]?.trim()??"").slice(0,10),H=q.match(/<link[^>]*href="([^"]+)"/)?.[1]?.trim()??"",J=(q.match(/<content[^>]*>([\s\S]*?)<\/content>/)?.[1]??"").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&amp;/g,"&").replace(/&quot;/g,'"').replace(/<[^>]+>/g," ").replace(/\s+/g," ").replace(/\s*Discussion\s*\|?\s*/gi,"").replace(/\s*\|?\s*Link\s*$/gi,"").trim().slice(0,120);if(z)B.push({rank:C++,name:z,tagline:J,author:E,date:G,url:H})}return B}export function pickVoteCount(w){return w.map((f)=>{const j=String(f.text??"").trim();if(!/^\d+$/.test(j))return null;if(f.inReviewLink)return null;const C=parseInt(j,10);if(!Number.isFinite(C)||C<=0)return null;const q=`${f.tagName??""} ${f.className??""} ${f.role??""}`.toLowerCase();let z=0;if(f.inButton)z+=4;if(q.includes("vote")||q.includes("upvote"))z+=3;if(q.includes("button"))z+=1;return{text:j,score:z,value:C}}).filter((f)=>Boolean(f)).sort((f,j)=>{if(j.score!==f.score)return j.score-f.score;if(j.value!==f.value)return j.value-f.value;return f.text.localeCompare(j.text)})[0]?.text??""}export function toDate(w){return w.slice(0,10)}

package/clis/pubmed/article.js

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

package/clis/pubmed/author.js

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

package/clis/pubmed/citations.js

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

package/clis/pubmed/clinical-trial.js

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

package/clis/pubmed/journal.js

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

package/clis/pubmed/mesh.js

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