e10-ebuilder-prototype 0.5.0

package/dist/platform.js

@@ -0,0 +1,123 @@
+import { CaptureError, id } from './common.js';
+export function parsePages(payload, appId, origin) {
+    const p = payload;
+    if (!p ||
+        typeof p !== 'object' ||
+        ![0, 200, '0', '200'].includes(p.code) ||
+        p.status === false ||
+        p.fail === true ||
+        !Array.isArray(p.data))
+        throw new CaptureError('PAGE_LIST_INVALID', '页面列表返回结构或业务状态异常');
+    const seen = new Set();
+    return p.data.map((raw) => {
+        if (!raw || typeof raw !== 'object')
+            throw new CaptureError('PAGE_ITEM_INVALID', '页面项必须是对象');
+        const item = raw;
+        const viewId = id(item.id);
+        if (seen.has(viewId))
+            throw new CaptureError('PAGE_ID_DUPLICATE', `重复页面 ID: ${viewId}`);
+        seen.add(viewId);
+        if (item.appid !== appId ||
+            !['PAGE', 'ECODE_HTML', 'ECODE_REACT'].includes(String(item.type)) ||
+            typeof item.name !== 'string' ||
+            !item.name.trim())
+            throw new CaptureError('PAGE_ITEM_INVALID', `页面 ${viewId} 的 appid/type/name 无效`);
+        if (!Array.isArray(item.terminalScope) ||
+            !item.terminalScope.length ||
+            item.terminalScope.some((v) => !['PC', 'MOBILE', 'ALL'].includes(v)))
+            throw new CaptureError('TERMINAL_UNKNOWN', `页面 ${viewId} 的终端类型未知`);
+        return {
+            id: viewId,
+            name: item.name,
+            appId,
+            type: item.type,
+            terminal: item.terminalScope.every((v) => v === 'MOBILE') ? 'MOBILE' : 'PC',
+            url: new URL(`/sp/ebdpage/view/${viewId}`, origin).href,
+        };
+    });
+}
+function envelope(payload) {
+    const p = payload;
+    if (!p ||
+        ![0, 200, '0', '200'].includes(p.code) ||
+        p.status === false ||
+        p.fail === true)
+        throw new CaptureError('CATALOG_INVALID', '应用/表单列表返回业务状态异常');
+    return p.data;
+}
+export function parseApp(payload, appId) {
+    const d = envelope(payload);
+    if (!d || d.id !== appId || typeof d.name !== 'string' || !d.name.trim())
+        throw new CaptureError('APP_INFO_INVALID', '应用信息的 id/name 无效');
+    return d.name;
+}
+export function parseForms(payload, appId, origin) {
+    const data = envelope(payload);
+    if (!Array.isArray(data))
+        throw new CaptureError('FORM_LIST_INVALID', '表单列表必须是数组');
+    const seen = new Set();
+    return data.map((raw) => {
+        if (!raw || typeof raw !== 'object')
+            throw new CaptureError('FORM_ITEM_INVALID', '表单项无效');
+        const formId = id(raw.id), name = raw.showName || raw.name || raw.objName;
+        if (raw.appId !== appId || typeof name !== 'string' || !name.trim())
+            throw new CaptureError('FORM_ITEM_INVALID', `表单 ${formId} 的 appId/name 无效`);
+        if (seen.has(formId))
+            throw new CaptureError('FORM_ID_DUPLICATE', `重复表单 ID: ${formId}`);
+        seen.add(formId);
+        return {
+            id: formId,
+            name,
+            appId,
+            url: new URL(`/sp/ebdapp/detail/${appId}/form/view/${formId}`, origin).href,
+        };
+    });
+}
+export async function fetchCatalog(auth, appId) {
+    id(appId, 'appId');
+    const get = async (pathname) => {
+        const response = await fetch(new URL(pathname, auth.baseUrl), {
+            headers: { Cookie: `ETEAMSID=${auth.eteamsId}`, accept: 'application/json' },
+            redirect: 'manual',
+            signal: AbortSignal.timeout(30000),
+        });
+        if ([301, 302, 303, 307, 308, 401, 403].includes(response.status))
+            throw new CaptureError('E10_LOGIN_REQUIRED', '登录已失效，请重新执行 auth set');
+        if (!response.ok)
+            throw new CaptureError('CATALOG_HTTP', `应用目录 HTTP ${response.status}`);
+        const data = await response.json().catch(() => {
+            throw new CaptureError('CATALOG_INVALID', '应用目录不是 JSON');
+        });
+        if ([401, 403, '401', '403'].includes(data?.code))
+            throw new CaptureError('E10_LOGIN_REQUIRED', '登录已失效，请重新执行 auth set');
+        return data;
+    };
+    const responses = await Promise.allSettled([
+        get(`/api/bs/ebuilder/app/info?id=${appId}`),
+        get(`/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`),
+    ]);
+    for (const r of responses)
+        if (r.status === 'rejected')
+            throw r.reason;
+    const [app, forms] = responses.map((r) => r.value);
+    return { appName: parseApp(app, appId), forms: parseForms(forms, appId, auth.baseUrl) };
+}
+export async function fetchPages(auth, appId) {
+    const url = new URL('/api/bs/ebuilder/page/list', auth.baseUrl);
+    url.searchParams.set('appid', id(appId, 'appId'));
+    const response = await fetch(url, {
+        headers: { Cookie: `ETEAMSID=${auth.eteamsId}`, accept: 'application/json' },
+        redirect: 'manual',
+        signal: AbortSignal.timeout(30000),
+    });
+    if ([301, 302, 303, 307, 308, 401, 403].includes(response.status))
+        throw new CaptureError('E10_LOGIN_REQUIRED', '登录已失效，请重新执行 auth set');
+    if (!response.ok)
+        throw new CaptureError('PAGE_LIST_HTTP', `页面列表 HTTP ${response.status}`);
+    const payload = await response.json().catch(() => {
+        throw new CaptureError('PAGE_LIST_INVALID', '页面列表不是 JSON');
+    });
+    if ([401, 403, '401', '403'].includes(payload?.code))
+        throw new CaptureError('E10_LOGIN_REQUIRED', '登录已失效，请重新执行 auth set');
+    return parsePages(payload, appId, auth.baseUrl);
+}

package/dist/readiness.d.ts

@@ -0,0 +1,124 @@
+import type { Page, Frame, Request } from 'playwright-core';
+export declare class Monitor {
+    readonly page: Page;
+    readonly origin: string;
+    readonly expectedPage?: {
+        id: string;
+        layoutType?: string;
+    } | undefined;
+    generation: number;
+    lastSample: unknown;
+    requestStarted: Map<Request, number>;
+    entranceAt: number;
+    pending: Set<Request>;
+    processing: Set<Promise<void>>;
+    processingRequests: Map<Request, Promise<void>>;
+    lastActivity: number;
+    epoch: number;
+    issues: {
+        path: string;
+        kind: string;
+        critical: boolean;
+    }[];
+    pageConfig?: {
+        id?: string;
+        componentCount?: number;
+        terminalMessage?: string;
+        layoutType?: string;
+    };
+    entrance: boolean;
+    constructor(page: Page, origin: string, expectedPage?: {
+        id: string;
+        layoutType?: string;
+    } | undefined);
+    touch(): void;
+    relevant(r: Request): boolean;
+    blocking(r: Request): boolean;
+    issue(r: Request, kind: string): void;
+    evidence(): {
+        lastSample: unknown;
+        pending: string[];
+        processing: number;
+        issues: {
+            path: string;
+            kind: string;
+            critical: boolean;
+        }[];
+    };
+    check(): void;
+}
+export declare function sample(page: Page, viewId: string, requireEntrance: boolean, monitor: Monitor): Promise<{
+    evidence: {
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+        timeOrigin: number;
+        origin: string;
+        pathname: string;
+        root: boolean;
+        boundContent: boolean;
+        pageState: string;
+        rootSize: {
+            width: number;
+            height: number;
+        } | null;
+        readyState: DocumentReadyState;
+        loading: number;
+        error: number;
+        components: {
+            id: string;
+            type: string;
+        }[];
+        canvases: string[];
+        broken: number;
+        pendingImages: number;
+        fonts: FontFaceSetLoadStatus;
+        finiteAnimations: number;
+        virtual: number;
+        width: number;
+        height: number;
+        frames: number;
+    };
+    contentSignature: string;
+    signature: string;
+    ready: boolean;
+}>;
+export declare function ready(page: Page, viewId: string, monitor: Monitor, deadline: number, stableMs: number, requireEntrance?: boolean): Promise<{
+    evidence: {
+        warnings: {
+            code: string;
+            message: string;
+        }[];
+        timeOrigin: number;
+        origin: string;
+        pathname: string;
+        root: boolean;
+        boundContent: boolean;
+        pageState: string;
+        rootSize: {
+            width: number;
+            height: number;
+        } | null;
+        readyState: DocumentReadyState;
+        loading: number;
+        error: number;
+        components: {
+            id: string;
+            type: string;
+        }[];
+        canvases: string[];
+        broken: number;
+        pendingImages: number;
+        fonts: FontFaceSetLoadStatus;
+        finiteAnimations: number;
+        virtual: number;
+        width: number;
+        height: number;
+        frames: number;
+    };
+    contentSignature: string;
+    signature: string;
+    ready: boolean;
+}>;
+export declare function lazyScroll(page: Page | Frame, waitReady: () => Promise<unknown>): Promise<number>;