@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/maven/artifact.js

@@ -0,0 +1,121 @@
+/**
+ * @owner   src/adapters/maven/artifact.ts
+ * @does    Register agent-facing Maven Central artifact version history command.
+ * @needs   search.maven.org Solr gav core and coordinate validation.
+ * @feeds   surface coverage ledger, JVM dependency inspection, registry command surface.
+ * @breaks  Maven coordinate parsing or Solr envelope drift hides dependency versions.
+ */
+import { cli, Strategy } from "../../registry.js";
+const MAVEN_BASE = "https://search.maven.org/solrsearch/select";
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function epochMsToIso(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? new Date(value).toISOString()
+        : "";
+}
+export function requireMavenLimit(value, fallback) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 200) {
+        throw new Error(`limit must be an integer in [1, 200]. Got: ${String(value)}`);
+    }
+    return n;
+}
+export function parseMavenCoordinate(value) {
+    const coordinate = String(value ?? "").trim();
+    const parts = coordinate.split(":").map((part) => part.trim());
+    if (parts.length !== 2 && parts.length !== 3) {
+        throw new Error('coordinate must be "groupId:artifactId" or "groupId:artifactId:version".');
+    }
+    const [groupId, artifactId, version = ""] = parts;
+    if (!groupId || !artifactId) {
+        throw new Error("coordinate groupId and artifactId are required.");
+    }
+    return { groupId, artifactId, version };
+}
+export function mapMavenArtifactRows(body, coordinate) {
+    const docs = Array.isArray(body.response?.docs) ? body.response.docs : [];
+    if (docs.length === 0) {
+        const label = coordinate.version
+            ? `${coordinate.groupId}:${coordinate.artifactId}:${coordinate.version}`
+            : `${coordinate.groupId}:${coordinate.artifactId}`;
+        throw new Error(`Maven Central has no published versions for ${label}.`);
+    }
+    return docs.map((doc) => {
+        const version = stringField(doc.v);
+        return {
+            groupId: stringField(doc.g) || coordinate.groupId,
+            artifactId: stringField(doc.a) || coordinate.artifactId,
+            version,
+            packaging: stringField(doc.p),
+            publishedAt: epochMsToIso(doc.timestamp),
+            tags: Array.isArray(doc.tags)
+                ? doc.tags.map(stringField).filter(Boolean).join(", ")
+                : "",
+            url: version
+                ? `https://central.sonatype.com/artifact/${coordinate.groupId}/${coordinate.artifactId}/${version}`
+                : `https://central.sonatype.com/artifact/${coordinate.groupId}/${coordinate.artifactId}`,
+        };
+    });
+}
+async function fetchMavenJson(url) {
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": "unicli (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    if (!response.ok)
+        throw new Error(`maven artifact returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "maven",
+    name: "artifact",
+    description: "Fetch Maven Central artifact version history",
+    domain: "search.maven.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "coordinate",
+            type: "str",
+            required: true,
+            positional: true,
+            description: 'Maven coordinate "groupId:artifactId[:version]"',
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Max versions",
+        },
+    ],
+    columns: [
+        "groupId",
+        "artifactId",
+        "version",
+        "packaging",
+        "publishedAt",
+        "tags",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const coordinate = parseMavenCoordinate(kwargs.coordinate);
+        const limit = requireMavenLimit(kwargs.limit, 20);
+        const filters = [`g:${coordinate.groupId}`, `a:${coordinate.artifactId}`];
+        if (coordinate.version)
+            filters.push(`v:${coordinate.version}`);
+        const params = new URLSearchParams({
+            q: filters.join(" AND "),
+            core: "gav",
+            rows: String(coordinate.version ? 1 : limit),
+            wt: "json",
+        });
+        const body = (await fetchMavenJson(`${MAVEN_BASE}?${params.toString()}`));
+        return mapMavenArtifactRows(body, coordinate);
+    },
+});
+//# sourceMappingURL=artifact.js.map

package/dist/adapters/maven/artifact.js.map

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

package/dist/adapters/mdn/search.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @owner   src/adapters/mdn/search.ts
+ * @does    Register agent-facing MDN Web Docs search command.
+ * @needs   MDN public search API, bounded limits, locale allowlist.
+ * @feeds   surface coverage ledger, web-platform documentation search rows.
+ * @breaks  MDN API drift, weak locale validation, or silent empty rows hide documentation lookup failures.
+ */
+export declare function requireMdnLimit(value: unknown): number;
+export declare function requireMdnLocale(value: unknown): string;
+export declare function mapMdnRows(documents: Array<Record<string, unknown>>, limit: number, fallbackLocale: string): Array<Record<string, unknown>>;
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/mdn/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/mdn/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMvD;AAMD,wBAAgB,UAAU,CACxB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GACrB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYhC"}

package/dist/adapters/mdn/search.js

@@ -0,0 +1,115 @@
+/**
+ * @owner   src/adapters/mdn/search.ts
+ * @does    Register agent-facing MDN Web Docs search command.
+ * @needs   MDN public search API, bounded limits, locale allowlist.
+ * @feeds   surface coverage ledger, web-platform documentation search rows.
+ * @breaks  MDN API drift, weak locale validation, or silent empty rows hide documentation lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://developer.mozilla.org";
+const LOCALES = new Set([
+    "de",
+    "en-US",
+    "es",
+    "fr",
+    "ja",
+    "ko",
+    "pt-BR",
+    "ru",
+    "zh-CN",
+    "zh-TW",
+]);
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`mdn ${label} cannot be empty.`);
+    return text;
+}
+export function requireMdnLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 10 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+        throw new Error("mdn limit must be an integer in [1, 50].");
+    }
+    return limit;
+}
+export function requireMdnLocale(value) {
+    const locale = String(value ?? "en-US").trim();
+    if (!LOCALES.has(locale)) {
+        throw new Error(`mdn locale "${String(value)}" is not supported.`);
+    }
+    return locale;
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function mapMdnRows(documents, limit, fallbackLocale) {
+    return documents.slice(0, limit).map((doc, index) => {
+        const mdnUrl = stringField(doc.mdn_url);
+        return {
+            rank: index + 1,
+            title: stringField(doc.title),
+            slug: stringField(doc.slug),
+            locale: stringField(doc.locale) || fallbackLocale,
+            summary: stringField(doc.summary).replace(/\s+/g, " "),
+            url: mdnUrl ? `${API_BASE}${mdnUrl}` : "",
+        };
+    });
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-mdn (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: "mdn",
+    name: "search",
+    description: "Search MDN Web Docs by keyword",
+    domain: "developer.mozilla.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Search keyword",
+        },
+        { name: "limit", type: "int", default: 10, description: "Max rows" },
+        {
+            name: "locale",
+            type: "str",
+            default: "en-US",
+            description: "MDN locale",
+        },
+    ],
+    columns: ["rank", "title", "slug", "locale", "summary", "url"],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const limit = requireMdnLimit(kwargs.limit);
+        const locale = requireMdnLocale(kwargs.locale);
+        const url = new URL(`${API_BASE}/api/v1/search`);
+        url.searchParams.set("q", query);
+        url.searchParams.set("locale", locale);
+        url.searchParams.set("size", String(limit));
+        const body = (await fetchJson(url, "mdn search"));
+        const rows = mapMdnRows(Array.isArray(body.documents)
+            ? body.documents
+            : [], limit, locale);
+        if (rows.length === 0) {
+            throw new Error(`mdn search returned no rows for "${query}" (${locale}).`);
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/mdn/search.js.map

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

package/dist/adapters/medium/tag.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @owner   src/adapters/medium/tag.ts
+ * @does    Register agent-facing Medium tag RSS reader.
+ * @needs   Medium public tag RSS feed, strict tag slugs, bounded item parsing.
+ * @feeds   surface coverage ledger, Medium topical article discovery, RSS reading workflows.
+ * @breaks  Medium RSS shape drift or weak entity stripping degrades tag article rows.
+ */
+export declare function requireMediumTag(value: unknown): string;
+export declare function requireMediumLimit(value: unknown, fallback?: number): number;
+export declare function decodeMediumHtml(value: unknown): string;
+export declare function stripMediumHtml(value: unknown): string;
+export declare function mediumRssDate(value: unknown): string;
+export declare function extractMediumCategories(block: string): string[];
+export declare function parseMediumTagRss(xml: string, limit: number): Array<Record<string, unknown>>;
+//# sourceMappingURL=tag.d.ts.map

package/dist/adapters/medium/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/adapters/medium/tag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASvD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAUxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAavD;AAaD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAU/D;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBhC"}

package/dist/adapters/medium/tag.js

@@ -0,0 +1,148 @@
+/**
+ * @owner   src/adapters/medium/tag.ts
+ * @does    Register agent-facing Medium tag RSS reader.
+ * @needs   Medium public tag RSS feed, strict tag slugs, bounded item parsing.
+ * @feeds   surface coverage ledger, Medium topical article discovery, RSS reading workflows.
+ * @breaks  Medium RSS shape drift or weak entity stripping degrades tag article rows.
+ */
+import { cli, Strategy } from "../../registry.js";
+const MEDIUM_TAG_PATTERN = /^[a-z0-9][a-z0-9-]*$/i;
+const MEDIUM_TAG_LIMIT = 25;
+const HTML_ENTITIES = {
+    "&": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&apos;": "'",
+    "&#39;": "'",
+    "&nbsp;": " ",
+};
+export function requireMediumTag(value) {
+    const tag = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (!tag)
+        throw new Error("medium tag is required.");
+    if (!MEDIUM_TAG_PATTERN.test(tag)) {
+        throw new Error(`medium tag "${String(value)}" is not valid.`);
+    }
+    return tag;
+}
+export function requireMediumLimit(value, fallback = 20) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > MEDIUM_TAG_LIMIT) {
+        throw new Error(`medium limit must be an integer in [1, ${MEDIUM_TAG_LIMIT}].`);
+    }
+    return limit;
+}
+export function decodeMediumHtml(value) {
+    return String(value ?? "")
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => {
+        const code = Number.parseInt(hex, 16);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : "";
+    })
+        .replace(/&#(\d+);/g, (_, dec) => {
+        const code = Number.parseInt(dec, 10);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : "";
+    })
+        .replace(/&(amp|lt|gt|quot|apos|#39|nbsp);/g, (match) => {
+        return HTML_ENTITIES[match] ?? match;
+    });
+}
+function extractXmlTag(block, tag) {
+    const cdata = block.match(new RegExp(`<${tag}[^>]*>\\s*<!\\[CDATA\\[([\\s\\S]*?)\\]\\]>\\s*<\\/${tag}>`));
+    if (cdata)
+        return cdata[1] ?? "";
+    const plain = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`));
+    return plain?.[1] ?? "";
+}
+export function stripMediumHtml(value) {
+    return decodeMediumHtml(String(value ?? "").replace(/<[^>]+>/g, " "))
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function mediumRssDate(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        return "";
+    const date = new Date(raw);
+    return Number.isNaN(date.getTime()) ? "" : date.toISOString().slice(0, 10);
+}
+export function extractMediumCategories(block) {
+    const categories = [];
+    const re = /<category(?:[^>]*)>(?:<!\[CDATA\[([\s\S]*?)\]\]>|([\s\S]*?))<\/category>/g;
+    let match;
+    while ((match = re.exec(block)) !== null) {
+        const category = decodeMediumHtml((match[1] ?? match[2] ?? "").trim());
+        if (category)
+            categories.push(category);
+    }
+    return categories;
+}
+export function parseMediumTagRss(xml, limit) {
+    const items = [];
+    const re = /<item[^>]*>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = re.exec(xml)) !== null) {
+        if (match[1])
+            items.push(match[1]);
+    }
+    if (items.length === 0)
+        throw new Error("Medium tag RSS feed has no items.");
+    return items.slice(0, limit).map((block, index) => ({
+        rank: index + 1,
+        title: decodeMediumHtml(extractXmlTag(block, "title")).trim(),
+        author: decodeMediumHtml(extractXmlTag(block, "dc:creator")).trim(),
+        description: stripMediumHtml(extractXmlTag(block, "description")),
+        categories: extractMediumCategories(block).join(", "),
+        published: mediumRssDate(decodeMediumHtml(extractXmlTag(block, "pubDate"))),
+        url: decodeMediumHtml(extractXmlTag(block, "link")).trim(),
+    }));
+}
+async function fetchMediumTagRss(tag) {
+    const response = await fetch(`https://medium.com/feed/tag/${tag}`, {
+        headers: {
+            Accept: "application/rss+xml, application/xml",
+            "User-Agent": "unicli-medium/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`Medium tag "${tag}" does not exist.`);
+    if (!response.ok)
+        throw new Error(`Medium tag returned HTTP ${response.status}.`);
+    return response.text();
+}
+cli({
+    site: "medium",
+    name: "tag",
+    description: "Latest Medium articles tagged with a keyword from RSS",
+    domain: "medium.com",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "tag",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Medium tag slug",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max articles" },
+    ],
+    columns: [
+        "rank",
+        "title",
+        "author",
+        "description",
+        "categories",
+        "published",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const tag = requireMediumTag(kwargs.tag);
+        const limit = requireMediumLimit(kwargs.limit);
+        return parseMediumTagRss(await fetchMediumTagRss(tag), limit);
+    },
+});
+//# sourceMappingURL=tag.js.map

package/dist/adapters/medium/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../../src/adapters/medium/tag.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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"}