@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/arxiv/papers.js

@@ -0,0 +1,193 @@
+/**
+ * @owner   src/adapters/arxiv/papers.ts
+ * @does    Register agent-facing arXiv author and recent category commands.
+ * @needs   export.arxiv.org Atom API, category validation, conservative XML parsing.
+ * @feeds   surface coverage ledger, scholarly search workflow, arXiv category monitoring.
+ * @breaks  arXiv Atom shape drift, weak category parsing, or silent empty feeds hide paper discovery failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const ARXIV_BASE = "https://export.arxiv.org/api/query";
+const CATEGORY_RE = /^[a-z]+(?:-[a-z]+)*(?:\.[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*)?$/;
+export function requireArxivLimit(value, fallback, max = 50) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > max) {
+        throw new Error(`arxiv limit must be an integer in [1, ${max}].`);
+    }
+    return n;
+}
+export function requireArxivAuthor(value) {
+    const author = String(value ?? "").trim();
+    if (!author)
+        throw new Error("arxiv author cannot be empty.");
+    return author;
+}
+export function requireArxivCategory(value) {
+    const category = String(value ?? "").trim();
+    if (!CATEGORY_RE.test(category)) {
+        throw new Error(`Invalid arXiv category "${String(value)}".`);
+    }
+    return category;
+}
+export function decodeArxivEntities(value) {
+    return value
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#39;/g, "'");
+}
+function extractFirst(xml, tag) {
+    const match = xml.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`));
+    return match ? match[1].trim() : "";
+}
+function extractAll(xml, tag) {
+    const out = [];
+    const re = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)<\\/${tag}>`, "g");
+    let match;
+    while ((match = re.exec(xml)) !== null)
+        out.push(match[1].trim());
+    return out;
+}
+function extractAttr(xml, tag, attr) {
+    const match = xml.match(new RegExp(`<${tag}\\b[^>]*?\\b${attr}="([^"]*)"`));
+    return match ? match[1] : "";
+}
+function extractAllAttr(xml, tag, attr) {
+    const out = [];
+    const re = new RegExp(`<${tag}\\b[^>]*?\\b${attr}="([^"]*)"`, "g");
+    let match;
+    while ((match = re.exec(xml)) !== null)
+        out.push(match[1]);
+    return out;
+}
+function findLinkHref(xml, rel) {
+    const re = /<link\b([^>]*)\/?>/g;
+    let match;
+    while ((match = re.exec(xml)) !== null) {
+        const attrs = match[1];
+        if (!new RegExp(`\\brel="${rel}"`).test(attrs))
+            continue;
+        const href = attrs.match(/\bhref="([^"]*)"/);
+        if (href)
+            return href[1];
+    }
+    return "";
+}
+export function parseArxivEntries(xml) {
+    const out = [];
+    const re = /<entry>([\s\S]*?)<\/entry>/g;
+    let match;
+    while ((match = re.exec(xml)) !== null) {
+        const entry = match[1];
+        const rawId = extractFirst(entry, "id");
+        const id = rawId
+            .replace(/^https?:\/\/arxiv\.org\/abs\//, "")
+            .replace(/v\d+$/, "");
+        const title = decodeArxivEntities(extractFirst(entry, "title").replace(/\s+/g, " ")).trim();
+        out.push({
+            id,
+            title,
+            authors: decodeArxivEntities(extractAll(entry, "name").join(", ")),
+            abstract: decodeArxivEntities(extractFirst(entry, "summary").replace(/\s+/g, " ")).trim(),
+            published: extractFirst(entry, "published").slice(0, 10),
+            updated: extractFirst(entry, "updated").slice(0, 10),
+            primary_category: extractAttr(entry, "arxiv:primary_category", "term"),
+            categories: extractAllAttr(entry, "category", "term").join(", "),
+            comment: decodeArxivEntities(extractFirst(entry, "arxiv:comment").replace(/\s+/g, " ")).trim(),
+            pdf: findLinkHref(entry, "related") || `https://arxiv.org/pdf/${id}`,
+            url: `https://arxiv.org/abs/${id}`,
+        });
+    }
+    return out;
+}
+async function fetchArxiv(params) {
+    const response = await fetch(`${ARXIV_BASE}?${params.toString()}`, {
+        headers: {
+            "User-Agent": "unicli-arxiv/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/atom+xml, application/xml, text/xml",
+        },
+    });
+    if (!response.ok)
+        throw new Error(`arXiv API returned HTTP ${response.status}.`);
+    return response.text();
+}
+function compactRows(entries) {
+    return entries.map((entry) => ({
+        id: entry.id,
+        title: entry.title,
+        authors: entry.authors,
+        published: entry.published,
+        primary_category: entry.primary_category,
+        url: entry.url,
+    }));
+}
+cli({
+    site: "arxiv",
+    name: "author",
+    description: "List arXiv papers by a given author",
+    domain: "export.arxiv.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "author",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Author name",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max papers" },
+    ],
+    columns: ["id", "title", "authors", "published", "primary_category", "url"],
+    func: async (_page, kwargs) => {
+        const author = requireArxivAuthor(kwargs.author);
+        const limit = requireArxivLimit(kwargs.limit, 20);
+        const params = new URLSearchParams({
+            search_query: `au:"${author}"`,
+            max_results: String(limit),
+            sortBy: "submittedDate",
+            sortOrder: "descending",
+        });
+        const rows = compactRows(parseArxivEntries(await fetchArxiv(params)));
+        if (rows.length === 0) {
+            throw new Error(`No arXiv papers found for author "${author}".`);
+        }
+        return rows;
+    },
+});
+cli({
+    site: "arxiv",
+    name: "recent",
+    description: "List recent arXiv submissions in a category",
+    domain: "export.arxiv.org",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "category",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "arXiv category",
+        },
+        { name: "limit", type: "int", default: 10, description: "Max papers" },
+    ],
+    columns: ["id", "title", "authors", "published", "primary_category", "url"],
+    func: async (_page, kwargs) => {
+        const category = requireArxivCategory(kwargs.category);
+        const limit = requireArxivLimit(kwargs.limit, 10);
+        const params = new URLSearchParams({
+            search_query: `cat:${category}`,
+            max_results: String(limit),
+            sortBy: "submittedDate",
+            sortOrder: "descending",
+        });
+        const rows = compactRows(parseArxivEntries(await fetchArxiv(params)));
+        if (rows.length === 0) {
+            throw new Error(`No recent arXiv papers found in ${category}.`);
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=papers.js.map

package/dist/adapters/arxiv/papers.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * @owner   src/adapters/bangumi/web.ts
+ * @does    Register Bangumi public search/detail commands for anime, books, games, subjects, and characters.
+ * @needs   Bangumi public REST/search endpoints and user-agent policy.
+ * @feeds   Chinese/Japanese ACG title, character, and visual-novel discovery.
+ * @breaks  Bangumi legacy search endpoint or v0 subject/character schema changes can block lookup.
+ */
+declare const TYPE_CODES: Record<string, number>;
+export declare function mapBangumiSubjects(rows: unknown[]): Record<string, unknown>[];
+export declare function mapBangumiSubject(item: Record<string, unknown>): Record<string, unknown>;
+export declare function mapBangumiCharacters(rows: unknown[]): Record<string, unknown>[];
+export declare function bangumiSubjectSearchBody(kind: keyof typeof TYPE_CODES, kwargs: Record<string, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/adapters/bangumi/web.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmCH,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMtC,CAAC;AAwCF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmB7E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EAAE,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkB3B;AAsBD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,OAAO,UAAU,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/dist/adapters/bangumi/web.js

@@ -0,0 +1,257 @@
+/**
+ * @owner   src/adapters/bangumi/web.ts
+ * @does    Register Bangumi public search/detail commands for anime, books, games, subjects, and characters.
+ * @needs   Bangumi public REST/search endpoints and user-agent policy.
+ * @feeds   Chinese/Japanese ACG title, character, and visual-novel discovery.
+ * @breaks  Bangumi legacy search endpoint or v0 subject/character schema changes can block lookup.
+ */
+import { USER_AGENT } from "../../constants.js";
+import { cli, Strategy } from "../../registry.js";
+const API = "https://api.bgm.tv";
+function str(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function required(value, label) {
+    const text = str(value).trim();
+    if (!text)
+        throw new Error(`bangumi ${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 > 50) {
+        throw new Error("bangumi limit must be an integer in [1, 50].");
+    }
+    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("bangumi year must be an integer in [1900, 2100].");
+    }
+    return n;
+}
+const TYPE_CODES = {
+    book: 1,
+    anime: 2,
+    music: 3,
+    game: 4,
+    real: 6,
+};
+const SORTS = new Set(["match", "rank", "score", "heat"]);
+function normalizeSort(value) {
+    const sort = str(value || "match")
+        .trim()
+        .toLowerCase();
+    if (!SORTS.has(sort)) {
+        throw new Error("bangumi sort must be one of: match, rank, score, heat.");
+    }
+    return sort;
+}
+async function getJson(url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": USER_AGENT,
+        },
+    });
+    if (!response.ok)
+        throw new Error(`bangumi request failed with HTTP ${response.status}.`);
+    return response.json();
+}
+async function postJson(url, body) {
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": USER_AGENT,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok)
+        throw new Error(`bangumi request failed with HTTP ${response.status}.`);
+    return response.json();
+}
+export function mapBangumiSubjects(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const rating = item.rating;
+        const images = item.images;
+        return {
+            rank: index + 1,
+            id: item.id,
+            type: item.type,
+            name: str(item.name),
+            name_cn: str(item.name_cn),
+            date: str(item.air_date ?? item.date),
+            score: rating?.score ?? null,
+            rank_site: item.rank ?? null,
+            summary: str(item.summary).slice(0, 500),
+            image: str(images?.common),
+            url: str(item.url) || `https://bgm.tv/subject/${item.id}`,
+        };
+    });
+}
+export function mapBangumiSubject(item) {
+    const rating = item.rating;
+    const images = item.images;
+    return {
+        id: item.id,
+        type: item.type,
+        name: str(item.name),
+        name_cn: str(item.name_cn),
+        platform: str(item.platform),
+        date: str(item.date),
+        score: rating?.score ?? null,
+        total_votes: rating?.total ?? null,
+        rank_site: item.rank ?? null,
+        summary: str(item.summary).slice(0, 1500),
+        image: str(images?.common),
+        url: `https://bgm.tv/subject/${item.id}`,
+    };
+}
+export function mapBangumiCharacters(rows) {
+    return rows.map((row, index) => {
+        const item = row;
+        const stat = item.stat;
+        const images = item.images;
+        return {
+            rank: index + 1,
+            id: item.id,
+            name: str(item.name),
+            gender: str(item.gender),
+            type: item.type ?? null,
+            comments: stat?.comments ?? null,
+            collects: stat?.collects ?? null,
+            summary: str(item.summary).slice(0, 700),
+            image: str(images?.medium ?? images?.grid),
+            url: `https://bgm.tv/character/${item.id}`,
+        };
+    });
+}
+async function searchSubject(kind, kwargs) {
+    const cap = requireLimit(kwargs.limit);
+    const url = new URL(`${API}/v0/search/subjects`);
+    url.searchParams.set("limit", String(cap));
+    url.searchParams.set("offset", "0");
+    const data = (await postJson(url.toString(), bangumiSubjectSearchBody(kind, kwargs)));
+    const rows = mapBangumiSubjects(data.data ?? []);
+    if (rows.length === 0)
+        throw new Error(`No Bangumi ${kind} found for "${required(kwargs.query, "query")}".`);
+    return rows;
+}
+export function bangumiSubjectSearchBody(kind, kwargs) {
+    const year = optionalYear(kwargs.year);
+    const sort = normalizeSort(kwargs.sort);
+    const filter = { type: [TYPE_CODES[kind]] };
+    if (year !== undefined) {
+        filter.air_date = [`>=${year}-01-01`, `<${year + 1}-01-01`];
+    }
+    return {
+        keyword: required(kwargs.query, "query"),
+        ...(sort === "match" ? {} : { sort }),
+        filter,
+    };
+}
+async function searchCharacters(kwargs) {
+    const query = required(kwargs.query, "query");
+    const cap = requireLimit(kwargs.limit);
+    const url = new URL(`${API}/v0/search/characters`);
+    url.searchParams.set("limit", String(cap));
+    const data = (await postJson(url.toString(), {
+        keyword: query,
+        filter: {},
+    }));
+    const rows = mapBangumiCharacters(data.data ?? []);
+    if (rows.length === 0)
+        throw new Error(`No Bangumi characters found for "${query}".`);
+    return rows;
+}
+const SEARCH_ARGS = [
+    { name: "query", type: "str", required: true, positional: true },
+    { name: "limit", type: "int", default: 10 },
+    { name: "year", type: "int" },
+    {
+        name: "sort",
+        type: "str",
+        default: "match",
+        choices: ["match", "rank", "score", "heat"],
+        description: "match, rank, score, heat",
+    },
+];
+const CHARACTER_ARGS = SEARCH_ARGS.filter((arg) => arg.name === "query" || arg.name === "limit");
+const SUBJECT_COLUMNS = [
+    "rank",
+    "id",
+    "type",
+    "name",
+    "name_cn",
+    "date",
+    "score",
+    "rank_site",
+    "url",
+];
+const CHARACTER_COLUMNS = [
+    "rank",
+    "id",
+    "name",
+    "gender",
+    "comments",
+    "collects",
+    "summary",
+    "url",
+];
+for (const name of ["anime", "book", "game"]) {
+    cli({
+        site: "bangumi",
+        name,
+        description: `Search Bangumi ${name} subjects by Japanese title, Chinese title, romaji, or alias`,
+        domain: "bgm.tv",
+        strategy: Strategy.PUBLIC,
+        browser: false,
+        args: SEARCH_ARGS,
+        columns: SUBJECT_COLUMNS,
+        func: async (_page, kwargs) => searchSubject(name, kwargs),
+    });
+}
+cli({
+    site: "bangumi",
+    name: "characters",
+    description: "Search Bangumi characters by Japanese name, Chinese name, romaji, or alias",
+    domain: "bgm.tv",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: CHARACTER_ARGS,
+    columns: CHARACTER_COLUMNS,
+    func: async (_page, kwargs) => searchCharacters(kwargs),
+});
+cli({
+    site: "bangumi",
+    name: "subject",
+    description: "Get Bangumi subject details by subject id",
+    domain: "bgm.tv",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [{ name: "id", type: "str", required: true, positional: true }],
+    columns: [
+        "id",
+        "type",
+        "name",
+        "name_cn",
+        "platform",
+        "date",
+        "score",
+        "rank_site",
+        "summary",
+        "url",
+    ],
+    func: async (_page, kwargs) => [
+        mapBangumiSubject((await getJson(`${API}/v0/subjects/${required(kwargs.id, "id")}`))),
+    ],
+});
+//# sourceMappingURL=web.js.map

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

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

package/dist/adapters/bbc/topic.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @owner   src/adapters/bbc/topic.ts
+ * @does    Register agent-facing BBC topic RSS command.
+ * @needs   feeds.bbci.co.uk public RSS feeds, topic whitelist, conservative RSS parsing.
+ * @feeds   surface coverage ledger, BBC section headline discovery.
+ * @breaks  BBC RSS envelope drift, loose topic parsing, or silent empty feeds hide news coverage failures.
+ */
+declare const TOPICS: readonly ["world", "business", "politics", "health", "education", "science_and_environment", "technology", "entertainment_and_arts"];
+type BbcTopic = (typeof TOPICS)[number];
+interface RssItem {
+    title: string;
+    description: string;
+    link: string;
+    pubDate: string;
+    guid: string;
+}
+export declare function requireBbcLimit(value: unknown, fallback?: number): number;
+export declare function requireBbcTopic(value: unknown): BbcTopic;
+export declare function decodeBbcEntities(value: unknown): string;
+export declare function extractRssTag(block: string, tag: string): string;
+export declare function parseBbcRssItems(xml: string): RssItem[];
+export declare function bbcPubDateToIso(value: unknown): string;
+export {};
+//# sourceMappingURL=topic.d.ts.map

package/dist/adapters/bbc/topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["../../../src/adapters/bbc/topic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,QAAA,MAAM,MAAM,sIASF,CAAC;AAEX,KAAK,QAAQ,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAExC,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAOrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CASxD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAexD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAShE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAiBvD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD"}

package/dist/adapters/bbc/topic.js

@@ -0,0 +1,122 @@
+/**
+ * @owner   src/adapters/bbc/topic.ts
+ * @does    Register agent-facing BBC topic RSS command.
+ * @needs   feeds.bbci.co.uk public RSS feeds, topic whitelist, conservative RSS parsing.
+ * @feeds   surface coverage ledger, BBC section headline discovery.
+ * @breaks  BBC RSS envelope drift, loose topic parsing, or silent empty feeds hide news coverage failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const BBC_FEED_BASE = "https://feeds.bbci.co.uk/news";
+const TOPICS = [
+    "world",
+    "business",
+    "politics",
+    "health",
+    "education",
+    "science_and_environment",
+    "technology",
+    "entertainment_and_arts",
+];
+export function requireBbcLimit(value, fallback = 20) {
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > 50) {
+        throw new Error("bbc limit must be an integer in [1, 50].");
+    }
+    return n;
+}
+export function requireBbcTopic(value) {
+    const topic = String(value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/[\s-]+/g, "_");
+    if (!TOPICS.includes(topic)) {
+        throw new Error(`bbc topic "${String(value)}" is not supported.`);
+    }
+    return topic;
+}
+export function decodeBbcEntities(value) {
+    return String(value ?? "")
+        .replace(/&#x([0-9a-fA-F]+);/g, (_m, hex) => String.fromCodePoint(Number.parseInt(hex, 16)))
+        .replace(/&#(\d+);/g, (_m, dec) => String.fromCodePoint(Number.parseInt(dec, 10)))
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ");
+}
+export function extractRssTag(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 ? plain[1] : "";
+}
+export function parseBbcRssItems(xml) {
+    const items = [];
+    const re = /<item[^>]*>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = re.exec(xml)) !== null) {
+        const block = match[1];
+        items.push({
+            title: decodeBbcEntities(extractRssTag(block, "title")).trim(),
+            description: decodeBbcEntities(extractRssTag(block, "description")).trim(),
+            link: decodeBbcEntities(extractRssTag(block, "link")).trim(),
+            pubDate: decodeBbcEntities(extractRssTag(block, "pubDate")).trim(),
+            guid: decodeBbcEntities(extractRssTag(block, "guid")).trim(),
+        });
+    }
+    return items;
+}
+export function bbcPubDateToIso(value) {
+    const date = new Date(String(value ?? ""));
+    return Number.isNaN(date.getTime()) ? "" : date.toISOString().slice(0, 10);
+}
+async function fetchBbcRss(topic) {
+    const response = await fetch(`${BBC_FEED_BASE}/${topic}/rss.xml`, {
+        headers: {
+            "User-Agent": "unicli-bbc/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+            Accept: "application/rss+xml, application/xml",
+        },
+    });
+    if (!response.ok)
+        throw new Error(`bbc topic ${topic} returned HTTP ${response.status}.`);
+    return response.text();
+}
+cli({
+    site: "bbc",
+    name: "topic",
+    description: "BBC News headlines for a specific section",
+    domain: "feeds.bbci.co.uk",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "topic",
+            type: "str",
+            required: true,
+            positional: true,
+            choices: [...TOPICS],
+            description: "BBC section name",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max headlines" },
+    ],
+    columns: ["rank", "title", "description", "pubDate", "url"],
+    func: async (_page, kwargs) => {
+        const topic = requireBbcTopic(kwargs.topic);
+        const limit = requireBbcLimit(kwargs.limit);
+        const items = parseBbcRssItems(await fetchBbcRss(topic));
+        if (items.length === 0)
+            throw new Error(`BBC ${topic} feed returned no items.`);
+        return items.slice(0, limit).map((item, index) => ({
+            rank: index + 1,
+            title: item.title,
+            description: item.description,
+            pubDate: bbcPubDateToIso(item.pubDate),
+            url: item.link,
+        }));
+    },
+});
+//# sourceMappingURL=topic.js.map

package/dist/adapters/bbc/topic.js.map

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