@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/lichess/players.js

@@ -0,0 +1,221 @@
+/**
+ * @owner   src/adapters/lichess/players.ts
+ * @does    Register agent-facing Lichess public user and leaderboard commands.
+ * @needs   lichess.org public JSON API, perf whitelist, bounded result limits.
+ * @feeds   surface coverage ledger, chess player lookup, leaderboard inspection.
+ * @breaks  Lichess API drift, weak handle validation, or silent disabled-account rows hide player state.
+ */
+import { cli, Strategy } from "../../registry.js";
+const LICHESS_BASE = "https://lichess.org";
+const PERFS = new Set([
+    "ultraBullet",
+    "bullet",
+    "blitz",
+    "rapid",
+    "classical",
+    "chess960",
+    "crazyhouse",
+    "antichess",
+    "atomic",
+    "horde",
+    "kingOfTheHill",
+    "racingKings",
+    "threeCheck",
+]);
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function boolField(value) {
+    return value === true;
+}
+export function requireLichessUsername(value) {
+    const username = String(value ?? "").trim();
+    if (!/^[A-Za-z0-9_-]{2,30}$/.test(username)) {
+        throw new Error("lichess username must be 2-30 letters, digits, underscores, or dashes.");
+    }
+    return username;
+}
+export function requireLichessPerf(value) {
+    const perf = String(value ?? "").trim();
+    if (!PERFS.has(perf)) {
+        throw new Error(`lichess perf must be one of: ${Array.from(PERFS).join(", ")}.`);
+    }
+    return perf;
+}
+export function requireLichessLimit(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].");
+    }
+    return n;
+}
+export function formatLichessTimestamp(value) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return null;
+    }
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+export function mapLichessTopRows(body, perf, limit) {
+    const users = Array.isArray(body.users) ? body.users : [];
+    if (users.length === 0) {
+        throw new Error(`Lichess returned no leaderboard rows for perf "${perf}".`);
+    }
+    return users.slice(0, limit).map((user, index) => {
+        const username = stringField(user.username);
+        const perfBlock = user.perfs?.[perf] ?? {};
+        return {
+            rank: index + 1,
+            username,
+            id: stringField(user.id) || null,
+            title: stringField(user.title) || null,
+            rating: numberField(perfBlock.rating),
+            progress: numberField(perfBlock.progress),
+            patron: boolField(user.patron),
+            url: username
+                ? `${LICHESS_BASE}/@/${encodeURIComponent(username)}/perf/${encodeURIComponent(perf)}`
+                : "",
+        };
+    });
+}
+export function mapLichessUserRow(body, requested) {
+    if (!body || typeof body !== "object") {
+        throw new Error(`Lichess user "${requested}" returned empty payload.`);
+    }
+    if (body.disabled === true) {
+        throw new Error(`Lichess user "${requested}" is closed or disabled.`);
+    }
+    const perfs = body.perfs ?? {};
+    const playable = Object.entries(perfs).filter(([name, perf]) => perf &&
+        typeof perf === "object" &&
+        !["puzzle", "storm", "racer", "streak"].includes(name));
+    let topPerfName = null;
+    let topPerfRating = null;
+    let topPerfGames = null;
+    for (const [name, perf] of playable) {
+        const games = numberField(perf.games) ?? 0;
+        if (topPerfGames === null || games > topPerfGames) {
+            topPerfName = name;
+            topPerfGames = games;
+            topPerfRating = numberField(perf.rating);
+        }
+    }
+    const username = stringField(body.username) || requested;
+    return {
+        username,
+        id: stringField(body.id) || null,
+        title: stringField(body.title) || null,
+        patron: boolField(body.patron),
+        online: boolField(body.online),
+        tosViolation: boolField(body.tosViolation),
+        createdAt: formatLichessTimestamp(body.createdAt),
+        seenAt: formatLichessTimestamp(body.seenAt),
+        gamesAll: numberField(body.count?.all),
+        gamesWin: numberField(body.count?.win),
+        gamesLoss: numberField(body.count?.loss),
+        gamesDraw: numberField(body.count?.draw),
+        topPerfName,
+        topPerfRating,
+        topPerfGames,
+        fideRating: numberField(body.profile?.fideRating),
+        country: stringField(body.profile?.country) || null,
+        bio: stringField(body.profile?.bio) || null,
+        url: `${LICHESS_BASE}/@/${encodeURIComponent(username)}`,
+    };
+}
+async function fetchLichessJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": "unicli-lichess/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/json",
+        },
+    });
+    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: "lichess",
+    name: "top",
+    description: "Top-N Lichess leaderboard for a perf type",
+    domain: "lichess.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "perf",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Perf type",
+        },
+        { name: "limit", type: "int", default: 10, description: "Top-N rows" },
+    ],
+    columns: [
+        "rank",
+        "username",
+        "id",
+        "title",
+        "rating",
+        "progress",
+        "patron",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const perf = requireLichessPerf(kwargs.perf);
+        const limit = requireLichessLimit(kwargs.limit, 10);
+        const body = (await fetchLichessJson(`${LICHESS_BASE}/api/player/top/${limit}/${encodeURIComponent(perf)}`, `lichess top ${perf}`));
+        return mapLichessTopRows(body, perf, limit);
+    },
+});
+cli({
+    site: "lichess",
+    name: "user",
+    description: "Fetch a public Lichess player profile by username",
+    domain: "lichess.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "username",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Lichess username",
+        },
+    ],
+    columns: [
+        "username",
+        "id",
+        "title",
+        "patron",
+        "online",
+        "tosViolation",
+        "createdAt",
+        "seenAt",
+        "gamesAll",
+        "gamesWin",
+        "gamesLoss",
+        "gamesDraw",
+        "topPerfName",
+        "topPerfRating",
+        "topPerfGames",
+        "fideRating",
+        "country",
+        "bio",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const username = requireLichessUsername(kwargs.username);
+        const body = (await fetchLichessJson(`${LICHESS_BASE}/api/user/${encodeURIComponent(username)}`, `lichess user ${username}`));
+        return [mapLichessUserRow(body, username)];
+    },
+});
+//# sourceMappingURL=players.js.map

package/dist/adapters/lichess/players.js.map

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

package/dist/adapters/lobsters/read-domain.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @owner   src/adapters/lobsters/read-domain.ts
+ * @does    Register agent-facing Lobsters read and domain commands.
+ * @needs   Public lobste.rs JSON endpoints, strict ids/domains, bounded comment tree rendering.
+ * @feeds   surface coverage ledger, Lobsters story readers, source-domain research workflows.
+ * @breaks  Lobsters JSON shape drift, weak tree bounds, or lossy HTML conversion degrades reads.
+ */
+interface LobstersStory {
+    short_id?: unknown;
+    title?: unknown;
+    description?: unknown;
+    description_plain?: unknown;
+    submitter_user?: unknown;
+    score?: unknown;
+    comment_count?: unknown;
+    comments?: unknown;
+    created_at?: unknown;
+    tags?: unknown;
+    url?: unknown;
+    comments_url?: unknown;
+}
+export declare function requireLobstersShortId(value: unknown): string;
+export declare function requireLobstersDomain(value: unknown): string;
+export declare function requireLobstersLimit(value: unknown, fallback: number, max: number | null, label: string): number;
+export declare function requireLobstersMinInt(value: unknown, fallback: number, min: number, label: string): number;
+export declare function lobstersHtmlToText(value: unknown): string;
+export declare function buildLobstersReadRows(story: LobstersStory | null | undefined, options: {
+    limit: number;
+    maxDepth: number;
+    maxReplies: number;
+    maxLength: number;
+}): Array<Record<string, unknown>>;
+export declare function mapLobstersDomainRows(stories: LobstersStory[]): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=read-domain.d.ts.map

package/dist/adapters/lobsters/read-domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-domain.d.ts","sourceRoot":"","sources":["../../../src/adapters/lobsters/read-domain.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAcD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW5D;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CAWR;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqBzD;AA8CD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACvC,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4EhC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EAAE,GACvB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAahC"}

package/dist/adapters/lobsters/read-domain.js

@@ -0,0 +1,306 @@
+/**
+ * @owner   src/adapters/lobsters/read-domain.ts
+ * @does    Register agent-facing Lobsters read and domain commands.
+ * @needs   Public lobste.rs JSON endpoints, strict ids/domains, bounded comment tree rendering.
+ * @feeds   surface coverage ledger, Lobsters story readers, source-domain research workflows.
+ * @breaks  Lobsters JSON shape drift, weak tree bounds, or lossy HTML conversion degrades reads.
+ */
+import { cli, Strategy } from "../../registry.js";
+const LOBSTERS_BASE = "https://lobste.rs";
+const DOMAIN_PATTERN = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?(\.[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)+$/i;
+function stringField(value) {
+    return typeof value === "string" ? value : "";
+}
+function numberOrNull(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function numberOrBlank(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : "";
+}
+export function requireLobstersShortId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^[a-z0-9]+$/.test(id)) {
+        throw new Error(`Invalid Lobsters short_id: ${String(value)}.`);
+    }
+    return id;
+}
+export function requireLobstersDomain(value) {
+    const domain = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (!domain)
+        throw new Error("lobsters domain is required.");
+    if (!DOMAIN_PATTERN.test(domain)) {
+        throw new Error(`lobsters domain "${String(value)}" is not a valid hostname.`);
+    }
+    return domain;
+}
+export function requireLobstersLimit(value, fallback, max, label) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error(`lobsters ${label} must be a positive integer.`);
+    }
+    if (max !== null && limit > max) {
+        throw new Error(`lobsters ${label} must be <= ${max}.`);
+    }
+    return limit;
+}
+export function requireLobstersMinInt(value, fallback, min, label) {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < min) {
+        throw new Error(`lobsters ${label} must be an integer >= ${min}.`);
+    }
+    return n;
+}
+export function lobstersHtmlToText(value) {
+    return String(value ?? "")
+        .replace(/<p>/gi, "\n\n")
+        .replace(/<\/p>/gi, "")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<i>(.*?)<\/i>/gi, "$1")
+        .replace(/<em>(.*?)<\/em>/gi, "$1")
+        .replace(/<strong>(.*?)<\/strong>/gi, "$1")
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, "$2 ($1)")
+        .replace(/<pre><code>([\s\S]*?)<\/code><\/pre>/gi, "\n$1\n")
+        .replace(/<code>(.*?)<\/code>/gi, "`$1`")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&#x27;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&quot;/g, '"')
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&#x2F;/g, "/")
+        .trim();
+}
+function truncate(text, maxLength, suffix) {
+    return text.length > maxLength
+        ? `${text.slice(0, maxLength)}${suffix}`
+        : text;
+}
+function indentLines(text, depth) {
+    if (depth <= 0)
+        return text;
+    const prefix = `${"  ".repeat(depth)}> `;
+    return text
+        .split("\n")
+        .map((line) => `${prefix}${line}`)
+        .join("\n");
+}
+function commentShortId(comment) {
+    return stringField(comment.short_id);
+}
+function commentParentId(comment) {
+    return stringField(comment.parent_comment);
+}
+function commentBody(comment) {
+    return (stringField(comment.comment_plain) || lobstersHtmlToText(comment.comment));
+}
+function storyBody(story) {
+    return (stringField(story.description_plain) ||
+        lobstersHtmlToText(story.description));
+}
+function visibleComments(story) {
+    return Array.isArray(story.comments)
+        ? story.comments.filter((comment) => {
+            return typeof comment === "object" && comment !== null;
+        })
+        : [];
+}
+export function buildLobstersReadRows(story, options) {
+    if (!story || !story.short_id)
+        throw new Error("Lobsters story not found.");
+    const rows = [];
+    const body = truncate(storyBody(story).trim(), options.maxLength, "\n... [truncated]");
+    const storyParts = [stringField(story.title)];
+    if (body)
+        storyParts.push(`\n${body}`);
+    if (story.url)
+        storyParts.push(`\n${stringField(story.url)}`);
+    rows.push({
+        type: "POST",
+        author: stringField(story.submitter_user) || "[deleted]",
+        score: numberOrNull(story.score) ?? 0,
+        text: storyParts.join("").trim(),
+    });
+    const children = new Map();
+    for (const comment of visibleComments(story)) {
+        const parent = commentParentId(comment);
+        const bucket = children.get(parent) ?? [];
+        bucket.push(comment);
+        children.set(parent, bucket);
+    }
+    function emit(comment, depth) {
+        if (comment.is_deleted || comment.is_moderated)
+            return;
+        const id = commentShortId(comment);
+        rows.push({
+            type: depth === 0 ? "L0" : `L${depth}`,
+            author: stringField(comment.commenting_user) || "[deleted]",
+            score: numberOrBlank(comment.score),
+            text: indentLines(truncate(commentBody(comment).trim(), options.maxLength, "..."), depth),
+        });
+        const kids = id ? (children.get(id) ?? []) : [];
+        if (depth + 1 >= options.maxDepth) {
+            if (kids.length > 0) {
+                rows.push({
+                    type: `L${depth + 1}`,
+                    author: "",
+                    score: "",
+                    text: `${"  ".repeat(depth + 1)}[+${kids.length} more replies]`,
+                });
+            }
+            return;
+        }
+        const visible = kids.slice(0, options.maxReplies);
+        for (const kid of visible)
+            emit(kid, depth + 1);
+        const hidden = kids.length - visible.length;
+        if (hidden > 0) {
+            rows.push({
+                type: `L${depth + 1}`,
+                author: "",
+                score: "",
+                text: `${"  ".repeat(depth + 1)}[+${hidden} more replies]`,
+            });
+        }
+    }
+    const topLevel = children.get("") ?? [];
+    const visibleTop = topLevel.slice(0, options.limit);
+    for (const comment of visibleTop)
+        emit(comment, 0);
+    const hiddenTop = topLevel.length - visibleTop.length;
+    if (hiddenTop > 0) {
+        rows.push({
+            type: "",
+            author: "",
+            score: "",
+            text: `[+${hiddenTop} more top-level comments]`,
+        });
+    }
+    return rows;
+}
+export function mapLobstersDomainRows(stories) {
+    return stories.map((item, index) => ({
+        rank: index + 1,
+        id: stringField(item.short_id),
+        title: stringField(item.title),
+        score: numberOrNull(item.score),
+        author: stringField(item.submitter_user),
+        comments: numberOrNull(item.comment_count),
+        created_at: stringField(item.created_at).slice(0, 10),
+        tags: Array.isArray(item.tags) ? item.tags.map(String).join(", ") : "",
+        submission_url: stringField(item.url),
+        comments_url: stringField(item.comments_url),
+    }));
+}
+async function fetchLobstersJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "unicli-lobsters/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} not found.`);
+    if (!response.ok)
+        throw new Error(`Lobsters returned HTTP ${response.status} for ${label}.`);
+    return (await response.json());
+}
+cli({
+    site: "lobsters",
+    name: "read",
+    description: "Read a Lobste.rs story and its comment tree",
+    domain: "lobste.rs",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Lobste.rs short_id",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Max top-level comments",
+        },
+        { name: "depth", type: "int", default: 2, description: "Max reply depth" },
+        {
+            name: "replies",
+            type: "int",
+            default: 5,
+            description: "Max replies per comment",
+        },
+        {
+            name: "max-length",
+            type: "int",
+            default: 2000,
+            description: "Max characters per comment body",
+        },
+    ],
+    columns: ["type", "author", "score", "text"],
+    func: async (_page, kwargs) => {
+        const id = requireLobstersShortId(kwargs.id);
+        const story = await fetchLobstersJson(`${LOBSTERS_BASE}/s/${id}.json`, `lobsters/${id}`);
+        return buildLobstersReadRows(story, {
+            limit: requireLobstersLimit(kwargs.limit, 25, null, "read limit"),
+            maxDepth: requireLobstersLimit(kwargs.depth, 2, null, "read depth"),
+            maxReplies: requireLobstersLimit(kwargs.replies, 5, null, "read replies"),
+            maxLength: requireLobstersMinInt(kwargs["max-length"] ?? kwargs.maxLength, 2000, 100, "read max-length"),
+        });
+    },
+});
+cli({
+    site: "lobsters",
+    name: "domain",
+    description: "Lobste.rs stories submitted from a specific domain",
+    domain: "lobste.rs",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "domain",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Source domain",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 20,
+            description: "Number of stories",
+        },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "title",
+        "score",
+        "author",
+        "comments",
+        "created_at",
+        "tags",
+        "submission_url",
+        "comments_url",
+    ],
+    func: async (_page, kwargs) => {
+        const domain = requireLobstersDomain(kwargs.domain);
+        const limit = requireLobstersLimit(kwargs.limit, 20, 25, "domain limit");
+        const stories = await fetchLobstersJson(`${LOBSTERS_BASE}/domains/${encodeURIComponent(domain)}.json`, `lobsters domain ${domain}`);
+        if (!Array.isArray(stories) || stories.length === 0) {
+            throw new Error(`No Lobste.rs stories found for domain "${domain}".`);
+        }
+        return mapLobstersDomainRows(stories
+            .filter((story) => typeof story === "object" && story !== null)
+            .slice(0, limit));
+    },
+});
+//# sourceMappingURL=read-domain.js.map

package/dist/adapters/lobsters/read-domain.js.map

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

package/dist/adapters/maven/artifact.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ */
+interface MavenDoc {
+    g?: unknown;
+    a?: unknown;
+    v?: unknown;
+    p?: unknown;
+    timestamp?: unknown;
+    tags?: unknown;
+}
+interface MavenBody {
+    response?: {
+        docs?: MavenDoc[];
+    };
+}
+export interface MavenCoordinate {
+    groupId: string;
+    artifactId: string;
+    version: string;
+}
+export declare function requireMavenLimit(value: unknown, fallback: number): number;
+export declare function parseMavenCoordinate(value: unknown): MavenCoordinate;
+export declare function mapMavenArtifactRows(body: MavenBody, coordinate: MavenCoordinate): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=artifact.d.ts.map

package/dist/adapters/maven/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../src/adapters/maven/artifact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,QAAQ;IAChB,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,CAAC,CAAC,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAapE;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAC1B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBhC"}