@djvlc/runtime-web 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { createRuntime } from '@djvlc/runtime-core';
+
+export declare const RUNTIME_VERSION: string;
+/**
+ * 挂载选项（简化版，用于浏览器端）
+ */
+export interface MountOptions {
+    /** 页面 UID */
+    pageUid: string;
+    /** API 基础 URL */
+    apiBaseUrl: string;
+    /** CDN 基础 URL */
+    cdnBaseUrl: string;
+    /** 渠道 */
+    channel?: 'preview' | 'prod' | 'gray';
+    /** 用户 ID */
+    userId?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 认证 Token */
+    authToken?: string;
+    /** 预览 Token（仅 preview 渠道） */
+    previewToken?: string;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 是否启用 SRI 校验 */
+    enableSRI?: boolean;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 加载完成回调 */
+    onLoad?: (data: unknown) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+    /** 性能指标回调 */
+    onMetric?: (metric: unknown) => void;
+}
+/**
+ * 挂载结果
+ */
+export interface MountResult {
+    /** 运行时实例 */
+    runtime: ReturnType<typeof createRuntime>;
+    /** 销毁函数 */
+    destroy: () => void;
+}
+/**
+ * 挂载运行时到指定容器
+ *
+ * @param container - 容器选择器或元素
+ * @param options - 挂载选项
+ * @returns 挂载结果
+ *
+ * @example
+ * ```javascript
+ * const { runtime, destroy } = await DJVRuntime.mount('#app', {
+ *   pageUid: 'page_123',
+ *   apiBaseUrl: 'https://api.example.com',
+ *   cdnBaseUrl: 'https://cdn.example.com',
+ *   channel: 'prod',
+ * });
+ *
+ * // 页面卸载时销毁
+ * window.addEventListener('beforeunload', destroy);
+ * ```
+ */
+export declare function mount(container: string | HTMLElement, options: MountOptions): Promise<MountResult>;
+/**
+ * 预连接 CDN/API 域名（优化加载速度）
+ *
+ * @param hosts - 域名列表
+ *
+ * @example
+ * ```javascript
+ * DJVRuntime.preconnect(['cdn.example.com', 'api.example.com']);
+ * ```
+ */
+export declare function preconnect(hosts: string[]): void;
+/**
+ * 预加载 runtime 资源
+ *
+ * @param cdnBaseUrl - CDN 基础 URL
+ * @param version - 运行时版本（默认当前版本）
+ */
+export declare function preloadAssets(cdnBaseUrl: string, version?: string): void;
+/**
+ * 获取设备 ID（自动生成并持久化）
+ */
+export declare function getDeviceId(): string;
+/**
+ * 生成追踪 ID（W3C Trace Context 格式）
+ */
+export declare function generateTraceId(): string;
+/**
+ * 生成 Span ID
+ */
+export declare function generateSpanId(): string;
+/**
+ * 生成 traceparent 头
+ */
+export declare function generateTraceparent(): string;
+export { createRuntime } from '@djvlc/runtime-core';
+export type { RuntimeOptions, RuntimeState, LoadedComponent, Logger } from '@djvlc/runtime-core';
+declare const _default: {
+    mount: typeof mount;
+    preconnect: typeof preconnect;
+    preloadAssets: typeof preloadAssets;
+    getDeviceId: typeof getDeviceId;
+    generateTraceId: typeof generateTraceId;
+    generateSpanId: typeof generateSpanId;
+    generateTraceparent: typeof generateTraceparent;
+    createRuntime: typeof createRuntime;
+    RUNTIME_VERSION: string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,eAAO,MAAM,eAAe,QAA6E,CAAC;AAI1G;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS;IACT,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,aAAa;IACb,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAC1C,WAAW;IACX,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAQhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,MAAwB,GAAG,IAAI,CAgBzF;AAED;;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,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;;;;;;;;;;;;AAIjG,wBAUE"}