@zenalexa/unicli 0.207.1 → 0.209.0

package/dist/engine/capability.js

@@ -0,0 +1,191 @@
+/**
+ * Capability Inference — map analyzed endpoints to CLI capabilities.
+ *
+ * Determines what a site can do (search, hot, feed, detail, etc.),
+ * what columns to display, what arguments to accept, and which
+ * pipeline pattern to use for adapter generation.
+ */
+// ── Goal Aliases (EN + ZH, 12 capabilities) ─────────────────────────────
+const CAPABILITY_ALIASES = {
+    search: ["search", "query", "find", "搜索", "查找", "检索"],
+    hot: [
+        "hot",
+        "trending",
+        "popular",
+        "rank",
+        "top",
+        "热门",
+        "热榜",
+        "排行",
+        "榜单",
+    ],
+    feed: ["feed", "timeline", "latest", "new", "stream", "最新", "动态", "推荐"],
+    profile: ["profile", "user", "me", "account", "个人", "用户", "我的"],
+    detail: ["detail", "item", "article", "post", "详情", "文章"],
+    comments: ["comments", "replies", "review", "评论", "回复"],
+    history: ["history", "recent", "历史", "最近"],
+    favorite: ["favorite", "bookmark", "star", "like", "收藏", "点赞"],
+    download: ["download", "save", "export", "下载", "导出"],
+    create: ["create", "post", "publish", "write", "发布", "创建"],
+    list: ["list", "index", "all", "列表", "全部"],
+    follow: ["follow", "subscribe", "关注", "订阅"],
+};
+// ── Goal Matching ───────────────────────────────────────────────────────
+export function normalizeGoal(goal) {
+    if (!goal)
+        return null;
+    const lower = goal.toLowerCase().trim();
+    for (const [key, aliases] of Object.entries(CAPABILITY_ALIASES)) {
+        if (aliases.some((a) => lower.includes(a)))
+            return key;
+    }
+    return null;
+}
+export function selectBestCapability(capabilities, goal) {
+    if (capabilities.length === 0)
+        return null;
+    const normalized = normalizeGoal(goal);
+    if (normalized) {
+        // Exact match
+        const exact = capabilities.find((c) => c.name === normalized);
+        if (exact)
+            return exact;
+        // Substring match (bidirectional)
+        const partial = capabilities.find((c) => c.name.includes(normalized) || normalized.includes(c.name));
+        if (partial)
+            return partial;
+    }
+    // Default: first capability (highest-scored endpoint)
+    return capabilities[0];
+}
+// ── Strategy Inference ──────────────────────────────────────────────────
+function inferStrategy(authIndicators) {
+    if (authIndicators.includes("signature"))
+        return "intercept";
+    if (authIndicators.includes("bearer") || authIndicators.includes("csrf"))
+        return "header";
+    if (authIndicators.includes("cookie"))
+        return "cookie";
+    return "public";
+}
+function inferPipelinePattern(strategy, hasStoreHint) {
+    if (hasStoreHint)
+        return "store-action";
+    switch (strategy) {
+        case "public":
+            return "public-fetch";
+        case "cookie":
+            return "cookie-fetch";
+        case "header":
+            return "browser-evaluate";
+        case "intercept":
+            return "intercept";
+        default:
+            return "public-fetch";
+    }
+}
+// ── Capability Inference ────────────────────────────────────────────────
+const COLUMN_ROLE_ORDER = [
+    "title",
+    "url",
+    "author",
+    "score",
+    "time",
+    "description",
+    "image",
+];
+export function inferCapabilities(endpoints, stores, options) {
+    const capabilities = [];
+    const usedNames = new Set();
+    for (const ep of endpoints.slice(0, 8)) {
+        // Capability name
+        let capName = ep.capability ?? "data";
+        if (usedNames.has(capName)) {
+            const suffix = ep.pattern
+                .split("/")
+                .filter((s) => s && !s.startsWith(":") && !s.includes("."))
+                .pop();
+            capName = suffix
+                ? `${capName}-${suffix}`
+                : `${capName}-${usedNames.size}`;
+        }
+        usedNames.add(capName);
+        // Columns from detected fields
+        const columns = [];
+        if (ep.responseAnalysis?.detectedFields) {
+            for (const role of COLUMN_ROLE_ORDER) {
+                if (ep.responseAnalysis.detectedFields[role]) {
+                    columns.push(role);
+                }
+            }
+        }
+        if (columns.length === 0)
+            columns.push("title", "url");
+        // Args from query params
+        const args = [];
+        if (ep.queryParams.hasSearch) {
+            args.push({
+                name: "query",
+                type: "string",
+                required: true,
+                positional: true,
+                description: "Search keyword",
+            });
+        }
+        args.push({
+            name: "limit",
+            type: "int",
+            required: false,
+            default: 20,
+            description: "Number of items to return",
+        });
+        if (ep.queryParams.hasPagination) {
+            args.push({
+                name: "page",
+                type: "int",
+                required: false,
+                default: 1,
+                description: "Page number",
+            });
+        }
+        if (ep.queryParams.hasId) {
+            args.push({
+                name: "id",
+                type: "string",
+                required: true,
+                positional: true,
+                description: "Item ID",
+            });
+        }
+        // Strategy
+        const strategy = inferStrategy(ep.authIndicators);
+        // Store hint matching
+        let storeHint;
+        if ((strategy === "intercept" || ep.authIndicators.includes("signature")) &&
+            stores.length > 0) {
+            for (const s of stores) {
+                const matchingAction = s.actions.find((a) => capName.split("-").some((part) => a.toLowerCase().includes(part)) ||
+                    a.toLowerCase().includes("fetch") ||
+                    a.toLowerCase().includes("get"));
+                if (matchingAction) {
+                    storeHint = { store: s.id, action: matchingAction };
+                    break;
+                }
+            }
+        }
+        const pipelinePattern = inferPipelinePattern(strategy, !!storeHint);
+        capabilities.push({
+            name: capName,
+            description: `${options.site} ${capName}`,
+            strategy: storeHint ? "intercept" : strategy,
+            endpoint: ep,
+            itemPath: ep.responseAnalysis?.itemPath ?? null,
+            columns,
+            args,
+            storeHint,
+            pipelinePattern,
+        });
+    }
+    return capabilities;
+}
+//# sourceMappingURL=capability.js.map

package/dist/engine/capability.js.map

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

package/dist/engine/endpoint.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Unified Endpoint Analysis — combines analysis.ts filters with
+ * response body analysis and auth detection for the discover pipeline.
+ *
+ * Used by: explore.ts, synthesize.ts, generate.ts, discover.ts
+ */
+export interface NetworkEntry {
+    url: string;
+    method: string;
+    status: number;
+    contentType: string;
+    body?: unknown;
+    requestHeaders?: Record<string, string>;
+}
+export interface QueryParamClassification {
+    params: string[];
+    hasSearch: boolean;
+    hasPagination: boolean;
+    hasLimit: boolean;
+    hasId: boolean;
+}
+export interface ResponseAnalysis {
+    itemPath: string | null;
+    itemCount: number;
+    detectedFields: Record<string, string>;
+}
+export interface AnalyzedEndpoint {
+    url: string;
+    method: string;
+    status: number;
+    contentType: string;
+    body?: unknown;
+    pattern: string;
+    capability: string | null;
+    sortKey: [number, number, number, number];
+    queryParams: QueryParamClassification;
+    authIndicators: string[];
+    responseAnalysis: ResponseAnalysis | null;
+}
+export declare function classifyQueryParams(url: string): QueryParamClassification;
+export declare function analyzeResponseBody(body: unknown): ResponseAnalysis;
+export declare function detectAuthIndicators(headers: Record<string, string>): string[];
+export declare function urlToPattern(url: string): string;
+export declare function analyzeEndpoints(entries: NetworkEntry[], opts?: {
+    top?: number;
+}): AnalyzedEndpoint[];
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/engine/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/engine/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,WAAW,EAAE,wBAAwB,CAAC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAyGD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAqBzE;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CA+EnE;AAID,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,EAAE,CAsBV;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYhD;AAID,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtB,gBAAgB,EAAE,CAyDpB"}

package/dist/engine/endpoint.js

@@ -0,0 +1,295 @@
+/**
+ * Unified Endpoint Analysis — combines analysis.ts filters with
+ * response body analysis and auth detection for the discover pipeline.
+ *
+ * Used by: explore.ts, synthesize.ts, generate.ts, discover.ts
+ */
+import { isNoiseUrl, isStaticResource, isUsefulEndpoint, endpointSortKey, detectCapability, } from "./analysis.js";
+// ── Constants ────────────────────────────────────────────────────────────
+const SEARCH_PARAMS = new Set([
+    "query",
+    "keyword",
+    "q",
+    "search",
+    "s",
+    "wd",
+    "kw",
+    "keywords",
+]);
+const PAGINATION_PARAMS = new Set([
+    "page",
+    "p",
+    "offset",
+    "start",
+    "from",
+    "pageNum",
+    "pn",
+]);
+const LIMIT_PARAMS = new Set([
+    "limit",
+    "count",
+    "size",
+    "num",
+    "per_page",
+    "pageSize",
+    "ps",
+]);
+const ID_PARAMS = new Set([
+    "id",
+    "uid",
+    "pid",
+    "item_id",
+    "user_id",
+    "mid",
+    "aid",
+    "bvid",
+]);
+const ARRAY_FIELD_NAMES = new Set([
+    "data",
+    "items",
+    "results",
+    "list",
+    "records",
+    "entries",
+    "rows",
+    "hits",
+    "posts",
+    "articles",
+    "comments",
+    "nodes",
+]);
+/** Role → candidate field names (order = priority) */
+const ROLE_FIELDS = {
+    title: ["title", "name", "headline", "subject", "display_name"],
+    url: ["url", "link", "href", "web_url", "share_url", "target_url"],
+    author: [
+        "author",
+        "user",
+        "username",
+        "creator",
+        "nickname",
+        "screen_name",
+        "user_name",
+    ],
+    score: [
+        "score",
+        "upvotes",
+        "likes",
+        "hot",
+        "digg_count",
+        "voteup_count",
+        "like_count",
+        "reply_count",
+    ],
+    time: [
+        "time",
+        "created_at",
+        "updated_at",
+        "date",
+        "publish_time",
+        "ctime",
+        "create_time",
+        "pubdate",
+    ],
+    description: [
+        "description",
+        "desc",
+        "summary",
+        "abstract",
+        "excerpt",
+        "content",
+    ],
+    image: ["image", "cover", "thumbnail", "pic", "avatar", "cover_url", "thumb"],
+    id: ["id", "uid", "pid", "item_id", "aid", "bvid", "mid"],
+};
+// ── Query Param Classification ──────────────────────────────────────────
+export function classifyQueryParams(url) {
+    const params = [];
+    let hasSearch = false;
+    let hasPagination = false;
+    let hasLimit = false;
+    let hasId = false;
+    try {
+        const u = new URL(url);
+        for (const key of u.searchParams.keys()) {
+            params.push(key);
+            if (SEARCH_PARAMS.has(key))
+                hasSearch = true;
+            if (PAGINATION_PARAMS.has(key))
+                hasPagination = true;
+            if (LIMIT_PARAMS.has(key))
+                hasLimit = true;
+            if (ID_PARAMS.has(key))
+                hasId = true;
+        }
+    }
+    catch {
+        /* invalid URL */
+    }
+    return { params, hasSearch, hasPagination, hasLimit, hasId };
+}
+// ── Response Body Analysis ──────────────────────────────────────────────
+export function analyzeResponseBody(body) {
+    if (body === null || body === undefined) {
+        return { itemPath: null, itemCount: 0, detectedFields: {} };
+    }
+    let items = null;
+    let itemPath = null;
+    // Direct array
+    if (Array.isArray(body)) {
+        items = body;
+        itemPath = null; // root is the array
+    }
+    else if (typeof body === "object") {
+        const obj = body;
+        // Check known array field names
+        for (const key of Object.keys(obj)) {
+            if (ARRAY_FIELD_NAMES.has(key) && Array.isArray(obj[key])) {
+                items = obj[key];
+                itemPath = key;
+                break;
+            }
+        }
+        // Fallback: check nested .data.list, .data.items patterns
+        if (!items &&
+            obj.data &&
+            typeof obj.data === "object" &&
+            !Array.isArray(obj.data)) {
+            const nested = obj.data;
+            for (const key of Object.keys(nested)) {
+                if (Array.isArray(nested[key]) &&
+                    nested[key].length > 0) {
+                    items = nested[key];
+                    itemPath = `data.${key}`;
+                    break;
+                }
+            }
+        }
+    }
+    if (!items || items.length === 0) {
+        return { itemPath, itemCount: 0, detectedFields: {} };
+    }
+    // Detect semantic fields from first array item
+    const firstItem = items[0];
+    const detectedFields = {};
+    if (firstItem && typeof firstItem === "object" && !Array.isArray(firstItem)) {
+        const itemObj = firstItem;
+        const flatKeys = Object.keys(itemObj);
+        for (const [role, candidates] of Object.entries(ROLE_FIELDS)) {
+            for (const candidate of candidates) {
+                // Direct match
+                if (flatKeys.includes(candidate) && itemObj[candidate] != null) {
+                    detectedFields[role] = candidate;
+                    break;
+                }
+                // Nested match: e.g. author.name, owner.login
+                for (const key of flatKeys) {
+                    const val = itemObj[key];
+                    if (val && typeof val === "object" && !Array.isArray(val)) {
+                        const nested = val;
+                        if (candidate in nested && nested[candidate] != null) {
+                            detectedFields[role] = `${key}.${candidate}`;
+                            break;
+                        }
+                    }
+                }
+                if (detectedFields[role])
+                    break;
+            }
+        }
+    }
+    return { itemPath, itemCount: items.length, detectedFields };
+}
+// ── Auth Indicators ─────────────────────────────────────────────────────
+export function detectAuthIndicators(headers) {
+    const indicators = [];
+    const headerStr = JSON.stringify(headers).toLowerCase();
+    if (headerStr.includes("bearer"))
+        indicators.push("bearer");
+    if (headerStr.includes("x-csrf-token") ||
+        headerStr.includes("ct0") ||
+        headerStr.includes("bili_jct")) {
+        indicators.push("csrf");
+    }
+    if (headerStr.includes("signature") ||
+        headerStr.includes("x-signature") ||
+        headerStr.includes("_signature")) {
+        indicators.push("signature");
+    }
+    if (headerStr.includes("cookie"))
+        indicators.push("cookie");
+    return indicators;
+}
+// ── URL Pattern ─────────────────────────────────────────────────────────
+export function urlToPattern(url) {
+    try {
+        const u = new URL(url);
+        const path = u.pathname
+            .split("/")
+            .map((seg) => (/^\d{4,}$/.test(seg) ? ":id" : seg))
+            .join("/");
+        const params = [...u.searchParams.keys()].sort().join(",");
+        return `${u.host}${path}${params ? "?" + params : ""}`.toLowerCase();
+    }
+    catch {
+        return url.toLowerCase();
+    }
+}
+// ── Main Pipeline ───────────────────────────────────────────────────────
+export function analyzeEndpoints(entries, opts) {
+    const top = opts?.top ?? 15;
+    const seen = new Map();
+    for (const entry of entries) {
+        if (!entry.url)
+            continue;
+        if (isNoiseUrl(entry.url))
+            continue;
+        if (isStaticResource(entry.url, entry.contentType))
+            continue;
+        if (!isUsefulEndpoint({
+            url: entry.url,
+            status: entry.status,
+            contentType: entry.contentType,
+            body: entry.body,
+        })) {
+            continue;
+        }
+        const pattern = urlToPattern(entry.url);
+        const key = `${entry.method}:${pattern}`;
+        if (seen.has(key))
+            continue;
+        const queryParams = classifyQueryParams(entry.url);
+        const responseAnalysis = entry.body
+            ? analyzeResponseBody(entry.body)
+            : null;
+        const authIndicators = entry.requestHeaders
+            ? detectAuthIndicators(entry.requestHeaders)
+            : [];
+        const capability = detectCapability(entry.url, entry.body);
+        const sortKey = endpointSortKey({ url: entry.url, body: entry.body });
+        seen.set(key, {
+            url: entry.url,
+            method: entry.method,
+            status: entry.status,
+            contentType: entry.contentType,
+            body: entry.body,
+            pattern,
+            capability,
+            sortKey,
+            queryParams,
+            authIndicators,
+            responseAnalysis,
+        });
+    }
+    // Sort descending by sort key
+    return [...seen.values()]
+        .sort((a, b) => {
+        for (let i = 0; i < 4; i++) {
+            if (b.sortKey[i] !== a.sortKey[i])
+                return b.sortKey[i] - a.sortKey[i];
+        }
+        return 0;
+    })
+        .slice(0, top);
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/engine/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/engine/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAyCvB,4EAA4E;AAE5E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO;IACP,SAAS;IACT,GAAG;IACH,QAAQ;IACR,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,UAAU;CACX,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,GAAG;IACH,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,IAAI;CACL,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,OAAO;IACP,OAAO;IACP,MAAM;IACN,KAAK;IACL,UAAU;IACV,UAAU;IACV,IAAI;CACL,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,IAAI;IACJ,KAAK;IACL,KAAK;IACL,SAAS;IACT,SAAS;IACT,KAAK;IACL,KAAK;IACL,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,UAAU;IACV,UAAU;IACV,OAAO;CACR,CAAC,CAAC;AAEH,sDAAsD;AACtD,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,CAAC;IAC/D,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC;IAClE,MAAM,EAAE;QACN,QAAQ;QACR,MAAM;QACN,UAAU;QACV,SAAS;QACT,UAAU;QACV,aAAa;QACb,WAAW;KACZ;IACD,KAAK,EAAE;QACL,OAAO;QACP,SAAS;QACT,OAAO;QACP,KAAK;QACL,YAAY;QACZ,cAAc;QACd,YAAY;QACZ,aAAa;KACd;IACD,IAAI,EAAE;QACJ,MAAM;QACN,YAAY;QACZ,YAAY;QACZ,MAAM;QACN,cAAc;QACd,OAAO;QACP,aAAa;QACb,SAAS;KACV;IACD,WAAW,EAAE;QACX,aAAa;QACb,MAAM;QACN,SAAS;QACT,UAAU;QACV,SAAS;QACT,SAAS;KACV;IACD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC;IAC7E,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;CAC1D,CAAC;AAEF,2EAA2E;AAE3E,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,GAAG,IAAI,CAAC;YAC7C,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,aAAa,GAAG,IAAI,CAAC;YACrD,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,QAAQ,GAAG,IAAI,CAAC;YAC3C,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,KAAK,GAAG,IAAI,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,IAAI,QAAQ,GAAkB,IAAI,CAAC;IAEnC,eAAe;IACf,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,CAAC;QACb,QAAQ,GAAG,IAAI,CAAC,CAAC,oBAAoB;IACvC,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,gCAAgC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC1D,KAAK,GAAG,GAAG,CAAC,GAAG,CAAc,CAAC;gBAC9B,QAAQ,GAAG,GAAG,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;QACD,0DAA0D;QAC1D,IACE,CAAC,KAAK;YACN,GAAG,CAAC,IAAI;YACR,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EACxB,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,CAAC,IAA+B,CAAC;YACnD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,IACE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACzB,MAAM,CAAC,GAAG,CAAe,CAAC,MAAM,GAAG,CAAC,EACrC,CAAC;oBACD,KAAK,GAAG,MAAM,CAAC,GAAG,CAAc,CAAC;oBACjC,QAAQ,GAAG,QAAQ,GAAG,EAAE,CAAC;oBACzB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,+CAA+C;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,cAAc,GAA2B,EAAE,CAAC;IAElD,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,SAAoC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,eAAe;gBACf,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;oBAC/D,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;oBACjC,MAAM;gBACR,CAAC;gBACD,8CAA8C;gBAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;oBACzB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC1D,MAAM,MAAM,GAAG,GAA8B,CAAC;wBAC9C,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;4BACrD,cAAc,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;4BAC7C,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,IAAI,cAAc,CAAC,IAAI,CAAC;oBAAE,MAAM;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,oBAAoB,CAClC,OAA+B;IAE/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAExD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5D,IACE,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;QAClC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzB,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAC9B,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IACD,IACE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC/B,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC;QACjC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAChC,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ;aACpB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aAClD,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,gBAAgB,CAC9B,OAAuB,EACvB,IAAuB;IAEvB,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,SAAS;QACzB,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,IAAI,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC;YAAE,SAAS;QAC7D,IACE,CAAC,gBAAgB,CAAC;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,EACF,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAE5B,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI;YACjC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc;YACzC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,cAAc,CAAC;YAC5C,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAEtE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;YACZ,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO;YACP,UAAU;YACV,OAAO;YACP,WAAW;YACX,cAAc;YACd,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;SACtB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/engine/framework.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Frontend Framework Detection + Store Discovery.
+ *
+ * Returns JS source strings for page.evaluate() — the caller executes them.
+ * Ported from Open-CLI's scripts/store.ts + detectFramework, adapted for
+ * Uni-CLI's evaluate API.
+ */
+export interface FrameworkInfo {
+    react: boolean;
+    vue: boolean;
+    next: boolean;
+    nuxt: boolean;
+    svelte: boolean;
+    angular: boolean;
+}
+export interface StoreInfo {
+    type: "pinia" | "vuex";
+    id: string;
+    actions: string[];
+    stateKeys: string[];
+}
+/** JS string that returns FrameworkInfo when evaluated in page context. */
+export declare function generateFrameworkDetectJs(): string;
+/** JS string that returns StoreInfo[] when evaluated in page context. */
+export declare function generateStoreDiscoverJs(): string;
+/** Check if Vue store discovery should be attempted. */
+export declare function hasVueStores(framework: FrameworkInfo): boolean;
+//# sourceMappingURL=framework.d.ts.map

package/dist/engine/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../src/engine/framework.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,IAAI,MAAM,CAmChD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAE9D"}

package/dist/engine/framework.js

@@ -0,0 +1,66 @@
+/**
+ * Frontend Framework Detection + Store Discovery.
+ *
+ * Returns JS source strings for page.evaluate() — the caller executes them.
+ * Ported from Open-CLI's scripts/store.ts + detectFramework, adapted for
+ * Uni-CLI's evaluate API.
+ */
+/** JS string that returns FrameworkInfo when evaluated in page context. */
+export function generateFrameworkDetectJs() {
+    return `(() => {
+  try {
+    return {
+      react: !!(document.querySelector('[data-reactroot]') || document.querySelector('[data-reactid]') || window.__REACT_DEVTOOLS_GLOBAL_HOOK__),
+      vue: !!(window.__vue_app__ || (document.querySelector('#app') && document.querySelector('#app').__vue_app__) || window.__VUE__),
+      next: !!(window.__NEXT_DATA__ || document.querySelector('#__next')),
+      nuxt: !!(window.__NUXT__ || window.__nuxt),
+      svelte: !!(document.querySelector('[class*="svelte-"]') || window.__svelte),
+      angular: !!(window.ng || document.querySelector('[ng-version]') || window.getAllAngularRootElements),
+    };
+  } catch (e) {
+    return { react: false, vue: false, next: false, nuxt: false, svelte: false, angular: false };
+  }
+})()`;
+}
+/** JS string that returns StoreInfo[] when evaluated in page context. */
+export function generateStoreDiscoverJs() {
+    return `(() => {
+  var stores = [];
+  try {
+    var app = document.querySelector('#app');
+    var vueApp = app && app.__vue_app__;
+    if (vueApp) {
+      var pinia = vueApp.config && vueApp.config.globalProperties && vueApp.config.globalProperties.$pinia;
+      if (pinia && pinia._s) {
+        pinia._s.forEach(function(store, id) {
+          if (id.charAt(0) === '$' || id.charAt(0) === '_') return;
+          var actions = [];
+          var stateKeys = [];
+          Object.keys(store).forEach(function(key) {
+            if (key.charAt(0) === '$' || key.charAt(0) === '_') return;
+            if (typeof store[key] === 'function') actions.push(key);
+            else stateKeys.push(key);
+          });
+          stores.push({ type: 'pinia', id: id, actions: actions.slice(0, 20), stateKeys: stateKeys.slice(0, 15) });
+        });
+      }
+      var vuexStore = vueApp.config && vueApp.config.globalProperties && vueApp.config.globalProperties.$store;
+      if (vuexStore && vuexStore._modules && vuexStore._modules.root && vuexStore._modules.root._children) {
+        var children = vuexStore._modules.root._children;
+        Object.keys(children).forEach(function(id) {
+          var mod = children[id];
+          var actions = mod._rawModule && mod._rawModule.actions ? Object.keys(mod._rawModule.actions) : [];
+          var stateKeys = mod.state ? Object.keys(mod.state) : [];
+          stores.push({ type: 'vuex', id: id, actions: actions.slice(0, 20), stateKeys: stateKeys.slice(0, 15) });
+        });
+      }
+    }
+  } catch (e) {}
+  return stores;
+})()`;
+}
+/** Check if Vue store discovery should be attempted. */
+export function hasVueStores(framework) {
+    return framework.vue;
+}
+//# sourceMappingURL=framework.js.map

package/dist/engine/framework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.js","sourceRoot":"","sources":["../../src/engine/framework.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;KAaJ,CAAC;AACN,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCJ,CAAC;AACN,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,SAAwB;IACnD,OAAO,SAAS,CAAC,GAAG,CAAC;AACvB,CAAC"}