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

package/clis/facebook/notifications.js

@@ -1,244 +1,4 @@
-// Facebook notifications — pulls the rendered notification feed from
-// `www.facebook.com/notifications` via in-page DOM walk.
-//
-// Replaces the legacy `pipeline:[]` form. The previous adapter had four
-// overlapping silent failures the new shape resolves:
-//   1. silent-bad-shape — `text.substring(0, 150)` truncated long
-//      notification bodies without telling the caller.
-//   2. silent-bad-shape — the old time field used a dash sentinel for
-//      unknown values; typed unknown should be `null` so an agent caller
-//      does not have to learn in-band sentinel strings.
-//   3. silent-column-drop — the IIFE saw the `<div>未读</div>` /
-//      `<div>Unread</div>` badge child and the anchor's `<a href>` URL
-//      but kept neither, so callers got a bare text blob with no way
-//      to follow up on a notification.
-//   4. silent-empty-row — empty `[role="listitem"]` (login expired,
-//      empty inbox, FB redirected to `/login`) returned `[]` instead
-//      of throwing a typed error.
-//
-// New behavior:
-//   - `func` form + `Strategy.COOKIE` + `browser:true`.
-//   - Upfront `--limit` validation: positive integer in [1, 100], no
-//     silent clamp; `ArgumentError` on bad input.
-//   - Pure extractor `extractNotificationRowsFromDoc` is a Node-side
-//     export — JSDOM-against-frozen-fixture tests call it directly while
-//     the live IIFE embeds it via `${fn.toString()}` (mirrors hupu
-//     #1387 / xiaoe #1388 / dianping #1313 pattern). Helpers
-//     `stripMarkAsReadPrefix`, `stripAnchorChrome`, `parseNotifQuery`
-//     are also pure exports for the same reason.
-//   - Seven columns instead of three:
-//       index, unread (bool), text (full, no truncation),
-//       time (string|null), url (string), notif_id (string|null),
-//       notif_type (string|null)
-//   - Auth detection: if the IIFE runs while window.location is on a
-//     login / checkpoint path, throw `AUTH_REQUIRED:` sentinel which
-//     the Node side maps to `AuthRequiredError`.
-//   - Empty list (after settle + auth check passes) → `EmptyResultError`,
-//     never silent `[]`.
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    AuthRequiredError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-
-export const FB_HOST = 'https://www.facebook.com';
-export const NOTIFICATIONS_LIMIT_DEFAULT = 15;
-export const NOTIFICATIONS_LIMIT_MAX = 100;
-
-// Locale-specific "Mark as read" button prefixes Facebook attaches to
-// the per-row mark-as-read action. We use this to recover the bare
-// notification body text without the leading "未读" / "Unread" badge or
-// the trailing time-ago suffix that the anchor's textContent contains.
-//
-// Each entry must be a complete, deterministic prefix — no regex — so a
-// rare false-positive substring match elsewhere on the page does not
-// silently truncate body text.
-export const MARK_AS_READ_PREFIXES = [
-    '标记为已读，',
-    'Mark as read, ',
-    'Mark as Read, ',
-    'Marquer comme lu, ',
-    'Marcar como leído, ',
-    '既読にする, ',
-];
-
-// Localised "unread" badge labels that appear inside a `<div>` inside
-// the notification listitem. Used to set the typed `unread` boolean.
-export const UNREAD_BADGE_LABELS = ['未读', 'Unread', 'No leído', '未読'];
-
-export function normalizeNotificationsLimit(raw) {
-    if (raw === undefined || raw === null || raw === '') {
-        return NOTIFICATIONS_LIMIT_DEFAULT;
-    }
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1 || n > NOTIFICATIONS_LIMIT_MAX) {
-        throw new ArgumentError(
-            `--limit must be a positive integer in [1, ${NOTIFICATIONS_LIMIT_MAX}], got ${JSON.stringify(raw)}`,
-        );
-    }
-    return n;
-}
-
-// Pure: strip a Facebook locale-specific "mark as read" prefix from a
-// `<div role="button">` aria-label so the caller gets the bare body
-// text. Returns the stripped body, or `null` when the input does not
-// start with a known prefix (i.e. we do not have a mark-as-read
-// aria-label and the caller should fall through to anchor text).
-//
-// `prefixes` is injected so the same function works in JSDOM tests
-// (passed the imported `MARK_AS_READ_PREFIXES`) and in the live IIFE
-// (the array is inlined into the embedded script via `JSON.stringify`).
-export function stripMarkAsReadPrefix(label, prefixes) {
-    if (!label) return null;
-    const text = String(label).trim();
-    if (!text) return null;
-    for (let i = 0; i < prefixes.length; i += 1) {
-        const p = prefixes[i];
-        if (text.startsWith(p)) return text.slice(p.length).trim();
-    }
-    return null;
-}
-
-// Pure: strip the leading "未读" / "Unread" badge prefix and the trailing
-// time-ago suffix (e.g. "2天" / "5 hrs") from the rendered text of a
-// notification anchor. Used as a fallback when the mark-as-read
-// aria-label is not present (already-read rows).
-//
-// `badges` is the localized unread-badge labels list; `timeStr` is the
-// trailing time string previously extracted from `<abbr>` (or `null`).
-// Trailing `.` / `。` that Facebook inserts between body and time are
-// also stripped — but only at the very end, never mid-text.
-export function stripAnchorChrome(rawText, timeStr, badges) {
-    if (!rawText) return '';
-    let text = String(rawText).trim();
-    for (let i = 0; i < badges.length; i += 1) {
-        const b = badges[i];
-        if (text.startsWith(b)) {
-            text = text.slice(b.length).trim();
-            break;
-        }
-    }
-    if (timeStr) {
-        const t = String(timeStr).trim();
-        if (t && text.endsWith(t)) {
-            text = text.slice(0, text.length - t.length).trim();
-        }
-    }
-    text = text.replace(/[.。]+$/, '').trim();
-    return text;
-}
-
-// Pure: extract `notif_id` and `notif_t` query params from a
-// notification anchor href. Both fields stay `null` when absent so the
-// caller can detect "this row has no canonical notif handle" (rare,
-// but happens for some notification types FB inlines a non-canonical
-// URL for) — never an in-band sentinel.
-export function parseNotifQuery(rawHref, fbHost) {
-    const out = { notif_id: null, notif_type: null };
-    if (!rawHref) return out;
-    let url;
-    try {
-        url = new URL(rawHref, fbHost);
-    } catch (_) {
-        return out;
-    }
-    out.notif_id = url.searchParams.get('notif_id') || null;
-    out.notif_type = url.searchParams.get('notif_t') || null;
-    return out;
-}
-
-export function isFacebookAuthRedirectPath(pathname) {
-    return /^\/(?:login|checkpoint)(?:\.php)?(?:\/|$)/i.test(String(pathname || ''));
-}
-
-// Pure extractor: walks `[role="listitem"]` containers in `doc` and
-// returns at most `limit` notification rows. Header listitems (those
-// without an `<a href>` child — e.g. the "新通知" / "Earlier" section
-// heading FB inserts at the top of the feed) are skipped.
-//
-// `helpers` carries the four pure helpers as positional refs so the
-// same function works in JSDOM (test imports them) and in the live
-// IIFE (embeds them via `${fn.toString()}`):
-//   { stripMark, stripChrome, parseQuery, fbHost,
-//     markPrefixes, unreadBadges }
-export function extractNotificationRowsFromDoc(doc, limit, helpers) {
-    const out = [];
-    const items = doc.querySelectorAll('[role="listitem"]');
-    for (let i = 0; i < items.length && out.length < limit; i += 1) {
-        const item = items[i];
-        const anchor = item.querySelector('a[href]');
-        if (!anchor) continue;
-        const href = anchor.href || anchor.getAttribute('href') || '';
-        if (!href) continue;
-
-        const abbr = item.querySelector('abbr');
-        const time = abbr ? ((abbr.textContent || '').trim() || null) : null;
-
-        // Unread badge: prefer the explicit `<div>未读</div>` /
-        // `<div>Unread</div>` child; fall back to anchor text prefix.
-        let unread = false;
-        const allDivs = item.querySelectorAll('div');
-        for (let j = 0; j < allDivs.length; j += 1) {
-            const t = (allDivs[j].textContent || '').trim();
-            if (helpers.unreadBadges.indexOf(t) !== -1) {
-                unread = true;
-                break;
-            }
-        }
-        if (!unread) {
-            const anchorText = (anchor.textContent || '').trim();
-            for (let k = 0; k < helpers.unreadBadges.length; k += 1) {
-                if (anchorText.startsWith(helpers.unreadBadges[k])) {
-                    unread = true;
-                    break;
-                }
-            }
-        }
-
-        // Body text — try every aria-label on descendants, take the
-        // first one that the mark-as-read prefix helper recognises.
-        // Fall back to the anchor's own textContent with badge / time
-        // / trailing punctuation chrome stripped.
-        let text = null;
-        const labelHosts = item.querySelectorAll('[aria-label]');
-        for (let k = 0; k < labelHosts.length; k += 1) {
-            const label = labelHosts[k].getAttribute('aria-label');
-            const stripped = helpers.stripMark(label, helpers.markPrefixes);
-            if (stripped !== null) {
-                const cleaned = stripped.replace(/[.。]+$/, '').trim();
-                text = cleaned || null;
-                break;
-            }
-        }
-        if (!text) {
-            const fallback = helpers.stripChrome(
-                anchor.textContent || '',
-                time,
-                helpers.unreadBadges,
-            );
-            text = fallback || null;
-        }
-        if (!text) continue;
-
-        const { notif_id, notif_type } = helpers.parseQuery(href, helpers.fbHost);
-        out.push({
-            index: out.length + 1,
-            unread,
-            text,
-            time,
-            url: href,
-            notif_id,
-            notif_type,
-        });
-    }
-    return out;
-}
-
-export function buildNotificationsScript(limit) {
-    return `
+import{cli as H,Strategy as L}from"@jackwener/opencli/registry";import{ArgumentError as M,AuthRequiredError as k,CommandExecutionError as C,EmptyResultError as O}from"@jackwener/opencli/errors";export const FB_HOST="https://www.facebook.com",NOTIFICATIONS_LIMIT_DEFAULT=15,NOTIFICATIONS_LIMIT_MAX=100,MARK_AS_READ_PREFIXES=["标记为已读，","Mark as read, ","Mark as Read, ","Marquer comme lu, ","Marcar como leído, ","既読にする, "],UNREAD_BADGE_LABELS=["未读","Unread","No leído","未読"];export function normalizeNotificationsLimit(V){if(V===void 0||V===null||V==="")return NOTIFICATIONS_LIMIT_DEFAULT;const Z=typeof V==="number"?V:Number(V);if(!Number.isFinite(Z)||!Number.isInteger(Z)||Z<1||Z>NOTIFICATIONS_LIMIT_MAX)throw new M(`--limit must be a positive integer in [1, ${NOTIFICATIONS_LIMIT_MAX}], got ${JSON.stringify(V)}`);return Z}export function stripMarkAsReadPrefix(V,Z){if(!V)return null;const W=String(V).trim();if(!W)return null;for(let J=0;J<Z.length;J+=1){const Y=Z[J];if(W.startsWith(Y))return W.slice(Y.length).trim()}return null}export function stripAnchorChrome(V,Z,W){if(!V)return"";let J=String(V).trim();for(let Y=0;Y<W.length;Y+=1){const $=W[Y];if(J.startsWith($)){J=J.slice($.length).trim();break}}if(Z){const Y=String(Z).trim();if(Y&&J.endsWith(Y))J=J.slice(0,J.length-Y.length).trim()}J=J.replace(/[.。]+$/,"").trim();return J}export function parseNotifQuery(V,Z){const W={notif_id:null,notif_type:null};if(!V)return W;let J;try{J=new URL(V,Z)}catch(Y){return W}W.notif_id=J.searchParams.get("notif_id")||null;W.notif_type=J.searchParams.get("notif_t")||null;return W}export function isFacebookAuthRedirectPath(V){return/^\/(?:login|checkpoint)(?:\.php)?(?:\/|$)/i.test(String(V||""))}export function extractNotificationRowsFromDoc(V,Z,W){const J=[],Y=V.querySelectorAll('[role="listitem"]');for(let $=0;$<Y.length&&J.length<Z;$+=1){const Q=Y[$],G=Q.querySelector("a[href]");if(!G)continue;const P=G.href||G.getAttribute("href")||"";if(!P)continue;const U=Q.querySelector("abbr"),B=U?(U.textContent||"").trim()||null:null;let v=!1;const X=Q.querySelectorAll("div");for(let q=0;q<X.length;q+=1){const z=(X[q].textContent||"").trim();if(W.unreadBadges.indexOf(z)!==-1){v=!0;break}}if(!v){const q=(G.textContent||"").trim();for(let z=0;z<W.unreadBadges.length;z+=1)if(q.startsWith(W.unreadBadges[z])){v=!0;break}}let K=null;const j=Q.querySelectorAll("[aria-label]");for(let q=0;q<j.length;q+=1){const z=j[q].getAttribute("aria-label"),y=W.stripMark(z,W.markPrefixes);if(y!==null){K=y.replace(/[.。]+$/,"").trim()||null;break}}if(!K)K=W.stripChrome(G.textContent||"",B,W.unreadBadges)||null;if(!K)continue;const{notif_id:D,notif_type:R}=W.parseQuery(P,W.fbHost);J.push({index:J.length+1,unread:v,text:K,time:B,url:P,notif_id:D,notif_type:R})}return J}export function buildNotificationsScript(V){return`
 (async () => {
   const FB_HOST = ${JSON.stringify(FB_HOST)};
   const MARK_AS_READ_PREFIXES = ${JSON.stringify(MARK_AS_READ_PREFIXES)};
@@ -259,7 +19,7 @@ export function buildNotificationsScript(limit) {
   while (document.querySelectorAll('[role="listitem"]').length === 0 && Date.now() - start < 8000) {
     await new Promise(function(r) { setTimeout(r, 200); });
   }
-  return extractNotificationRowsFromDoc(document, ${JSON.stringify(limit)}, {
+  return extractNotificationRowsFromDoc(document, ${JSON.stringify(V)}, {
     stripMark: stripMarkAsReadPrefix,
     stripChrome: stripAnchorChrome,
     parseQuery: parseNotifQuery,
@@ -268,66 +28,4 @@ export function buildNotificationsScript(limit) {
     unreadBadges: UNREAD_BADGE_LABELS,
   });
 })()
-`;
-}
-
-async function getFacebookNotifications(page, args) {
-    const limit = normalizeNotificationsLimit(args.limit);
-    try {
-        await page.goto(`${FB_HOST}/notifications`, { waitUntil: 'load', settleMs: 3000 });
-    } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new CommandExecutionError(
-            `Failed to navigate to facebook notifications: ${message}`,
-            'facebook.com may be unreachable',
-        );
-    }
-    let rows;
-    try {
-        rows = await page.evaluate(buildNotificationsScript(limit));
-    } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (/AUTH_REQUIRED/i.test(message)) {
-            throw new AuthRequiredError(
-                'facebook.com',
-                'Open Chrome and log in to Facebook before retrying',
-            );
-        }
-        throw new CommandExecutionError(
-            `Failed to read facebook notifications: ${message}`,
-            'facebook.com page may not have rendered or markup may have changed',
-        );
-    }
-    if (!Array.isArray(rows) || rows.length === 0) {
-        throw new EmptyResultError(
-            'facebook/notifications',
-            'No notifications found — login session may have expired or you have no recent notifications',
-        );
-    }
-    return rows;
-}
-
-export const notificationsCommand = cli({
-    site: 'facebook',
-    name: 'notifications',
-    access: 'read',
-    description: 'Get recent Facebook notifications (含 unread / time / url / notif_id / notif_type 列)',
-    domain: 'www.facebook.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        {
-            name: 'limit',
-            type: 'int',
-            default: NOTIFICATIONS_LIMIT_DEFAULT,
-            help: `Number of notifications (1-${NOTIFICATIONS_LIMIT_MAX})`,
-        },
-    ],
-    columns: ['index', 'unread', 'text', 'time', 'url', 'notif_id', 'notif_type'],
-    func: getFacebookNotifications,
-});
-
-export const __test__ = {
-    buildNotificationsScript,
-};
+`}async function F(V,Z){const W=normalizeNotificationsLimit(Z.limit);try{await V.goto(`${FB_HOST}/notifications`,{waitUntil:"load",settleMs:3000})}catch(Y){const $=Y instanceof Error?Y.message:String(Y);throw new C(`Failed to navigate to facebook notifications: ${$}`,"facebook.com may be unreachable")}let J;try{J=await V.evaluate(buildNotificationsScript(W))}catch(Y){const $=Y instanceof Error?Y.message:String(Y);if(/AUTH_REQUIRED/i.test($))throw new k("facebook.com","Open Chrome and log in to Facebook before retrying");throw new C(`Failed to read facebook notifications: ${$}`,"facebook.com page may not have rendered or markup may have changed")}if(!Array.isArray(J)||J.length===0)throw new O("facebook/notifications","No notifications found — login session may have expired or you have no recent notifications");return J}export const notificationsCommand=H({site:"facebook",name:"notifications",access:"read",description:"Get recent Facebook notifications (含 unread / time / url / notif_id / notif_type 列)",domain:"www.facebook.com",strategy:L.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:NOTIFICATIONS_LIMIT_DEFAULT,help:`Number of notifications (1-${NOTIFICATIONS_LIMIT_MAX})`}],columns:["index","unread","text","time","url","notif_id","notif_type"],func:F}),__test__={buildNotificationsScript};

package/clis/facebook/profile.js

@@ -1,22 +1,4 @@
-import { cli } from '@jackwener/opencli/registry';
-cli({
-    site: 'facebook',
-    name: 'profile',
-    access: 'read',
-    description: 'Get Facebook user/page profile info',
-    domain: 'www.facebook.com',
-    args: [
-        {
-            name: 'username',
-            required: true,
-            positional: true,
-            help: 'Facebook username or page name',
-        },
-    ],
-    columns: ['name', 'username', 'friends', 'followers', 'url'],
-    pipeline: [
-        { navigate: { url: 'https://www.facebook.com/${{ args.username }}', settleMs: 3000 } },
-        { evaluate: `(() => {
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"profile",access:"read",description:"Get Facebook user/page profile info",domain:"www.facebook.com",args:[{name:"username",required:!0,positional:!0,help:"Facebook username or page name"}],columns:["name","username","friends","followers","url"],pipeline:[{navigate:{url:"https://www.facebook.com/${{ args.username }}",settleMs:3000}},{evaluate:`(() => {
   const h1 = document.querySelector('h1');
   let name = h1 ? h1.textContent.trim() : '';
 
@@ -33,6 +15,4 @@ cli({
     url: window.location.href,
   }];
 })()
-` },
-    ],
-});
+`}]});

package/clis/facebook/search.js

@@ -1,19 +1,4 @@
-import { cli } from '@jackwener/opencli/registry';
-cli({
-    site: 'facebook',
-    name: 'search',
-    access: 'read',
-    description: 'Search Facebook for people, pages, or posts',
-    domain: 'www.facebook.com',
-    args: [
-        { name: 'query', required: true, positional: true, help: 'Search query' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of results' },
-    ],
-    columns: ['index', 'title', 'text', 'url'],
-    pipeline: [
-        { navigate: 'https://www.facebook.com' },
-        { navigate: { url: 'https://www.facebook.com/search/top?q=${{ args.query | urlencode }}', settleMs: 4000 } },
-        { evaluate: `(async () => {
+import{cli as e}from"@jackwener/opencli/registry";e({site:"facebook",name:"search",access:"read",description:"Search Facebook for people, pages, or posts",domain:"www.facebook.com",args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results"}],columns:["index","title","text","url"],pipeline:[{navigate:"https://www.facebook.com"},{navigate:{url:"https://www.facebook.com/search/top?q=${{ args.query | urlencode }}",settleMs:4000}},{evaluate:`(async () => {
   const limit = \${{ args.limit }};
   // Search results are typically in role="article" or role="listitem"
   let items = document.querySelectorAll('[role="article"]');
@@ -34,6 +19,4 @@ cli({
       };
     });
 })()
-` },
-    ],
-});
+`}]});

package/clis/flathub/app.js

@@ -1,71 +1 @@
-// flathub app — full appstream metadata for a Flathub app id.
-//
-// Hits `/api/v2/appstream/<appId>`. AppStream IDs are reverse-DNS (e.g.
-// "org.mozilla.firefox", "org.gnome.Calculator").
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    FLATHUB_API_BASE,
-    FLATHUB_APP_BASE,
-    flathubFetch,
-    joinList,
-    pickLatestRelease,
-    requireAppId,
-} from './utils.js';
-
-cli({
-    site: 'flathub',
-    name: 'app',
-    access: 'read',
-    description: 'Full Flathub appstream metadata for an app id (license, categories, latest release)',
-    domain: 'flathub.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'appId', positional: true, required: true, help: 'AppStream id (e.g. "org.mozilla.firefox", "org.gnome.Calculator")' },
-    ],
-    columns: [
-        'appId',
-        'name',
-        'summary',
-        'developer',
-        'license',
-        'isFreeLicense',
-        'isEol',
-        'categories',
-        'keywords',
-        'latestVersion',
-        'latestReleaseDate',
-        'homepage',
-        'bugtracker',
-        'donation',
-        'url',
-    ],
-    func: async (args) => {
-        const appId = requireAppId(args.appId);
-        const url = `${FLATHUB_API_BASE}/appstream/${encodeURIComponent(appId)}`;
-        const body = await flathubFetch(url, 'flathub app');
-        if (!body || typeof body !== 'object' || !body.id) {
-            throw new EmptyResultError('flathub app', `Flathub app "${appId}" returned empty payload.`);
-        }
-        const urls = body.urls && typeof body.urls === 'object' ? body.urls : {};
-        const release = pickLatestRelease(body.releases);
-        return [{
-            appId: typeof body.id === 'string' ? body.id : appId,
-            name: typeof body.name === 'string' ? body.name : null,
-            summary: typeof body.summary === 'string' ? body.summary : null,
-            developer: typeof body.developer_name === 'string' ? body.developer_name : null,
-            license: typeof body.project_license === 'string' ? body.project_license : null,
-            isFreeLicense: body.is_free_license === true,
-            isEol: body.is_eol === true,
-            categories: joinList(body.categories),
-            keywords: joinList(body.keywords, 8),
-            latestVersion: release.version,
-            latestReleaseDate: release.date,
-            homepage: typeof urls.homepage === 'string' ? urls.homepage : null,
-            bugtracker: typeof urls.bugtracker === 'string' ? urls.bugtracker : null,
-            donation: typeof urls.donation === 'string' ? urls.donation : null,
-            url: `${FLATHUB_APP_BASE}/${appId}`,
-        }];
-    },
-});
+import{cli as p,Strategy as n}from"@jackwener/opencli/registry";import{EmptyResultError as i}from"@jackwener/opencli/errors";import{FLATHUB_API_BASE as u,FLATHUB_APP_BASE as m,flathubFetch as c,joinList as o,pickLatestRelease as d,requireAppId as g}from"./utils.js";p({site:"flathub",name:"app",access:"read",description:"Full Flathub appstream metadata for an app id (license, categories, latest release)",domain:"flathub.org",strategy:n.PUBLIC,browser:!1,args:[{name:"appId",positional:!0,required:!0,help:'AppStream id (e.g. "org.mozilla.firefox", "org.gnome.Calculator")'}],columns:["appId","name","summary","developer","license","isFreeLicense","isEol","categories","keywords","latestVersion","latestReleaseDate","homepage","bugtracker","donation","url"],func:async(s)=>{const t=g(s.appId),l=`${u}/appstream/${encodeURIComponent(t)}`,e=await c(l,"flathub app");if(!e||typeof e!=="object"||!e.id)throw new i("flathub app",`Flathub app "${t}" returned empty payload.`);const a=e.urls&&typeof e.urls==="object"?e.urls:{},r=d(e.releases);return[{appId:typeof e.id==="string"?e.id:t,name:typeof e.name==="string"?e.name:null,summary:typeof e.summary==="string"?e.summary:null,developer:typeof e.developer_name==="string"?e.developer_name:null,license:typeof e.project_license==="string"?e.project_license:null,isFreeLicense:e.is_free_license===!0,isEol:e.is_eol===!0,categories:o(e.categories),keywords:o(e.keywords,8),latestVersion:r.version,latestReleaseDate:r.date,homepage:typeof a.homepage==="string"?a.homepage:null,bugtracker:typeof a.bugtracker==="string"?a.bugtracker:null,donation:typeof a.donation==="string"?a.donation:null,url:`${m}/${t}`}]}});

package/clis/flathub/search.js

@@ -1,80 +1 @@
-// flathub search — keyword search the Flathub app registry.
-//
-// POSTs to `/api/v2/search` with `{query}`. The `appId` column round-trips into
-// `flathub app` for full appstream detail. Note: the search hit's `id` is
-// underscored (e.g. `org_mozilla_firefox`); the actual reverse-DNS appId lives
-// at `app_id`. We surface the dotted form so it round-trips without translation.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import {
-    FLATHUB_API_BASE,
-    FLATHUB_APP_BASE,
-    flathubFetch,
-    joinList,
-    requireBoundedInt,
-    requireString,
-} from './utils.js';
-
-cli({
-    site: 'flathub',
-    name: 'search',
-    access: 'read',
-    description: 'Search Flathub apps by keyword',
-    domain: 'flathub.org',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 25, help: 'Max apps (1-100)' },
-    ],
-    columns: [
-        'rank',
-        'appId',
-        'name',
-        'summary',
-        'developer',
-        'license',
-        'isFreeLicense',
-        'mainCategories',
-        'installsLastMonth',
-        'updatedAt',
-        'url',
-    ],
-    func: async (args) => {
-        const query = requireString(args.query, 'query');
-        const limit = requireBoundedInt(args.limit, 25, 100);
-        const url = `${FLATHUB_API_BASE}/search`;
-        const body = await flathubFetch(url, 'flathub search', {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify({ query, hitsPerPage: limit, page: 1 }),
-        });
-        const list = Array.isArray(body?.hits) ? body.hits : [];
-        if (!list.length) {
-            throw new EmptyResultError('flathub search', `No Flathub apps matched "${query}".`);
-        }
-        return list.slice(0, limit).map((hit, i) => {
-            const appId = typeof hit?.app_id === 'string' ? hit.app_id : null;
-            return {
-                rank: i + 1,
-                appId,
-                name: typeof hit?.name === 'string' ? hit.name : null,
-                summary: typeof hit?.summary === 'string' ? hit.summary : null,
-                developer: typeof hit?.developer_name === 'string' ? hit.developer_name : null,
-                license: typeof hit?.project_license === 'string' ? hit.project_license : null,
-                isFreeLicense: hit?.is_free_license === true,
-                // `main_categories` comes back as a string (single value) on /search, not an array.
-                mainCategories: typeof hit?.main_categories === 'string'
-                    ? hit.main_categories
-                    : joinList(hit?.main_categories),
-                installsLastMonth: typeof hit?.installs_last_month === 'number' ? hit.installs_last_month : null,
-                // /search emits `updated_at` as unix-seconds int; /appstream emits ISO strings.
-                // Normalise to ISO date here so both surfaces look consistent.
-                updatedAt: typeof hit?.updated_at === 'number' && hit.updated_at > 0
-                    ? new Date(hit.updated_at * 1000).toISOString().slice(0, 10)
-                    : (typeof hit?.updated_at === 'string' ? hit.updated_at : null),
-                url: appId ? `${FLATHUB_APP_BASE}/${appId}` : '',
-            };
-        });
-    },
-});
+import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{EmptyResultError as W}from"@jackwener/opencli/errors";import{FLATHUB_API_BASE as X,FLATHUB_APP_BASE as Y,flathubFetch as Z,joinList as $,requireBoundedInt as N,requireString as O}from"./utils.js";Q({site:"flathub",name:"search",access:"read",description:"Search Flathub apps by keyword",domain:"flathub.org",strategy:V.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:25,help:"Max apps (1-100)"}],columns:["rank","appId","name","summary","developer","license","isFreeLicense","mainCategories","installsLastMonth","updatedAt","url"],func:async(z)=>{const C=O(z.query,"query"),D=N(z.limit,25,100),K=`${X}/search`,G=await Z(K,"flathub search",{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({query:C,hitsPerPage:D,page:1})}),J=Array.isArray(G?.hits)?G.hits:[];if(!J.length)throw new W("flathub search",`No Flathub apps matched "${C}".`);return J.slice(0,D).map((v,M)=>{const x=typeof v?.app_id==="string"?v.app_id:null;return{rank:M+1,appId:x,name:typeof v?.name==="string"?v.name:null,summary:typeof v?.summary==="string"?v.summary:null,developer:typeof v?.developer_name==="string"?v.developer_name:null,license:typeof v?.project_license==="string"?v.project_license:null,isFreeLicense:v?.is_free_license===!0,mainCategories:typeof v?.main_categories==="string"?v.main_categories:$(v?.main_categories),installsLastMonth:typeof v?.installs_last_month==="number"?v.installs_last_month:null,updatedAt:typeof v?.updated_at==="number"&&v.updated_at>0?new Date(v.updated_at*1000).toISOString().slice(0,10):typeof v?.updated_at==="string"?v.updated_at:null,url:x?`${Y}/${x}`:""}})}});