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

package/clis/coingecko/categories.js

@@ -1,75 +1 @@
-// coingecko categories — top crypto categories by aggregated market cap.
-//
-// Hits the public `/api/v3/coins/categories` endpoint. Useful for spotting
-// which sectors (DeFi, L1, gaming, RWAs, …) are leading the market.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-const ORDER_OPTIONS = ['market_cap_desc', 'market_cap_asc', 'name_desc', 'name_asc', 'market_cap_change_24h_desc', 'market_cap_change_24h_asc'];
-
-cli({
-    site: 'coingecko',
-    name: 'categories',
-    access: 'read',
-    description: 'Crypto categories ranked by aggregated market cap',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'sort', default: 'market_cap_desc', help: `Sort order (${ORDER_OPTIONS.join(' / ')})` },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of categories (1-100; CoinGecko returns ~120 max)' },
-    ],
-    columns: ['rank', 'id', 'name', 'marketCap', 'volume24h', 'marketCapChange24hPct', 'top3Coins'],
-    func: async (args) => {
-        const sort = String(args.sort ?? 'market_cap_desc').trim().toLowerCase();
-        if (!ORDER_OPTIONS.includes(sort)) {
-            throw new ArgumentError(
-                `coingecko sort "${args.sort}" is not supported`,
-                `Supported sorts: ${ORDER_OPTIONS.join(', ')}`,
-            );
-        }
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('coingecko limit must be a positive integer');
-        }
-        if (limit > 100) {
-            throw new ArgumentError('coingecko limit must be <= 100');
-        }
-        const url = `https://api.coingecko.com/api/v3/coins/categories?order=${encodeURIComponent(sort)}`;
-        let resp;
-        try {
-            resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko categories request failed: ${err?.message ?? err}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError(
-                'coingecko returned HTTP 429 (rate limited)',
-                'Free tier allows ~30 calls/min. Wait and retry.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko categories returned HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko categories returned malformed JSON: ${err?.message ?? err}`);
-        }
-        if (!Array.isArray(data) || !data.length) {
-            throw new EmptyResultError('coingecko categories', 'CoinGecko returned no category data.');
-        }
-        return data.slice(0, limit).map((cat, i) => ({
-            rank: i + 1,
-            id: String(cat.id ?? ''),
-            name: String(cat.name ?? ''),
-            marketCap: cat.market_cap != null ? Number(cat.market_cap) : null,
-            volume24h: cat.volume_24h != null ? Number(cat.volume_24h) : null,
-            marketCapChange24hPct: cat.market_cap_change_24h != null ? Number(cat.market_cap_change_24h) : null,
-            top3Coins: Array.isArray(cat.top_3_coins_id) ? cat.top_3_coins_id.join(', ') : '',
-        }));
-    },
-});
+import{cli as l,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as a,EmptyResultError as u}from"@jackwener/opencli/errors";const c=["market_cap_desc","market_cap_asc","name_desc","name_asc","market_cap_change_24h_desc","market_cap_change_24h_asc"];l({site:"coingecko",name:"categories",access:"read",description:"Crypto categories ranked by aggregated market cap",domain:"api.coingecko.com",strategy:p.PUBLIC,browser:!1,args:[{name:"sort",default:"market_cap_desc",help:`Sort order (${c.join(" / ")})`},{name:"limit",type:"int",default:20,help:"Number of categories (1-100; CoinGecko returns ~120 max)"}],columns:["rank","id","name","marketCap","volume24h","marketCapChange24hPct","top3Coins"],func:async(i)=>{const s=String(i.sort??"market_cap_desc").trim().toLowerCase();if(!c.includes(s))throw new n(`coingecko sort "${i.sort}" is not supported`,`Supported sorts: ${c.join(", ")}`);const t=Number(i.limit??20);if(!Number.isInteger(t)||t<=0)throw new n("coingecko limit must be a positive integer");if(t>100)throw new n("coingecko limit must be <= 100");const m=`https://api.coingecko.com/api/v3/coins/categories?order=${encodeURIComponent(s)}`;let r;try{r=await fetch(m,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(e){throw new a(`coingecko categories request failed: ${e?.message??e}`)}if(r.status===429)throw new a("coingecko returned HTTP 429 (rate limited)","Free tier allows ~30 calls/min. Wait and retry.");if(!r.ok)throw new a(`coingecko categories returned HTTP ${r.status}`);let o;try{o=await r.json()}catch(e){throw new a(`coingecko categories returned malformed JSON: ${e?.message??e}`)}if(!Array.isArray(o)||!o.length)throw new u("coingecko categories","CoinGecko returned no category data.");return o.slice(0,t).map((e,g)=>({rank:g+1,id:String(e.id??""),name:String(e.name??""),marketCap:e.market_cap!=null?Number(e.market_cap):null,volume24h:e.volume_24h!=null?Number(e.volume_24h):null,marketCapChange24hPct:e.market_cap_change_24h!=null?Number(e.market_cap_change_24h):null,top3Coins:Array.isArray(e.top_3_coins_id)?e.top_3_coins_id.join(", "):""}))}});

package/clis/coingecko/coin.js

@@ -1,107 +1 @@
-// coingecko coin — fetch a single cryptocurrency's market detail by id.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-cli({
-    site: 'coingecko',
-    name: 'coin',
-    access: 'read',
-    description: 'Fetch a single cryptocurrency\'s market data by CoinGecko id (e.g. bitcoin, ethereum).',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, type: 'string', help: 'CoinGecko coin id (lowercase, e.g. bitcoin / ethereum / solana).' },
-        { name: 'currency', type: 'string', default: 'usd', help: 'Quote currency (usd, cny, eur, jpy, ...).' },
-    ],
-    columns: [
-        'id', 'symbol', 'name', 'rank', 'price', 'marketCap', 'volume24h',
-        'change24hPct', 'change7dPct', 'change30dPct', 'ath', 'athDate', 'atl', 'atlDate',
-        'circulatingSupply', 'totalSupply', 'maxSupply', 'genesisDate', 'homepage',
-    ],
-    func: async (args) => {
-        const id = String(args.id ?? '').trim().toLowerCase();
-        if (!id) {
-            throw new ArgumentError('coingecko coin id cannot be empty', 'Example: opencli coingecko coin bitcoin');
-        }
-        if (!/^[a-z0-9][a-z0-9-]*$/.test(id)) {
-            throw new ArgumentError(`coingecko coin id must look like a CoinGecko slug (got "${args.id}")`);
-        }
-        const currency = String(args.currency ?? 'usd').trim().toLowerCase();
-        if (!/^[a-z0-9-]{2,20}$/.test(currency)) {
-            throw new ArgumentError(`coingecko currency must look like a currency slug (got "${args.currency}")`);
-        }
-
-        const url = new URL(`https://api.coingecko.com/api/v3/coins/${id}`);
-        url.searchParams.set('localization', 'false');
-        url.searchParams.set('tickers', 'false');
-        url.searchParams.set('market_data', 'true');
-        url.searchParams.set('community_data', 'false');
-        url.searchParams.set('developer_data', 'false');
-        url.searchParams.set('sparkline', 'false');
-
-        let resp;
-        try {
-            resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        } catch (error) {
-            throw new CommandExecutionError(`coingecko coin request failed: ${error?.message || error}`);
-        }
-        if (resp.status === 404) {
-            throw new EmptyResultError('coingecko coin', `coingecko has no coin with id "${id}".`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError('coingecko returned HTTP 429 (rate limited)', 'Free tier allows ~30 calls/min. Wait and retry.');
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko coin failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`coingecko returned malformed JSON: ${error?.message || error}`);
-        }
-        if (data?.error) {
-            throw new CommandExecutionError(`coingecko returned error: ${data.error}`);
-        }
-
-        const md = data.market_data || {};
-        const pick = (obj, key) => (obj && obj[key] != null ? obj[key] : null);
-        const isoFromMaybe = (s) => (s ? String(s).slice(0, 10) : '');
-        const price = pick(md.current_price, currency);
-        const marketCap = pick(md.market_cap, currency);
-        const volume24h = pick(md.total_volume, currency);
-        if (price == null && marketCap == null && volume24h == null) {
-            throw new CommandExecutionError(
-                `coingecko returned no market data for currency "${currency}"`,
-                'Use a CoinGecko-supported quote currency such as usd, cny, eur, or jpy.',
-            );
-        }
-
-        return [{
-            id: data.id || id,
-            symbol: String(data.symbol || '').toUpperCase(),
-            name: data.name || '',
-            rank: data.market_cap_rank ?? null,
-            price,
-            marketCap,
-            volume24h,
-            change24hPct: md.price_change_percentage_24h ?? null,
-            change7dPct: md.price_change_percentage_7d ?? null,
-            change30dPct: md.price_change_percentage_30d ?? null,
-            ath: pick(md.ath, currency),
-            athDate: isoFromMaybe(pick(md.ath_date, currency)),
-            atl: pick(md.atl, currency),
-            atlDate: isoFromMaybe(pick(md.atl_date, currency)),
-            circulatingSupply: md.circulating_supply ?? null,
-            totalSupply: md.total_supply ?? null,
-            maxSupply: md.max_supply ?? null,
-            genesisDate: data.genesis_date || '',
-            homepage: Array.isArray(data.links?.homepage) ? (data.links.homepage.find(Boolean) || '') : '',
-        }];
-    },
-});
+import{cli as y,Strategy as k}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as i,EmptyResultError as w}from"@jackwener/opencli/errors";y({site:"coingecko",name:"coin",access:"read",description:"Fetch a single cryptocurrency's market data by CoinGecko id (e.g. bitcoin, ethereum).",domain:"api.coingecko.com",strategy:k.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,type:"string",help:"CoinGecko coin id (lowercase, e.g. bitcoin / ethereum / solana)."},{name:"currency",type:"string",default:"usd",help:"Quote currency (usd, cny, eur, jpy, ...)."}],columns:["id","symbol","name","rank","price","marketCap","volume24h","change24hPct","change7dPct","change30dPct","ath","athDate","atl","atlDate","circulatingSupply","totalSupply","maxSupply","genesisDate","homepage"],func:async(l)=>{const s=String(l.id??"").trim().toLowerCase();if(!s)throw new u("coingecko coin id cannot be empty","Example: opencli coingecko coin bitcoin");if(!/^[a-z0-9][a-z0-9-]*$/.test(s))throw new u(`coingecko coin id must look like a CoinGecko slug (got "${l.id}")`);const r=String(l.currency??"usd").trim().toLowerCase();if(!/^[a-z0-9-]{2,20}$/.test(r))throw new u(`coingecko currency must look like a currency slug (got "${l.currency}")`);const c=new URL(`https://api.coingecko.com/api/v3/coins/${s}`);c.searchParams.set("localization","false");c.searchParams.set("tickers","false");c.searchParams.set("market_data","true");c.searchParams.set("community_data","false");c.searchParams.set("developer_data","false");c.searchParams.set("sparkline","false");let o;try{o=await fetch(c,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(t){throw new i(`coingecko coin request failed: ${t?.message||t}`)}if(o.status===404)throw new w("coingecko coin",`coingecko has no coin with id "${s}".`);if(o.status===429)throw new i("coingecko returned HTTP 429 (rate limited)","Free tier allows ~30 calls/min. Wait and retry.");if(!o.ok)throw new i(`coingecko coin failed: HTTP ${o.status}`);let a;try{a=await o.json()}catch(t){throw new i(`coingecko returned malformed JSON: ${t?.message||t}`)}if(a?.error)throw new i(`coingecko returned error: ${a.error}`);const e=a.market_data||{},n=(t,h)=>t&&t[h]!=null?t[h]:null,m=(t)=>t?String(t).slice(0,10):"",p=n(e.current_price,r),g=n(e.market_cap,r),d=n(e.total_volume,r);if(p==null&&g==null&&d==null)throw new i(`coingecko returned no market data for currency "${r}"`,"Use a CoinGecko-supported quote currency such as usd, cny, eur, or jpy.");return[{id:a.id||s,symbol:String(a.symbol||"").toUpperCase(),name:a.name||"",rank:a.market_cap_rank??null,price:p,marketCap:g,volume24h:d,change24hPct:e.price_change_percentage_24h??null,change7dPct:e.price_change_percentage_7d??null,change30dPct:e.price_change_percentage_30d??null,ath:n(e.ath,r),athDate:m(n(e.ath_date,r)),atl:n(e.atl,r),atlDate:m(n(e.atl_date,r)),circulatingSupply:e.circulating_supply??null,totalSupply:e.total_supply??null,maxSupply:e.max_supply??null,genesisDate:a.genesis_date||"",homepage:Array.isArray(a.links?.homepage)?a.links.homepage.find(Boolean)||"":""}]}});

package/clis/coingecko/derivatives.js

@@ -1,84 +1 @@
-// coingecko derivatives — perpetual / futures tickers across crypto exchanges.
-//
-// Hits the public `/api/v3/derivatives` endpoint (no auth, free tier). Each
-// row is one exchange-symbol combo: market, contract type, mark price, 24h
-// %, basis vs index, funding rate, open interest (USD), 24h volume.
-//
-// CoinGecko sorts the response by 24h volume desc, so `rank` mirrors the
-// listing order with no client-side reshuffling.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-const ENDPOINT = 'https://api.coingecko.com/api/v3/derivatives';
-
-cli({
-    site: 'coingecko',
-    name: 'derivatives',
-    access: 'read',
-    description: 'Top crypto derivative (perpetual / futures) markets by 24h volume',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Max rows to return (1-500; CoinGecko returns one large page).' },
-        { name: 'symbol', type: 'string', required: false, help: 'Optional symbol substring filter (e.g. "BTC", "ETHUSDT").' },
-    ],
-    columns: ['rank', 'market', 'symbol', 'indexId', 'contractType', 'price', 'change24hPct', 'fundingRate', 'openInterestUsd', 'volume24hUsd', 'expired'],
-    func: async (args) => {
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('coingecko derivatives limit must be a positive integer');
-        }
-        if (limit > 500) {
-            throw new ArgumentError('coingecko derivatives limit must be <= 500');
-        }
-        const filter = args.symbol == null ? '' : String(args.symbol).trim().toUpperCase();
-        let resp;
-        try {
-            resp = await fetch(ENDPOINT, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko derivatives request failed: ${err?.message ?? err}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError(
-                'coingecko derivatives returned HTTP 429 (rate limited)',
-                'Free tier allows ~30 calls/min. Wait and retry.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko derivatives returned HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko derivatives returned malformed JSON: ${err?.message ?? err}`);
-        }
-        if (!Array.isArray(data) || !data.length) {
-            throw new EmptyResultError('coingecko derivatives', 'CoinGecko returned no derivative tickers.');
-        }
-        let rows = data;
-        if (filter) {
-            rows = data.filter((d) => String(d.symbol ?? '').toUpperCase().includes(filter)
-                || String(d.index_id ?? '').toUpperCase().includes(filter));
-            if (!rows.length) {
-                throw new EmptyResultError('coingecko derivatives', `No derivative tickers matched symbol="${filter}".`);
-            }
-        }
-        return rows.slice(0, limit).map((d, i) => ({
-            rank: i + 1,
-            market: String(d.market ?? ''),
-            symbol: String(d.symbol ?? ''),
-            indexId: String(d.index_id ?? ''),
-            contractType: String(d.contract_type ?? ''),
-            price: d.price != null ? Number(d.price) : null,
-            change24hPct: d.price_percentage_change_24h != null ? Number(d.price_percentage_change_24h) : null,
-            fundingRate: d.funding_rate != null ? Number(d.funding_rate) : null,
-            openInterestUsd: d.open_interest != null ? Number(d.open_interest) : null,
-            volume24hUsd: d.volume_24h != null ? Number(d.volume_24h) : null,
-            expired: d.expired_at ? String(d.expired_at) : '',
-        }));
-    },
-});
+import{cli as u,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as o,EmptyResultError as l}from"@jackwener/opencli/errors";const g="https://api.coingecko.com/api/v3/derivatives";u({site:"coingecko",name:"derivatives",access:"read",description:"Top crypto derivative (perpetual / futures) markets by 24h volume",domain:"api.coingecko.com",strategy:p.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Max rows to return (1-500; CoinGecko returns one large page)."},{name:"symbol",type:"string",required:!1,help:'Optional symbol substring filter (e.g. "BTC", "ETHUSDT").'}],columns:["rank","market","symbol","indexId","contractType","price","change24hPct","fundingRate","openInterestUsd","volume24hUsd","expired"],func:async(s)=>{const i=Number(s.limit??20);if(!Number.isInteger(i)||i<=0)throw new c("coingecko derivatives limit must be a positive integer");if(i>500)throw new c("coingecko derivatives limit must be <= 500");const n=s.symbol==null?"":String(s.symbol).trim().toUpperCase();let r;try{r=await fetch(g,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(e){throw new o(`coingecko derivatives request failed: ${e?.message??e}`)}if(r.status===429)throw new o("coingecko derivatives returned HTTP 429 (rate limited)","Free tier allows ~30 calls/min. Wait and retry.");if(!r.ok)throw new o(`coingecko derivatives returned HTTP ${r.status}`);let t;try{t=await r.json()}catch(e){throw new o(`coingecko derivatives returned malformed JSON: ${e?.message??e}`)}if(!Array.isArray(t)||!t.length)throw new l("coingecko derivatives","CoinGecko returned no derivative tickers.");let a=t;if(n){a=t.filter((e)=>String(e.symbol??"").toUpperCase().includes(n)||String(e.index_id??"").toUpperCase().includes(n));if(!a.length)throw new l("coingecko derivatives",`No derivative tickers matched symbol="${n}".`)}return a.slice(0,i).map((e,m)=>({rank:m+1,market:String(e.market??""),symbol:String(e.symbol??""),indexId:String(e.index_id??""),contractType:String(e.contract_type??""),price:e.price!=null?Number(e.price):null,change24hPct:e.price_percentage_change_24h!=null?Number(e.price_percentage_change_24h):null,fundingRate:e.funding_rate!=null?Number(e.funding_rate):null,openInterestUsd:e.open_interest!=null?Number(e.open_interest):null,volume24hUsd:e.volume_24h!=null?Number(e.volume_24h):null,expired:e.expired_at?String(e.expired_at):""}))}});

package/clis/coingecko/exchanges.js

@@ -1,74 +1 @@
-// coingecko exchanges — top crypto exchanges by 24h BTC trading volume.
-//
-// Hits the public `/api/v3/exchanges` endpoint. Returns the columns most
-// useful for an agent: trust score, 24h BTC volume, country, year founded,
-// canonical URL.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-cli({
-    site: 'coingecko',
-    name: 'exchanges',
-    access: 'read',
-    description: 'Top crypto exchanges by 24h BTC trading volume',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of exchanges (1-250, CoinGecko per_page upper bound)' },
-        { name: 'page', type: 'int', default: 1, help: 'Page number (1-based)' },
-    ],
-    columns: ['rank', 'id', 'name', 'trustScore', 'volume24hBtc', 'country', 'yearEstablished', 'url'],
-    func: async (args) => {
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('coingecko limit must be a positive integer');
-        }
-        if (limit > 250) {
-            throw new ArgumentError('coingecko limit must be <= 250 (per_page upper bound)');
-        }
-        const page = Number(args.page ?? 1);
-        if (!Number.isInteger(page) || page <= 0) {
-            throw new ArgumentError('coingecko page must be a positive integer');
-        }
-        const url = new URL('https://api.coingecko.com/api/v3/exchanges');
-        url.searchParams.set('per_page', String(limit));
-        url.searchParams.set('page', String(page));
-        let resp;
-        try {
-            resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko exchanges request failed: ${err?.message ?? err}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError(
-                'coingecko returned HTTP 429 (rate limited)',
-                'Free tier allows ~30 calls/min. Wait and retry.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko exchanges returned HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko exchanges returned malformed JSON: ${err?.message ?? err}`);
-        }
-        if (!Array.isArray(data) || !data.length) {
-            throw new EmptyResultError('coingecko exchanges', 'CoinGecko returned no exchange data.');
-        }
-        return data.map((ex, i) => ({
-            rank: (page - 1) * limit + i + 1,
-            id: String(ex.id ?? ''),
-            name: String(ex.name ?? ''),
-            trustScore: ex.trust_score != null ? Number(ex.trust_score) : null,
-            volume24hBtc: ex.trade_volume_24h_btc != null ? Number(ex.trade_volume_24h_btc) : null,
-            country: String(ex.country ?? ''),
-            yearEstablished: ex.year_established != null ? Number(ex.year_established) : null,
-            url: String(ex.url ?? ''),
-        }));
-    },
-});
+import{cli as l,Strategy as g}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as o,EmptyResultError as m}from"@jackwener/opencli/errors";l({site:"coingecko",name:"exchanges",access:"read",description:"Top crypto exchanges by 24h BTC trading volume",domain:"api.coingecko.com",strategy:g.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of exchanges (1-250, CoinGecko per_page upper bound)"},{name:"page",type:"int",default:1,help:"Page number (1-based)"}],columns:["rank","id","name","trustScore","volume24hBtc","country","yearEstablished","url"],func:async(s)=>{const r=Number(s.limit??20);if(!Number.isInteger(r)||r<=0)throw new c("coingecko limit must be a positive integer");if(r>250)throw new c("coingecko limit must be <= 250 (per_page upper bound)");const n=Number(s.page??1);if(!Number.isInteger(n)||n<=0)throw new c("coingecko page must be a positive integer");const i=new URL("https://api.coingecko.com/api/v3/exchanges");i.searchParams.set("per_page",String(r));i.searchParams.set("page",String(n));let t;try{t=await fetch(i,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(e){throw new o(`coingecko exchanges request failed: ${e?.message??e}`)}if(t.status===429)throw new o("coingecko returned HTTP 429 (rate limited)","Free tier allows ~30 calls/min. Wait and retry.");if(!t.ok)throw new o(`coingecko exchanges returned HTTP ${t.status}`);let a;try{a=await t.json()}catch(e){throw new o(`coingecko exchanges returned malformed JSON: ${e?.message??e}`)}if(!Array.isArray(a)||!a.length)throw new m("coingecko exchanges","CoinGecko returned no exchange data.");return a.map((e,u)=>({rank:(n-1)*r+u+1,id:String(e.id??""),name:String(e.name??""),trustScore:e.trust_score!=null?Number(e.trust_score):null,volume24hBtc:e.trade_volume_24h_btc!=null?Number(e.trade_volume_24h_btc):null,country:String(e.country??""),yearEstablished:e.year_established!=null?Number(e.year_established):null,url:String(e.url??"")}))}});

package/clis/coingecko/global.js

@@ -1,71 +1 @@
-// coingecko global — total crypto market cap, volume, BTC/ETH dominance,
-// active currencies, ICO counts, in a single row.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
-
-cli({
-    site: 'coingecko',
-    name: 'global',
-    access: 'read',
-    description: 'Aggregate crypto market stats: total market cap, volume, dominance',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'currency', type: 'string', default: 'usd', help: 'Quote currency for total market cap / volume (usd, cny, eur, jpy, ...)' },
-    ],
-    columns: ['currency', 'totalMarketCap', 'totalVolume24h', 'marketCapChange24hPct', 'btcDominancePct', 'ethDominancePct', 'activeCryptocurrencies', 'markets', 'ongoingIcos', 'updatedAt'],
-    func: async (args) => {
-        const currency = String(args.currency ?? 'usd').trim().toLowerCase();
-        if (!/^[a-z0-9-]{2,20}$/.test(currency)) {
-            throw new ArgumentError(`coingecko currency must look like a currency slug (got "${args.currency}")`);
-        }
-        let resp;
-        try {
-            resp = await fetch('https://api.coingecko.com/api/v3/global', { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko global request failed: ${err?.message ?? err}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError(
-                'coingecko returned HTTP 429 (rate limited)',
-                'Free tier allows ~30 calls/min. Wait and retry.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko global returned HTTP ${resp.status}`);
-        }
-        let body;
-        try {
-            body = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`coingecko global returned malformed JSON: ${err?.message ?? err}`);
-        }
-        const data = body?.data;
-        if (!data) {
-            throw new CommandExecutionError('coingecko global returned no data envelope');
-        }
-        const totalMarketCap = data?.total_market_cap?.[currency];
-        const totalVolume = data?.total_volume?.[currency];
-        if (totalMarketCap == null && totalVolume == null) {
-            throw new ArgumentError(
-                `coingecko has no market totals for currency "${currency}"`,
-                'Use a CoinGecko-supported quote currency such as usd, cny, eur, or jpy.',
-            );
-        }
-        return [{
-            currency: currency.toUpperCase(),
-            totalMarketCap: totalMarketCap != null ? Number(totalMarketCap) : null,
-            totalVolume24h: totalVolume != null ? Number(totalVolume) : null,
-            marketCapChange24hPct: data.market_cap_change_percentage_24h_usd != null ? Number(data.market_cap_change_percentage_24h_usd) : null,
-            btcDominancePct: data?.market_cap_percentage?.btc != null ? Number(data.market_cap_percentage.btc) : null,
-            ethDominancePct: data?.market_cap_percentage?.eth != null ? Number(data.market_cap_percentage.eth) : null,
-            activeCryptocurrencies: data.active_cryptocurrencies != null ? Number(data.active_cryptocurrencies) : null,
-            markets: data.markets != null ? Number(data.markets) : null,
-            ongoingIcos: data.ongoing_icos != null ? Number(data.ongoing_icos) : null,
-            updatedAt: data.updated_at ? new Date(data.updated_at * 1000).toISOString() : '',
-        }];
-    },
-});
+import{cli as s,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as i,CommandExecutionError as c}from"@jackwener/opencli/errors";s({site:"coingecko",name:"global",access:"read",description:"Aggregate crypto market stats: total market cap, volume, dominance",domain:"api.coingecko.com",strategy:m.PUBLIC,browser:!1,args:[{name:"currency",type:"string",default:"usd",help:"Quote currency for total market cap / volume (usd, cny, eur, jpy, ...)"}],columns:["currency","totalMarketCap","totalVolume24h","marketCapChange24hPct","btcDominancePct","ethDominancePct","activeCryptocurrencies","markets","ongoingIcos","updatedAt"],func:async(l)=>{const t=String(l.currency??"usd").trim().toLowerCase();if(!/^[a-z0-9-]{2,20}$/.test(t))throw new i(`coingecko currency must look like a currency slug (got "${l.currency}")`);let r;try{r=await fetch("https://api.coingecko.com/api/v3/global",{headers:{"User-Agent":"Mozilla/5.0"}})}catch(a){throw new c(`coingecko global request failed: ${a?.message??a}`)}if(r.status===429)throw new c("coingecko returned HTTP 429 (rate limited)","Free tier allows ~30 calls/min. Wait and retry.");if(!r.ok)throw new c(`coingecko global returned HTTP ${r.status}`);let u;try{u=await r.json()}catch(a){throw new c(`coingecko global returned malformed JSON: ${a?.message??a}`)}const e=u?.data;if(!e)throw new c("coingecko global returned no data envelope");const o=e?.total_market_cap?.[t],n=e?.total_volume?.[t];if(o==null&&n==null)throw new i(`coingecko has no market totals for currency "${t}"`,"Use a CoinGecko-supported quote currency such as usd, cny, eur, or jpy.");return[{currency:t.toUpperCase(),totalMarketCap:o!=null?Number(o):null,totalVolume24h:n!=null?Number(n):null,marketCapChange24hPct:e.market_cap_change_percentage_24h_usd!=null?Number(e.market_cap_change_percentage_24h_usd):null,btcDominancePct:e?.market_cap_percentage?.btc!=null?Number(e.market_cap_percentage.btc):null,ethDominancePct:e?.market_cap_percentage?.eth!=null?Number(e.market_cap_percentage.eth):null,activeCryptocurrencies:e.active_cryptocurrencies!=null?Number(e.active_cryptocurrencies):null,markets:e.markets!=null?Number(e.markets):null,ongoingIcos:e.ongoing_icos!=null?Number(e.ongoing_icos):null,updatedAt:e.updated_at?new Date(e.updated_at*1000).toISOString():""}]}});

package/clis/coingecko/top.js

@@ -1,64 +1 @@
-// coingecko top — top coins by market cap.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-cli({
-  site: 'coingecko',
-  name: 'top',
-  access: 'read',
-  description: '按市值排序的加密货币行情（默认 USD）',
-  domain: 'api.coingecko.com',
-  strategy: Strategy.PUBLIC,
-  browser: false,
-  args: [
-    { name: 'currency', type: 'string', default: 'usd', help: '计价币种 (usd / cny / eur / jpy ...)' },
-    { name: 'limit',    type: 'int',    default: 10,    help: '返回数量（默认 10，最多 250）' },
-  ],
-  columns: ['rank', 'symbol', 'name', 'price', 'change24hPct', 'marketCap', 'volume24h', 'high24h', 'low24h'],
-  func: async (args) => {
-    const currency = String(args.currency ?? 'usd').toLowerCase();
-    const limit = Number(args.limit ?? 10);
-    if (!Number.isInteger(limit) || limit <= 0) {
-      throw new ArgumentError('limit must be a positive integer');
-    }
-    if (limit > 250) {
-      throw new ArgumentError('limit must be <= 250 (CoinGecko per_page upper bound)');
-    }
-
-    const url = new URL('https://api.coingecko.com/api/v3/coins/markets');
-    url.searchParams.set('vs_currency', currency);
-    url.searchParams.set('order', 'market_cap_desc');
-    url.searchParams.set('per_page', String(limit));
-    url.searchParams.set('page', '1');
-    url.searchParams.set('sparkline', 'false');
-
-    let resp;
-    try {
-      resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-    } catch (error) {
-      throw new CommandExecutionError(`coingecko top request failed: ${error?.message || error}`);
-    }
-    if (!resp.ok) throw new CommandExecutionError(`coingecko top failed: HTTP ${resp.status}`);
-    let data;
-    try {
-      data = await resp.json();
-    } catch (error) {
-      throw new CommandExecutionError(`coingecko returned malformed JSON: ${error?.message || error}`);
-    }
-    if (data?.error) throw new CommandExecutionError(`coingecko returned error: ${data.error}`);
-    if (!Array.isArray(data)) throw new CommandExecutionError('coingecko returned an unexpected response');
-    if (data.length === 0) throw new EmptyResultError('coingecko top', 'coingecko returned no market data');
-
-    return data.map((c) => ({
-      rank: c.market_cap_rank,
-      symbol: String(c.symbol ?? '').toUpperCase(),
-      name: c.name,
-      price: c.current_price,
-      change24hPct: c.price_change_percentage_24h,
-      marketCap: c.market_cap,
-      volume24h: c.total_volume,
-      high24h: c.high_24h,
-      low24h: c.low_24h,
-    }));
-  },
-});
+import{cli as m,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as i,CommandExecutionError as a,EmptyResultError as h}from"@jackwener/opencli/errors";m({site:"coingecko",name:"top",access:"read",description:"按市值排序的加密货币行情（默认 USD）",domain:"api.coingecko.com",strategy:p.PUBLIC,browser:!1,args:[{name:"currency",type:"string",default:"usd",help:"计价币种 (usd / cny / eur / jpy ...)"},{name:"limit",type:"int",default:10,help:"返回数量（默认 10，最多 250）"}],columns:["rank","symbol","name","price","change24hPct","marketCap","volume24h","high24h","low24h"],func:async(c)=>{const s=String(c.currency??"usd").toLowerCase(),o=Number(c.limit??10);if(!Number.isInteger(o)||o<=0)throw new i("limit must be a positive integer");if(o>250)throw new i("limit must be <= 250 (CoinGecko per_page upper bound)");const r=new URL("https://api.coingecko.com/api/v3/coins/markets");r.searchParams.set("vs_currency",s);r.searchParams.set("order","market_cap_desc");r.searchParams.set("per_page",String(o));r.searchParams.set("page","1");r.searchParams.set("sparkline","false");let n;try{n=await fetch(r,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(e){throw new a(`coingecko top request failed: ${e?.message||e}`)}if(!n.ok)throw new a(`coingecko top failed: HTTP ${n.status}`);let t;try{t=await n.json()}catch(e){throw new a(`coingecko returned malformed JSON: ${e?.message||e}`)}if(t?.error)throw new a(`coingecko returned error: ${t.error}`);if(!Array.isArray(t))throw new a("coingecko returned an unexpected response");if(t.length===0)throw new h("coingecko top","coingecko returned no market data");return t.map((e)=>({rank:e.market_cap_rank,symbol:String(e.symbol??"").toUpperCase(),name:e.name,price:e.current_price,change24hPct:e.price_change_percentage_24h,marketCap:e.market_cap,volume24h:e.total_volume,high24h:e.high_24h,low24h:e.low_24h}))}});

package/clis/coingecko/trending.js

@@ -1,55 +1 @@
-// coingecko trending — top trending coins on CoinGecko (by user search activity).
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-cli({
-    site: 'coingecko',
-    name: 'trending',
-    access: 'read',
-    description: 'Top trending cryptocurrencies on CoinGecko in the last 24h (search-volume based).',
-    domain: 'api.coingecko.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [],
-    columns: ['rank', 'id', 'symbol', 'name', 'marketCapRank', 'priceBtc', 'thumb'],
-    func: async () => {
-        const url = 'https://api.coingecko.com/api/v3/search/trending';
-        let resp;
-        try {
-            resp = await fetch(url, { headers: { 'User-Agent': 'Mozilla/5.0' } });
-        } catch (error) {
-            throw new CommandExecutionError(`coingecko trending request failed: ${error?.message || error}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError('coingecko returned HTTP 429 (rate limited)', 'Wait and retry.');
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`coingecko trending failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        } catch (error) {
-            throw new CommandExecutionError(`coingecko returned malformed JSON: ${error?.message || error}`);
-        }
-        const coins = Array.isArray(data?.coins) ? data.coins : [];
-        if (coins.length === 0) {
-            throw new EmptyResultError('coingecko trending', 'coingecko returned no trending coins.');
-        }
-        return coins.map((entry, i) => {
-            const c = entry?.item || {};
-            return {
-                rank: i + 1,
-                id: c.id || '',
-                symbol: String(c.symbol || '').toUpperCase(),
-                name: c.name || '',
-                marketCapRank: c.market_cap_rank ?? null,
-                priceBtc: c.price_btc ?? null,
-                thumb: c.thumb || c.small || c.large || '',
-            };
-        });
-    },
-});
+import{cli as s,Strategy as m}from"@jackwener/opencli/registry";import{CommandExecutionError as t,EmptyResultError as g}from"@jackwener/opencli/errors";s({site:"coingecko",name:"trending",access:"read",description:"Top trending cryptocurrencies on CoinGecko in the last 24h (search-volume based).",domain:"api.coingecko.com",strategy:m.PUBLIC,browser:!1,args:[],columns:["rank","id","symbol","name","marketCapRank","priceBtc","thumb"],func:async()=>{const c="https://api.coingecko.com/api/v3/search/trending";let n;try{n=await fetch(c,{headers:{"User-Agent":"Mozilla/5.0"}})}catch(r){throw new t(`coingecko trending request failed: ${r?.message||r}`)}if(n.status===429)throw new t("coingecko returned HTTP 429 (rate limited)","Wait and retry.");if(!n.ok)throw new t(`coingecko trending failed: HTTP ${n.status}`);let o;try{o=await n.json()}catch(r){throw new t(`coingecko returned malformed JSON: ${r?.message||r}`)}const i=Array.isArray(o?.coins)?o.coins:[];if(i.length===0)throw new g("coingecko trending","coingecko returned no trending coins.");return i.map((r,a)=>{const e=r?.item||{};return{rank:a+1,id:e.id||"",symbol:String(e.symbol||"").toUpperCase(),name:e.name||"",marketCapRank:e.market_cap_rank??null,priceBtc:e.price_btc??null,thumb:e.thumb||e.small||e.large||""}})}});

package/clis/confluence/create.js

@@ -1,39 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { requireExecute, requirePayloadObject, requireString } from '../_atlassian/shared.js';
-import { confluenceConfig, createPagePayload, normalizeConfluencePage, readPageBodyFile } from './shared.js';
-import { atlassianRequest } from '../_atlassian/shared.js';
-
-cli({
-    site: 'confluence',
-    name: 'create',
-    access: 'write',
-    description: 'Create a Confluence page from Markdown or storage XHTML',
-    domain: 'atlassian.net',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'space', type: 'string', required: true, help: 'Cloud space id, or Data Center space key' },
-        { name: 'title', type: 'string', required: true, help: 'Page title' },
-        { name: 'file', type: 'string', required: true, help: 'Markdown file path' },
-        { name: 'parent', type: 'string', help: 'Optional parent page id' },
-        { name: 'representation', type: 'string', default: 'markdown', choices: ['markdown', 'storage'], help: 'Input file format' },
-        { name: 'execute', type: 'boolean', help: 'Actually create the remote page' },
-    ],
-    columns: ['status', 'id', 'title', 'spaceId', 'spaceKey', 'version', 'url'],
-    func: async (args) => {
-        requireExecute(args, 'confluence create');
-        requireString(args.space, 'Confluence space');
-        requireString(args.title, 'Confluence page title');
-        const storage = await readPageBodyFile(args);
-        const config = confluenceConfig();
-        const payload = createPagePayload(config, args, storage);
-        const path = config.deployment === 'cloud' ? '/api/v2/pages' : '/rest/api/content';
-        const page = requirePayloadObject(await atlassianRequest(config, path, {
-            method: 'POST',
-            body: payload,
-            label: 'confluence create',
-        }), 'confluence create');
-        const normalized = normalizeConfluencePage(page, config);
-        return [{ ...normalized, pageStatus: normalized.status, status: 'created' }];
-    },
-});
+import{cli as l,Strategy as s}from"@jackwener/opencli/registry";import{requireExecute as p,requirePayloadObject as u,requireString as n}from"../_atlassian/shared.js";import{confluenceConfig as d,createPagePayload as m,normalizeConfluencePage as f,readPageBodyFile as g}from"./shared.js";import{atlassianRequest as y}from"../_atlassian/shared.js";l({site:"confluence",name:"create",access:"write",description:"Create a Confluence page from Markdown or storage XHTML",domain:"atlassian.net",strategy:s.PUBLIC,browser:!1,args:[{name:"space",type:"string",required:!0,help:"Cloud space id, or Data Center space key"},{name:"title",type:"string",required:!0,help:"Page title"},{name:"file",type:"string",required:!0,help:"Markdown file path"},{name:"parent",type:"string",help:"Optional parent page id"},{name:"representation",type:"string",default:"markdown",choices:["markdown","storage"],help:"Input file format"},{name:"execute",type:"boolean",help:"Actually create the remote page"}],columns:["status","id","title","spaceId","spaceKey","version","url"],func:async(e)=>{p(e,"confluence create");n(e.space,"Confluence space");n(e.title,"Confluence page title");const r=await g(e),t=d(),o=m(t,e,r),c=t.deployment==="cloud"?"/api/v2/pages":"/rest/api/content",i=u(await y(t,c,{method:"POST",body:o,label:"confluence create"}),"confluence create"),a=f(i,t);return[{...a,pageStatus:a.status,status:"created"}]}});

package/clis/confluence/page.js

@@ -1,23 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { requireString } from '../_atlassian/shared.js';
-import { confluenceConfig, getPage, normalizeConfluencePage } from './shared.js';
-
-cli({
-    site: 'confluence',
-    name: 'page',
-    access: 'read',
-    description: 'Confluence page by id with storage and Markdown body',
-    domain: 'atlassian.net',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'Confluence page id' },
-    ],
-    columns: ['id', 'title', 'status', 'spaceId', 'spaceKey', 'version', 'url'],
-    func: async (args) => {
-        const config = confluenceConfig();
-        const id = requireString(args.id, 'Confluence page id');
-        const page = await getPage(config, id);
-        return [normalizeConfluencePage(page, config)];
-    },
-});
+import{cli as o,Strategy as r}from"@jackwener/opencli/registry";import{requireString as t}from"../_atlassian/shared.js";import{confluenceConfig as s,getPage as c,normalizeConfluencePage as d}from"./shared.js";o({site:"confluence",name:"page",access:"read",description:"Confluence page by id with storage and Markdown body",domain:"atlassian.net",strategy:r.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Confluence page id"}],columns:["id","title","status","spaceId","spaceKey","version","url"],func:async(n)=>{const e=s(),a=t(n.id,"Confluence page id"),i=await c(e,a);return[d(i,e)]}});