@lark-apaas/client-toolkit 1.2.62-alpha.0 → 1.2.62-alpha.1

package/lib/runtime/preview-run.js

@@ -1,76 +0,0 @@
-const PREVIEW_RUN_ID_QUERY = '__miaoda_preview_run_id';
-const PREVIEW_RENDERED_MESSAGE_TYPE = 'MiaodaPreviewRendered';
-const PREVIEW_RUN_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
-const EPOCH_TIME_THRESHOLD_MS = 1000000000000;
-const ALLOWED_PARENT_ORIGINS = new Set([
-    'https://miaoda.feishu.cn',
-    'https://miaoda.feishu-pre.cn',
-    'https://miaoda.feishu-boe.cn'
-]);
-function isFiniteNonNegative(value) {
-    return 'number' == typeof value && Number.isFinite(value) && value >= 0;
-}
-function resolveRenderedAtEpochMs(renderedAtEpochMs, eventTimeStampMs, performanceTimeOriginMs) {
-    if (isFiniteNonNegative(renderedAtEpochMs) && renderedAtEpochMs > 0) return renderedAtEpochMs;
-    if (!isFiniteNonNegative(eventTimeStampMs)) return;
-    if (eventTimeStampMs >= EPOCH_TIME_THRESHOLD_MS) return eventTimeStampMs;
-    if (!isFiniteNonNegative(performanceTimeOriginMs) || performanceTimeOriginMs <= 0) return;
-    return performanceTimeOriginMs + eventTimeStampMs;
-}
-function resolveParentOrigin(referrer) {
-    try {
-        const origin = new URL(referrer).origin;
-        return ALLOWED_PARENT_ORIGINS.has(origin) ? origin : void 0;
-    } catch  {
-        return;
-    }
-}
-function createPreviewRenderedMessage(options) {
-    const runID = new URLSearchParams(options.search).get(PREVIEW_RUN_ID_QUERY);
-    const renderedAtEpochMs = resolveRenderedAtEpochMs(options.renderedAtEpochMs, options.eventTimeStampMs, options.performanceTimeOriginMs);
-    if (!runID || !PREVIEW_RUN_ID_PATTERN.test(runID) || !isFiniteNonNegative(options.customTtiMs) || void 0 === renderedAtEpochMs) return;
-    return {
-        type: PREVIEW_RENDERED_MESSAGE_TYPE,
-        data: {
-            runID,
-            customTtiMs: options.customTtiMs,
-            renderedAtEpochMs
-        }
-    };
-}
-function createBrowserEnvironment() {
-    const legacyNavigationStart = performance.timing?.navigationStart;
-    const performanceTimeOriginMs = 'number' == typeof performance.timeOrigin && performance.timeOrigin > 0 ? performance.timeOrigin : legacyNavigationStart ?? 0;
-    return {
-        search: window.location.search,
-        referrer: document.referrer,
-        performanceTimeOriginMs,
-        isEmbedded: window.parent !== window,
-        addEventListener: (type, handler)=>window.addEventListener(type, handler),
-        removeEventListener: (type, handler)=>window.removeEventListener(type, handler),
-        postMessage: (message, targetOrigin)=>window.parent.postMessage(message, targetOrigin)
-    };
-}
-function initPreviewRunReporting(environment = createBrowserEnvironment()) {
-    const parentOrigin = resolveParentOrigin(environment.referrer);
-    const runID = new URLSearchParams(environment.search).get(PREVIEW_RUN_ID_QUERY);
-    if (!environment.isEmbedded || !parentOrigin || !runID || !PREVIEW_RUN_ID_PATTERN.test(runID)) return ()=>void 0;
-    let lastRenderedAtEpochMs;
-    const handleCustomTti = (event)=>{
-        const detail = event.detail;
-        if (!isFiniteNonNegative(detail?.time)) return;
-        const message = createPreviewRenderedMessage({
-            search: environment.search,
-            customTtiMs: detail.time,
-            eventTimeStampMs: event.timeStamp,
-            performanceTimeOriginMs: environment.performanceTimeOriginMs,
-            renderedAtEpochMs: 'number' == typeof detail.renderedAtEpochMs ? detail.renderedAtEpochMs : void 0
-        });
-        if (!message || lastRenderedAtEpochMs === message.data.renderedAtEpochMs) return;
-        lastRenderedAtEpochMs = message.data.renderedAtEpochMs;
-        environment.postMessage(message, parentOrigin);
-    };
-    environment.addEventListener('builderV3-custom-TTI', handleCustomTti);
-    return ()=>environment.removeEventListener('builderV3-custom-TTI', handleCustomTti);
-}
-export { PREVIEW_RENDERED_MESSAGE_TYPE, PREVIEW_RUN_ID_QUERY, createPreviewRenderedMessage, initPreviewRunReporting };

package/lib/runtime/preview-run.spec.js

@@ -1,94 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { PREVIEW_RENDERED_MESSAGE_TYPE, createPreviewRenderedMessage, initPreviewRunReporting } from "./preview-run.js";
-describe('createPreviewRenderedMessage', ()=>{
-    it('使用 TTI 事件时间戳生成精确的 iframe 渲染完成消息', ()=>{
-        expect(createPreviewRenderedMessage({
-            search: '?__miaoda_preview_run_id=prv_test_123',
-            customTtiMs: 8951.8,
-            eventTimeStampMs: 12643.9,
-            performanceTimeOriginMs: 1784022258000
-        })).toEqual({
-            type: PREVIEW_RENDERED_MESSAGE_TYPE,
-            data: {
-                runID: 'prv_test_123',
-                customTtiMs: 8951.8,
-                renderedAtEpochMs: 1784022270643.9
-            }
-        });
-    });
-    it('优先采用新版 TTI 显式提供的 epoch 时间', ()=>{
-        expect(createPreviewRenderedMessage({
-            search: '?__miaoda_preview_run_id=prv_explicit',
-            customTtiMs: 321,
-            eventTimeStampMs: 999,
-            performanceTimeOriginMs: 1000,
-            renderedAtEpochMs: 1720000000123
-        })?.data.renderedAtEpochMs).toBe(1720000000123);
-    });
-    it('拒绝非法 run_id 和非有限耗时', ()=>{
-        expect(createPreviewRenderedMessage({
-            search: '?__miaoda_preview_run_id=invalid%2Frun',
-            customTtiMs: 321,
-            eventTimeStampMs: 999,
-            performanceTimeOriginMs: 1000
-        })).toBeUndefined();
-        expect(createPreviewRenderedMessage({
-            search: '?__miaoda_preview_run_id=prv_valid',
-            customTtiMs: NaN,
-            eventTimeStampMs: 999,
-            performanceTimeOriginMs: 1000
-        })).toBeUndefined();
-    });
-});
-describe('initPreviewRunReporting', ()=>{
-    it('只向可信妙搭父页面回传一次 TTI，并支持旧版 detail', ()=>{
-        let listener;
-        const postMessage = vi.fn();
-        const cleanup = initPreviewRunReporting({
-            search: '?__miaoda_preview_run_id=prv_runtime',
-            referrer: 'https://miaoda.feishu-boe.cn/app/app_test',
-            performanceTimeOriginMs: 1700000000000,
-            isEmbedded: true,
-            addEventListener: (_type, handler)=>{
-                listener = handler;
-            },
-            removeEventListener: vi.fn(),
-            postMessage
-        });
-        listener?.({
-            timeStamp: 2345,
-            detail: {
-                time: 456
-            }
-        });
-        listener?.({
-            timeStamp: 2345,
-            detail: {
-                time: 456
-            }
-        });
-        expect(postMessage).toHaveBeenCalledTimes(1);
-        expect(postMessage).toHaveBeenCalledWith({
-            type: PREVIEW_RENDERED_MESSAGE_TYPE,
-            data: {
-                runID: 'prv_runtime',
-                customTtiMs: 456,
-                renderedAtEpochMs: 1700000002345
-            }
-        }, 'https://miaoda.feishu-boe.cn');
-        cleanup();
-    });
-    it('拒绝向非妙搭 referrer 回传', ()=>{
-        const addEventListener = vi.fn();
-        initPreviewRunReporting({
-            search: '?__miaoda_preview_run_id=prv_runtime',
-            referrer: 'https://evil.example/app',
-            performanceTimeOriginMs: 1700000000000,
-            isEmbedded: true,
-            addEventListener,
-            removeEventListener: vi.fn(),
-            postMessage: vi.fn()
-        });
-        expect(addEventListener).not.toHaveBeenCalled();
-    });
-});