@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/steam/app.js

@@ -0,0 +1,165 @@
+/**
+ * @owner   src/adapters/steam/app.ts
+ * @does    Register agent-facing Steam app storefront detail command.
+ * @needs   Steam appdetails API, strict app ids, storefront country code validation.
+ * @feeds   surface coverage ledger, Steam app detail workflows, storefront metadata readers.
+ * @breaks  Steam appdetails envelope drift or regional availability changes can hide app metadata.
+ */
+import { cli, Strategy } from "../../registry.js";
+const STEAM_STORE = "https://store.steampowered.com";
+const HTML_ENTITIES = {
+    "&": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&apos;": "'",
+    "&#39;": "'",
+    "&nbsp;": " ",
+};
+function stringField(value) {
+    return value === undefined || value === null ? "" : String(value);
+}
+function numberOrNull(value) {
+    if (value === undefined || value === null || value === "")
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+export function decodeSteamHtml(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;
+    });
+}
+export function requireSteamAppId(value) {
+    const id = String(value ?? "").trim();
+    if (!/^\d+$/.test(id)) {
+        throw new Error("steam app id must be a positive integer.");
+    }
+    return id;
+}
+export function requireSteamCountryCode(value, fallback = "us") {
+    const raw = value === undefined || value === null || value === "" ? fallback : value;
+    const code = String(raw).trim().toLowerCase();
+    if (!/^[a-z]{2}$/.test(code)) {
+        throw new Error("steam currency must be a two-letter storefront country code.");
+    }
+    return code;
+}
+export function steamPriceCents(value) {
+    const cents = numberOrNull(value);
+    return cents === null ? null : Number((cents / 100).toFixed(2));
+}
+function joinSteamNames(value) {
+    if (!Array.isArray(value))
+        return "";
+    return value
+        .map((entry) => {
+        if (typeof entry === "string")
+            return entry;
+        return stringField(entry.description || entry.name);
+    })
+        .filter(Boolean)
+        .join(", ");
+}
+export function mapSteamAppRow(appId, data) {
+    const id = stringField(data.steam_appid || appId);
+    const isFree = data.is_free === true;
+    return {
+        id,
+        name: decodeSteamHtml(data.name),
+        type: stringField(data.type),
+        isFree,
+        releaseDate: stringField(data.release_date?.date),
+        developers: Array.isArray(data.developers)
+            ? data.developers.join(", ")
+            : "",
+        publishers: Array.isArray(data.publishers)
+            ? data.publishers.join(", ")
+            : "",
+        price: isFree ? 0 : steamPriceCents(data.price_overview?.final),
+        currency: stringField(data.price_overview?.currency).toUpperCase(),
+        metacritic: numberOrNull(data.metacritic?.score),
+        recommendations: numberOrNull(data.recommendations?.total),
+        genres: joinSteamNames(data.genres),
+        categories: joinSteamNames(data.categories),
+        shortDescription: decodeSteamHtml(data.short_description),
+        website: stringField(data.website),
+        url: `${STEAM_STORE}/app/${id}/`,
+    };
+}
+async function fetchSteamApp(appId, countryCode) {
+    const url = new URL(`${STEAM_STORE}/api/appdetails`);
+    url.searchParams.set("appids", appId);
+    url.searchParams.set("l", "en");
+    url.searchParams.set("cc", countryCode);
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "unicli-steam/1.0 (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (!response.ok)
+        throw new Error(`Steam app returned HTTP ${response.status}.`);
+    const envelope = (await response.json());
+    const wrapper = envelope[appId];
+    if (!wrapper || wrapper.success !== true || !wrapper.data) {
+        throw new Error(`Steam app id ${appId} returned no data.`);
+    }
+    return wrapper.data;
+}
+cli({
+    site: "steam",
+    name: "app",
+    description: "Steam storefront detail for a single app id",
+    domain: "store.steampowered.com",
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        {
+            name: "id",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Numeric Steam app id",
+        },
+        {
+            name: "currency",
+            type: "str",
+            default: "us",
+            description: "Storefront country code",
+        },
+    ],
+    columns: [
+        "id",
+        "name",
+        "type",
+        "isFree",
+        "releaseDate",
+        "developers",
+        "publishers",
+        "price",
+        "currency",
+        "metacritic",
+        "recommendations",
+        "genres",
+        "categories",
+        "shortDescription",
+        "website",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireSteamAppId(kwargs.id);
+        const countryCode = requireSteamCountryCode(kwargs.currency);
+        return [mapSteamAppRow(id, await fetchSteamApp(id, countryCode))];
+    },
+});
+//# sourceMappingURL=app.js.map

package/dist/adapters/steam/app.js.map

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

package/dist/adapters/tiktok/creator-videos.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @owner   src/adapters/tiktok/creator-videos.ts
+ * @does    Register agent-facing TikTok Studio creator video list extraction implemented with site-specific safety checks.
+ * @needs   Logged-in www.tiktok.com browser session with access to TikTok Studio content management.
+ * @feeds   surface coverage ledger and creator analytics workflows for TikTok owned videos.
+ * @breaks  TikTok Studio API schema changes, missing creator permissions, auth redirects, or item_list pagination drift.
+ */
+interface TikTokCreatorApiItem {
+    item_id?: unknown;
+    id?: unknown;
+    desc?: unknown;
+    title?: unknown;
+    post_time?: unknown;
+    create_time?: unknown;
+    schedule_time?: unknown;
+    play_count?: unknown;
+    like_count?: unknown;
+    comment_count?: unknown;
+    favorite_count?: unknown;
+    share_count?: unknown;
+    author?: {
+        unique_id?: unknown;
+        uniqueId?: unknown;
+    };
+    author_unique_id?: unknown;
+    authorUniqueId?: unknown;
+    user_name?: unknown;
+    username?: unknown;
+    play_addr?: unknown;
+    download_info?: {
+        download_urls?: unknown;
+    };
+}
+export declare function requireTikTokPositiveInt(value: unknown, label: string, fallback: number, max: number): number;
+export declare function requireTikTokCursor(value: unknown): number;
+export declare function buildTikTokItemListRequest(cursor: number, size: number): {
+    cursor: number;
+    size: number;
+    query: {
+        conditions: never[];
+        sort_orders: {
+            field_name: string;
+            order: number;
+        }[];
+    };
+};
+export declare function buildTikTokItemListScript(body: unknown): string;
+export declare function formatTikTokStudioDate(value: unknown): string;
+export declare function extractTikTokUsername(item: TikTokCreatorApiItem): string;
+export declare function normalizeTikTokCreatorVideoRow(item: TikTokCreatorApiItem): Record<string, unknown> | null;
+export {};
+//# sourceMappingURL=creator-videos.d.ts.map

package/dist/adapters/tiktok/creator-videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-videos.d.ts","sourceRoot":"","sources":["../../../src/adapters/tiktok/creator-videos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7C;AAuBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CAWR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY1D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;EAStE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgD/D;AA8CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO7D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAkBxE;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,oBAAoB,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAqBhC"}

package/dist/adapters/tiktok/creator-videos.js

@@ -0,0 +1,267 @@
+/**
+ * @owner   src/adapters/tiktok/creator-videos.ts
+ * @does    Register agent-facing TikTok Studio creator video list extraction implemented with site-specific safety checks.
+ * @needs   Logged-in www.tiktok.com browser session with access to TikTok Studio content management.
+ * @feeds   surface coverage ledger and creator analytics workflows for TikTok owned videos.
+ * @breaks  TikTok Studio API schema changes, missing creator permissions, auth redirects, or item_list pagination drift.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { str } from "../_shared/browser-tools.js";
+const STUDIO_CONTENT_URL = "https://www.tiktok.com/tiktokstudio/content";
+const ITEM_LIST_API_PATH = "/tiktok/creator/manage/item_list/v1/";
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 250;
+const SERVER_PAGE_MAX = 50;
+export function requireTikTokPositiveInt(value, label, fallback, max) {
+    const parsed = Number(value ?? fallback);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`TikTok creator-videos ${label} must be a positive integer.`);
+    }
+    if (parsed > max) {
+        throw new Error(`TikTok creator-videos ${label} must be <= ${max}.`);
+    }
+    return parsed;
+}
+export function requireTikTokCursor(value) {
+    const text = str(value ?? "0").trim();
+    if (!/^\d+$/.test(text)) {
+        throw new Error("TikTok creator-videos cursor must be a non-negative integer string.");
+    }
+    const cursor = Number(text);
+    if (!Number.isSafeInteger(cursor)) {
+        throw new Error("TikTok creator-videos cursor must be a safe integer.");
+    }
+    return cursor;
+}
+export function buildTikTokItemListRequest(cursor, size) {
+    return {
+        cursor,
+        size,
+        query: {
+            conditions: [],
+            sort_orders: [{ field_name: "create_time", order: 2 }],
+        },
+    };
+}
+export function buildTikTokItemListScript(body) {
+    const request = {
+        url: `${ITEM_LIST_API_PATH}?aid=1988`,
+        body,
+    };
+    return `(async () => {
+    const request = ${JSON.stringify(request)};
+    try {
+      const response = await fetch(request.url, {
+        method: 'POST',
+        credentials: 'include',
+        headers: {
+          accept: 'application/json',
+          'content-type': 'application/json',
+        },
+        body: JSON.stringify(request.body),
+      });
+      const text = await response.text();
+      let data = null;
+      if (text.trim()) {
+        try {
+          data = JSON.parse(text);
+        } catch (error) {
+          return {
+            ok: false,
+            status: response.status,
+            statusText: response.statusText,
+            parseError: error instanceof Error ? error.message : String(error),
+            text: text.slice(0, 500),
+          };
+        }
+      }
+      return {
+        ok: response.ok,
+        status: response.status,
+        statusText: response.statusText,
+        data,
+        text: text.slice(0, 500),
+      };
+    } catch (error) {
+      return {
+        ok: false,
+        status: 0,
+        statusText: '',
+        networkError: error instanceof Error ? error.message : String(error),
+      };
+    }
+  })()`;
+}
+function looksAuthFailure(value) {
+    return /\b(auth|login|log in|permission|unauthori[sz]ed|forbidden)\b/i.test(str(value));
+}
+function unwrapPayload(data) {
+    if (!data || typeof data !== "object") {
+        throw new Error("TikTok Studio item_list returned an empty response.");
+    }
+    const payload = data;
+    return payload.data && typeof payload.data === "object"
+        ? payload.data
+        : payload;
+}
+function assertApiSuccess(data) {
+    const statusCode = data.status_code ?? data.statusCode;
+    const statusMessage = str(data.status_msg ?? data.statusMsg).trim();
+    if (statusCode !== undefined && Number(statusCode) !== 0) {
+        if (looksAuthFailure(statusMessage)) {
+            throw new Error(`TikTok Studio item_list requires login or creator permission: ${statusMessage || statusCode}.`);
+        }
+        throw new Error(`TikTok Studio item_list failed: ${statusMessage || statusCode}.`);
+    }
+    if (statusMessage && !/^(success|ok)$/i.test(statusMessage)) {
+        if (looksAuthFailure(statusMessage)) {
+            throw new Error(`TikTok Studio item_list requires login or creator permission: ${statusMessage}.`);
+        }
+        throw new Error(`TikTok Studio item_list failed: ${statusMessage}.`);
+    }
+}
+function normalizeCount(value) {
+    const count = Number(value);
+    return Number.isFinite(count) ? count : 0;
+}
+export function formatTikTokStudioDate(value) {
+    const seconds = Number(value);
+    if (!Number.isFinite(seconds) || seconds <= 0)
+        return "";
+    return new Date(seconds * 1000).toLocaleString("zh-CN", {
+        timeZone: "Asia/Shanghai",
+        hour12: false,
+    });
+}
+export function extractTikTokUsername(item) {
+    const direct = item.author?.unique_id ??
+        item.author?.uniqueId ??
+        item.author_unique_id ??
+        item.authorUniqueId ??
+        item.user_name ??
+        item.username;
+    if (direct)
+        return str(direct);
+    const playAddresses = Array.isArray(item.play_addr) ? item.play_addr : [];
+    const downloadUrls = Array.isArray(item.download_info?.download_urls)
+        ? item.download_info.download_urls
+        : [];
+    for (const rawUrl of [...playAddresses, ...downloadUrls]) {
+        const match = str(rawUrl).match(/[?&]user_text=([^&]+)/);
+        if (match)
+            return decodeURIComponent(match[1]);
+    }
+    return "";
+}
+export function normalizeTikTokCreatorVideoRow(item) {
+    const videoId = str(item.item_id ?? item.id).trim();
+    if (!videoId)
+        return null;
+    const username = extractTikTokUsername(item);
+    return {
+        video_id: videoId,
+        title: str(item.desc ?? item.title)
+            .replace(/\s+/g, " ")
+            .trim(),
+        date: formatTikTokStudioDate(item.post_time ?? item.create_time ?? item.schedule_time),
+        views: normalizeCount(item.play_count),
+        likes: normalizeCount(item.like_count),
+        comments: normalizeCount(item.comment_count),
+        saves: normalizeCount(item.favorite_count),
+        shares: normalizeCount(item.share_count),
+        url: username
+            ? `https://www.tiktok.com/@${encodeURIComponent(username)}/video/${encodeURIComponent(videoId)}`
+            : "",
+    };
+}
+async function fetchCreatorVideosPage(page, cursor, size) {
+    const result = (await page.evaluate(buildTikTokItemListScript(buildTikTokItemListRequest(cursor, size))));
+    if (!result || typeof result !== "object") {
+        throw new Error("TikTok Studio item_list returned an unreadable response.");
+    }
+    if (result.networkError) {
+        throw new Error(`TikTok Studio item_list network failure: ${str(result.networkError)}.`);
+    }
+    if (result.status === 401 || result.status === 403) {
+        throw new Error(`TikTok Studio item_list requires login (HTTP ${result.status}).`);
+    }
+    if (!result.ok) {
+        const detail = result.parseError
+            ? `invalid JSON (${str(result.parseError)})`
+            : `HTTP ${str(result.status || 0)}${result.statusText ? ` ${str(result.statusText)}` : ""}`;
+        const preview = str(result.text).slice(0, 160);
+        throw new Error(`TikTok Studio item_list failed: ${detail}${preview ? `; response preview: ${preview}` : ""}.`);
+    }
+    const payload = unwrapPayload(result.data);
+    assertApiSuccess(payload);
+    return payload;
+}
+async function listCreatorVideos(page, kwargs) {
+    const limit = requireTikTokPositiveInt(kwargs.limit, "limit", DEFAULT_LIMIT, MAX_LIMIT);
+    let cursor = requireTikTokCursor(kwargs.cursor);
+    const rows = [];
+    let skippedMissingId = 0;
+    const pageSize = Math.min(SERVER_PAGE_MAX, limit);
+    const maxPages = Math.ceil(limit / pageSize);
+    await page.goto(STUDIO_CONTENT_URL, { waitUntil: "load", settleMs: 6000 });
+    for (let pageIndex = 0; pageIndex < maxPages && rows.length < limit; pageIndex += 1) {
+        const payload = await fetchCreatorVideosPage(page, cursor, pageSize);
+        const items = Array.isArray(payload.item_list) ? payload.item_list : [];
+        for (const item of items) {
+            const row = normalizeTikTokCreatorVideoRow(item);
+            if (!row) {
+                skippedMissingId += 1;
+                continue;
+            }
+            rows.push(row);
+            if (rows.length >= limit)
+                break;
+        }
+        if (!payload.has_more || items.length === 0)
+            break;
+        cursor = requireTikTokCursor(payload.cursor);
+        await page.wait(0.25);
+    }
+    if (rows.length === 0 && skippedMissingId > 0) {
+        throw new Error("TikTok Studio item_list returned videos without stable video_id.");
+    }
+    if (rows.length === 0) {
+        throw new Error("No TikTok Studio creator videos were returned. Confirm the browser profile is logged in and has published content.");
+    }
+    return rows.slice(0, limit);
+}
+cli({
+    site: "tiktok",
+    name: "creator-videos",
+    description: "Read TikTok Studio creator content metrics",
+    domain: "www.tiktok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        {
+            name: "limit",
+            type: "int",
+            default: DEFAULT_LIMIT,
+            description: `Number of creator videos to return (max ${MAX_LIMIT})`,
+        },
+        {
+            name: "cursor",
+            type: "str",
+            default: "0",
+            description: "Non-negative TikTok Studio pagination cursor",
+        },
+    ],
+    columns: [
+        "video_id",
+        "title",
+        "date",
+        "views",
+        "likes",
+        "comments",
+        "saves",
+        "shares",
+        "url",
+    ],
+    func: async (page, kwargs) => listCreatorVideos(page, kwargs),
+});
+//# sourceMappingURL=creator-videos.js.map

package/dist/adapters/tiktok/creator-videos.js.map

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

package/dist/adapters/tvmaze/shows.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @owner   src/adapters/tvmaze/shows.ts
+ * @does    Register agent-facing TVmaze show search and detail commands.
+ * @needs   TVmaze public API, bounded search limits, positive show ids.
+ * @feeds   surface coverage ledger, TV show reference rows, cross-reference ids.
+ * @breaks  TVmaze API drift, weak id validation, or silent empty rows hide show lookup failures.
+ */
+export declare function requireTvmazeLimit(value: unknown): number;
+export declare function requireTvmazeShowId(value: unknown): number;
+export declare function stripTvmazeHtml(value: unknown): string;
+export declare function mapTvmazeSearchRows(entries: Array<Record<string, unknown>>, limit: number): Array<Record<string, unknown>>;
+export declare function mapTvmazeShowRow(show: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=shows.d.ts.map

package/dist/adapters/tvmaze/shows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shows.d.ts","sourceRoot":"","sources":["../../../src/adapters/tvmaze/shows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM1D;AAqCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBtD;AAkBD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoBhC;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB"}