@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/jikan/web.js

@@ -0,0 +1,154 @@
+/**
+ * @owner   src/adapters/jikan/web.ts
+ * @does    Register Jikan public MyAnimeList search commands for anime, manga, characters, and people.
+ * @needs   Jikan v4 public REST API and MAL entity URL formats.
+ * @feeds   ACG title, character, and creator discovery.
+ * @breaks  Jikan throttling or response field changes can block MyAnimeList-backed lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://api.jikan.moe/v4";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`jikan ${label} cannot be empty.`);
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 10;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 25) {
+        throw new Error("jikan limit must be an integer in [1, 25].");
+    }
+    return n;
+}
+function optionalYear(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1900 || n > 2100) {
+        throw new Error("jikan year must be an integer in [1900, 2100].");
+    }
+    return n;
+}
+const SORTS = {
+    score: { orderBy: "score", direction: "desc" },
+    popularity: { orderBy: "popularity", direction: "asc" },
+    recent: { orderBy: "start_date", direction: "desc" },
+    relevance: { orderBy: "", direction: "" },
+};
+function sortSpec(value) {
+    const key = String(value ?? "relevance").trim();
+    const spec = SORTS[key];
+    if (!spec) {
+        throw new Error(`jikan sort must be one of: ${Object.keys(SORTS).join(", ")}.`);
+    }
+    return spec;
+}
+async function fetchJikan(path, query, limit, kwargs) {
+    const url = new URL(`${API}/${path}`);
+    url.searchParams.set("q", query);
+    url.searchParams.set("limit", String(limit));
+    if (path === "anime" || path === "manga") {
+        const year = optionalYear(kwargs.year);
+        if (year) {
+            url.searchParams.set("start_date", `${year}-01-01`);
+            url.searchParams.set("end_date", `${year}-12-31`);
+        }
+        const sort = sortSpec(kwargs.sort);
+        if (sort.orderBy) {
+            url.searchParams.set("order_by", sort.orderBy);
+            url.searchParams.set("sort", sort.direction);
+        }
+    }
+    const response = await fetch(url, {
+        headers: { Accept: "application/json", "User-Agent": USER_AGENT },
+    });
+    if (!response.ok)
+        throw new Error(`jikan request failed with HTTP ${response.status}.`);
+    const data = (await response.json());
+    return data.data ?? [];
+}
+export function mapJikanRows(rows, kind) {
+    return rows.map((row, index) => {
+        const item = row;
+        const images = item.images;
+        return {
+            rank: index + 1,
+            id: item.mal_id ?? null,
+            kind,
+            title: str(item.title ?? item.name),
+            title_japanese: str(item.title_japanese ?? item.name_kanji),
+            type: str(item.type),
+            score: item.score ?? null,
+            members: item.members ?? item.favorites ?? null,
+            url: str(item.url),
+            image: str(images?.jpg?.image_url),
+        };
+    });
+}
+async function search(kind, kwargs) {
+    const query = required(kwargs.query, "query");
+    const cap = requireLimit(kwargs.limit);
+    const rows = mapJikanRows(await fetchJikan(kind, query, cap, kwargs), kind);
+    if (rows.length === 0)
+        throw new Error(`No Jikan ${kind} found for "${query}".`);
+    return rows;
+}
+const ENTITY_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+];
+const MEDIA_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+    { name: "year", type: "int" },
+    {
+        name: "sort",
+        type: "str",
+        default: "relevance",
+        choices: ["relevance", "score", "popularity", "recent"],
+    },
+];
+const COLUMNS = [
+    "rank",
+    "id",
+    "kind",
+    "title",
+    "title_japanese",
+    "type",
+    "score",
+    "members",
+    "url",
+];
+for (const name of ["anime", "manga"]) {
+    cli({
+        site: "jikan",
+        name,
+        description: `Search MyAnimeList ${name} through Jikan by Japanese name, romaji, or alias`,
+        domain: "api.jikan.moe",
+        strategy: Strategy.PUBLIC,
+        browser: false,
+        args: MEDIA_ARGS,
+        columns: COLUMNS,
+        func: async (_page, kwargs) => search(name, kwargs),
+    });
+}
+for (const name of ["characters", "people"]) {
+    cli({
+        site: "jikan",
+        name,
+        description: `Search MyAnimeList ${name} through Jikan by Japanese name, romaji, or alias`,
+        domain: "api.jikan.moe",
+        strategy: Strategy.PUBLIC,
+        browser: false,
+        args: ENTITY_ARGS,
+        columns: COLUMNS,
+        func: async (_page, kwargs) => search(name, kwargs),
+    });
+}
+//# sourceMappingURL=web.js.map

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

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

package/dist/adapters/kitsu/web.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   src/adapters/kitsu/web.ts
+ * @does    Register Kitsu public anime and manga search commands.
+ * @needs   Kitsu JSON:API text filters and public media pages.
+ * @feeds   ACG title discovery with community rating and subtype metadata.
+ * @breaks  Kitsu JSON:API field changes or service availability can block lookup.
+ */
+export declare function mapKitsuMedia(rows: unknown[]): Record<string, unknown>[];
+//# sourceMappingURL=web.d.ts.map

package/dist/adapters/kitsu/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/kitsu/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAsBxE"}

package/dist/adapters/kitsu/web.js

@@ -0,0 +1,97 @@
+/**
+ * @owner   src/adapters/kitsu/web.ts
+ * @does    Register Kitsu public anime and manga search commands.
+ * @needs   Kitsu JSON:API text filters and public media pages.
+ * @feeds   ACG title discovery with community rating and subtype metadata.
+ * @breaks  Kitsu JSON:API field changes or service availability can block lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://kitsu.io/api/edge";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error("kitsu query cannot be empty.");
+    return text;
+}
+function requireLimit(value) {
+    if (value === undefined || value === null || value === "")
+        return 10;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 20) {
+        throw new Error("kitsu limit must be an integer in [1, 20].");
+    }
+    return n;
+}
+export function mapKitsuMedia(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const attrs = item.attributes ?? {};
+        const titles = attrs.titles ?? {};
+        return {
+            rank: index + 1,
+            id: item.id,
+            type: item.type,
+            title: str(attrs.canonicalTitle || titles.en || titles.en_jp || titles.ja_jp),
+            subtype: str(attrs.subtype),
+            status: str(attrs.status),
+            start_date: str(attrs.startDate),
+            average_rating: str(attrs.averageRating),
+            popularity_rank: attrs.popularityRank ?? null,
+            synopsis: str(attrs.synopsis).slice(0, 500),
+            url: `https://kitsu.io/${item.type}/${attrs.slug || item.id}`,
+        };
+    });
+}
+async function search(kind, kwargs) {
+    const query = required(kwargs.query);
+    const cap = requireLimit(kwargs.limit);
+    const url = new URL(`${API}/${kind}`);
+    url.searchParams.set("filter[text]", query);
+    url.searchParams.set("page[limit]", String(cap));
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/vnd.api+json",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok)
+        throw new Error(`kitsu request failed with HTTP ${response.status}.`);
+    const data = (await response.json());
+    const rows = mapKitsuMedia(data.data ?? []);
+    if (rows.length === 0)
+        throw new Error(`No Kitsu ${kind} found for "${query}".`);
+    return rows;
+}
+const ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+];
+const COLUMNS = [
+    "rank",
+    "id",
+    "type",
+    "title",
+    "subtype",
+    "status",
+    "start_date",
+    "average_rating",
+    "url",
+];
+for (const name of ["anime", "manga"]) {
+    cli({
+        site: "kitsu",
+        name,
+        description: `Search Kitsu ${name} by Japanese title, romaji, alias, or keyword`,
+        domain: "kitsu.io",
+        strategy: Strategy.PUBLIC,
+        browser: false,
+        args: ARGS,
+        columns: COLUMNS,
+        func: async (_page, kwargs) => search(name, kwargs),
+    });
+}
+//# sourceMappingURL=web.js.map

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

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

package/dist/adapters/lichess/players.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @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.
+ */
+interface LichessPerf {
+    rating?: unknown;
+    progress?: unknown;
+    games?: unknown;
+}
+interface LichessUser {
+    username?: unknown;
+    id?: unknown;
+    title?: unknown;
+    patron?: unknown;
+    online?: unknown;
+    tosViolation?: unknown;
+    disabled?: unknown;
+    createdAt?: unknown;
+    seenAt?: unknown;
+    count?: {
+        all?: unknown;
+        win?: unknown;
+        loss?: unknown;
+        draw?: unknown;
+    };
+    perfs?: Record<string, LichessPerf>;
+    profile?: {
+        fideRating?: unknown;
+        country?: unknown;
+        bio?: unknown;
+    };
+}
+interface LichessTopBody {
+    users?: LichessUser[];
+}
+export declare function requireLichessUsername(value: unknown): string;
+export declare function requireLichessPerf(value: unknown): string;
+export declare function requireLichessLimit(value: unknown, fallback: number): number;
+export declare function formatLichessTimestamp(value: unknown): string | null;
+export declare function mapLichessTopRows(body: LichessTopBody, perf: string, limit: number): Array<Record<string, unknown>>;
+export declare function mapLichessUserRow(body: LichessUser, requested: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=players.d.ts.map

package/dist/adapters/lichess/players.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"players.d.ts","sourceRoot":"","sources":["../../../src/adapters/lichess/players.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACtE;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAcD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ7D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMpE;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBhC;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+CzB"}

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"}