@djvlc/runtime-web 1.0.3 → 1.0.4

package/dist/tracking.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 埋点与追踪
+ */
+/**
+ * 埋点事件
+ */
+export interface TrackEvent {
+    /** 事件名称 */
+    event: string;
+    /** 事件数据 */
+    data?: Record<string, unknown>;
+    /** 页面 UID */
+    pageUid?: string;
+    /** 页面版本 ID */
+    pageVersionId?: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 追踪 ID */
+    traceId?: string;
+}
+/**
+ * 埋点配置
+ */
+export interface TrackingConfig {
+    /** 上报端点 */
+    endpoint?: string;
+    /** 批量上报阈值 */
+    batchSize?: number;
+    /** 上报间隔 */
+    flushInterval?: number;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 采样率 */
+    sampleRate?: number;
+    /** 自定义上报函数 */
+    reporter?: (events: TrackEvent[]) => void | Promise<void>;
+}
+/**
+ * 埋点管理器
+ */
+export declare class TrackingManager {
+    private events;
+    private config;
+    private flushTimer;
+    private traceId;
+    constructor(config?: TrackingConfig);
+    /**
+     * 追踪事件
+     */
+    track(event: string, data?: Record<string, unknown>, context?: Partial<TrackEvent>): void;
+    /**
+     * 追踪页面访问
+     */
+    trackPageView(pageUid: string, pageVersionId?: string): void;
+    /**
+     * 追踪组件曝光
+     */
+    trackComponentView(componentId: string, componentType: string, pageUid?: string): void;
+    /**
+     * 追踪组件点击
+     */
+    trackComponentClick(componentId: string, componentType: string, pageUid?: string): void;
+    /**
+     * 追踪动作执行
+     */
+    trackAction(actionType: string, success: boolean, duration: number, pageUid?: string): void;
+    /**
+     * 追踪错误
+     */
+    trackError(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * 立即上报
+     */
+    flush(): Promise<void>;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+    private defaultReporter;
+}
+/**
+ * 创建埋点管理器
+ */
+export declare function createTrackingManager(config?: TrackingConfig): TrackingManager;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,cAAmB;IAiBvC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAmBzF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAY5D;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAItF;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvF;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3F;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQjE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACH,OAAO,IAAI,IAAI;YAQD,eAAe;CAU9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,eAAe,CAE9E"}

package/dist/utils.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 工具函数
+ */
+/**
+ * 预连接 CDN/API 域名
+ */
+export declare function preconnect(hosts: string[]): void;
+/**
+ * 预加载 runtime 资源
+ */
+export declare function preloadAssets(cdnBaseUrl: string, version?: string): void;
+/**
+ * 获取设备 ID
+ */
+export declare function getDeviceId(): string;
+/**
+ * 生成追踪 ID
+ */
+export declare function generateTraceId(): string;
+/**
+ * 生成 Span ID
+ */
+export declare function generateSpanId(): string;
+/**
+ * 生成 traceparent 头
+ */
+export declare function generateTraceparent(): string;
+export declare const urlUtils: {
+    /**
+     * 获取 URL 参数
+     */
+    getParam(name: string, url?: string): string | null;
+    /**
+     * 设置 URL 参数
+     */
+    setParam(name: string, value: string): void;
+    /**
+     * 删除 URL 参数
+     */
+    removeParam(name: string): void;
+    /**
+     * 构建 URL
+     */
+    build(base: string, params: Record<string, string | number | boolean | undefined>): string;
+};
+/**
+ * 可见性监听
+ */
+export declare function onVisibilityChange(callback: (visible: boolean) => void): () => void;
+/**
+ * 网络状态监听
+ */
+export declare function onNetworkChange(callback: (online: boolean) => void): () => void;
+/**
+ * 检测是否为移动端
+ */
+export declare function isMobile(): boolean;
+/**
+ * 检测是否为微信环境
+ */
+export declare function isWeChat(): boolean;
+/**
+ * 检测是否支持 WebP
+ */
+export declare function supportsWebP(): Promise<boolean>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAQhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,MAAwB,GAAG,IAAI,CAgBzF;AAID;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAcpC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAID,eAAO,MAAM,QAAQ;IACnB;;OAEG;mBACY,MAAM,iBAA+B,MAAM,GAAG,IAAI;IAKjE;;OAEG;mBACY,MAAM,SAAS,MAAM,GAAG,IAAI;IAM3C;;OAEG;sBACe,MAAM,GAAG,IAAI;IAM/B;;OAEG;gBAEK,MAAM,UACJ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM;CASV,CAAC;AAIF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAMnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAS/E;AAID;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAIlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAYrD"}

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 版本信息
+ */
+export declare const RUNTIME_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,eAAe,QACgD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djvlc/runtime-web",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "DJV 低代码平台浏览器版运行时（CDN 发布用）",
   "type": "module",
   "main": "./dist/runtime.iife.js",
@@ -33,9 +33,8 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "@djvlc/contracts-types": "^1.4.0",
     "@djvlc/openapi-user-client": "^1.5.0",
-    "@djvlc/runtime-core": "1.0.0"
+    "@djvlc/runtime-core": "1.0.1"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",