@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/endoflife/product.js

@@ -0,0 +1,113 @@
+/**
+ * @owner   src/adapters/endoflife/product.ts
+ * @does    Register agent-facing endoflife.date product lifecycle command.
+ * @needs   endoflife.date public API, product slug validation, date/flag normalization.
+ * @feeds   surface coverage ledger, product support lifecycle rows, version planning data.
+ * @breaks  endoflife.date API drift, weak slug validation, or silent empty rows hide lifecycle data failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://endoflife.date/api";
+const PRODUCT_RE = /^[a-z0-9][a-z0-9._-]{0,79}$/;
+export function requireEndoflifeProduct(value) {
+    const product = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (!product)
+        throw new Error("endoflife product cannot be empty.");
+    if (!PRODUCT_RE.test(product)) {
+        throw new Error(`endoflife product "${String(value)}" is not a valid slug.`);
+    }
+    return product;
+}
+export function normalizeEndoflifeDateOrFlag(value) {
+    if (value === true)
+        return "ongoing";
+    if (value === false || value == null)
+        return null;
+    if (typeof value !== "string")
+        return null;
+    const text = value.trim();
+    return text || null;
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function mapEndoflifeRows(product, cycles, today) {
+    return cycles.map((cycle) => {
+        const eol = normalizeEndoflifeDateOrFlag(cycle.eol);
+        const eolStatus = eol === "ongoing"
+            ? "ongoing"
+            : typeof eol === "string" && eol >= today
+                ? "active"
+                : typeof eol === "string"
+                    ? "eol"
+                    : null;
+        return {
+            product,
+            cycle: stringField(cycle.cycle),
+            releaseDate: stringField(cycle.releaseDate),
+            latest: stringField(cycle.latest),
+            latestReleaseDate: stringField(cycle.latestReleaseDate),
+            lts: normalizeEndoflifeDateOrFlag(cycle.lts),
+            support: normalizeEndoflifeDateOrFlag(cycle.support),
+            eol,
+            extendedSupport: normalizeEndoflifeDateOrFlag(cycle.extendedSupport),
+            eolStatus,
+            url: `https://endoflife.date/${product}`,
+        };
+    });
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-endoflife (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "endoflife",
+    name: "product",
+    description: "Release cycles and support dates for an endoflife.date product",
+    domain: "endoflife.date",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "product",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "endoflife.date product slug",
+        },
+    ],
+    columns: [
+        "product",
+        "cycle",
+        "releaseDate",
+        "latest",
+        "latestReleaseDate",
+        "lts",
+        "support",
+        "eol",
+        "extendedSupport",
+        "eolStatus",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const product = requireEndoflifeProduct(kwargs.product);
+        const body = await fetchJson(`${API_BASE}/${encodeURIComponent(product)}.json`, "endoflife product");
+        const rows = mapEndoflifeRows(product, Array.isArray(body) ? body : [], new Date().toISOString().slice(0, 10));
+        if (rows.length === 0) {
+            throw new Error(`endoflife product returned no cycles for "${product}".`);
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=product.js.map

package/dist/adapters/endoflife/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../../src/adapters/endoflife/product.ts"],"names":[],"mappings":"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"}

package/dist/adapters/facebook/marketplace-extra.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   src/adapters/facebook/marketplace-extra.ts
+ * @does    Register agent-facing Facebook Marketplace seller listings and inbox readers.
+ * @needs   Logged-in www.facebook.com browser session with Marketplace access.
+ * @feeds   surface coverage ledger and Marketplace selling/conversation workflows.
+ * @breaks  Facebook Marketplace DOM text changes, login redirects, or unavailable Marketplace account access.
+ */
+export declare function requireFacebookMarketplaceLimit(value: unknown): number;
+//# sourceMappingURL=marketplace-extra.d.ts.map

package/dist/adapters/facebook/marketplace-extra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-extra.d.ts","sourceRoot":"","sources":["../../../src/adapters/facebook/marketplace-extra.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAStE"}

package/dist/adapters/facebook/marketplace-extra.js

@@ -0,0 +1,170 @@
+/**
+ * @owner   src/adapters/facebook/marketplace-extra.ts
+ * @does    Register agent-facing Facebook Marketplace seller listings and inbox readers.
+ * @needs   Logged-in www.facebook.com browser session with Marketplace access.
+ * @feeds   surface coverage ledger and Marketplace selling/conversation workflows.
+ * @breaks  Facebook Marketplace DOM text changes, login redirects, or unavailable Marketplace account access.
+ */
+import { cli, Strategy } from "../../registry.js";
+export function requireFacebookMarketplaceLimit(value) {
+    const limit = Number(value ?? 20);
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error("Facebook Marketplace limit must be a positive integer.");
+    }
+    if (limit > 100) {
+        throw new Error("Facebook Marketplace limit must be <= 100.");
+    }
+    return limit;
+}
+function requireBrowserPage(page, command) {
+    if (!page || typeof page !== "object") {
+        throw new Error(`Browser session required for facebook ${command}.`);
+    }
+    return page;
+}
+function text(value) {
+    return value == null ? "" : String(value);
+}
+function readRows(result, command) {
+    if (result?.authRequired) {
+        throw new Error(`Facebook Marketplace ${command} requires an active signed-in Facebook session.`);
+    }
+    const rows = Array.isArray(result?.rows) ? result.rows : [];
+    if (!rows.length) {
+        throw new Error(`No Facebook Marketplace ${command} rows were visible. Check Marketplace access for this account.`);
+    }
+    return rows;
+}
+function marketplaceListingsScript() {
+    return String.raw `(() => {
+    const clean = (value) => String(value || '').replace(/\u00a0/g, ' ').replace(/\s+/g, ' ').trim();
+    const allText = document.body?.innerText || '';
+    if (/log in|sign in/i.test(allText) && !/Marketplace/i.test(allText)) {
+      return { authRequired: true, rows: [] };
+    }
+    const lines = allText.split(/\n+/).map(clean).filter(Boolean);
+    const seen = new Set();
+    const rows = [];
+    for (let index = 1; index < lines.length; index += 1) {
+      if (!/^(?:CA\$|\$)\s*\d+/.test(lines[index])) continue;
+      const title = lines[index - 1];
+      if (!title || /^(Hide|All listings|Needs attention|Marketplace|Selling)$/i.test(title)) continue;
+      if (seen.has(title)) continue;
+      seen.add(title);
+      const windowLines = lines.slice(index, index + 12);
+      const status = windowLines.find((line) => /^(Active|Sold|Pending|Draft)$/i.test(line)) || '';
+      const listed = windowLines.find((line) => /Listed on\b/i.test(line))?.replace(/^·\s*/, '') || '';
+      const clickLine = windowLines.find((line) => /clicks? on listing/i.test(line)) || '';
+      const clickMatch = clickLine.match(/([\d,.]+)\s+clicks? on listing/i);
+      const actions = windowLines.filter((line) => /^(Mark as sold|Mark as available|Relist this item|Share|Boost listing)$/i.test(line));
+      rows.push({
+        title,
+        price: lines[index],
+        status,
+        listed,
+        clicks: clickMatch ? clickMatch[1] : '',
+        actions,
+      });
+    }
+    return { authRequired: false, rows };
+  })()`;
+}
+function marketplaceInboxScript() {
+    return String.raw `(() => {
+    const clean = (value) => String(value || '').replace(/[\u00a0\u202f]/g, ' ').replace(/\s+/g, ' ').trim();
+    const timeRe = /^(?:\d{1,2}:\d{2}\s?(?:AM|PM|am|pm|上午|下午)?|Mon|Tue|Wed|Thu|Fri|Sat|Sun|Today|Yesterday|\d+[mhdw]|\d+\s*(?:min|h|d|w))$/;
+    const allText = document.body?.innerText || '';
+    if (/log in|sign in/i.test(allText) && !/Marketplace/i.test(allText)) {
+      return { authRequired: true, rows: [] };
+    }
+    const lines = allText.split(/\n+/).map(clean).filter(Boolean);
+    const rows = [];
+    const seen = new Set();
+    const skipBuyer = /^(Marketplace|Browse all|Notifications|Inbox|Marketplace access|Buying|Selling|Create new listing|Create multiple listings|Location|Categories|Vehicles|Property Rentals|All|Pending payment|Paid|To be shipped|Shipped|Cash on delivery|Completed|Filter by label)$/i;
+    for (let index = 0; index < lines.length - 2; index += 1) {
+      const buyer = lines[index];
+      const meta = lines[index + 1];
+      if (skipBuyer.test(buyer) || !/^·\s+/.test(meta)) continue;
+      const listing = meta.replace(/^·\s*/, '');
+      if (!listing || /^Within\b/i.test(listing)) continue;
+      const snippet = lines[index + 2] || '';
+      const time = timeRe.test(lines[index + 3] || '') ? lines[index + 3] : '';
+      const key = buyer + '|' + listing;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      const nearby = lines.slice(Math.max(0, index - 2), index + 5).join(' ');
+      rows.push({
+        buyer,
+        listing,
+        snippet,
+        time,
+        unread: /Unread/i.test(nearby),
+      });
+    }
+    return { authRequired: false, rows };
+  })()`;
+}
+cli({
+    site: "facebook",
+    name: "marketplace-listings",
+    description: "List your Facebook Marketplace seller listings",
+    domain: "www.facebook.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "limit", type: "int", default: 20 }],
+    columns: ["index", "title", "price", "status", "listed", "clicks", "actions"],
+    func: async (page, kwargs) => {
+        const p = requireBrowserPage(page, "marketplace-listings");
+        const limit = requireFacebookMarketplaceLimit(kwargs.limit);
+        await p.goto("https://www.facebook.com/marketplace/you/selling/");
+        await p.wait(4);
+        const result = (await p.evaluate(marketplaceListingsScript()));
+        return readRows(result, "seller listings")
+            .slice(0, limit)
+            .map((item, index) => {
+            const row = item;
+            return {
+                index: index + 1,
+                title: text(row.title),
+                price: text(row.price),
+                status: text(row.status),
+                listed: text(row.listed),
+                clicks: text(row.clicks),
+                actions: Array.isArray(row.actions)
+                    ? row.actions.map(text).join(", ")
+                    : text(row.actions),
+            };
+        });
+    },
+});
+cli({
+    site: "facebook",
+    name: "marketplace-inbox",
+    description: "List recent Facebook Marketplace buyer and seller conversations",
+    domain: "www.facebook.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "limit", type: "int", default: 20 }],
+    columns: ["index", "buyer", "listing", "snippet", "time", "unread"],
+    func: async (page, kwargs) => {
+        const p = requireBrowserPage(page, "marketplace-inbox");
+        const limit = requireFacebookMarketplaceLimit(kwargs.limit);
+        await p.goto("https://www.facebook.com/marketplace/inbox/");
+        await p.wait(4);
+        const result = (await p.evaluate(marketplaceInboxScript()));
+        return readRows(result, "inbox conversations")
+            .slice(0, limit)
+            .map((item, index) => {
+            const row = item;
+            return {
+                index: index + 1,
+                buyer: text(row.buyer),
+                listing: text(row.listing),
+                snippet: text(row.snippet),
+                time: text(row.time),
+                unread: Boolean(row.unread),
+            };
+        });
+    },
+});
+//# sourceMappingURL=marketplace-extra.js.map

package/dist/adapters/facebook/marketplace-extra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-extra.js","sourceRoot":"","sources":["../../../src/adapters/facebook/marketplace-extra.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAyBlD,MAAM,UAAU,+BAA+B,CAAC,KAAc;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa,EAAE,OAAe;IACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAa,CAAC;AACvB,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CACf,MAAiC,EACjC,OAAe;IAEf,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,iDAAiD,CACjF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,gEAAgE,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BZ,CAAC;AACR,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCZ,CAAC;AACR,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,gDAAgD;IAC7D,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;IAC7E,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,+BAA+B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAC9B,yBAAyB,EAAE,CAC5B,CAA8B,CAAC;QAChC,OAAO,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,IAA6B,CAAC;YAC1C,OAAO;gBACL,KAAK,EAAE,KAAK,GAAG,CAAC;gBAChB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACtB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBACxB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBACxB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;oBACjC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;aACtB,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,iEAAiE;IACnE,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACnD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC;IACnE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,+BAA+B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAC9B,sBAAsB,EAAE,CACzB,CAA8B,CAAC;QAChC,OAAO,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnB,MAAM,GAAG,GAAG,IAA2B,CAAC;YACxC,OAAO;gBACL,KAAK,EAAE,KAAK,GAAG,CAAC;gBAChB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBACtB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBACpB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;aAC5B,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/flathub/apps.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @owner   src/adapters/flathub/apps.ts
+ * @does    Register agent-facing Flathub app search and detail commands.
+ * @needs   Flathub public API, AppStream id validation, bounded search limits.
+ * @feeds   surface coverage ledger, Linux app registry search rows, appstream metadata rows.
+ * @breaks  Flathub API drift, weak app id validation, or silent empty rows hide app registry data.
+ */
+export declare function requireFlathubLimit(value: unknown): number;
+export declare function requireFlathubAppId(value: unknown): string;
+export declare function joinFlathubList(value: unknown, max?: number): string;
+export declare function pickLatestFlathubRelease(value: unknown): {
+    date: string | null;
+    version: string | null;
+};
+export declare function mapFlathubSearchRows(hits: Array<Record<string, unknown>>, limit: number): Array<Record<string, unknown>>;
+export declare function mapFlathubAppRow(appId: string, body: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=apps.d.ts.map

package/dist/adapters/flathub/apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../../src/adapters/flathub/apps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO1D;AAsBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,MAAM,CAMhE;AASD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG;IACxD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAWA;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAmBhC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}

package/dist/adapters/flathub/apps.js

@@ -0,0 +1,220 @@
+/**
+ * @owner   src/adapters/flathub/apps.ts
+ * @does    Register agent-facing Flathub app search and detail commands.
+ * @needs   Flathub public API, AppStream id validation, bounded search limits.
+ * @feeds   surface coverage ledger, Linux app registry search rows, appstream metadata rows.
+ * @breaks  Flathub API drift, weak app id validation, or silent empty rows hide app registry data.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://flathub.org/api/v2";
+const APP_BASE = "https://flathub.org/apps";
+const APP_ID_RE = /^[A-Za-z][A-Za-z0-9_-]*(?:\.[A-Za-z0-9_][A-Za-z0-9_-]*){1,}$/;
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`flathub ${label} cannot be empty.`);
+    return text;
+}
+export function requireFlathubLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 25 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+        throw new Error("flathub limit must be an integer in [1, 100].");
+    }
+    return limit;
+}
+export function requireFlathubAppId(value) {
+    const id = String(value ?? "").trim();
+    if (!id)
+        throw new Error("flathub appId cannot be empty.");
+    if (!APP_ID_RE.test(id)) {
+        throw new Error(`flathub appId "${String(value)}" is not valid.`);
+    }
+    return id;
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+export function joinFlathubList(value, max = 10) {
+    if (!Array.isArray(value))
+        return "";
+    const items = value.filter((item) => typeof item === "string" && item.trim());
+    return items.length > max
+        ? [...items.slice(0, max), `(+${items.length - max})`].join(", ")
+        : items.join(", ");
+}
+function timestampToDate(value) {
+    const n = numberField(value);
+    if (n == null || n <= 0)
+        return null;
+    const date = new Date(n * 1000);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString().slice(0, 10);
+}
+export function pickLatestFlathubRelease(value) {
+    if (!Array.isArray(value))
+        return { date: null, version: null };
+    const releases = [...value].sort((a, b) => (numberField(b.timestamp) ?? 0) - (numberField(a.timestamp) ?? 0));
+    const latest = releases[0];
+    if (!latest)
+        return { date: null, version: null };
+    return {
+        version: stringField(latest.version) || null,
+        date: timestampToDate(latest.timestamp) ?? stringField(latest.date) ?? null,
+    };
+}
+export function mapFlathubSearchRows(hits, limit) {
+    return hits.slice(0, limit).map((hit, index) => {
+        const appId = stringField(hit.app_id);
+        return {
+            rank: index + 1,
+            appId,
+            name: stringField(hit.name),
+            summary: stringField(hit.summary),
+            developer: stringField(hit.developer_name),
+            license: stringField(hit.project_license),
+            isFreeLicense: hit.is_free_license === true,
+            mainCategories: stringField(hit.main_categories) ||
+                joinFlathubList(hit.main_categories),
+            installsLastMonth: numberField(hit.installs_last_month),
+            updatedAt: timestampToDate(hit.updated_at) ?? stringField(hit.updated_at),
+            url: appId ? `${APP_BASE}/${appId}` : "",
+        };
+    });
+}
+export function mapFlathubAppRow(appId, body) {
+    const urls = objectField(body.urls);
+    const release = pickLatestFlathubRelease(body.releases);
+    return {
+        appId: stringField(body.id) || appId,
+        name: stringField(body.name),
+        summary: stringField(body.summary),
+        developer: stringField(body.developer_name),
+        license: stringField(body.project_license),
+        isFreeLicense: body.is_free_license === true,
+        isEol: body.is_eol === true,
+        categories: joinFlathubList(body.categories),
+        keywords: joinFlathubList(body.keywords, 8),
+        latestVersion: release.version,
+        latestReleaseDate: release.date,
+        homepage: stringField(urls.homepage) || null,
+        bugtracker: stringField(urls.bugtracker) || null,
+        donation: stringField(urls.donation) || null,
+        url: `${APP_BASE}/${appId}`,
+    };
+}
+async function fetchJson(url, label, init) {
+    const response = await fetch(url, {
+        ...init,
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-flathub (https://github.com/olo-dot-io/Uni-CLI)",
+            ...init?.headers,
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "flathub",
+    name: "search",
+    description: "Search Flathub apps by keyword",
+    domain: "flathub.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search keyword",
+        },
+        { name: "limit", type: "int", default: 25, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "appId",
+        "name",
+        "summary",
+        "developer",
+        "license",
+        "isFreeLicense",
+        "mainCategories",
+        "installsLastMonth",
+        "updatedAt",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const limit = requireFlathubLimit(kwargs.limit);
+        const body = (await fetchJson(`${API_BASE}/search`, "flathub search", {
+            body: JSON.stringify({ hitsPerPage: limit, page: 1, query }),
+            headers: { "content-type": "application/json" },
+            method: "POST",
+        }));
+        const rows = mapFlathubSearchRows(Array.isArray(body.hits)
+            ? body.hits
+            : [], limit);
+        if (rows.length === 0)
+            throw new Error(`flathub search returned no rows for "${query}".`);
+        return rows;
+    },
+});
+cli({
+    site: "flathub",
+    name: "app",
+    description: "Fetch full Flathub appstream metadata by app id",
+    domain: "flathub.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "appId",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "AppStream id",
+        },
+    ],
+    columns: [
+        "appId",
+        "name",
+        "summary",
+        "developer",
+        "license",
+        "isFreeLicense",
+        "isEol",
+        "categories",
+        "keywords",
+        "latestVersion",
+        "latestReleaseDate",
+        "homepage",
+        "bugtracker",
+        "donation",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const appId = requireFlathubAppId(kwargs.appId);
+        const body = objectField(await fetchJson(`${API_BASE}/appstream/${encodeURIComponent(appId)}`, "flathub app"));
+        if (!body.id)
+            throw new Error(`flathub app returned no row for "${appId}".`);
+        return [mapFlathubAppRow(appId, body)];
+    },
+});
+//# sourceMappingURL=apps.js.map

package/dist/adapters/flathub/apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../../../src/adapters/flathub/apps.ts"],"names":[],"mappings":"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"}

package/dist/adapters/goproxy/module.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @owner   src/adapters/goproxy/module.ts
+ * @does    Register agent-facing Go module proxy metadata and version commands.
+ * @needs   Public proxy.golang.org GOPROXY protocol, TypeScript adapter loader, Go module path validation.
+ * @feeds   surface coverage ledger, Go package registry command surface, agent-readable module rows.
+ * @breaks  GOPROXY protocol drift, weak module path validation, or silent empty rows hide module lookup failures.
+ */
+interface GoProxyLatest {
+    Version?: unknown;
+    Time?: unknown;
+    Origin?: {
+        VCS?: unknown;
+        URL?: unknown;
+        Hash?: unknown;
+        Ref?: unknown;
+    };
+}
+export declare function requireGoModulePath(value: unknown): string;
+export declare function requireGoProxyLimit(value: unknown, fallback?: number): number;
+export declare function sortGoVersionsDescending(versions: string[]): string[];
+export declare function mapGoProxyModuleRow(modulePath: string, detail: GoProxyLatest): Record<string, unknown>;
+export declare function mapGoProxyVersionRows(modulePath: string, versions: string[], limit: number): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/adapters/goproxy/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/adapters/goproxy/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAiBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CASzE;AAwDD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAIrE;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAehC"}