@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/moegirl/web.js

@@ -0,0 +1,269 @@
+/**
+ * @owner   src/adapters/moegirl/web.ts
+ * @does    Register Moegirl public search, page reading, and article link extraction commands.
+ * @needs   Moegirl public OpenSearch endpoint and rendered MediaWiki HTML.
+ * @feeds   ACG entity discovery, character disambiguation, and wiki-backed content research.
+ * @breaks  Moegirl skin/template markup drift can reduce page and link extraction quality.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const ORIGIN = "https://zh.moegirl.org.cn";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function decodeHtml(value) {
+    return decodeHtmlEntities(value).replace(/\s+/g, " ").trim();
+}
+function decodeHtmlText(value) {
+    return decodeHtmlEntities(value)
+        .replace(/[ \t\f\v]+/g, " ")
+        .replace(/\n[ \t]+/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+function decodeHtmlEntities(value) {
+    return str(value)
+        .replace(/&#(\d+);/g, (_m, code) => String.fromCodePoint(Number(code)))
+        .replace(/&#x([0-9a-f]+);/gi, (_m, code) => String.fromCodePoint(Number.parseInt(code, 16)))
+        .replace(/ /g, " ")
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#039;/g, "'")
+        .replace(/&#39;/g, "'");
+}
+function requireText(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`moegirl ${label} cannot be empty.`);
+    return text;
+}
+function requireLimit(value, fallback = 10) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 50) {
+        throw new Error("moegirl limit must be an integer in [1, 50].");
+    }
+    return n;
+}
+function requireParagraphCap(value) {
+    if (value === undefined || value === null || value === "")
+        return 0;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 0 || n > 100) {
+        throw new Error("moegirl paragraphs must be an integer in [0, 100].");
+    }
+    return n;
+}
+function articleUrl(title) {
+    return `${ORIGIN}/${encodeURIComponent(title.replace(/ /g, "_"))}`;
+}
+async function fetchJson(url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`moegirl request failed with HTTP ${response.status}.`);
+    }
+    return response.json();
+}
+async function fetchText(url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "text/html,application/xhtml+xml",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`moegirl request failed with HTTP ${response.status}.`);
+    }
+    return response.text();
+}
+export function mapMoegirlOpenSearch(data, limit) {
+    if (!Array.isArray(data) ||
+        !Array.isArray(data[1]) ||
+        !Array.isArray(data[3])) {
+        throw new Error("moegirl OpenSearch response shape changed.");
+    }
+    const titles = data[1];
+    const descriptions = Array.isArray(data[2]) ? data[2] : [];
+    const urls = data[3];
+    return titles.slice(0, limit).map((title, index) => ({
+        rank: index + 1,
+        title: str(title),
+        description: str(descriptions[index]),
+        url: str(urls[index]),
+    }));
+}
+function firstMatch(value, re) {
+    const match = value.match(re);
+    return match ? decodeHtml(match[1]) : "";
+}
+function bodyHtml(html) {
+    return (firstRawMatch(html, /<template id="MOE_SKIN_TEMPLATE_BODYCONTENT">([\s\S]*?)<\/template>/) ||
+        firstRawMatch(html, /<div[^>]+class="[^"]*\bmw-parser-output\b[^"]*"[^>]*>([\s\S]*?)<\/div>\s*<\/div>/) ||
+        html);
+}
+function firstRawMatch(value, re) {
+    const match = value.match(re);
+    return match ? match[1] : "";
+}
+function cleanArticleText(html) {
+    return decodeHtmlText(bodyHtml(html)
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<sup[\s\S]*?<\/sup>/gi, " ")
+        .replace(/<\/(?:p|li|h[1-6]|tr)>/gi, "\n\n")
+        .replace(/<(?:br|div)\b[^>]*>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\n\s+/g, "\n")
+        .replace(/\n{3,}/g, "\n\n"));
+}
+export function parseMoegirlPageHtml(html, requestedTitle, paragraphCap) {
+    const pageTitle = firstMatch(html, /<title>([^<]+?)(?: - 萌娘百科[^<]*)?<\/title>/) ||
+        firstMatch(html, /<meta property="og:title" content="(?:&lt;[^&]+&gt;)?([^"<]+)(?:&lt;\/[^&]+&gt;)?"/) ||
+        requestedTitle;
+    const title = requestedTitle.includes("(") ? requestedTitle : pageTitle;
+    const description = firstMatch(html, /<meta name="description" content="([^"]*)"/) ||
+        firstMatch(html, /<meta property="og:description" content="([^"]*)"/);
+    const url = firstMatch(html, /<link rel="canonical" href="([^"]+)"/) ||
+        articleUrl(title);
+    const categories = [...html.matchAll(/"wgCategories":\[(.*?)\]/g)][0]?.[1]
+        ?.split(",")
+        .map((item) => decodeHtml(item.replace(/^"|"$/g, "")))
+        .filter(Boolean);
+    const text = cleanArticleText(html);
+    if (!text) {
+        throw new Error(`Moegirl article "${requestedTitle}" has no readable text.`);
+    }
+    const paragraphs = text
+        .split(/\n+/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const selected = paragraphCap > 0 ? paragraphs.slice(0, paragraphCap) : paragraphs;
+    return {
+        title,
+        description,
+        categories: categories ?? [],
+        paragraphs: selected.length,
+        extract: selected.join("\n\n"),
+        url,
+    };
+}
+export function parseMoegirlLinksHtml(html, limit, contains) {
+    const rows = [];
+    const seen = new Set();
+    const needle = contains.trim();
+    for (const match of bodyHtml(html).matchAll(/<a\b(?=[^>]*\bhref="([^"]+)")(?=[^>]*\btitle="([^"]+)")[^>]*>/g)) {
+        const href = decodeHtml(match[1]);
+        const title = decodeHtml(match[2]);
+        if (!href.startsWith("/") || href.includes("redlink=1"))
+            continue;
+        if (title.includes("页面不存在"))
+            continue;
+        if (needle && !title.includes(needle))
+            continue;
+        const key = `${title}\n${href}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        rows.push({
+            rank: rows.length + 1,
+            title,
+            url: `${ORIGIN}${href}`,
+        });
+        if (rows.length >= limit)
+            break;
+    }
+    return rows;
+}
+cli({
+    site: "moegirl",
+    name: "search",
+    description: "Search Moegirl ACG wiki articles for characters, works, songs, games, and studios",
+    domain: "zh.moegirl.org.cn",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "query", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 10 },
+    ],
+    columns: ["rank", "title", "description", "url"],
+    func: async (_page, kwargs) => {
+        const query = requireText(kwargs.query, "query");
+        const limit = requireLimit(kwargs.limit);
+        const url = new URL(`${ORIGIN}/api.php`);
+        url.searchParams.set("action", "opensearch");
+        url.searchParams.set("search", query);
+        url.searchParams.set("limit", String(limit));
+        url.searchParams.set("namespace", "0");
+        url.searchParams.set("format", "json");
+        const rows = mapMoegirlOpenSearch(await fetchJson(url.toString()), limit);
+        if (rows.length === 0)
+            throw new Error(`No Moegirl pages found for "${query}".`);
+        return rows;
+    },
+});
+cli({
+    site: "moegirl",
+    name: "page",
+    description: "Read a Moegirl article as plain text with metadata",
+    domain: "zh.moegirl.org.cn",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "title", type: "str", required: true, positional: true },
+        {
+            name: "paragraphs",
+            type: "int",
+            default: 0,
+            description: "Paragraph cap, 0 means full",
+        },
+    ],
+    columns: [
+        "title",
+        "description",
+        "categories",
+        "paragraphs",
+        "extract",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const title = requireText(kwargs.title, "title");
+        const paragraphCap = requireParagraphCap(kwargs.paragraphs);
+        return [
+            parseMoegirlPageHtml(await fetchText(articleUrl(title)), title, paragraphCap),
+        ];
+    },
+});
+cli({
+    site: "moegirl",
+    name: "links",
+    description: "Extract internal Moegirl article links from a page, useful for disambiguation pages",
+    domain: "zh.moegirl.org.cn",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: "title", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+        {
+            name: "contains",
+            type: "str",
+            description: "Only return links whose title contains this text",
+        },
+    ],
+    columns: ["rank", "title", "url"],
+    func: async (_page, kwargs) => {
+        const title = requireText(kwargs.title, "title");
+        const rows = parseMoegirlLinksHtml(await fetchText(articleUrl(title)), requireLimit(kwargs.limit), str(kwargs.contains));
+        if (rows.length === 0)
+            throw new Error(`No Moegirl links found on "${title}".`);
+        return rows;
+    },
+});
+//# sourceMappingURL=web.js.map

package/dist/adapters/moegirl/web.js.map

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

package/dist/adapters/npm/package.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @owner   src/adapters/npm/package.ts
+ * @does    Register agent-facing npm single-package metadata command.
+ * @needs   registry.npmjs.org public package documents.
+ * @feeds   surface coverage ledger, JavaScript package inspection, registry command surface.
+ * @breaks  npm registry document drift or weak scoped-name parsing hides package metadata failures.
+ */
+interface NpmPackageVersion {
+    description?: unknown;
+    license?: unknown;
+    homepage?: unknown;
+    repository?: unknown;
+    bugs?: unknown;
+    keywords?: unknown;
+}
+interface NpmPackageBody {
+    name?: unknown;
+    description?: unknown;
+    "dist-tags"?: {
+        latest?: unknown;
+    };
+    versions?: Record<string, NpmPackageVersion>;
+    maintainers?: unknown;
+    time?: {
+        created?: unknown;
+        modified?: unknown;
+    };
+}
+export declare function requireNpmPackageName(value: unknown): string;
+export declare function mapNpmPackageRow(body: NpmPackageBody, requested: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=package.d.ts.map

package/dist/adapters/npm/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/adapters/npm/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,iBAAiB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAClD;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU5D;AAyCD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCzB"}

package/dist/adapters/npm/package.js

@@ -0,0 +1,141 @@
+/**
+ * @owner   src/adapters/npm/package.ts
+ * @does    Register agent-facing npm single-package metadata command.
+ * @needs   registry.npmjs.org public package documents.
+ * @feeds   surface coverage ledger, JavaScript package inspection, registry command surface.
+ * @breaks  npm registry document drift or weak scoped-name parsing hides package metadata failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const NPM_REGISTRY = "https://registry.npmjs.org";
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function requireNpmPackageName(value) {
+    const name = String(value ?? "").trim();
+    if (!name)
+        throw new Error("npm package name is required.");
+    if (!/^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i.test(name) ||
+        name.includes("..")) {
+        throw new Error(`npm package name "${String(value)}" is not valid.`);
+    }
+    return name;
+}
+function repoUrl(repo) {
+    if (typeof repo === "string")
+        return repo.replace(/^git\+/, "").replace(/\.git$/, "");
+    if (repo &&
+        typeof repo === "object" &&
+        typeof repo.url === "string") {
+        return repo.url
+            .replace(/^git\+/, "")
+            .replace(/\.git$/, "");
+    }
+    return "";
+}
+function bugUrl(bugs) {
+    if (typeof bugs === "string")
+        return bugs;
+    if (bugs &&
+        typeof bugs === "object" &&
+        typeof bugs.url === "string") {
+        return bugs.url;
+    }
+    return "";
+}
+function licenseText(license) {
+    if (typeof license === "string")
+        return license.trim();
+    if (license &&
+        typeof license === "object" &&
+        typeof license.type === "string") {
+        return license.type.trim();
+    }
+    return "";
+}
+export function mapNpmPackageRow(body, requested) {
+    const latest = stringField(body["dist-tags"]?.latest);
+    if (!latest) {
+        throw new Error(`npm registry has no latest version for "${requested}".`);
+    }
+    const version = body.versions?.[latest] ?? {};
+    const name = stringField(body.name) || requested;
+    const maintainers = Array.isArray(body.maintainers)
+        ? body.maintainers
+            .map((item) => {
+            if (item && typeof item === "object") {
+                const rec = item;
+                return stringField(rec.name) || stringField(rec.email);
+            }
+            return String(item ?? "").trim();
+        })
+            .filter(Boolean)
+            .join(", ")
+        : "";
+    const keywords = Array.isArray(version.keywords)
+        ? version.keywords.map(stringField).filter(Boolean).join(", ")
+        : "";
+    return {
+        name,
+        latestVersion: latest,
+        description: stringField(version.description) || stringField(body.description),
+        license: licenseText(version.license),
+        homepage: stringField(version.homepage),
+        repository: repoUrl(version.repository),
+        bugs: bugUrl(version.bugs),
+        maintainers,
+        keywords,
+        created: stringField(body.time?.created).slice(0, 10),
+        modified: stringField(body.time?.modified).slice(0, 10),
+        url: `https://www.npmjs.com/package/${encodeURIComponent(name)}`,
+    };
+}
+async function fetchNpmJson(name) {
+    const path = name.split("/").map(encodeURIComponent).join("/");
+    const response = await fetch(`${NPM_REGISTRY}/${path}`, {
+        headers: {
+            "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`npm package ${name} returned no result.`);
+    if (!response.ok)
+        throw new Error(`npm package ${name} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "npm",
+    name: "package",
+    description: "Single npm package metadata",
+    domain: "registry.npmjs.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "name",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "npm package name",
+        },
+    ],
+    columns: [
+        "name",
+        "latestVersion",
+        "description",
+        "license",
+        "homepage",
+        "repository",
+        "bugs",
+        "maintainers",
+        "keywords",
+        "created",
+        "modified",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const name = requireNpmPackageName(kwargs.name);
+        const body = (await fetchNpmJson(name));
+        return [mapNpmPackageRow(body, name)];
+    },
+});
+//# sourceMappingURL=package.js.map

package/dist/adapters/npm/package.js.map

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

package/dist/adapters/nuget/package.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @owner   src/adapters/nuget/package.ts
+ * @does    Register agent-facing NuGet package version-history command.
+ * @needs   api.nuget.org registration index and leaf-page pagination.
+ * @feeds   surface coverage ledger, .NET dependency inspection, registry command surface.
+ * @breaks  NuGet registration stubs or malformed catalog entries hide package release history.
+ */
+interface NugetCatalogEntry {
+    id?: unknown;
+    version?: unknown;
+    title?: unknown;
+    authors?: unknown;
+    tags?: unknown;
+    language?: unknown;
+    licenseExpression?: unknown;
+    projectUrl?: unknown;
+    published?: unknown;
+    listed?: unknown;
+}
+interface NugetRegistrationItem {
+    catalogEntry?: NugetCatalogEntry;
+}
+interface NugetRegistrationPage {
+    "@id"?: unknown;
+    items?: NugetRegistrationItem[];
+}
+interface NugetRegistrationBody {
+    items?: NugetRegistrationPage[];
+}
+export declare function requireNugetPackageId(value: unknown): string;
+export declare function collectNugetEntries(body: NugetRegistrationBody, fetchLeaf: (url: string) => Promise<NugetRegistrationPage>): Promise<NugetRegistrationItem[]>;
+export declare function mapNugetPackageRows(entries: NugetRegistrationItem[], requested: string): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=package.d.ts.map

package/dist/adapters/nuget/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/adapters/nuget/package.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,iBAAiB;IACzB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM5D;AAcD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,qBAAqB,EAC3B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,GACzD,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA4BlC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAAE,EAChC,SAAS,EAAE,MAAM,GAChB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiChC"}

package/dist/adapters/nuget/package.js

@@ -0,0 +1,135 @@
+/**
+ * @owner   src/adapters/nuget/package.ts
+ * @does    Register agent-facing NuGet package version-history command.
+ * @needs   api.nuget.org registration index and leaf-page pagination.
+ * @feeds   surface coverage ledger, .NET dependency inspection, registry command surface.
+ * @breaks  NuGet registration stubs or malformed catalog entries hide package release history.
+ */
+import { cli, Strategy } from "../../registry.js";
+const NUGET_REGISTRATION_BASE = "https://api.nuget.org/v3/registration5-semver1";
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function requireNugetPackageId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id)) {
+        throw new Error("nuget package id must be a non-empty package token.");
+    }
+    return id;
+}
+function joinAuthors(value) {
+    return Array.isArray(value)
+        ? value.map(stringField).filter(Boolean).join(", ")
+        : stringField(value);
+}
+function joinTags(value) {
+    return Array.isArray(value)
+        ? value.map(stringField).filter(Boolean).join(", ")
+        : stringField(value);
+}
+export async function collectNugetEntries(body, fetchLeaf) {
+    const pages = Array.isArray(body.items) ? body.items : [];
+    const entries = [];
+    for (const [index, page] of pages.entries()) {
+        let pageItems = Array.isArray(page.items) ? page.items : null;
+        if (!pageItems) {
+            const url = stringField(page["@id"]);
+            if (!url) {
+                throw new Error(`nuget package registration page ${index + 1} is missing @id.`);
+            }
+            const leaf = await fetchLeaf(url);
+            if (!Array.isArray(leaf.items)) {
+                throw new Error(`nuget package registration leaf has no items array.`);
+            }
+            pageItems = leaf.items;
+        }
+        for (const item of pageItems) {
+            if (!item?.catalogEntry || typeof item.catalogEntry !== "object") {
+                throw new Error(`nuget package registration page ${index + 1} has a malformed version entry.`);
+            }
+            entries.push(item);
+        }
+    }
+    return entries;
+}
+export function mapNugetPackageRows(entries, requested) {
+    if (entries.length === 0) {
+        throw new Error(`No published versions found for NuGet package "${requested}".`);
+    }
+    const sorted = [...entries].sort((a, b) => {
+        const ap = stringField(a.catalogEntry?.published);
+        const bp = stringField(b.catalogEntry?.published);
+        if (ap !== bp)
+            return bp.localeCompare(ap);
+        return stringField(b.catalogEntry?.version).localeCompare(stringField(a.catalogEntry?.version));
+    });
+    return sorted.map((entry, index) => {
+        const cat = entry.catalogEntry ?? {};
+        const id = stringField(cat.id) || requested;
+        const version = stringField(cat.version);
+        return {
+            rank: index + 1,
+            id,
+            version,
+            title: stringField(cat.title),
+            authors: joinAuthors(cat.authors),
+            tags: joinTags(cat.tags),
+            language: stringField(cat.language),
+            licenseExpression: stringField(cat.licenseExpression),
+            projectUrl: stringField(cat.projectUrl),
+            published: stringField(cat.published),
+            listed: typeof cat.listed === "boolean" ? cat.listed : null,
+            url: version ? `https://www.nuget.org/packages/${id}/${version}` : "",
+        };
+    });
+}
+async function fetchNugetJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "nuget",
+    name: "package",
+    description: "Full NuGet package version history",
+    domain: "api.nuget.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "NuGet package id",
+        },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "version",
+        "title",
+        "authors",
+        "tags",
+        "language",
+        "licenseExpression",
+        "projectUrl",
+        "published",
+        "listed",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireNugetPackageId(kwargs.id);
+        const body = (await fetchNugetJson(`${NUGET_REGISTRATION_BASE}/${encodeURIComponent(id.toLowerCase())}/index.json`, `nuget package ${id}`));
+        const entries = await collectNugetEntries(body, async (url) => (await fetchNugetJson(url, "nuget package page")));
+        return mapNugetPackageRows(entries, id);
+    },
+});
+//# sourceMappingURL=package.js.map

package/dist/adapters/nuget/package.js.map

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