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

package/clis/defillama/protocol.js

@@ -1,84 +1 @@
-// defillama protocol — single DeFi protocol details by slug.
-//
-// Hits `https://api.llama.fi/protocol/<slug>`. The endpoint returns a rich
-// object that includes a `tvl` time-series array; we project the latest entry
-// as the current TVL plus identifying metadata (category from /protocols since
-// the per-protocol endpoint omits it).
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { LLAMA_BASE, llamaFetch, requireSlug, unixToDate } from './utils.js';
-
-cli({
-    site: 'defillama',
-    name: 'protocol',
-    access: 'read',
-    description: 'Single DefiLlama protocol details (current TVL, mcap, chains, twitter, github, description)',
-    domain: 'defillama.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'slug', positional: true, type: 'string', required: true, help: 'DefiLlama protocol slug (e.g. "aave", "lido")' },
-    ],
-    columns: [
-        'slug', 'name', 'category', 'isParent', 'tvl', 'tvlAt', 'mcap',
-        'chains', 'twitter', 'github', 'audits', 'listedAt',
-        'description', 'website', 'url',
-    ],
-    func: async (args) => {
-        const slug = requireSlug(args.slug, 'slug');
-        // Per-protocol detail endpoint
-        const detail = await llamaFetch(`${LLAMA_BASE}/protocol/${encodeURIComponent(slug)}`, `defillama protocol ${slug}`);
-        if (!detail || !detail.name) {
-            throw new EmptyResultError('defillama protocol', `DefiLlama returned no metadata for "${slug}".`);
-        }
-        // Latest TVL from the time-series array (per-protocol endpoint omits a scalar tvl).
-        const tvlSeries = Array.isArray(detail.tvl) ? detail.tvl : [];
-        const lastPoint = tvlSeries.length ? tvlSeries[tvlSeries.length - 1] : null;
-        const tvl = lastPoint && Number.isFinite(Number(lastPoint.totalLiquidityUSD))
-            ? Number(lastPoint.totalLiquidityUSD)
-            : null;
-        const tvlAt = lastPoint ? unixToDate(lastPoint.date) : null;
-        // /protocols carries category + chains. Parent protocols (isParentProtocol=true)
-        // do NOT appear in /protocols themselves — only their children do — so we union
-        // child chains and leave category empty for parents.
-        const isParent = detail.isParentProtocol === true;
-        let category = '';
-        const chainsSet = new Set(Array.isArray(detail.chains) ? detail.chains : []);
-        const list = await llamaFetch(`${LLAMA_BASE}/protocols`, `defillama protocol ${slug} list lookup`);
-        if (Array.isArray(list)) {
-            if (!isParent) {
-                const match = list.find((p) => p && p.slug === slug);
-                if (match && typeof match.category === 'string') category = match.category;
-                if (match && Array.isArray(match.chains)) {
-                    for (const c of match.chains) chainsSet.add(c);
-                }
-            }
-            else {
-                // Aggregate chains across child protocols of this parent.
-                for (const p of list) {
-                    if (p && p.parentProtocol === detail.id && Array.isArray(p.chains)) {
-                        for (const c of p.chains) chainsSet.add(c);
-                    }
-                }
-            }
-        }
-        const githubArr = Array.isArray(detail.github) ? detail.github : [];
-        return [{
-            slug,
-            name: String(detail.name).trim(),
-            category,
-            isParent,
-            tvl,
-            tvlAt,
-            mcap: detail.mcap == null ? null : Number(detail.mcap),
-            chains: [...chainsSet].join(', '),
-            twitter: String(detail.twitter ?? '').trim(),
-            github: githubArr.join(', '),
-            audits: String(detail.audits ?? '').trim(),
-            listedAt: unixToDate(detail.listedAt),
-            description: String(detail.description ?? '').trim(),
-            website: String(detail.url ?? '').trim(),
-            url: `https://defillama.com/protocol/${slug}`,
-        }];
-    },
-});
+import{cli as b,Strategy as f}from"@jackwener/opencli/registry";import{EmptyResultError as q}from"@jackwener/opencli/errors";import{LLAMA_BASE as U,llamaFetch as V,requireSlug as R,unixToDate as W}from"./utils.js";b({site:"defillama",name:"protocol",access:"read",description:"Single DefiLlama protocol details (current TVL, mcap, chains, twitter, github, description)",domain:"defillama.com",strategy:f.PUBLIC,browser:!1,args:[{name:"slug",positional:!0,type:"string",required:!0,help:'DefiLlama protocol slug (e.g. "aave", "lido")'}],columns:["slug","name","category","isParent","tvl","tvlAt","mcap","chains","twitter","github","audits","listedAt","description","website","url"],func:async(X)=>{const G=R(X.slug,"slug"),z=await V(`${U}/protocol/${encodeURIComponent(G)}`,`defillama protocol ${G}`);if(!z||!z.name)throw new q("defillama protocol",`DefiLlama returned no metadata for "${G}".`);const J=Array.isArray(z.tvl)?z.tvl:[],I=J.length?J[J.length-1]:null,Y=I&&Number.isFinite(Number(I.totalLiquidityUSD))?Number(I.totalLiquidityUSD):null,Z=I?W(I.date):null,O=z.isParentProtocol===!0;let Q="";const K=new Set(Array.isArray(z.chains)?z.chains:[]),N=await V(`${U}/protocols`,`defillama protocol ${G} list lookup`);if(Array.isArray(N)){if(!O){const C=N.find((H)=>H&&H.slug===G);if(C&&typeof C.category==="string")Q=C.category;if(C&&Array.isArray(C.chains))for(const H of C.chains)K.add(H)}else for(const C of N)if(C&&C.parentProtocol===z.id&&Array.isArray(C.chains))for(const H of C.chains)K.add(H)}const $=Array.isArray(z.github)?z.github:[];return[{slug:G,name:String(z.name).trim(),category:Q,isParent:O,tvl:Y,tvlAt:Z,mcap:z.mcap==null?null:Number(z.mcap),chains:[...K].join(", "),twitter:String(z.twitter??"").trim(),github:$.join(", "),audits:String(z.audits??"").trim(),listedAt:W(z.listedAt),description:String(z.description??"").trim(),website:String(z.url??"").trim(),url:`https://defillama.com/protocol/${G}`}]}});

package/clis/defillama/protocols.js

@@ -1,55 +1 @@
-// defillama protocols — top DeFi protocols by current TVL.
-//
-// Hits `https://api.llama.fi/protocols`, sorts by TVL (desc), and returns the
-// requested top-N. The API ships ~7400 entries today; we cap output at 500
-// rows so agents do not paginate their entire DeFi universe by accident.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { LLAMA_BASE, llamaFetch, requireBoundedInt, unixToDate } from './utils.js';
-
-cli({
-    site: 'defillama',
-    name: 'protocols',
-    access: 'read',
-    description: 'Top DeFi protocols on DefiLlama by current TVL (slug, name, category, TVL, mcap, change_1d/7d, chains)',
-    domain: 'defillama.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 30, help: 'Number of rows to return (1-500)' },
-    ],
-    columns: [
-        'rank', 'slug', 'name', 'category', 'tvl', 'mcap',
-        'change_1d', 'change_7d', 'chains', 'listedAt', 'url',
-    ],
-    func: async (args) => {
-        const limit = requireBoundedInt(args.limit, 30, 500, 'limit');
-        const list = await llamaFetch(`${LLAMA_BASE}/protocols`, 'defillama protocols');
-        if (!Array.isArray(list) || list.length === 0) {
-            throw new EmptyResultError('defillama protocols', 'DefiLlama returned no protocol entries.');
-        }
-        const ranked = list
-            .filter((p) => p && (p.slug || p.name) && Number.isFinite(Number(p.tvl)))
-            .sort((a, b) => Number(b.tvl) - Number(a.tvl))
-            .slice(0, limit);
-        if (ranked.length === 0) {
-            throw new EmptyResultError('defillama protocols', 'DefiLlama returned no protocols with numeric TVL.');
-        }
-        return ranked.map((p, i) => {
-            const slug = String(p.slug ?? '').trim();
-            return {
-                rank: i + 1,
-                slug,
-                name: String(p.name ?? '').trim(),
-                category: String(p.category ?? '').trim(),
-                tvl: Number(p.tvl),
-                mcap: p.mcap == null ? null : Number(p.mcap),
-                change_1d: p.change_1d == null ? null : Number(p.change_1d),
-                change_7d: p.change_7d == null ? null : Number(p.change_7d),
-                chains: Array.isArray(p.chains) ? p.chains.join(', ') : '',
-                listedAt: unixToDate(p.listedAt),
-                url: slug ? `https://defillama.com/protocol/${slug}` : '',
-            };
-        });
-    },
-});
+import{cli as s,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{LLAMA_BASE as m,llamaFetch as u,requireBoundedInt as d,unixToDate as g}from"./utils.js";s({site:"defillama",name:"protocols",access:"read",description:"Top DeFi protocols on DefiLlama by current TVL (slug, name, category, TVL, mcap, change_1d/7d, chains)",domain:"defillama.com",strategy:c.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:30,help:"Number of rows to return (1-500)"}],columns:["rank","slug","name","category","tvl","mcap","change_1d","change_7d","chains","listedAt","url"],func:async(n)=>{const i=d(n.limit,30,500,"limit"),t=await u(`${m}/protocols`,"defillama protocols");if(!Array.isArray(t)||t.length===0)throw new l("defillama protocols","DefiLlama returned no protocol entries.");const o=t.filter((e)=>e&&(e.slug||e.name)&&Number.isFinite(Number(e.tvl))).sort((e,r)=>Number(r.tvl)-Number(e.tvl)).slice(0,i);if(o.length===0)throw new l("defillama protocols","DefiLlama returned no protocols with numeric TVL.");return o.map((e,r)=>{const a=String(e.slug??"").trim();return{rank:r+1,slug:a,name:String(e.name??"").trim(),category:String(e.category??"").trim(),tvl:Number(e.tvl),mcap:e.mcap==null?null:Number(e.mcap),change_1d:e.change_1d==null?null:Number(e.change_1d),change_7d:e.change_7d==null?null:Number(e.change_7d),chains:Array.isArray(e.chains)?e.chains.join(", "):"",listedAt:g(e.listedAt),url:a?`https://defillama.com/protocol/${a}`:""}})}});

package/clis/defillama/utils.js

@@ -1,99 +1 @@
-// Shared helpers for the DefiLlama adapters.
-//
-// DefiLlama serves a public REST API (no auth) over https://api.llama.fi.
-// Docs: https://defillama.com/docs/api
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-export const LLAMA_BASE = 'https://api.llama.fi';
-const UA = 'opencli-defillama-adapter (+https://github.com/jackwener/opencli)';
-
-// DefiLlama slugs are lowercase with hyphens / digits / dots; allow up to 100 chars.
-const SLUG = /^[a-z0-9][a-z0-9._-]{0,99}$/;
-
-export function requireString(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError(`defillama ${label} cannot be empty`);
-    return s;
-}
-
-export function requireSlug(value, label = 'slug') {
-    const s = String(value ?? '').trim();
-    if (!s) {
-        throw new ArgumentError(
-            `defillama ${label} is required (e.g. "aave", "lido")`,
-            'Use the protocol slug as it appears on https://defillama.com/protocol/<slug>.',
-        );
-    }
-    if (!SLUG.test(s)) {
-        throw new ArgumentError(
-            `defillama ${label} "${value}" is not a valid DefiLlama slug`,
-            'Slugs are lowercase ASCII (letters / digits / "._-"), e.g. "aave", "lido", "pancakeswap-amm".',
-        );
-    }
-    return s;
-}
-
-export function requireBoundedInt(value, defaultValue, maxValue, label = 'limit') {
-    const raw = value ?? defaultValue;
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`defillama ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`defillama ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-export async function llamaFetch(url, label) {
-    let resp;
-    try {
-        resp = await fetch(url, { headers: { 'user-agent': UA, accept: 'application/json' } });
-    }
-    catch (err) {
-        throw new CommandExecutionError(
-            `${label} request failed: ${err?.message ?? err}`,
-            'Check that api.llama.fi is reachable from this network.',
-        );
-    }
-    if (resp.status === 404) {
-        throw new EmptyResultError(label, `DefiLlama returned 404 for ${url}.`);
-    }
-    if (resp.status === 400) {
-        // DefiLlama returns 400 + plain-text "Protocol not found" for unknown slugs.
-        const body = await resp.text().catch(() => '');
-        if (/not\s*found/i.test(body)) {
-            throw new EmptyResultError(label, `DefiLlama: ${body.trim() || 'not found'}.`);
-        }
-        throw new CommandExecutionError(`${label} returned HTTP 400: ${body.slice(0, 200)}`);
-    }
-    if (resp.status === 429) {
-        throw new CommandExecutionError(
-            `${label} returned HTTP 429 (rate limited)`,
-            'DefiLlama throttles unauthenticated traffic; wait a few seconds and retry.',
-        );
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`${label} returned HTTP ${resp.status}`);
-    }
-    let body;
-    try {
-        body = await resp.json();
-    }
-    catch (err) {
-        throw new CommandExecutionError(`${label} returned malformed JSON: ${err?.message ?? err}`);
-    }
-    return body;
-}
-
-// Convert a unix-seconds timestamp (DefiLlama's listedAt convention) to YYYY-MM-DD,
-// or null when the value is missing / not a finite number.
-export function unixToDate(value) {
-    if (value == null) return null;
-    const n = typeof value === 'number' ? value : Number(value);
-    if (!Number.isFinite(n) || n <= 0) return null;
-    const ms = n > 1e12 ? n : n * 1000;
-    const d = new Date(ms);
-    if (Number.isNaN(d.getTime())) return null;
-    return d.toISOString().slice(0, 10);
-}
+import{ArgumentError as H,CommandExecutionError as I,EmptyResultError as K}from"@jackwener/opencli/errors";export const LLAMA_BASE="https://api.llama.fi";const M="opencli-defillama-adapter (+https://github.com/jackwener/opencli)",N=/^[a-z0-9][a-z0-9._-]{0,99}$/;export function requireString(B,q){const z=String(B??"").trim();if(!z)throw new H(`defillama ${q} cannot be empty`);return z}export function requireSlug(B,q="slug"){const z=String(B??"").trim();if(!z)throw new H(`defillama ${q} is required (e.g. "aave", "lido")`,"Use the protocol slug as it appears on https://defillama.com/protocol/<slug>.");if(!N.test(z))throw new H(`defillama ${q} "${B}" is not a valid DefiLlama slug`,'Slugs are lowercase ASCII (letters / digits / "._-"), e.g. "aave", "lido", "pancakeswap-amm".');return z}export function requireBoundedInt(B,q,z,F="limit"){const D=B??q,J=typeof D==="number"?D:Number(D);if(!Number.isInteger(J)||J<=0)throw new H(`defillama ${F} must be a positive integer`);if(J>z)throw new H(`defillama ${F} must be <= ${z}`);return J}export async function llamaFetch(B,q){let z;try{z=await fetch(B,{headers:{"user-agent":M,accept:"application/json"}})}catch(D){throw new I(`${q} request failed: ${D?.message??D}`,"Check that api.llama.fi is reachable from this network.")}if(z.status===404)throw new K(q,`DefiLlama returned 404 for ${B}.`);if(z.status===400){const D=await z.text().catch(()=>"");if(/not\s*found/i.test(D))throw new K(q,`DefiLlama: ${D.trim()||"not found"}.`);throw new I(`${q} returned HTTP 400: ${D.slice(0,200)}`)}if(z.status===429)throw new I(`${q} returned HTTP 429 (rate limited)`,"DefiLlama throttles unauthenticated traffic; wait a few seconds and retry.");if(!z.ok)throw new I(`${q} returned HTTP ${z.status}`);let F;try{F=await z.json()}catch(D){throw new I(`${q} returned malformed JSON: ${D?.message??D}`)}return F}export function unixToDate(B){if(B==null)return null;const q=typeof B==="number"?B:Number(B);if(!Number.isFinite(q)||q<=0)return null;const z=q>1000000000000?q:q*1000,F=new Date(z);if(Number.isNaN(F.getTime()))return null;return F.toISOString().slice(0,10)}

package/clis/devto/auth.js

@@ -0,0 +1,9 @@
+import{AuthRequiredError as B}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as J}from"../_shared/site-auth.js";const F="https://dev.to";async function G(x){return(await x.getCookies({url:F})).some((z)=>z.name==="remember_user_token"&&z.value)}async function I(x){await x.goto(F);const f=await x.evaluate(`(() => {
+    try {
+      var du = document.body && document.body.getAttribute('data-user');
+      if (!du) return { ok: false, reason: 'no data-user' };
+      var u = JSON.parse(du);
+      if (!u || u.id == null) return { ok: false, reason: 'anonymous' };
+      return { ok: true, id: String(u.id), username: String(u.username || ''), name: String(u.name || '') };
+    } catch (e) { return { ok: false, reason: String(e && e.message || e) }; }
+  })()`);if(!f||!f.ok)throw new B("dev.to",`Not logged in (${f?f.reason:"no probe"})`);return{user_id:f.id,username:f.username,name:f.name}}J({site:"devto",domain:"dev.to",loginUrl:"https://dev.to/enter",columns:["user_id","username","name"],loginDescription:"打开 dev.to 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:G,verify:I,poll:async(x)=>{if(!await G(x))throw new B("dev.to","Waiting for dev.to session cookie");return I(x)}});

package/clis/devto/latest.js

@@ -1,74 +1 @@
-// devto latest — newest dev.to articles, regardless of tag.
-//
-// Hits the public `/api/articles/latest` endpoint. Complements the existing
-// `devto top` (most-reactioned) and `devto tag` (filtered) commands by
-// surfacing the firehose of brand-new posts.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-function requireBoundedInt(value, defaultValue, maxValue) {
-    const raw = value ?? defaultValue;
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError('devto limit must be a positive integer');
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`devto limit must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-cli({
-    site: 'devto',
-    name: 'latest',
-    access: 'read',
-    description: 'Newest dev.to articles (firehose, all tags)',
-    domain: 'dev.to',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Articles per page (1-100)' },
-        { name: 'page', type: 'int', default: 1, help: 'Page number (1-based)' },
-    ],
-    columns: ['rank', 'id', 'title', 'author', 'tags', 'reactions', 'comments', 'published', 'url'],
-    func: async (args) => {
-        const limit = requireBoundedInt(args.limit, 20, 100);
-        const page = requireBoundedInt(args.page, 1, 1000);
-        const url = `https://dev.to/api/articles/latest?per_page=${limit}&page=${page}`;
-        let resp;
-        try {
-            resp = await fetch(url, { headers: { accept: 'application/json' } });
-        }
-        catch (err) {
-            throw new CommandExecutionError(
-                `devto latest request failed: ${err?.message ?? err}`,
-                'Check that dev.to is reachable from this network.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`devto latest returned HTTP ${resp.status}`);
-        }
-        let body;
-        try {
-            body = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`devto latest returned malformed JSON: ${err?.message ?? err}`);
-        }
-        const list = Array.isArray(body) ? body : [];
-        if (!list.length) {
-            throw new EmptyResultError('devto latest', `dev.to /articles/latest returned no items at page ${page}.`);
-        }
-        return list.map((item, i) => ({
-            rank: (page - 1) * limit + i + 1,
-            id: item.id != null ? String(item.id) : '',
-            title: String(item.title ?? ''),
-            author: String(item?.user?.username ?? ''),
-            tags: String(item.tag_list ?? '').replace(/,\s*/g, ', '),
-            reactions: item.public_reactions_count != null ? Number(item.public_reactions_count) : null,
-            comments: item.comments_count != null ? Number(item.comments_count) : null,
-            published: String(item.published_at ?? '').slice(0, 10),
-            url: String(item.url ?? ''),
-        }));
-    },
-});
+import{cli as p,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as i,EmptyResultError as g}from"@jackwener/opencli/errors";function u(a,n,r){const s=a??n,e=typeof s==="number"?s:Number(s);if(!Number.isInteger(e)||e<=0)throw new c("devto limit must be a positive integer");if(e>r)throw new c(`devto limit must be <= ${r}`);return e}p({site:"devto",name:"latest",access:"read",description:"Newest dev.to articles (firehose, all tags)",domain:"dev.to",strategy:m.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Articles per page (1-100)"},{name:"page",type:"int",default:1,help:"Page number (1-based)"}],columns:["rank","id","title","author","tags","reactions","comments","published","url"],func:async(a)=>{const n=u(a.limit,20,100),r=u(a.page,1,1000),s=`https://dev.to/api/articles/latest?per_page=${n}&page=${r}`;let e;try{e=await fetch(s,{headers:{accept:"application/json"}})}catch(t){throw new i(`devto latest request failed: ${t?.message??t}`,"Check that dev.to is reachable from this network.")}if(!e.ok)throw new i(`devto latest returned HTTP ${e.status}`);let o;try{o=await e.json()}catch(t){throw new i(`devto latest returned malformed JSON: ${t?.message??t}`)}const l=Array.isArray(o)?o:[];if(!l.length)throw new g("devto latest",`dev.to /articles/latest returned no items at page ${r}.`);return l.map((t,d)=>({rank:(r-1)*n+d+1,id:t.id!=null?String(t.id):"",title:String(t.title??""),author:String(t?.user?.username??""),tags:String(t.tag_list??"").replace(/,\s*/g,", "),reactions:t.public_reactions_count!=null?Number(t.public_reactions_count):null,comments:t.comments_count!=null?Number(t.comments_count):null,published:String(t.published_at??"").slice(0,10),url:String(t.url??"")}))}});

package/clis/devto/publish.js

@@ -0,0 +1,17 @@
+import*as V from"node:fs";import{cli as q,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as U,CommandExecutionError as O}from"@jackwener/opencli/errors";import{assertLiteralContent as v}from"../_shared/content-guard.js";const W=4;export function resolveBody(z){if(z["body-file"]){const D=String(z["body-file"]);if(!V.statSync(D,{throwIfNoEntry:!1})?.isFile())throw new K(`--body-file not found: ${D}`);return V.readFileSync(D,"utf8")}if(z.body!==void 0&&z.body!==null){v(String(z.body),{fileFlag:"--body-file"});return String(z.body)}return}export function resolveTagList(z){if(z===void 0||z===null||z==="")return;const D=String(z).split(",").map((F)=>F.trim().toLowerCase()).filter(Boolean);if(D.length>W)throw new K(`Too many tags: ${D.length} (DEV.to max ${W})`);for(const F of D)if(!/^[a-z0-9]+$/.test(F))throw new K(`Invalid tag "${F}". DEV.to tags must be lowercase alphanumeric (no spaces/punctuation).`);return D.join(", ")}export function buildArticle(z,D,F){const H={};if(z.title!==void 0)H.title=String(z.title);if(D!==void 0)H.body_markdown=D;if(z.published!==void 0)H.published=!!z.published;if(F!==void 0)H.tag_list=F;if(z["cover-image"])H.main_image=String(z["cover-image"]);if(z["canonical-url"])H.canonical_url=String(z["canonical-url"]);if(z.series)H.series=String(z.series);if(z.description)H.description=String(z.description);return H}q({site:"devto",name:"publish",access:"write",description:"Publish or update a DEV.to article (markdown). Draft by default; pass --published to go live.",domain:"dev.to",strategy:B.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!1,help:"Article title (required for new articles)"},{name:"body",type:"string",required:!1,help:"Article body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"published",type:"boolean",required:!1,default:!1,help:"Publish live now (default: save as draft)"},{name:"tags",type:"string",required:!1,help:"Comma-separated tags, max 4, lowercase alphanumeric"},{name:"cover-image",type:"string",required:!1,help:"Cover image URL (main_image)"},{name:"canonical-url",type:"string",required:!1,help:"Canonical URL (original source)"},{name:"series",type:"string",required:!1,help:"Series name to group articles"},{name:"description",type:"string",required:!1,help:"Social/SEO description"},{name:"id",type:"string",required:!1,help:"Existing article id to update (PUT instead of POST)"}],columns:["status","id","url","published","slug"],func:async(z,D)=>{if(!z)throw new O("Browser session required for devto publish");const F=D.id?String(D.id).trim():"",H=resolveBody(D),Y=resolveTagList(D.tags);if(!F&&!D.title)throw new K("--title is required when creating a new article");if(!F&&H===void 0)throw new K("--body or --body-file is required when creating a new article");const P=buildArticle(D,H,Y),Z=F?"PUT":"POST",$=F?`/articles/${encodeURIComponent(F)}`:"/articles";await z.goto("https://dev.to/");const I=await z.evaluate(`(async () => {
+      try {
+        var csrf = (document.querySelector('meta[name="csrf-token"]') || {}).content || window.csrfToken;
+        if (!csrf) return { kind: 'auth', detail: 'no csrf-token meta — not logged in?' };
+        var r = await fetch(${JSON.stringify($)}, {
+          method: ${JSON.stringify(Z)},
+          credentials: 'include',
+          headers: { 'Accept': 'application/json', 'Content-Type': 'application/json', 'X-CSRF-Token': csrf },
+          body: JSON.stringify({ article: ${JSON.stringify(P)} }),
+        });
+        var text = await r.text();
+        var data = null; try { data = JSON.parse(text); } catch (e) {}
+        if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'HTTP ' + r.status };
+        if (!r.ok) return { kind: 'http', status: r.status, detail: text.slice(0, 300) };
+        return { kind: 'ok', data: data };
+      } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
+    })()`);if(I?.kind==="auth")throw new U("dev.to",`Not logged in (${I.detail}). Run \`opencli devto login\`.`);if(I?.kind==="http")throw new O(`dev.to publish failed: HTTP ${I.status} ${I.detail}`);if(I?.kind==="exception")throw new O(`dev.to publish error: ${I.detail}`);if(I?.kind!=="ok"||!I.data)throw new O(`Unexpected dev.to response: ${JSON.stringify(I)}`);const J=I.data,Q=!!P.published;let N="";if(J.current_state_path)try{N=new URL(J.current_state_path,"https://dev.to").href}catch(G){N=String(J.current_state_path)}else if(J.url)N=String(J.url);return[{status:F?"updated":"created",id:J.id??"",url:Q?N:"",published:Q,slug:J.slug??""}]}});

package/clis/devto/read.js

@@ -1,103 +1,3 @@
-/**
- * DEV.to article reader.
- *
- * Public API: https://dev.to/api/articles/<id>
- * Returns the full article including `body_markdown` (and `body_html`).
- *
- * The DEV.to API does not currently expose article comments — this reader
- * therefore emits one row with the article body. If/when comments become
- * available we can extend to a POST + L0/L1 shape like `hackernews read`.
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";import{ArgumentError as U,CommandExecutionError as K,EmptyResultError as W}from"@jackwener/opencli/errors";const f="https://dev.to/api/articles";async function z(G){let H;try{H=await fetch(`${f}/${G}`)}catch(J){const F=J instanceof Error?J.message:String(J);throw new K(`DEV.to API request failed for article ${G}`,F)}if(H.status===404)throw new W(`devto/${G}`,"Article not found");if(!H.ok)throw new K(`DEV.to API HTTP ${H.status} for article ${G}`,"Check the article id");try{return await H.json()}catch{throw new K(`DEV.to API returned invalid JSON for article ${G}`,"Retry later or open the article URL directly")}}function D(G,H,J){const F=typeof G==="number"?G:Number(G);if(!Number.isInteger(F)||F<H)throw new U(`${J} must be an integer >= ${H}`);return F}function M(G,H){if(typeof G.body_markdown==="string"&&G.body_markdown.trim())return G.body_markdown;throw new K(`DEV.to article ${H} did not include body_markdown`,"DEV.to API response shape may have changed. Open the article URL directly or retry later.")}Z({site:"devto",name:"read",access:"read",description:"Read a DEV.to article body by id",domain:"dev.to",strategy:$.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"DEV.to article id (numeric, e.g. 3605688)"},{name:"max-length",type:"int",default:20000,help:"Max characters of body to return (min 100)"}],columns:["id","title","author","reactions","reading_time","tags","published_at","body","url"],func:async(G)=>{const H=String(G.id||"").trim();if(!/^\d+$/.test(H))throw new U(`Invalid DEV.to article id: ${G.id}`,"Pass a numeric id like 3605688");const J=D(G["max-length"]??20000,100,"devto read --max-length"),F=await z(H);if(!F||!F.id)throw new W(`devto/${H}`,"Article not found");const P=M(F,H),X=P.length>J?P.slice(0,J)+`
 
-const DEVTO_ARTICLE_BASE = 'https://dev.to/api/articles';
-
-async function fetchArticle(id) {
-    let res;
-    try {
-        res = await fetch(`${DEVTO_ARTICLE_BASE}/${id}`);
-    } catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        throw new CommandExecutionError(`DEV.to API request failed for article ${id}`, detail);
-    }
-    if (res.status === 404) {
-        throw new EmptyResultError(`devto/${id}`, 'Article not found');
-    }
-    if (!res.ok) {
-        throw new CommandExecutionError(`DEV.to API HTTP ${res.status} for article ${id}`, 'Check the article id');
-    }
-    try {
-        return await res.json();
-    } catch {
-        throw new CommandExecutionError(`DEV.to API returned invalid JSON for article ${id}`, 'Retry later or open the article URL directly');
-    }
-}
-
-function requireMinInt(value, min, label) {
-    const number = typeof value === 'number' ? value : Number(value);
-    if (!Number.isInteger(number) || number < min) {
-        throw new ArgumentError(`${label} must be an integer >= ${min}`);
-    }
-    return number;
-}
-
-function requireArticleBody(article, id) {
-    if (typeof article.body_markdown === 'string' && article.body_markdown.trim()) {
-        return article.body_markdown;
-    }
-    throw new CommandExecutionError(
-        `DEV.to article ${id} did not include body_markdown`,
-        'DEV.to API response shape may have changed. Open the article URL directly or retry later.',
-    );
-}
-
-cli({
-    site: 'devto',
-    name: 'read',
-    access: 'read',
-    description: 'Read a DEV.to article body by id',
-    domain: 'dev.to',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', required: true, positional: true, help: 'DEV.to article id (numeric, e.g. 3605688)' },
-        { name: 'max-length', type: 'int', default: 20000, help: 'Max characters of body to return (min 100)' },
-    ],
-    columns: ['id', 'title', 'author', 'reactions', 'reading_time', 'tags', 'published_at', 'body', 'url'],
-    func: async (args) => {
-        const id = String(args.id || '').trim();
-        if (!/^\d+$/.test(id)) {
-            throw new ArgumentError(`Invalid DEV.to article id: ${args.id}`, 'Pass a numeric id like 3605688');
-        }
-        const maxLength = requireMinInt(args['max-length'] ?? 20000, 100, 'devto read --max-length');
-
-        const article = await fetchArticle(id);
-        if (!article || !article.id) {
-            throw new EmptyResultError(`devto/${id}`, 'Article not found');
-        }
-
-        const body = requireArticleBody(article, id);
-        const truncated = body.length > maxLength
-            ? body.slice(0, maxLength) + '\n\n... [truncated]'
-            : body;
-
-        // The single-article endpoint returns `tag_list` as a comma-separated
-        // string and `tags` as an array — the opposite of the listing endpoints.
-        // Normalize either shape into a single comma-separated string.
-        const tagsRaw = article.tag_list ?? article.tags ?? '';
-        const tags = Array.isArray(tagsRaw) ? tagsRaw.join(', ') : String(tagsRaw);
-
-        return [{
-            id: article.id,
-            title: article.title || '',
-            author: article.user?.username || '[deleted]',
-            reactions: article.public_reactions_count ?? 0,
-            reading_time: article.reading_time_minutes ?? 0,
-            tags,
-            published_at: article.published_at || '',
-            body: truncated,
-            url: article.url || '',
-        }];
-    },
-});
+... [truncated]`:P,Q=F.tag_list??F.tags??"",Y=Array.isArray(Q)?Q.join(", "):String(Q);return[{id:F.id,title:F.title||"",author:F.user?.username||"[deleted]",reactions:F.public_reactions_count??0,reading_time:F.reading_time_minutes??0,tags:Y,published_at:F.published_at||"",body:X,url:F.url||""}]}});

package/clis/devto/tag.js

@@ -1,36 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'devto',
-    name: 'tag',
-    access: 'read',
-    description: 'Latest DEV.to articles for a specific tag',
-    domain: 'dev.to',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        {
-            name: 'tag',
-            required: true,
-            positional: true,
-            help: 'Tag name (e.g. javascript, python, webdev)',
-        },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
-    ],
-    columns: ['rank', 'id', 'title', 'author', 'reactions', 'comments', 'reading_time', 'published_at', 'tags', 'url'],
-    pipeline: [
-        { fetch: { url: 'https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}' } },
-        { map: {
-                rank: '${{ index + 1 }}',
-                id: '${{ item.id }}',
-                title: '${{ item.title }}',
-                author: '${{ item.user.username }}',
-                reactions: '${{ item.public_reactions_count }}',
-                comments: '${{ item.comments_count }}',
-                reading_time: '${{ item.reading_time_minutes }}',
-                published_at: '${{ item.published_at }}',
-                tags: `\${{ item.tag_list | join(', ') }}`,
-                url: '${{ item.url }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"devto",name:"tag",access:"read",description:"Latest DEV.to articles for a specific tag",domain:"dev.to",strategy:e.PUBLIC,browser:!1,args:[{name:"tag",required:!0,positional:!0,help:"Tag name (e.g. javascript, python, webdev)"},{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","author","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",author:"${{ item.user.username }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/devto/top.js

@@ -1,30 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'devto',
-    name: 'top',
-    access: 'read',
-    description: 'Top DEV.to articles of the day',
-    domain: 'dev.to',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
-    ],
-    columns: ['rank', 'id', 'title', 'author', 'reactions', 'comments', 'reading_time', 'published_at', 'tags', 'url'],
-    pipeline: [
-        { fetch: { url: 'https://dev.to/api/articles?top=1&per_page=${{ args.limit }}' } },
-        { map: {
-                rank: '${{ index + 1 }}',
-                id: '${{ item.id }}',
-                title: '${{ item.title }}',
-                author: '${{ item.user.username }}',
-                reactions: '${{ item.public_reactions_count }}',
-                comments: '${{ item.comments_count }}',
-                reading_time: '${{ item.reading_time_minutes }}',
-                published_at: '${{ item.published_at }}',
-                tags: `\${{ item.tag_list | join(', ') }}`,
-                url: '${{ item.url }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"devto",name:"top",access:"read",description:"Top DEV.to articles of the day",domain:"dev.to",strategy:e.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","author","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?top=1&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",author:"${{ item.user.username }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/devto/user.js

@@ -1,35 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-cli({
-    site: 'devto',
-    name: 'user',
-    access: 'read',
-    description: 'Recent DEV.to articles from a specific user',
-    domain: 'dev.to',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        {
-            name: 'username',
-            required: true,
-            positional: true,
-            help: 'DEV.to username (e.g. ben, thepracticaldev)',
-        },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of articles' },
-    ],
-    columns: ['rank', 'id', 'title', 'reactions', 'comments', 'reading_time', 'published_at', 'tags', 'url'],
-    pipeline: [
-        { fetch: { url: 'https://dev.to/api/articles?username=${{ args.username }}&per_page=${{ args.limit }}' } },
-        { map: {
-                rank: '${{ index + 1 }}',
-                id: '${{ item.id }}',
-                title: '${{ item.title }}',
-                reactions: '${{ item.public_reactions_count }}',
-                comments: '${{ item.comments_count }}',
-                reading_time: '${{ item.reading_time_minutes }}',
-                published_at: '${{ item.published_at }}',
-                tags: `\${{ item.tag_list | join(', ') }}`,
-                url: '${{ item.url }}',
-            } },
-        { limit: '${{ args.limit }}' },
-    ],
-});
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"devto",name:"user",access:"read",description:"Recent DEV.to articles from a specific user",domain:"dev.to",strategy:t.PUBLIC,browser:!1,args:[{name:"username",required:!0,positional:!0,help:"DEV.to username (e.g. ben, thepracticaldev)"},{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?username=${{ args.username }}&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/dianping/auth.js

@@ -1,22 +1,4 @@
-import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasDianpingSessionCookie(page) {
-  const cookies = await page.getCookies({ url: 'https://www.dianping.com' });
-  return cookies.some(c => c.name === 'dper' && c.value);
-}
-
-async function verifyDianpingIdentity(page) {
-  if (!await hasDianpingSessionCookie(page)) {
-    throw new AuthRequiredError('dianping.com', 'Dianping dper cookie missing');
-  }
-  await page.goto('https://www.dianping.com/member/myinformation');
-  await page.wait(2);
-  const finalUrl = await page.evaluate(`location.href`);
-  if (/account\.dianping\.com\/(pc)?login/.test(String(finalUrl || ''))) {
-    throw new AuthRequiredError('dianping.com', `Dianping member page redirected to login: ${finalUrl}`);
-  }
-  const info = await page.evaluate(`
+import{AuthRequiredError as t,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as m}from"../_shared/site-auth.js";async function o(n){return(await n.getCookies({url:"https://www.dianping.com"})).some((i)=>i.name==="dper"&&i.value)}async function r(n){if(!await o(n))throw new t("dianping.com","Dianping dper cookie missing");await n.goto("https://www.dianping.com/member/myinformation");await n.wait(2);const e=await n.evaluate("location.href");if(/account\.dianping\.com\/(pc)?login/.test(String(e||"")))throw new t("dianping.com",`Dianping member page redirected to login: ${e}`);const i=await n.evaluate(`
     (() => {
       const nicknameEl = document.querySelector('.user-name, .username, .nickname, .user-info .name');
       const nickname = (nicknameEl?.textContent || '').trim();
@@ -26,24 +8,4 @@ async function verifyDianpingIdentity(page) {
       const uidMatch = String(profileLink || '').match(/\\/member\\/(\\d+)/);
       return { user_id: uidMatch?.[1] || '', nickname };
     })()
-  `);
-  if (!info?.user_id) {
-    throw new CommandExecutionError('Dianping member page rendered but no user_id link found — stale dper or layout drift');
-  }
-  return { user_id: String(info.user_id), nickname: String(info.nickname || '') };
-}
-
-registerSiteAuthCommands({
-  site: 'dianping',
-  domain: 'dianping.com',
-  loginUrl: 'https://account.dianping.com/pclogin',
-  columns: ['user_id', 'nickname'],
-  quickCheck: hasDianpingSessionCookie,
-  verify: verifyDianpingIdentity,
-  poll: async (page) => {
-    if (!await hasDianpingSessionCookie(page)) {
-      throw new AuthRequiredError('dianping.com', 'Waiting for Dianping dper cookie');
-    }
-    return verifyDianpingIdentity(page);
-  },
-});
+  `);if(!i?.user_id)throw new a("Dianping member page rendered but no user_id link found — stale dper or layout drift");return{user_id:String(i.user_id),nickname:String(i.nickname||"")}}m({site:"dianping",domain:"dianping.com",loginUrl:"https://account.dianping.com/pclogin",columns:["user_id","nickname"],quickCheck:o,verify:r,poll:async(n)=>{if(!await o(n))throw new t("dianping.com","Waiting for Dianping dper cookie");return r(n)}});