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

package/clis/coupang/utils.js

@@ -1,316 +1 @@
-import { ArgumentError } from '@jackwener/opencli/errors';
-
-/**
- * Parse a positive integer arg (--limit / --page / --review-page).
- *
- * Throws ArgumentError on out-of-range / non-integer values rather than
- * silently clamping. We prefer typed-fail-fast over silent clamping for the
- * same reason as feedback_typed_fail_fast_for_adapters: callers cannot tell
- * that their value was rewritten and end up confused why "limit=999" returned
- * 50 rows.
- */
-export function parseLimitArg(raw, fallback, max) {
-    if (raw === undefined || raw === null || raw === '') {
-        return fallback;
-    }
-    const num = Number(raw);
-    if (!Number.isInteger(num) || num < 1 || num > max) {
-        throw new ArgumentError(`--limit must be an integer between 1 and ${max} (got ${raw})`);
-    }
-    return num;
-}
-
-export function parsePageArg(raw, fallback) {
-    if (raw === undefined || raw === null || raw === '') {
-        return fallback;
-    }
-    const num = Number(raw);
-    if (!Number.isInteger(num) || num < 1) {
-        throw new ArgumentError(`--page must be a positive integer (got ${raw})`);
-    }
-    return num;
-}
-
-function itemKey(item) {
-    return item.url || item.product_id || `${item.title}:${item.price ?? ''}`;
-}
-const ROCKET_PATTERNS = ['판매자로켓', '로켓프레시', '로켓와우', '로켓배송', '로켓직구'];
-const DELIVERY_TYPE_PATTERNS = ['무료배송', '일반배송'];
-const DELIVERY_PROMISE_PATTERNS = ['오늘도착', '내일도착', '새벽도착', '오늘출발'];
-const BADGE_ID_TO_ROCKET = {
-    ROCKET: '로켓배송',
-    ROCKET_MERCHANT: '판매자로켓',
-    ROCKET_WOW: '로켓와우',
-    WOW: '로켓와우',
-    ROCKET_FRESH: '로켓프레시',
-    FRESH: '로켓프레시',
-    SELLER_ROCKET: '판매자로켓',
-    ROCKET_JIKGU: '로켓직구',
-    JIKGU: '로켓직구',
-    COUPANG_GLOBAL: '로켓직구',
-};
-const BADGE_ID_TO_PROMISE = {
-    DAWN: '새벽도착',
-    EARLY_DAWN: '새벽도착',
-    TOMORROW: '내일도착',
-    TODAY: '오늘도착',
-    SAME_DAY: '오늘도착',
-    TODAY_SHIP: '오늘출발',
-    TODAY_DISPATCH: '오늘출발',
-};
-function asString(value) {
-    if (value == null)
-        return '';
-    return String(value).trim();
-}
-function toNumber(value) {
-    if (typeof value === 'number' && Number.isFinite(value))
-        return value;
-    const text = asString(value).replace(/[^\d.]/g, '');
-    if (!text)
-        return null;
-    const num = Number(text);
-    return Number.isFinite(num) ? num : null;
-}
-function pickFirst(obj, paths) {
-    for (const path of paths) {
-        const parts = path.split('.');
-        let current = obj;
-        let ok = true;
-        for (const part of parts) {
-            if (!current || typeof current !== 'object' || !(part in current)) {
-                ok = false;
-                break;
-            }
-            current = current[part];
-        }
-        if (ok && current != null && asString(current) !== '')
-            return current;
-    }
-    return null;
-}
-export function normalizeProductId(raw) {
-    const text = asString(raw);
-    if (!text)
-        return '';
-    const match = text.match(/\/vp\/products\/(\d+)/) || text.match(/\b(\d{6,})\b/);
-    return match?.[1] ?? '';
-}
-export function requireProductIdArg(raw, label = '--product-id') {
-    const text = asString(raw);
-    if (label === '--url') {
-        try {
-            const url = new URL(text.startsWith('http') ? text : `https://www.coupang.com${text}`);
-            const match = url.pathname.match(/^\/vp\/products\/(\d{6,})(?:\/|$)/);
-            const isCoupangHost = url.hostname === 'coupang.com' || url.hostname.endsWith('.coupang.com');
-            if (isCoupangHost && match) {
-                return match[1];
-            }
-        }
-        catch {
-            // Fall through to the typed validation error below.
-        }
-        throw new ArgumentError(`${label} must be a Coupang product URL containing /vp/products/<id>`);
-    }
-    if (!/^\d{6,}$/.test(text)) {
-        throw new ArgumentError(`${label} must be a numeric Coupang product ID`);
-    }
-    return text;
-}
-export function canonicalizeProductUrl(rawUrl, productId) {
-    const raw = asString(rawUrl);
-    if (raw) {
-        try {
-            const url = new URL(raw.startsWith('http') ? raw : `https://www.coupang.com${raw}`);
-            if (!url.hostname.includes('coupang.com'))
-                return '';
-            const id = normalizeProductId(url.pathname) || normalizeProductId(productId);
-            if (!id)
-                return url.toString();
-            return `https://www.coupang.com/vp/products/${id}`;
-        }
-        catch {
-            return '';
-        }
-    }
-    const id = normalizeProductId(productId);
-    return id ? `https://www.coupang.com/vp/products/${id}` : '';
-}
-function extractTokens(values) {
-    return values
-        .flatMap((value) => {
-        const text = asString(value);
-        if (!text)
-            return [];
-        return text.split(/[,\s|]+/);
-    })
-        .map((token) => token.trim().toUpperCase())
-        .filter(Boolean);
-}
-function normalizeJoinedText(...values) {
-    return values
-        .map(asString)
-        .filter(Boolean)
-        .join(' ')
-        .replace(/schema\.org\/[A-Za-z]+/gi, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-function normalizeRocket(...values) {
-    const tokens = extractTokens(values);
-    for (const token of tokens) {
-        if (BADGE_ID_TO_ROCKET[token])
-            return BADGE_ID_TO_ROCKET[token];
-    }
-    const text = normalizeJoinedText(...values);
-    if (!text)
-        return '';
-    if (/판매자\s*로켓/.test(text))
-        return '판매자로켓';
-    if (/로켓\s*프레시|새벽\s*도착\s*보장/.test(text))
-        return '로켓프레시';
-    if (/로켓\s*와우/.test(text))
-        return '로켓와우';
-    if (/로켓\s*직구|직구/.test(text))
-        return '로켓직구';
-    if (/로켓\s*배송/.test(text))
-        return '로켓배송';
-    return ROCKET_PATTERNS.find(pattern => text.includes(pattern)) ?? '';
-}
-function normalizeDeliveryType(...values) {
-    const text = normalizeJoinedText(...values);
-    if (!text)
-        return '';
-    if (/무료\s*배송/.test(text))
-        return '무료배송';
-    if (/일반\s*배송/.test(text))
-        return '일반배송';
-    return DELIVERY_TYPE_PATTERNS.find(pattern => text.includes(pattern)) ?? '';
-}
-function normalizeDeliveryPromise(...values) {
-    const tokens = extractTokens(values);
-    for (const token of tokens) {
-        if (BADGE_ID_TO_PROMISE[token])
-            return BADGE_ID_TO_PROMISE[token];
-    }
-    const text = normalizeJoinedText(...values);
-    if (!text)
-        return '';
-    if (/오늘\s*출발/.test(text))
-        return '오늘출발';
-    if (/오늘.*도착/.test(text))
-        return '오늘도착';
-    if (/새벽.*도착/.test(text))
-        return '새벽도착';
-    if (/내일.*도착/.test(text))
-        return '내일도착';
-    return DELIVERY_PROMISE_PATTERNS.find(pattern => text.includes(pattern)) ?? '';
-}
-function normalizeBadge(value) {
-    const normalizeOne = (entry) => {
-        const text = asString(entry);
-        if (!text)
-            return '';
-        if (/schema\.org\//i.test(text)) {
-            return text.split('/').pop() ?? '';
-        }
-        return text;
-    };
-    if (Array.isArray(value)) {
-        return value.map(normalizeOne).filter(Boolean).join(', ');
-    }
-    return normalizeOne(value);
-}
-export function normalizeSearchItem(raw, index) {
-    const productId = normalizeProductId(pickFirst(raw, ['productId', 'product_id', 'id', 'productNo', 'item.id', 'product.productId', 'url']));
-    const title = asString(pickFirst(raw, ['title', 'name', 'productName', 'productTitle', 'itemName', 'item.title']));
-    const price = toNumber(pickFirst(raw, ['price', 'salePrice', 'finalPrice', 'sellingPrice', 'discountPrice', 'item.price']));
-    const originalPrice = toNumber(pickFirst(raw, ['originalPrice', 'basePrice', 'listPrice', 'originPrice', 'strikePrice']));
-    const unitPrice = asString(pickFirst(raw, ['unitPrice', 'unit_price', 'unitPriceText']));
-    const rating = toNumber(pickFirst(raw, ['rating', 'star', 'reviewRating', 'review.rating', 'item.rating']));
-    const reviewCount = toNumber(pickFirst(raw, ['reviewCount', 'ratingCount', 'reviews', 'reviewCnt', 'item.reviewCount']));
-    const deliveryHintValues = [
-        pickFirst(raw, ['deliveryType', 'deliveryBadge', 'badgeLabel', 'shippingType', 'shippingBadge']),
-        pickFirst(raw, ['badge', 'badges', 'labels', 'benefitBadge', 'promotionBadge']),
-        pickFirst(raw, ['text', 'summary']),
-        pickFirst(raw, ['deliveryPromise', 'promise', 'arrivalText', 'arrivalBadge']),
-        pickFirst(raw, ['rocket', 'rocketType']),
-    ];
-    const deliveryType = normalizeDeliveryType(...deliveryHintValues);
-    const deliveryPromise = normalizeDeliveryPromise(...deliveryHintValues);
-    const rocket = normalizeRocket(...deliveryHintValues);
-    const badge = normalizeBadge(pickFirst(raw, ['badge', 'badges', 'labels', 'benefitBadge', 'promotionBadge']));
-    const category = asString(pickFirst(raw, ['category', 'categoryName', 'categoryPath', 'item.category']));
-    const seller = asString(pickFirst(raw, ['seller', 'sellerName', 'vendorName', 'merchantName', 'item.seller']));
-    const url = canonicalizeProductUrl(pickFirst(raw, ['url', 'productUrl', 'link', 'item.url']), productId);
-    const discountRate = toNumber(pickFirst(raw, ['discountRate', 'discount', 'discountPercent', 'discount_rate']));
-    return {
-        rank: index + 1,
-        product_id: productId,
-        title,
-        price,
-        original_price: originalPrice,
-        unit_price: unitPrice,
-        discount_rate: discountRate,
-        rating,
-        review_count: reviewCount,
-        rocket,
-        delivery_type: deliveryType,
-        delivery_promise: deliveryPromise,
-        seller,
-        badge,
-        category,
-        url,
-    };
-}
-export function dedupeSearchItems(items) {
-    const seen = new Set();
-    const out = [];
-    for (const item of items) {
-        const key = itemKey(item);
-        if (!key || seen.has(key))
-            continue;
-        seen.add(key);
-        out.push({ ...item, rank: out.length + 1 });
-    }
-    return out;
-}
-export function sanitizeSearchItems(items, limit) {
-    return dedupeSearchItems(items.filter(item => Boolean(item.title && (item.product_id || item.url)))).slice(0, limit);
-}
-export function mergeSearchItems(base, extra, limit) {
-    const extraMap = new Map();
-    for (const item of extra) {
-        const key = itemKey(item);
-        if (key)
-            extraMap.set(key, item);
-    }
-    const merged = base.map((item) => {
-        const key = itemKey(item);
-        const patch = key ? extraMap.get(key) : null;
-        if (!patch)
-            return item;
-        return {
-            ...item,
-            price: patch.price ?? item.price,
-            original_price: patch.original_price ?? item.original_price,
-            unit_price: patch.unit_price || item.unit_price,
-            discount_rate: patch.discount_rate ?? item.discount_rate,
-            rating: patch.rating ?? item.rating,
-            review_count: patch.review_count ?? item.review_count,
-            rocket: patch.rocket || item.rocket,
-            delivery_type: patch.delivery_type || item.delivery_type,
-            delivery_promise: patch.delivery_promise || item.delivery_promise,
-            seller: patch.seller || item.seller,
-            badge: patch.badge || item.badge,
-            category: patch.category || item.category,
-            url: patch.url || item.url,
-        };
-    });
-    const mergedKeys = new Set(merged.map(item => itemKey(item)).filter(Boolean));
-    const appended = extra.filter(item => {
-        const key = itemKey(item);
-        return key && !mergedKeys.has(key);
-    });
-    return sanitizeSearchItems([...merged, ...appended], limit);
-}
+import{ArgumentError as G}from"@jackwener/opencli/errors";export function parseLimitArg(q,W,Q){if(q===void 0||q===null||q==="")return W;const X=Number(q);if(!Number.isInteger(X)||X<1||X>Q)throw new G(`--limit must be an integer between 1 and ${Q} (got ${q})`);return X}export function parsePageArg(q,W){if(q===void 0||q===null||q==="")return W;const Q=Number(q);if(!Number.isInteger(Q)||Q<1)throw new G(`--page must be a positive integer (got ${q})`);return Q}function f(q){return q.url||q.product_id||`${q.title}:${q.price??""}`}const F=["판매자로켓","로켓프레시","로켓와우","로켓배송","로켓직구"],S=["무료배송","일반배송"],b=["오늘도착","내일도착","새벽도착","오늘출발"],M={ROCKET:"로켓배송",ROCKET_MERCHANT:"판매자로켓",ROCKET_WOW:"로켓와우",WOW:"로켓와우",ROCKET_FRESH:"로켓프레시",FRESH:"로켓프레시",SELLER_ROCKET:"판매자로켓",ROCKET_JIKGU:"로켓직구",JIKGU:"로켓직구",COUPANG_GLOBAL:"로켓직구"},V={DAWN:"새벽도착",EARLY_DAWN:"새벽도착",TOMORROW:"내일도착",TODAY:"오늘도착",SAME_DAY:"오늘도착",TODAY_SHIP:"오늘출발",TODAY_DISPATCH:"오늘출발"};function H(q){if(q==null)return"";return String(q).trim()}function C(q){if(typeof q==="number"&&Number.isFinite(q))return q;const W=H(q).replace(/[^\d.]/g,"");if(!W)return null;const Q=Number(W);return Number.isFinite(Q)?Q:null}function j(q,W){for(const Q of W){const X=Q.split(".");let $=q,J=!0;for(const Y of X){if(!$||typeof $!=="object"||!(Y in $)){J=!1;break}$=$[Y]}if(J&&$!=null&&H($)!=="")return $}return null}export function normalizeProductId(q){const W=H(q);if(!W)return"";return(W.match(/\/vp\/products\/(\d+)/)||W.match(/\b(\d{6,})\b/))?.[1]??""}export function requireProductIdArg(q,W="--product-id"){const Q=H(q);if(W==="--url"){try{const X=new URL(Q.startsWith("http")?Q:`https://www.coupang.com${Q}`),$=X.pathname.match(/^\/vp\/products\/(\d{6,})(?:\/|$)/);if((X.hostname==="coupang.com"||X.hostname.endsWith(".coupang.com"))&&$)return $[1]}catch{}throw new G(`${W} must be a Coupang product URL containing /vp/products/<id>`)}if(!/^\d{6,}$/.test(Q))throw new G(`${W} must be a numeric Coupang product ID`);return Q}export function canonicalizeProductUrl(q,W){const Q=H(q);if(Q)try{const $=new URL(Q.startsWith("http")?Q:`https://www.coupang.com${Q}`);if(!$.hostname.includes("coupang.com"))return"";const J=normalizeProductId($.pathname)||normalizeProductId(W);if(!J)return $.toString();return`https://www.coupang.com/vp/products/${J}`}catch{return""}const X=normalizeProductId(W);return X?`https://www.coupang.com/vp/products/${X}`:""}function N(q){return q.flatMap((W)=>{const Q=H(W);if(!Q)return[];return Q.split(/[,\s|]+/)}).map((W)=>W.trim().toUpperCase()).filter(Boolean)}function B(...q){return q.map(H).filter(Boolean).join(" ").replace(/schema\.org\/[A-Za-z]+/gi," ").replace(/\s+/g," ").trim()}function I(...q){const W=N(q);for(const X of W)if(M[X])return M[X];const Q=B(...q);if(!Q)return"";if(/판매자\s*로켓/.test(Q))return"판매자로켓";if(/로켓\s*프레시|새벽\s*도착\s*보장/.test(Q))return"로켓프레시";if(/로켓\s*와우/.test(Q))return"로켓와우";if(/로켓\s*직구|직구/.test(Q))return"로켓직구";if(/로켓\s*배송/.test(Q))return"로켓배송";return F.find((X)=>Q.includes(X))??""}function T(...q){const W=B(...q);if(!W)return"";if(/무료\s*배송/.test(W))return"무료배송";if(/일반\s*배송/.test(W))return"일반배송";return S.find((Q)=>W.includes(Q))??""}function E(...q){const W=N(q);for(const X of W)if(V[X])return V[X];const Q=B(...q);if(!Q)return"";if(/오늘\s*출발/.test(Q))return"오늘출발";if(/오늘.*도착/.test(Q))return"오늘도착";if(/새벽.*도착/.test(Q))return"새벽도착";if(/내일.*도착/.test(Q))return"내일도착";return b.find((X)=>Q.includes(X))??""}function h(q){const W=(Q)=>{const X=H(Q);if(!X)return"";if(/schema\.org\//i.test(X))return X.split("/").pop()??"";return X};if(Array.isArray(q))return q.map(W).filter(Boolean).join(", ");return W(q)}export function normalizeSearchItem(q,W){const Q=normalizeProductId(j(q,["productId","product_id","id","productNo","item.id","product.productId","url"])),X=H(j(q,["title","name","productName","productTitle","itemName","item.title"])),$=C(j(q,["price","salePrice","finalPrice","sellingPrice","discountPrice","item.price"])),J=C(j(q,["originalPrice","basePrice","listPrice","originPrice","strikePrice"])),Y=H(j(q,["unitPrice","unit_price","unitPriceText"])),Z=C(j(q,["rating","star","reviewRating","review.rating","item.rating"])),U=C(j(q,["reviewCount","ratingCount","reviews","reviewCnt","item.reviewCount"])),L=[j(q,["deliveryType","deliveryBadge","badgeLabel","shippingType","shippingBadge"]),j(q,["badge","badges","labels","benefitBadge","promotionBadge"]),j(q,["text","summary"]),j(q,["deliveryPromise","promise","arrivalText","arrivalBadge"]),j(q,["rocket","rocketType"])],K=T(...L),A=E(...L),D=I(...L),O=h(j(q,["badge","badges","labels","benefitBadge","promotionBadge"])),R=H(j(q,["category","categoryName","categoryPath","item.category"])),z=H(j(q,["seller","sellerName","vendorName","merchantName","item.seller"])),P=canonicalizeProductUrl(j(q,["url","productUrl","link","item.url"]),Q),_=C(j(q,["discountRate","discount","discountPercent","discount_rate"]));return{rank:W+1,product_id:Q,title:X,price:$,original_price:J,unit_price:Y,discount_rate:_,rating:Z,review_count:U,rocket:D,delivery_type:K,delivery_promise:A,seller:z,badge:O,category:R,url:P}}export function dedupeSearchItems(q){const W=new Set,Q=[];for(const X of q){const $=f(X);if(!$||W.has($))continue;W.add($);Q.push({...X,rank:Q.length+1})}return Q}export function sanitizeSearchItems(q,W){return dedupeSearchItems(q.filter((Q)=>Boolean(Q.title&&(Q.product_id||Q.url)))).slice(0,W)}export function mergeSearchItems(q,W,Q){const X=new Map;for(const Z of W){const U=f(Z);if(U)X.set(U,Z)}const $=q.map((Z)=>{const U=f(Z),L=U?X.get(U):null;if(!L)return Z;return{...Z,price:L.price??Z.price,original_price:L.original_price??Z.original_price,unit_price:L.unit_price||Z.unit_price,discount_rate:L.discount_rate??Z.discount_rate,rating:L.rating??Z.rating,review_count:L.review_count??Z.review_count,rocket:L.rocket||Z.rocket,delivery_type:L.delivery_type||Z.delivery_type,delivery_promise:L.delivery_promise||Z.delivery_promise,seller:L.seller||Z.seller,badge:L.badge||Z.badge,category:L.category||Z.category,url:L.url||Z.url}}),J=new Set($.map((Z)=>f(Z)).filter(Boolean)),Y=W.filter((Z)=>{const U=f(Z);return U&&!J.has(U)});return sanitizeSearchItems([...$,...Y],Q)}

package/clis/crates/crate.js

@@ -1,62 +1 @@
-// crates crate — fetch a single crate's metadata.
-//
-// Hits `https://crates.io/api/v1/crates/<name>`. Returns the agent-useful
-// projection: name, latest version, description, total + recent downloads,
-// homepage / docs / repo, license (from latest version row), version count,
-// created / updated timestamps.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { CRATES_BASE, cratesFetch, requireCrateName } from './utils.js';
-
-cli({
-    site: 'crates',
-    name: 'crate',
-    access: 'read',
-    description: 'Single crates.io crate metadata (latest version, downloads, license, repo)',
-    domain: 'crates.io',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'name', positional: true, required: true, help: 'crates.io crate name (e.g. "serde", "tokio")' },
-    ],
-    columns: [
-        'name', 'latestVersion', 'description', 'downloads', 'recentDownloads', 'versions',
-        'license', 'homepage', 'documentation', 'repository', 'keywords', 'categories', 'created', 'updated', 'url',
-    ],
-    func: async (args) => {
-        const name = requireCrateName(args.name);
-        const body = await cratesFetch(`${CRATES_BASE}/api/v1/crates/${encodeURIComponent(name)}`, `crates crate ${name}`);
-        const c = body?.crate;
-        if (!c || !c.id) {
-            throw new EmptyResultError('crates crate', `crates.io returned no metadata for "${name}".`);
-        }
-        const versions = Array.isArray(body.versions) ? body.versions : [];
-        const latestRow = versions.find((v) => v.num === c.newest_version)
-            || versions.find((v) => v.num === c.max_stable_version)
-            || versions[0]
-            || {};
-        const keywords = Array.isArray(body.keywords)
-            ? body.keywords.map((k) => k?.keyword || k?.id || '').filter(Boolean).join(', ')
-            : '';
-        const categories = Array.isArray(body.categories)
-            ? body.categories.map((cat) => cat?.category || cat?.slug || '').filter(Boolean).join(', ')
-            : '';
-        return [{
-            name: String(c.name ?? c.id),
-            latestVersion: String(c.newest_version ?? c.max_stable_version ?? c.max_version ?? ''),
-            description: String(c.description ?? '').trim(),
-            downloads: c.downloads != null ? Number(c.downloads) : null,
-            recentDownloads: c.recent_downloads != null ? Number(c.recent_downloads) : null,
-            versions: c.num_versions != null ? Number(c.num_versions) : versions.length,
-            license: String(latestRow.license ?? ''),
-            homepage: String(c.homepage ?? ''),
-            documentation: String(c.documentation ?? ''),
-            repository: String(c.repository ?? ''),
-            keywords,
-            categories,
-            created: String(c.created_at ?? '').slice(0, 10),
-            updated: String(c.updated_at ?? '').slice(0, 10),
-            url: `https://crates.io/crates/${c.name ?? c.id}`,
-        }];
-    },
-});
+import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{CRATES_BASE as u,cratesFetch as p,requireCrateName as g}from"./utils.js";d({site:"crates",name:"crate",access:"read",description:"Single crates.io crate metadata (latest version, downloads, license, repo)",domain:"crates.io",strategy:l.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'crates.io crate name (e.g. "serde", "tokio")'}],columns:["name","latestVersion","description","downloads","recentDownloads","versions","license","homepage","documentation","repository","keywords","categories","created","updated","url"],func:async(a)=>{const s=g(a.name),t=await p(`${u}/api/v1/crates/${encodeURIComponent(s)}`,`crates crate ${s}`),e=t?.crate;if(!e||!e.id)throw new m("crates crate",`crates.io returned no metadata for "${s}".`);const o=Array.isArray(t.versions)?t.versions:[],n=o.find((r)=>r.num===e.newest_version)||o.find((r)=>r.num===e.max_stable_version)||o[0]||{},i=Array.isArray(t.keywords)?t.keywords.map((r)=>r?.keyword||r?.id||"").filter(Boolean).join(", "):"",c=Array.isArray(t.categories)?t.categories.map((r)=>r?.category||r?.slug||"").filter(Boolean).join(", "):"";return[{name:String(e.name??e.id),latestVersion:String(e.newest_version??e.max_stable_version??e.max_version??""),description:String(e.description??"").trim(),downloads:e.downloads!=null?Number(e.downloads):null,recentDownloads:e.recent_downloads!=null?Number(e.recent_downloads):null,versions:e.num_versions!=null?Number(e.num_versions):o.length,license:String(n.license??""),homepage:String(e.homepage??""),documentation:String(e.documentation??""),repository:String(e.repository??""),keywords:i,categories:c,created:String(e.created_at??"").slice(0,10),updated:String(e.updated_at??"").slice(0,10),url:`https://crates.io/crates/${e.name??e.id}`}]}});

package/clis/crates/search.js

@@ -1,44 +1 @@
-// crates search — search the crates.io registry by free-text query.
-//
-// Hits `https://crates.io/api/v1/crates?q=…&per_page=…`. Returns name (round-
-// trips into `crates crate`), latest version, description, downloads, recent
-// downloads, repository, last-update.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { CRATES_BASE, cratesFetch, requireBoundedInt, requireString } from './utils.js';
-
-cli({
-    site: 'crates',
-    name: 'search',
-    access: 'read',
-    description: 'Search the public crates.io registry by keyword',
-    domain: 'crates.io',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword (e.g. "serde", "async runtime")' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max results (1-100)' },
-    ],
-    columns: ['rank', 'name', 'latestVersion', 'description', 'downloads', 'recentDownloads', 'repository', 'updated', 'url'],
-    func: async (args) => {
-        const query = requireString(args.query, 'query');
-        const limit = requireBoundedInt(args.limit, 20, 100);
-        const url = `${CRATES_BASE}/api/v1/crates?q=${encodeURIComponent(query)}&per_page=${limit}`;
-        const body = await cratesFetch(url, 'crates search');
-        const list = Array.isArray(body?.crates) ? body.crates : [];
-        if (!list.length) {
-            throw new EmptyResultError('crates search', `No crates.io results matched "${query}".`);
-        }
-        return list.slice(0, limit).map((c, i) => ({
-            rank: i + 1,
-            name: String(c.name ?? c.id ?? ''),
-            latestVersion: String(c.newest_version ?? c.max_stable_version ?? c.max_version ?? ''),
-            description: String(c.description ?? '').trim(),
-            downloads: c.downloads != null ? Number(c.downloads) : null,
-            recentDownloads: c.recent_downloads != null ? Number(c.recent_downloads) : null,
-            repository: String(c.repository ?? c.homepage ?? ''),
-            updated: String(c.updated_at ?? '').slice(0, 10),
-            url: c.name ? `https://crates.io/crates/${c.name}` : '',
-        }));
-    },
-});
+import{cli as d,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{CRATES_BASE as u,cratesFetch as p,requireBoundedInt as m,requireString as y}from"./utils.js";d({site:"crates",name:"search",access:"read",description:"Search the public crates.io registry by keyword",domain:"crates.io",strategy:l.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "serde", "async runtime")'},{name:"limit",type:"int",default:20,help:"Max results (1-100)"}],columns:["rank","name","latestVersion","description","downloads","recentDownloads","repository","updated","url"],func:async(r)=>{const t=y(r.query,"query"),s=m(r.limit,20,100),n=`${u}/api/v1/crates?q=${encodeURIComponent(t)}&per_page=${s}`,a=await p(n,"crates search"),o=Array.isArray(a?.crates)?a.crates:[];if(!o.length)throw new c("crates search",`No crates.io results matched "${t}".`);return o.slice(0,s).map((e,i)=>({rank:i+1,name:String(e.name??e.id??""),latestVersion:String(e.newest_version??e.max_stable_version??e.max_version??""),description:String(e.description??"").trim(),downloads:e.downloads!=null?Number(e.downloads):null,recentDownloads:e.recent_downloads!=null?Number(e.recent_downloads):null,repository:String(e.repository??e.homepage??""),updated:String(e.updated_at??"").slice(0,10),url:e.name?`https://crates.io/crates/${e.name}`:""}))}});

package/clis/crates/utils.js

@@ -1,72 +1 @@
-// Shared helpers for the crates.io adapters.
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-export const CRATES_BASE = 'https://crates.io';
-const UA = 'opencli-crates-adapter (+https://github.com/jackwener/opencli)';
-
-// crates.io crate names: 1-64 chars, ascii letters/digits/-_, must start with a letter.
-const CRATE_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
-
-export function requireString(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError(`crates ${label} cannot be empty`);
-    return s;
-}
-
-export function requireCrateName(value) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError('crates crate name is required (e.g. "serde", "tokio")');
-    if (!CRATE_NAME.test(s)) {
-        throw new ArgumentError(
-            `crates crate name "${value}" is not a valid crates.io name`,
-            'Names start with an ASCII letter, then 0-63 chars of letters / digits / "_-".',
-        );
-    }
-    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(`crates ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`crates ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-export async function cratesFetch(url, label) {
-    let resp;
-    try {
-        // crates.io requires a descriptive User-Agent per https://crates.io/data-access
-        resp = await fetch(url, { headers: { 'user-agent': UA, accept: 'application/json' } });
-    }
-    catch (err) {
-        throw new CommandExecutionError(
-            `${label} request failed: ${err?.message ?? err}`,
-            'Check that crates.io is reachable from this network.',
-        );
-    }
-    if (resp.status === 404) {
-        throw new EmptyResultError(label, `crates.io returned 404 for ${url}.`);
-    }
-    if (resp.status === 429) {
-        throw new CommandExecutionError(
-            `${label} returned HTTP 429 (rate limited)`,
-            'crates.io rate-limits 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;
-}
+import{ArgumentError as H,CommandExecutionError as J,EmptyResultError as K}from"@jackwener/opencli/errors";export const CRATES_BASE="https://crates.io";const L="opencli-crates-adapter (+https://github.com/jackwener/opencli)",O=/^[A-Za-z][A-Za-z0-9_-]{0,63}$/;export function requireString(D,z){const B=String(D??"").trim();if(!B)throw new H(`crates ${z} cannot be empty`);return B}export function requireCrateName(D){const z=String(D??"").trim();if(!z)throw new H('crates crate name is required (e.g. "serde", "tokio")');if(!O.test(z))throw new H(`crates crate name "${D}" is not a valid crates.io name`,'Names start with an ASCII letter, then 0-63 chars of letters / digits / "_-".');return z}export function requireBoundedInt(D,z,B,G="limit"){const F=D??z,I=typeof F==="number"?F:Number(F);if(!Number.isInteger(I)||I<=0)throw new H(`crates ${G} must be a positive integer`);if(I>B)throw new H(`crates ${G} must be <= ${B}`);return I}export async function cratesFetch(D,z){let B;try{B=await fetch(D,{headers:{"user-agent":L,accept:"application/json"}})}catch(F){throw new J(`${z} request failed: ${F?.message??F}`,"Check that crates.io is reachable from this network.")}if(B.status===404)throw new K(z,`crates.io returned 404 for ${D}.`);if(B.status===429)throw new J(`${z} returned HTTP 429 (rate limited)`,"crates.io rate-limits unauthenticated traffic; wait a few seconds and retry.");if(!B.ok)throw new J(`${z} returned HTTP ${B.status}`);let G;try{G=await B.json()}catch(F){throw new J(`${z} returned malformed JSON: ${F?.message??F}`)}return G}