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

package/clis/archive/item.js

@@ -1,92 +1 @@
-// archive item: Internet Archive item metadata (one row per identifier).
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-const IDENTIFIER_RE = /^[A-Za-z0-9._-]+$/;
-
-cli({
-    site: 'archive',
-    name: 'item',
-    access: 'read',
-    description: 'Fetch metadata for a single Internet Archive item by identifier.',
-    domain: 'archive.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'identifier', positional: true, required: true, help: 'Archive item identifier (e.g. "open-syllabus", "FinalFantasy2_356").' },
-    ],
-    columns: ['identifier', 'title', 'creator', 'date', 'mediatype', 'collection', 'description', 'file_count', 'url'],
-    func: async (args) => {
-        const identifier = String(args.identifier ?? '').trim();
-        if (!identifier) {
-            throw new ArgumentError(
-                'archive item identifier cannot be empty',
-                'Example: opencli archive item open-syllabus',
-            );
-        }
-        if (!IDENTIFIER_RE.test(identifier)) {
-            throw new ArgumentError(
-                `archive item identifier "${args.identifier}" is not valid`,
-                'Archive item identifiers may only contain letters, digits, ".", "_", "-".',
-            );
-        }
-
-        const url = `https://archive.org/metadata/${encodeURIComponent(identifier)}`;
-        let resp;
-        try {
-            resp = await fetch(url, {
-                headers: {
-                    'Accept': 'application/json',
-                    'User-Agent': 'opencli/1.0 (+https://github.com/jackwener/opencli)',
-                },
-            });
-        } catch (error) {
-            throw new CommandExecutionError(`archive item request failed: ${error?.message || error}`);
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`archive item failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`archive item returned malformed JSON: ${error?.message || error}`);
-        }
-
-        const meta = data?.metadata;
-        // The metadata endpoint returns {} for missing or dark items.
-        if (!meta || typeof meta !== 'object' || !meta.identifier) {
-            throw new EmptyResultError('archive item', `No public metadata for "${identifier}" on archive.org.`);
-        }
-        const responseIdentifier = String(meta.identifier);
-        if (!IDENTIFIER_RE.test(responseIdentifier)) {
-            throw new CommandExecutionError('archive item returned malformed payload: metadata.identifier is not stable');
-        }
-        if (responseIdentifier !== identifier) {
-            throw new CommandExecutionError(`archive item returned metadata for "${responseIdentifier}" instead of "${identifier}"`);
-        }
-
-        const creator = Array.isArray(meta.creator) ? meta.creator.join(', ') : String(meta.creator ?? '');
-        const collection = Array.isArray(meta.collection) ? meta.collection.join(', ') : String(meta.collection ?? '');
-        const description = Array.isArray(meta.description) ? meta.description.join(' ') : String(meta.description ?? '');
-        if (!Array.isArray(data.files)) {
-            throw new CommandExecutionError('archive item returned malformed payload: files must be an array');
-        }
-
-        return [{
-            identifier: responseIdentifier,
-            title: String(meta.title ?? ''),
-            creator,
-            date: meta.date ? String(meta.date).slice(0, 10) : '',
-            mediatype: String(meta.mediatype ?? ''),
-            collection,
-            description,
-            file_count: data.files.length,
-            url: `https://archive.org/details/${responseIdentifier}`,
-        }];
-    },
-});
+import{cli as U,Strategy as V}from"@jackwener/opencli/registry";import{ArgumentError as K,CommandExecutionError as v,EmptyResultError as W}from"@jackwener/opencli/errors";const L=/^[A-Za-z0-9._-]+$/;U({site:"archive",name:"item",access:"read",description:"Fetch metadata for a single Internet Archive item by identifier.",domain:"archive.org",strategy:V.PUBLIC,browser:!1,args:[{name:"identifier",positional:!0,required:!0,help:'Archive item identifier (e.g. "open-syllabus", "FinalFantasy2_356").'}],columns:["identifier","title","creator","date","mediatype","collection","description","file_count","url"],func:async(J)=>{const q=String(J.identifier??"").trim();if(!q)throw new K("archive item identifier cannot be empty","Example: opencli archive item open-syllabus");if(!L.test(q))throw new K(`archive item identifier "${J.identifier}" is not valid`,'Archive item identifiers may only contain letters, digits, ".", "_", "-".');const M=`https://archive.org/metadata/${encodeURIComponent(q)}`;let G;try{G=await fetch(M,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(B){throw new v(`archive item request failed: ${B?.message||B}`)}if(!G.ok)throw new v(`archive item failed: HTTP ${G.status}`);let H;try{H=await G.json()}catch(B){throw new v(`archive item returned malformed JSON: ${B?.message||B}`)}const b=H?.metadata;if(!b||typeof b!=="object"||!b.identifier)throw new W("archive item",`No public metadata for "${q}" on archive.org.`);const z=String(b.identifier);if(!L.test(z))throw new v("archive item returned malformed payload: metadata.identifier is not stable");if(z!==q)throw new v(`archive item returned metadata for "${z}" instead of "${q}"`);const O=Array.isArray(b.creator)?b.creator.join(", "):String(b.creator??""),P=Array.isArray(b.collection)?b.collection.join(", "):String(b.collection??""),Q=Array.isArray(b.description)?b.description.join(" "):String(b.description??"");if(!Array.isArray(H.files))throw new v("archive item returned malformed payload: files must be an array");return[{identifier:z,title:String(b.title??""),creator:O,date:b.date?String(b.date).slice(0,10):"",mediatype:String(b.mediatype??""),collection:P,description:Q,file_count:H.files.length,url:`https://archive.org/details/${z}`}]}});

package/clis/archive/search.js

@@ -1,115 +1 @@
-// archive search: Internet Archive Advanced Search across all mediatypes.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-const SORT_OPTIONS = ['downloads', 'date', 'addeddate', 'week', 'title'];
-const SORT_ALIAS = { added: 'addeddate', published: 'date' };
-const MEDIATYPES = ['texts', 'movies', 'audio', 'software', 'image', 'web', 'data', 'collection'];
-const IDENTIFIER_RE = /^[A-Za-z0-9._-]+$/;
-
-cli({
-    site: 'archive',
-    name: 'search',
-    access: 'read',
-    description: 'Search Internet Archive items across books, movies, audio, software, and web.',
-    domain: 'archive.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Full-text query (matches title, description, creator, subject).' },
-        { name: 'mediatype', type: 'string', required: false, help: `Restrict to mediatype: ${MEDIATYPES.join(', ')}` },
-        { name: 'sort', type: 'string', default: 'downloads', help: `Sort key: ${SORT_OPTIONS.join(', ')}` },
-        { name: 'limit', type: 'int', default: 20, help: 'Max items (max 100; one API page).' },
-    ],
-    columns: ['rank', 'identifier', 'title', 'creator', 'date', 'mediatype', 'downloads', 'url'],
-    func: async (args) => {
-        const sortRaw = String(args.sort ?? 'downloads').toLowerCase();
-        const sort = SORT_ALIAS[sortRaw] ?? sortRaw;
-        if (!SORT_OPTIONS.includes(sort)) {
-            throw new ArgumentError(`archive search sort must be one of ${SORT_OPTIONS.join(', ')}`);
-        }
-        if (args.mediatype && !MEDIATYPES.includes(String(args.mediatype))) {
-            throw new ArgumentError(`archive search mediatype must be one of ${MEDIATYPES.join(', ')}`);
-        }
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('archive search limit must be a positive integer');
-        }
-        if (limit > 100) {
-            throw new ArgumentError('archive search limit must be <= 100');
-        }
-
-        const query = String(args.query ?? '').trim();
-        if (!query) {
-            throw new ArgumentError('archive search query must not be empty');
-        }
-
-        const fullQuery = args.mediatype
-            ? `(${query}) AND mediatype:${args.mediatype}`
-            : query;
-
-        const url = new URL('https://archive.org/advancedsearch.php');
-        url.searchParams.set('q', fullQuery);
-        url.searchParams.set('output', 'json');
-        url.searchParams.set('rows', String(limit));
-        url.searchParams.set('sort[]', `${sort} desc`);
-        for (const fl of ['identifier', 'title', 'creator', 'date', 'mediatype', 'downloads']) {
-            url.searchParams.append('fl[]', fl);
-        }
-
-        let resp;
-        try {
-            resp = await fetch(url, {
-                headers: {
-                    'Accept': 'application/json',
-                    'User-Agent': 'opencli/1.0 (+https://github.com/jackwener/opencli)',
-                },
-            });
-        } catch (error) {
-            throw new CommandExecutionError(`archive search request failed: ${error?.message || error}`);
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`archive search failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`archive search returned malformed JSON: ${error?.message || error}`);
-        }
-
-        const docs = data?.response?.docs;
-        if (!Array.isArray(docs)) {
-            throw new CommandExecutionError('archive search returned malformed payload: response.docs must be an array');
-        }
-        if (docs.length === 0) {
-            throw new EmptyResultError('archive search', `No items match "${query}" on archive.org.`);
-        }
-
-        return docs.slice(0, limit).map((d, i) => {
-            const id = String(d.identifier ?? '');
-            if (!IDENTIFIER_RE.test(id)) {
-                throw new CommandExecutionError('archive search returned malformed payload: result row is missing a stable identifier');
-            }
-            const downloads = Number(d.downloads ?? 0);
-            if (!Number.isFinite(downloads)) {
-                throw new CommandExecutionError(`archive search returned malformed payload for "${id}": downloads must be numeric`);
-            }
-            const creator = Array.isArray(d.creator) ? d.creator.join(', ') : String(d.creator ?? '');
-            return {
-                rank: i + 1,
-                identifier: id,
-                title: String(d.title ?? ''),
-                creator,
-                date: d.date ? String(d.date).slice(0, 10) : '',
-                mediatype: String(d.mediatype ?? ''),
-                downloads,
-                url: id ? `https://archive.org/details/${id}` : '',
-            };
-        });
-    },
-});
+import{cli as g,Strategy as b}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as a,EmptyResultError as S}from"@jackwener/opencli/errors";const m=["downloads","date","addeddate","week","title"],A={added:"addeddate",published:"date"},h=["texts","movies","audio","software","image","web","data","collection"],$=/^[A-Za-z0-9._-]+$/;g({site:"archive",name:"search",access:"read",description:"Search Internet Archive items across books, movies, audio, software, and web.",domain:"archive.org",strategy:b.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Full-text query (matches title, description, creator, subject)."},{name:"mediatype",type:"string",required:!1,help:`Restrict to mediatype: ${h.join(", ")}`},{name:"sort",type:"string",default:"downloads",help:`Sort key: ${m.join(", ")}`},{name:"limit",type:"int",default:20,help:"Max items (max 100; one API page)."}],columns:["rank","identifier","title","creator","date","mediatype","downloads","url"],func:async(r)=>{const l=String(r.sort??"downloads").toLowerCase(),u=A[l]??l;if(!m.includes(u))throw new o(`archive search sort must be one of ${m.join(", ")}`);if(r.mediatype&&!h.includes(String(r.mediatype)))throw new o(`archive search mediatype must be one of ${h.join(", ")}`);const i=Number(r.limit??20);if(!Number.isInteger(i)||i<=0)throw new o("archive search limit must be a positive integer");if(i>100)throw new o("archive search limit must be <= 100");const n=String(r.query??"").trim();if(!n)throw new o("archive search query must not be empty");const f=r.mediatype?`(${n}) AND mediatype:${r.mediatype}`:n,t=new URL("https://archive.org/advancedsearch.php");t.searchParams.set("q",f);t.searchParams.set("output","json");t.searchParams.set("rows",String(i));t.searchParams.set("sort[]",`${u} desc`);for(const e of["identifier","title","creator","date","mediatype","downloads"])t.searchParams.append("fl[]",e);let c;try{c=await fetch(t,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(e){throw new a(`archive search request failed: ${e?.message||e}`)}if(!c.ok)throw new a(`archive search failed: HTTP ${c.status}`);let p;try{p=await c.json()}catch(e){throw new a(`archive search returned malformed JSON: ${e?.message||e}`)}const d=p?.response?.docs;if(!Array.isArray(d))throw new a("archive search returned malformed payload: response.docs must be an array");if(d.length===0)throw new S("archive search",`No items match "${n}" on archive.org.`);return d.slice(0,i).map((e,y)=>{const s=String(e.identifier??"");if(!$.test(s))throw new a("archive search returned malformed payload: result row is missing a stable identifier");const w=Number(e.downloads??0);if(!Number.isFinite(w))throw new a(`archive search returned malformed payload for "${s}": downloads must be numeric`);const v=Array.isArray(e.creator)?e.creator.join(", "):String(e.creator??"");return{rank:y+1,identifier:s,title:String(e.title??""),creator:v,date:e.date?String(e.date).slice(0,10):"",mediatype:String(e.mediatype??""),downloads:w,url:s?`https://archive.org/details/${s}`:""}})}});

package/clis/archive/snapshots.js

@@ -1,129 +1 @@
-// archive snapshots: Wayback Machine CDX history for a URL.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-function buildWaybackUrl(timestamp, original) {
-    if (!timestamp || !original) return '';
-    return `https://web.archive.org/web/${timestamp}/${original}`;
-}
-
-function requireCdxColumn(cols, name) {
-    const index = cols[name];
-    if (!Number.isInteger(index)) {
-        throw new CommandExecutionError(`archive snapshots returned malformed CDX payload: missing "${name}" column`);
-    }
-    return index;
-}
-
-cli({
-    site: 'archive',
-    name: 'snapshots',
-    access: 'read',
-    description: 'List Wayback Machine snapshots over time for a URL via the CDX API.',
-    domain: 'archive.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'url', positional: true, required: true, help: 'URL to look up (with or without scheme).' },
-        { name: 'from', type: 'string', required: false, help: 'Earliest year/timestamp (YYYY[MM[DD[hh[mm[ss]]]]])' },
-        { name: 'to', type: 'string', required: false, help: 'Latest year/timestamp (YYYY[MM[DD[hh[mm[ss]]]]])' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max snapshots to return (max 1000).' },
-    ],
-    columns: ['timestamp', 'snapshot_url', 'status', 'mimetype', 'original_url'],
-    func: async (args) => {
-        const target = String(args.url ?? '').trim();
-        if (!target) {
-            throw new ArgumentError(
-                'archive snapshots url cannot be empty',
-                'Example: opencli archive snapshots wikipedia.org',
-            );
-        }
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('archive snapshots limit must be a positive integer');
-        }
-        if (limit > 1000) {
-            throw new ArgumentError('archive snapshots limit must be <= 1000');
-        }
-        for (const key of ['from', 'to']) {
-            const v = args[key];
-            if (v != null && !/^\d{4,14}$/.test(String(v))) {
-                throw new ArgumentError(`archive snapshots ${key} must be a digit-only timestamp (YYYY[MM[DD[hh[mm[ss]]]]])`);
-            }
-        }
-
-        // Wayback CDX is served on HTTP only; the HTTPS endpoint returns 503.
-        const apiUrl = new URL('http://web.archive.org/cdx/search/cdx');
-        apiUrl.searchParams.set('url', target);
-        apiUrl.searchParams.set('output', 'json');
-        apiUrl.searchParams.set('limit', String(limit));
-        if (args.from) apiUrl.searchParams.set('from', String(args.from));
-        if (args.to) apiUrl.searchParams.set('to', String(args.to));
-
-        let resp;
-        try {
-            resp = await fetch(apiUrl, {
-                headers: {
-                    'Accept': 'application/json',
-                    'User-Agent': 'opencli/1.0 (+https://github.com/jackwener/opencli)',
-                },
-            });
-        } catch (error) {
-            throw new CommandExecutionError(`archive snapshots request failed: ${error?.message || error}`);
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`archive snapshots failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`archive snapshots returned malformed JSON: ${error?.message || error}`);
-        }
-
-        // CDX returns an array of arrays; the first row is the header.
-        if (!Array.isArray(data)) {
-            throw new CommandExecutionError('archive snapshots returned malformed CDX payload: top-level payload must be an array');
-        }
-        if (data.length < 2) {
-            throw new EmptyResultError('archive snapshots', `No Wayback snapshots for "${target}".`);
-        }
-        const [header, ...rows] = data;
-        if (!Array.isArray(header)) {
-            throw new CommandExecutionError('archive snapshots returned malformed CDX payload: header row must be an array');
-        }
-        const cols = {};
-        header.forEach((name, i) => { cols[name] = i; });
-        const timestampCol = requireCdxColumn(cols, 'timestamp');
-        const originalCol = requireCdxColumn(cols, 'original');
-        const statusCol = requireCdxColumn(cols, 'statuscode');
-        const mimetypeCol = requireCdxColumn(cols, 'mimetype');
-
-        return rows.slice(0, limit).map(row => {
-            if (!Array.isArray(row)) {
-                throw new CommandExecutionError('archive snapshots returned malformed CDX payload: snapshot row must be an array');
-            }
-            const timestamp = String(row[timestampCol] ?? '');
-            const original = String(row[originalCol] ?? '');
-            const status = row[statusCol];
-            const mimetype = row[mimetypeCol];
-            if (!/^\d{14}$/.test(timestamp) || !original) {
-                throw new CommandExecutionError('archive snapshots returned malformed CDX payload: snapshot row is missing timestamp/original URL');
-            }
-            if (status == null || mimetype == null || String(status) === '' || String(mimetype) === '') {
-                throw new CommandExecutionError('archive snapshots returned malformed CDX payload: snapshot row is missing statuscode/mimetype');
-            }
-            return {
-                timestamp,
-                snapshot_url: buildWaybackUrl(timestamp, original),
-                status: String(status),
-                mimetype: String(mimetype),
-                original_url: original,
-            };
-        });
-    },
-});
+import{cli as R,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as N,CommandExecutionError as G,EmptyResultError as W}from"@jackwener/opencli/errors";function X(B,F){if(!B||!F)return"";return`https://web.archive.org/web/${B}/${F}`}function O(B,F){const H=B[F];if(!Number.isInteger(H))throw new G(`archive snapshots returned malformed CDX payload: missing "${F}" column`);return H}R({site:"archive",name:"snapshots",access:"read",description:"List Wayback Machine snapshots over time for a URL via the CDX API.",domain:"archive.org",strategy:S.PUBLIC,browser:!1,args:[{name:"url",positional:!0,required:!0,help:"URL to look up (with or without scheme)."},{name:"from",type:"string",required:!1,help:"Earliest year/timestamp (YYYY[MM[DD[hh[mm[ss]]]]])"},{name:"to",type:"string",required:!1,help:"Latest year/timestamp (YYYY[MM[DD[hh[mm[ss]]]]])"},{name:"limit",type:"int",default:20,help:"Max snapshots to return (max 1000)."}],columns:["timestamp","snapshot_url","status","mimetype","original_url"],func:async(B)=>{const F=String(B.url??"").trim();if(!F)throw new N("archive snapshots url cannot be empty","Example: opencli archive snapshots wikipedia.org");const H=Number(B.limit??20);if(!Number.isInteger(H)||H<=0)throw new N("archive snapshots limit must be a positive integer");if(H>1000)throw new N("archive snapshots limit must be <= 1000");for(const z of["from","to"]){const I=B[z];if(I!=null&&!/^\d{4,14}$/.test(String(I)))throw new N(`archive snapshots ${z} must be a digit-only timestamp (YYYY[MM[DD[hh[mm[ss]]]]])`)}const J=new URL("http://web.archive.org/cdx/search/cdx");J.searchParams.set("url",F);J.searchParams.set("output","json");J.searchParams.set("limit",String(H));if(B.from)J.searchParams.set("from",String(B.from));if(B.to)J.searchParams.set("to",String(B.to));let L;try{L=await fetch(J,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(z){throw new G(`archive snapshots request failed: ${z?.message||z}`)}if(!L.ok)throw new G(`archive snapshots failed: HTTP ${L.status}`);let M;try{M=await L.json()}catch(z){throw new G(`archive snapshots returned malformed JSON: ${z?.message||z}`)}if(!Array.isArray(M))throw new G("archive snapshots returned malformed CDX payload: top-level payload must be an array");if(M.length<2)throw new W("archive snapshots",`No Wayback snapshots for "${F}".`);const[V,...Y]=M;if(!Array.isArray(V))throw new G("archive snapshots returned malformed CDX payload: header row must be an array");const K={};V.forEach((z,I)=>{K[z]=I});const Z=O(K,"timestamp"),_=O(K,"original"),$=O(K,"statuscode"),D=O(K,"mimetype");return Y.slice(0,H).map((z)=>{if(!Array.isArray(z))throw new G("archive snapshots returned malformed CDX payload: snapshot row must be an array");const I=String(z[Z]??""),P=String(z[_]??""),Q=z[$],T=z[D];if(!/^\d{14}$/.test(I)||!P)throw new G("archive snapshots returned malformed CDX payload: snapshot row is missing timestamp/original URL");if(Q==null||T==null||String(Q)===""||String(T)==="")throw new G("archive snapshots returned malformed CDX payload: snapshot row is missing statuscode/mimetype");return{timestamp:I,snapshot_url:X(I,P),status:String(Q),mimetype:String(T),original_url:P}})}});

package/clis/archive/wayback.js

@@ -1,83 +1 @@
-// archive wayback: Wayback Machine closest-snapshot lookup for a URL.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-function normalizeTimestamp(raw) {
-    // Accept YYYY, YYYYMM, YYYYMMDD, YYYYMMDDhh, YYYYMMDDhhmm, YYYYMMDDhhmmss,
-    // YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss. Strip non-digits and validate length.
-    const digits = String(raw).replace(/[^0-9]/g, '');
-    if (!/^\d{4,14}$/.test(digits) || digits.length % 2 !== 0 && digits.length !== 4) {
-        throw new ArgumentError('archive wayback timestamp must be YYYY[MM[DD[hh[mm[ss]]]]] or an ISO date');
-    }
-    return digits;
-}
-
-cli({
-    site: 'archive',
-    name: 'wayback',
-    access: 'read',
-    description: 'Look up the closest Wayback Machine snapshot for a URL.',
-    domain: 'archive.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'url', positional: true, required: true, help: 'URL to look up (with or without scheme).' },
-        { name: 'timestamp', type: 'string', required: false, help: 'Target timestamp (YYYY[MM[DD[hh[mm[ss]]]]] or ISO date). Defaults to most recent snapshot.' },
-    ],
-    columns: ['original_url', 'requested_timestamp', 'snapshot_timestamp', 'snapshot_url', 'status'],
-    func: async (args) => {
-        const target = String(args.url ?? '').trim();
-        if (!target) {
-            throw new ArgumentError(
-                'archive wayback url cannot be empty',
-                'Example: opencli archive wayback wikipedia.org',
-            );
-        }
-        const timestamp = args.timestamp ? normalizeTimestamp(args.timestamp) : '';
-
-        const apiUrl = new URL('https://archive.org/wayback/available');
-        apiUrl.searchParams.set('url', target);
-        if (timestamp) apiUrl.searchParams.set('timestamp', timestamp);
-
-        let resp;
-        try {
-            resp = await fetch(apiUrl, {
-                headers: {
-                    'Accept': 'application/json',
-                    'User-Agent': 'opencli/1.0 (+https://github.com/jackwener/opencli)',
-                },
-            });
-        } catch (error) {
-            throw new CommandExecutionError(`archive wayback request failed: ${error?.message || error}`);
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`archive wayback failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`archive wayback returned malformed JSON: ${error?.message || error}`);
-        }
-
-        const snap = data?.archived_snapshots?.closest;
-        if (!snap || !snap.available) {
-            throw new EmptyResultError('archive wayback', `No Wayback snapshot for "${target}".`);
-        }
-        if (typeof snap.url !== 'string' || !snap.url || !/^\d{14}$/.test(String(snap.timestamp ?? ''))) {
-            throw new CommandExecutionError('archive wayback returned malformed payload: closest snapshot is missing url/timestamp');
-        }
-
-        return [{
-            original_url: String(data.url ?? target),
-            requested_timestamp: timestamp,
-            snapshot_timestamp: String(snap.timestamp ?? ''),
-            snapshot_url: String(snap.url),
-            status: String(snap.status ?? ''),
-        }];
-    },
-});
+import{cli as L,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as K,CommandExecutionError as G,EmptyResultError as O}from"@jackwener/opencli/errors";function P(q){const b=String(q).replace(/[^0-9]/g,"");if(!/^\d{4,14}$/.test(b)||b.length%2!==0&&b.length!==4)throw new K("archive wayback timestamp must be YYYY[MM[DD[hh[mm[ss]]]]] or an ISO date");return b}L({site:"archive",name:"wayback",access:"read",description:"Look up the closest Wayback Machine snapshot for a URL.",domain:"archive.org",strategy:N.PUBLIC,browser:!1,args:[{name:"url",positional:!0,required:!0,help:"URL to look up (with or without scheme)."},{name:"timestamp",type:"string",required:!1,help:"Target timestamp (YYYY[MM[DD[hh[mm[ss]]]]] or ISO date). Defaults to most recent snapshot."}],columns:["original_url","requested_timestamp","snapshot_timestamp","snapshot_url","status"],func:async(q)=>{const b=String(q.url??"").trim();if(!b)throw new K("archive wayback url cannot be empty","Example: opencli archive wayback wikipedia.org");const H=q.timestamp?P(q.timestamp):"",I=new URL("https://archive.org/wayback/available");I.searchParams.set("url",b);if(H)I.searchParams.set("timestamp",H);let F;try{F=await fetch(I,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(B){throw new G(`archive wayback request failed: ${B?.message||B}`)}if(!F.ok)throw new G(`archive wayback failed: HTTP ${F.status}`);let J;try{J=await F.json()}catch(B){throw new G(`archive wayback returned malformed JSON: ${B?.message||B}`)}const f=J?.archived_snapshots?.closest;if(!f||!f.available)throw new O("archive wayback",`No Wayback snapshot for "${b}".`);if(typeof f.url!=="string"||!f.url||!/^\d{14}$/.test(String(f.timestamp??"")))throw new G("archive wayback returned malformed payload: closest snapshot is missing url/timestamp");return[{original_url:String(J.url??b),requested_timestamp:H,snapshot_timestamp:String(f.timestamp??""),snapshot_url:String(f.url),status:String(f.status??"")}]}});

package/clis/arxiv/author.js

@@ -1,44 +1 @@
-// arxiv author — list papers authored by a person, newest first.
-//
-// arXiv's public API supports `au:` prefix queries. Author names on arXiv are
-// not stable IDs, so this is a best-effort fuzzy match — the same person can
-// appear under multiple spellings ("Y. Bengio" vs "Yoshua Bengio").
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import { arxivFetch, normalizeArxivLimit, parseEntries } from './utils.js';
-
-cli({
-    site: 'arxiv',
-    name: 'author',
-    access: 'read',
-    description: 'List arXiv papers by a given author (newest first)',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'author', positional: true, required: true, help: 'Author name (e.g. "Yoshua Bengio" or "Y Bengio")' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max papers to return (max 50)' },
-    ],
-    columns: ['id', 'title', 'authors', 'published', 'primary_category', 'url'],
-    func: async (args) => {
-        const authorText = String(args.author || '').trim();
-        if (!authorText) {
-            throw new ArgumentError('arxiv author cannot be empty', 'Example: opencli arxiv author "Yoshua Bengio"');
-        }
-        const limit = normalizeArxivLimit(args.limit, 20, 50);
-        // Quote the value so multi-word author names match as a phrase.
-        const query = encodeURIComponent(`au:"${authorText}"`);
-        const xml = await arxivFetch(`search_query=${query}&max_results=${limit}&sortBy=submittedDate&sortOrder=descending`);
-        const entries = parseEntries(xml);
-        if (!entries.length) {
-            throw new EmptyResultError('arxiv author', `No papers found for author "${authorText}". Try alternate spellings (e.g. initials).`);
-        }
-        return entries.map(e => ({
-            id: e.id,
-            title: e.title,
-            authors: e.authors,
-            published: e.published,
-            primary_category: e.primary_category,
-            url: e.url,
-        }));
-    },
-});
+import{cli as I,Strategy as J}from"@jackwener/opencli/registry";import{ArgumentError as K,EmptyResultError as M}from"@jackwener/opencli/errors";import{arxivFetch as N,normalizeArxivLimit as O,parseEntries as P}from"./utils.js";I({site:"arxiv",name:"author",access:"read",description:"List arXiv papers by a given author (newest first)",strategy:J.PUBLIC,browser:!1,args:[{name:"author",positional:!0,required:!0,help:'Author name (e.g. "Yoshua Bengio" or "Y Bengio")'},{name:"limit",type:"int",default:20,help:"Max papers to return (max 50)"}],columns:["id","title","authors","published","primary_category","url"],func:async(B)=>{const f=String(B.author||"").trim();if(!f)throw new K("arxiv author cannot be empty",'Example: opencli arxiv author "Yoshua Bengio"');const D=O(B.limit,20,50),G=encodeURIComponent(`au:"${f}"`),H=await N(`search_query=${G}&max_results=${D}&sortBy=submittedDate&sortOrder=descending`),C=P(H);if(!C.length)throw new M("arxiv author",`No papers found for author "${f}". Try alternate spellings (e.g. initials).`);return C.map((b)=>({id:b.id,title:b.title,authors:b.authors,published:b.published,primary_category:b.primary_category,url:b.url}))}});

package/clis/arxiv/paper.js

@@ -1,22 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { arxivFetch, parseEntries } from './utils.js';
-cli({
-    site: 'arxiv',
-    name: 'paper',
-    access: 'read',
-    description: 'Get arXiv paper details by ID',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'arXiv paper ID (e.g. 1706.03762)' },
-    ],
-    columns: ['id', 'title', 'authors', 'published', 'updated', 'primary_category', 'categories', 'abstract', 'comment', 'pdf', 'url'],
-    func: async (args) => {
-        const xml = await arxivFetch(`id_list=${encodeURIComponent(args.id)}`);
-        const entries = parseEntries(xml);
-        if (!entries.length)
-            throw new EmptyResultError('arxiv paper', `Paper ${args.id} was not found. Check the arXiv ID format, e.g. 1706.03762`);
-        return entries;
-    },
-});
+import{cli as a,Strategy as i}from"@jackwener/opencli/registry";import{EmptyResultError as o}from"@jackwener/opencli/errors";import{arxivFetch as s,parseEntries as p}from"./utils.js";a({site:"arxiv",name:"paper",access:"read",description:"Get arXiv paper details by ID",strategy:i.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"arXiv paper ID (e.g. 1706.03762)"}],columns:["id","title","authors","published","updated","primary_category","categories","abstract","comment","pdf","url"],func:async(e)=>{const t=await s(`id_list=${encodeURIComponent(e.id)}`),r=p(t);if(!r.length)throw new o("arxiv paper",`Paper ${e.id} was not found. Check the arXiv ID format, e.g. 1706.03762`);return r}});

package/clis/arxiv/recent.js

@@ -1,33 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { arxivFetch, normalizeArxivCategory, normalizeArxivLimit, parseEntries } from './utils.js';
-cli({
-    site: 'arxiv',
-    name: 'recent',
-    access: 'read',
-    description: 'List recent arXiv submissions in a category',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'category', positional: true, required: true, help: 'arXiv category (e.g. cs.CL, cs.LG, math.PR, q-bio.NC)' },
-        { name: 'limit', type: 'int', default: 10, help: 'Max results (max 50)' },
-    ],
-    columns: ['id', 'title', 'authors', 'published', 'primary_category', 'url'],
-    func: async (args) => {
-        const category = normalizeArxivCategory(args.category);
-        const limit = normalizeArxivLimit(args.limit, 10, 50);
-        const query = encodeURIComponent(`cat:${category}`);
-        const xml = await arxivFetch(`search_query=${query}&max_results=${limit}&sortBy=submittedDate&sortOrder=descending`);
-        const entries = parseEntries(xml);
-        if (!entries.length)
-            throw new EmptyResultError('arxiv', `No recent papers in ${category}. Check the category name.`);
-        return entries.map(e => ({
-            id: e.id,
-            title: e.title,
-            authors: e.authors,
-            published: e.published,
-            primary_category: e.primary_category,
-            url: e.url,
-        }));
-    },
-});
+import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{arxivFetch as l,normalizeArxivCategory as u,normalizeArxivLimit as y,parseEntries as p}from"./utils.js";n({site:"arxiv",name:"recent",access:"read",description:"List recent arXiv submissions in a category",strategy:c.PUBLIC,browser:!1,args:[{name:"category",positional:!0,required:!0,help:"arXiv category (e.g. cs.CL, cs.LG, math.PR, q-bio.NC)"},{name:"limit",type:"int",default:10,help:"Max results (max 50)"}],columns:["id","title","authors","published","primary_category","url"],func:async(t)=>{const e=u(t.category),a=y(t.limit,10,50),s=encodeURIComponent(`cat:${e}`),o=await l(`search_query=${s}&max_results=${a}&sortBy=submittedDate&sortOrder=descending`),i=p(o);if(!i.length)throw new m("arxiv",`No recent papers in ${e}. Check the category name.`);return i.map((r)=>({id:r.id,title:r.title,authors:r.authors,published:r.published,primary_category:r.primary_category,url:r.url}))}});

package/clis/arxiv/search.js

@@ -1,36 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import { arxivFetch, normalizeArxivLimit, parseEntries } from './utils.js';
-cli({
-    site: 'arxiv',
-    name: 'search',
-    access: 'read',
-    description: 'Search arXiv papers',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword (e.g. "attention is all you need")' },
-        { name: 'limit', type: 'int', default: 10, help: 'Max results (max 25)' },
-    ],
-    columns: ['id', 'title', 'authors', 'published', 'primary_category', 'url'],
-    func: async (args) => {
-        const queryText = String(args.query || '').trim();
-        if (!queryText) {
-            throw new ArgumentError('arxiv search query cannot be empty');
-        }
-        const limit = normalizeArxivLimit(args.limit, 10, 25);
-        const query = encodeURIComponent(`all:${queryText}`);
-        const xml = await arxivFetch(`search_query=${query}&max_results=${limit}&sortBy=relevance`);
-        const entries = parseEntries(xml);
-        if (!entries.length)
-            throw new EmptyResultError('arxiv', 'No papers found. Try a different keyword.');
-        return entries.map(e => ({
-            id: e.id,
-            title: e.title,
-            authors: e.authors,
-            published: e.published,
-            primary_category: e.primary_category,
-            url: e.url,
-        }));
-    },
-});
+import{cli as n,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as u,EmptyResultError as m}from"@jackwener/opencli/errors";import{arxivFetch as c,normalizeArxivLimit as p,parseEntries as y}from"./utils.js";n({site:"arxiv",name:"search",access:"read",description:"Search arXiv papers",strategy:l.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "attention is all you need")'},{name:"limit",type:"int",default:10,help:"Max results (max 25)"}],columns:["id","title","authors","published","primary_category","url"],func:async(e)=>{const t=String(e.query||"").trim();if(!t)throw new u("arxiv search query cannot be empty");const a=p(e.limit,10,25),o=encodeURIComponent(`all:${t}`),s=await c(`search_query=${o}&max_results=${a}&sortBy=relevance`),i=y(s);if(!i.length)throw new m("arxiv","No papers found. Try a different keyword.");return i.map((r)=>({id:r.id,title:r.title,authors:r.authors,published:r.published,primary_category:r.primary_category,url:r.url}))}});