@hd-front-end/jsbridge-sdk 1.0.1

package/dist/index.umd.js

@@ -0,0 +1,1561 @@
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+    typeof define === 'function' && define.amd ? define(['exports'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.JSBridgeSDK = {}));
+})(this, (function (exports) { 'use strict';
+
+    /**
+     * JSBridge 核心通信层
+     *
+     * 参考：context/soa/src/jsBridge/JsBridge.ts
+     * 优化：增强错误处理、超时机制、初始化重试
+     */
+    class Bridge {
+        constructor() {
+            this.bridge = null;
+            this.isInitialized = false;
+            this.platform = 'unknown';
+            this.initPromise = null;
+            this.detectPlatform();
+        }
+        /**
+         * 检测平台
+         * 优化：支持更多的 UA 特征识别
+         */
+        detectPlatform() {
+            if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+                this.platform = 'unknown';
+                return;
+            }
+            const ua = navigator.userAgent;
+            // Android 检测
+            if (/SoaAndroid/i.test(ua) || /HDApp.*Android/i.test(ua)) {
+                this.platform = 'android';
+                return;
+            }
+            // iOS 检测
+            if (/iPhone|iPad|iPod/i.test(ua) && /HDApp/i.test(ua)) {
+                this.platform = 'ios';
+                return;
+            }
+            this.platform = 'unknown';
+        }
+        /**
+         * 初始化 JSBridge
+         * 优化：支持多次调用（返回同一个 Promise）、增加重试机制
+         */
+        async init() {
+            // 如果已初始化，直接返回成功
+            if (this.isInitialized) {
+                return true;
+            }
+            // 如果正在初始化，返回同一个 Promise
+            if (this.initPromise) {
+                return this.initPromise;
+            }
+            // 不在原生环境中
+            if (this.platform === 'unknown') {
+                console.warn('[JSBridge] 不在原生 App 环境中');
+                return false;
+            }
+            // 创建初始化 Promise
+            this.initPromise = new Promise((resolve, reject) => {
+                var _a;
+                try {
+                    // 检查是否已有 Bridge 实例
+                    if (window.WKWebViewJavascriptBridge) {
+                        this.bridge = window.WKWebViewJavascriptBridge;
+                        this.isInitialized = true;
+                        resolve(true);
+                        return;
+                    }
+                    // 初始化 WKWVJBCallbacks 队列
+                    if (!window.WKWVJBCallbacks) {
+                        window.WKWVJBCallbacks = [];
+                    }
+                    // 添加回调到队列
+                    window.WKWVJBCallbacks.push((bridge) => {
+                        this.bridge = bridge;
+                        this.isInitialized = true;
+                        resolve(true);
+                    });
+                    // Android 平台：触发注入
+                    if (this.platform === 'android') {
+                        // 兼容性检查：InjectJavascript 可能未注入或延迟注入
+                        // 优化策略：如果 InjectJavascript 不存在，不立即报错，而是等待原生注入（通过超时机制）
+                        if (window.InjectJavascript && typeof window.InjectJavascript.init === 'function') {
+                            window.InjectJavascript.init();
+                        }
+                        else {
+                            console.warn('[JSBridge] InjectJavascript 暂未就绪，等待原生注入或超时...');
+                            // 不 reject，依赖下方的 setTimeout 超时机制或原生主动调用 WKWVJBCallbacks
+                        }
+                    }
+                    // iOS 平台：使用 iframe 触发
+                    if (this.platform === 'ios') {
+                        const iframe = document.createElement('iframe');
+                        iframe.style.display = 'none';
+                        iframe.src = 'https://__bridge_loaded__';
+                        document.documentElement.appendChild(iframe);
+                        setTimeout(() => {
+                            document.documentElement.removeChild(iframe);
+                        }, 0);
+                    }
+                    // 超时保护（10 秒）
+                    const timeoutId = setTimeout(() => {
+                        if (!this.isInitialized) {
+                            const error = new Error(`${this.platform} 初始化超时`);
+                            console.error(`[JSBridge] ${error.message}`);
+                            reject(error);
+                        }
+                    }, 10000);
+                    // 清理超时定时器（当初始化成功时）
+                    (_a = this.initPromise) === null || _a === void 0 ? void 0 : _a.then(() => clearTimeout(timeoutId));
+                }
+                catch (error) {
+                    console.error('[JSBridge] 初始化异常:', error);
+                    reject(error);
+                }
+            });
+            return this.initPromise;
+        }
+        /**
+         * 等待 Bridge 就绪
+         * 轮询检查 Bridge 实例是否存在
+         */
+        async waitForReady() {
+            if (this.bridge)
+                return;
+            return new Promise((resolve, reject) => {
+                let retryCount = 0;
+                const maxRetries = 20; // 最多重试 20 次 (4秒)
+                const interval = 200; // 每次间隔 200ms
+                const check = () => {
+                    var _a;
+                    // 再次尝试从全局获取
+                    if (window.WKWebViewJavascriptBridge) {
+                        this.bridge = window.WKWebViewJavascriptBridge;
+                        this.isInitialized = true;
+                        resolve();
+                        return;
+                    }
+                    // Android 再次尝试触发注入
+                    if (this.platform === 'android' && ((_a = window.InjectJavascript) === null || _a === void 0 ? void 0 : _a.init)) {
+                        window.InjectJavascript.init();
+                    }
+                    retryCount++;
+                    if (retryCount > maxRetries) {
+                        reject(new Error('Bridge 等待就绪超时'));
+                    }
+                    else {
+                        setTimeout(check, interval);
+                    }
+                };
+                check();
+            });
+        }
+        /**
+         * 调用原生方法
+         * 优化：自动初始化、增强错误处理、支持泛型返回值
+         */
+        async call(method, data) {
+            // 自动初始化
+            if (!this.isInitialized) {
+                await this.init();
+            }
+            // 确保 bridge 实例就绪
+            if (!this.bridge) {
+                try {
+                    await this.waitForReady();
+                }
+                catch (e) {
+                    throw new Error(`调用 ${method} 失败: Bridge 未就绪`);
+                }
+            }
+            return new Promise((resolve, reject) => {
+                try {
+                    // 超时控制（10 秒）
+                    const timeoutId = setTimeout(() => {
+                        reject(new Error(`${method} 调用超时`));
+                    }, 10000);
+                    // 调用原生方法
+                    this.bridge.callHandler(method, data, (result) => {
+                        clearTimeout(timeoutId);
+                        resolve(result);
+                    });
+                }
+                catch (error) {
+                    console.error(`[JSBridge] ${method} 调用异常:`, error);
+                    reject(error);
+                }
+            });
+        }
+        /**
+         * 注册 JS 方法供原生调用
+         * 优化：增加错误处理
+         */
+        async register(method, handler) {
+            // 自动初始化
+            if (!this.isInitialized) {
+                const success = await this.init();
+                if (!success) {
+                    throw new Error('JSBridge 未初始化');
+                }
+            }
+            try {
+                this.bridge.registerHandler(method, handler);
+            }
+            catch (error) {
+                console.error(`[JSBridge] 注册方法失败: ${method}`, error);
+                throw error;
+            }
+        }
+        /**
+         * 检查是否在 App 内
+         */
+        inApp() {
+            return this.platform !== 'unknown';
+        }
+        /**
+         * 获取平台类型
+         */
+        getPlatform() {
+            return this.platform;
+        }
+        /**
+         * 检查是否已初始化
+         */
+        isReady() {
+            return this.isInitialized;
+        }
+    }
+    // 导出单例
+    const bridge = new Bridge();
+
+    /**
+     * JSBridge SDK 类型定义
+     */
+    // ==================== 日志类型 ====================
+    exports.LogLevel = void 0;
+    (function (LogLevel) {
+        LogLevel["DEBUG"] = "DEBUG";
+        LogLevel["INFO"] = "INFO";
+        LogLevel["WARN"] = "WARN";
+        LogLevel["ERROR"] = "ERROR";
+    })(exports.LogLevel || (exports.LogLevel = {}));
+
+    /**
+     * 日志 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts (line 152-154)
+     * 优化：增强类型安全、支持批量日志、支持日志队列
+     */
+    /**
+     * 写入日志到原生端
+     *
+     * @example
+     * await writeLog({
+     *   tag: 'MyApp',
+     *   level: LogLevel.INFO,
+     *   message: '用户点击了按钮'
+     * })
+     */
+    async function writeLog(request) {
+        try {
+            // 调用原生 log handler
+            await bridge.call('log', {
+                tag: request.tag || 'JSBridge',
+                level: request.level,
+                message: request.message
+            });
+        }
+        catch (error) {
+            // 日志上报失败不应该影响业务逻辑，只在控制台警告
+            console.warn('[JSBridge] 日志上报失败:', error);
+        }
+    }
+    /**
+     * 便捷的日志方法
+     *
+     * @example
+     * await log.info('用户登录成功', 'Auth')
+     * await log.error('网络请求失败', 'Network')
+     */
+    const log = {
+        /**
+         * DEBUG 级别日志
+         */
+        debug: async (message, tag) => {
+            return writeLog({
+                level: 'DEBUG',
+                message,
+                tag
+            });
+        },
+        /**
+         * INFO 级别日志
+         */
+        info: async (message, tag) => {
+            return writeLog({
+                level: 'INFO',
+                message,
+                tag
+            });
+        },
+        /**
+         * WARN 级别日志
+         */
+        warn: async (message, tag) => {
+            return writeLog({
+                level: 'WARN',
+                message,
+                tag
+            });
+        },
+        /**
+         * ERROR 级别日志
+         */
+        error: async (message, tag) => {
+            return writeLog({
+                level: 'ERROR',
+                message,
+                tag
+            });
+        }
+    };
+
+    /**
+     * 监控层
+     *
+     * 优化：
+     * - 使用原生 log 上报（不依赖 HTTP）
+     * - 支持性能统计
+     * - 支持错误追踪
+     * - 自动批量上报
+     */
+    let Monitor$1 = class Monitor {
+        constructor() {
+            this.records = [];
+            this.reportTimer = null;
+            this.config = {
+                enabled: false,
+                autoReport: false,
+                reportInterval: 60000, // 默认 60 秒
+                maxRecords: 100,
+                logTag: 'JSBridge-Monitor'
+            };
+        }
+        /**
+         * 初始化监控
+         */
+        init(config) {
+            this.config = {
+                ...this.config,
+                ...config
+            };
+            if (this.config.enabled && this.config.autoReport) {
+                this.startAutoReport();
+            }
+        }
+        /**
+         * 开始自动上报
+         * 优化：使用 visibilitychange 控制上报
+         */
+        startAutoReport() {
+            // 清理旧的定时器
+            if (this.reportTimer) {
+                clearInterval(this.reportTimer);
+            }
+            // 启动定时上报
+            this.reportTimer = window.setInterval(() => {
+                // 只在页面可见时上报
+                if (!document.hidden) {
+                    this.report().catch(err => {
+                        console.warn('[Monitor] 自动上报失败:', err);
+                    });
+                }
+            }, this.config.reportInterval);
+            // 监听页面可见性变化
+            document.addEventListener('visibilitychange', () => {
+                if (!document.hidden && this.records.length > 0) {
+                    // 页面变为可见时，立即上报积压的数据
+                    this.report().catch(err => {
+                        console.warn('[Monitor] 可见性变化上报失败:', err);
+                    });
+                }
+            });
+        }
+        /**
+         * 停止自动上报
+         */
+        stopAutoReport() {
+            if (this.reportTimer) {
+                clearInterval(this.reportTimer);
+                this.reportTimer = null;
+            }
+        }
+        /**
+         * 记录 API 调用
+         */
+        record(api, duration, success, error) {
+            if (!this.config.enabled)
+                return;
+            const record = {
+                api,
+                timestamp: Date.now(),
+                duration,
+                success,
+                error,
+                platform: bridge.getPlatform()
+            };
+            this.records.push(record);
+            // 超过最大记录数时，自动上报
+            if (this.records.length >= this.config.maxRecords) {
+                this.report().catch(err => {
+                    console.warn('[Monitor] 自动上报失败:', err);
+                });
+            }
+        }
+        /**
+         * 上报监控数据（通过原生 log）
+         */
+        async report() {
+            if (this.records.length === 0)
+                return;
+            // 复制并清空记录
+            const recordsToReport = this.records.slice(0, this.config.maxRecords);
+            this.records = this.records.slice(this.config.maxRecords);
+            const data = {
+                timestamp: Date.now(),
+                platform: bridge.getPlatform(),
+                count: recordsToReport.length,
+                records: recordsToReport
+            };
+            try {
+                // 通过 log handler 上报（INFO 级别）
+                await writeLog({
+                    tag: this.config.logTag,
+                    level: 'INFO',
+                    message: `[MONITOR] ${JSON.stringify(data)}`
+                });
+                console.log(`[Monitor] 上报成功，记录数: ${recordsToReport.length}`);
+            }
+            catch (error) {
+                console.error('[Monitor] 上报失败:', error);
+                // 上报失败，放回队列（但限制最大数量）
+                this.records = [...recordsToReport, ...this.records].slice(0, this.config.maxRecords * 2);
+                throw error;
+            }
+        }
+        /**
+         * 上报错误（立即上报）
+         */
+        async reportError(api, error, detail) {
+            if (!this.config.enabled)
+                return;
+            const errorData = {
+                timestamp: Date.now(),
+                api,
+                error,
+                detail,
+                platform: bridge.getPlatform(),
+                userAgent: navigator.userAgent
+            };
+            try {
+                // 通过 log handler 立即上报（ERROR 级别）
+                await writeLog({
+                    tag: this.config.logTag,
+                    level: 'ERROR',
+                    message: `[ERROR] ${JSON.stringify(errorData)}`
+                });
+            }
+            catch (err) {
+                console.error('[Monitor] 错误上报失败:', err);
+            }
+        }
+        /**
+         * 获取统计信息
+         */
+        getStats() {
+            const totalCalls = this.records.length;
+            const successCalls = this.records.filter(r => r.success).length;
+            const failedCalls = totalCalls - successCalls;
+            const avgDuration = totalCalls > 0
+                ? this.records.reduce((sum, r) => sum + r.duration, 0) / totalCalls
+                : 0;
+            const successRate = totalCalls > 0 ? successCalls / totalCalls : 0;
+            return {
+                totalCalls,
+                successCalls,
+                failedCalls,
+                avgDuration: Math.round(avgDuration),
+                successRate: Math.round(successRate * 10000) / 100 // 保留两位小数
+            };
+        }
+        /**
+         * 获取所有记录
+         */
+        getRecords() {
+            return [...this.records];
+        }
+        /**
+         * 清空记录
+         */
+        clear() {
+            this.records = [];
+        }
+        /**
+         * 销毁监控器
+         */
+        destroy() {
+            this.stopAutoReport();
+            this.clear();
+        }
+    };
+    // 导出单例
+    const monitor = new Monitor$1();
+
+    /**
+     * 调试层
+     *
+     * 优化：
+     * - 动态加载 vconsole（按需加载）
+     * - 支持调用追踪
+     * - 支持日志分级
+     */
+    let Debug$1 = class Debug {
+        constructor() {
+            this.vConsole = null;
+            this.logs = [];
+            this.maxLogs = 100;
+            this.config = {
+                enabled: false,
+                useVConsole: false,
+                logLevel: 'info',
+                showTimestamp: true
+            };
+        }
+        /**
+         * 初始化调试模式
+         */
+        async init(config) {
+            this.config = {
+                ...this.config,
+                ...config
+            };
+            if (this.config.enabled && this.config.useVConsole) {
+                await this.initVConsole();
+            }
+        }
+        /**
+         * 初始化 vconsole
+         * 优化：动态导入，只在需要时加载
+         */
+        async initVConsole() {
+            if (this.vConsole) {
+                console.log('[Debug] vconsole 已存在');
+                return;
+            }
+            // 检查是否已被其他地方初始化
+            if (window.vConsole) {
+                console.log('[Debug] vconsole 已被外部初始化');
+                this.vConsole = window.vConsole;
+                return;
+            }
+            try {
+                // 动态导入 vconsole
+                const VConsoleModule = await import('vconsole');
+                const VConsole = VConsoleModule.default || VConsoleModule;
+                this.vConsole = new VConsole({
+                    theme: 'dark',
+                    defaultPlugins: ['system', 'network', 'element', 'storage'],
+                    maxLogNumber: 1000
+                });
+                console.log('[Debug] vconsole 初始化成功');
+            }
+            catch (error) {
+                console.warn('[Debug] vconsole 加载失败:', error);
+                console.warn('[Debug] 请确保已安装 vconsole: npm install vconsole');
+            }
+        }
+        /**
+         * 记录调用追踪
+         */
+        trace(api, message, data) {
+            if (!this.config.enabled)
+                return;
+            const log = {
+                timestamp: Date.now(),
+                level: this.config.logLevel,
+                api,
+                message,
+                data
+            };
+            this.logs.push(log);
+            // 限制日志数量
+            if (this.logs.length > this.maxLogs) {
+                this.logs.shift();
+            }
+            // 输出到控制台
+            this.outputLog(log);
+        }
+        /**
+         * 输出日志到控制台
+         */
+        outputLog(log) {
+            const timestamp = this.config.showTimestamp
+                ? `[${new Date(log.timestamp).toLocaleTimeString()}]`
+                : '';
+            const prefix = `${timestamp} [JSBridge][${log.api}]`;
+            const message = `${prefix} ${log.message}`;
+            switch (log.level) {
+                case 'debug':
+                    console.debug(message, log.data || '');
+                    break;
+                case 'info':
+                    console.info(message, log.data || '');
+                    break;
+                case 'warn':
+                    console.warn(message, log.data || '');
+                    break;
+                case 'error':
+                    console.error(message, log.data || '');
+                    break;
+                default:
+                    console.log(message, log.data || '');
+            }
+        }
+        /**
+         * 获取所有日志
+         */
+        getLogs() {
+            return [...this.logs];
+        }
+        /**
+         * 清空日志
+         */
+        clearLogs() {
+            this.logs = [];
+        }
+        /**
+         * 销毁调试器
+         */
+        destroy() {
+            if (this.vConsole && typeof this.vConsole.destroy === 'function') {
+                this.vConsole.destroy();
+                this.vConsole = null;
+            }
+            this.clearLogs();
+        }
+    };
+    // 导出单例
+    const debug = new Debug$1();
+
+    /**
+     * 设备相关 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts
+     */
+    /**
+     * 扫码
+     * 参考：JsBridgeHandlers.ts line 75-87
+     *
+     * @example
+     * const result = await scan({ scanType: ['qrCode', 'barCode'] })
+     * if (result.resp_code === 1000) {
+     *   console.log('扫码结果:', result.resp_result)
+     * }
+     */
+    async function scan(request = {}) {
+        const startTime = Date.now();
+        try {
+            debug.trace('scan', '开始扫码', request);
+            const result = await bridge.call('scan', request);
+            // 解析返回结果（参考 JsBridgeHandlers.ts line 76-86）
+            const parsedResult = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            const success = parsedResult.resp_code === 1000;
+            monitor.record('scan', duration, success, parsedResult.resp_message);
+            debug.trace('scan', success ? '扫码成功' : '扫码取消', parsedResult);
+            return parsedResult;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('scan', duration, false, error.message);
+            monitor.reportError('scan', error.message, request);
+            debug.trace('scan', '扫码失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 震动
+     *
+     * @param duration 震动时长（毫秒），默认 400ms
+     */
+    async function vibrate(duration = 400) {
+        const startTime = Date.now();
+        try {
+            debug.trace('vibrate', '开始震动', { duration });
+            await bridge.call('vibrate', { duration });
+            const elapsed = Date.now() - startTime;
+            monitor.record('vibrate', elapsed, true);
+            debug.trace('vibrate', '震动完成');
+        }
+        catch (error) {
+            const elapsed = Date.now() - startTime;
+            monitor.record('vibrate', elapsed, false, error.message);
+            debug.trace('vibrate', '震动失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取设备信息
+     *
+     * @example
+     * const info = await getDeviceInfo()
+     * console.log('设备型号:', info.model)
+     * console.log('系统版本:', info.version)
+     */
+    async function getDeviceInfo() {
+        const startTime = Date.now();
+        try {
+            debug.trace('getDeviceInfo', '获取设备信息');
+            const result = await bridge.call('getDeviceInfo');
+            const info = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            monitor.record('getDeviceInfo', duration, true);
+            debug.trace('getDeviceInfo', '获取成功', info);
+            return info;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('getDeviceInfo', duration, false, error.message);
+            debug.trace('getDeviceInfo', '获取失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取网络类型
+     *
+     * @example
+     * const network = await getNetworkType()
+     * console.log('网络类型:', network.networkType)
+     */
+    async function getNetworkType() {
+        const startTime = Date.now();
+        try {
+            debug.trace('getNetworkType', '获取网络类型');
+            const result = await bridge.call('getNetworkType');
+            const info = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            monitor.record('getNetworkType', duration, true);
+            debug.trace('getNetworkType', '获取成功', info);
+            return info;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('getNetworkType', duration, false, error.message);
+            debug.trace('getNetworkType', '获取失败', error);
+            throw error;
+        }
+    }
+
+    /**
+     * 媒体相关 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts
+     */
+    /**
+     * 选择图片/视频
+     * 参考：JsBridgeHandlers.ts line 93-100
+     *
+     * @example
+     * const result = await chooseMedia({
+     *   count: 9,
+     *   mediaType: ['image'],
+     *   sourceType: ['album', 'camera']
+     * })
+     */
+    async function chooseMedia(request) {
+        const startTime = Date.now();
+        try {
+            debug.trace('chooseMedia', '选择媒体', request);
+            const result = await bridge.call('chooseMedia', request);
+            if (!result) {
+                debug.trace('chooseMedia', '用户取消选择');
+                monitor.record('chooseMedia', Date.now() - startTime, true);
+                return null;
+            }
+            const mediaResult = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            monitor.record('chooseMedia', duration, true);
+            debug.trace('chooseMedia', '选择成功', mediaResult);
+            return mediaResult;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('chooseMedia', duration, false, error.message);
+            monitor.reportError('chooseMedia', error.message, request);
+            debug.trace('chooseMedia', '选择失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 上传文件
+     * 参考：JsBridgeHandlers.ts line 117-122
+     *
+     * @example
+     * const result = await uploadFile({
+     *   url: 'https://api.example.com/upload',
+     *   filePath: '/path/to/file',
+     *   name: 'file'
+     * })
+     */
+    async function uploadFile(request) {
+        const startTime = Date.now();
+        try {
+            debug.trace('uploadFile', '上传文件', request);
+            const result = await bridge.call('uploadFile', request);
+            const uploadResult = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            const success = uploadResult.statusCode >= 200 && uploadResult.statusCode < 300;
+            monitor.record('uploadFile', duration, success, uploadResult.errMsg);
+            debug.trace('uploadFile', success ? '上传成功' : '上传失败', uploadResult);
+            return uploadResult;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('uploadFile', duration, false, error.message);
+            monitor.reportError('uploadFile', error.message, request);
+            debug.trace('uploadFile', '上传异常', error);
+            throw error;
+        }
+    }
+    /**
+     * 预览图片
+     *
+     * @param urls 图片URL数组
+     * @param current 当前显示图片的索引，默认 0
+     */
+    async function previewImage(urls, current = 0) {
+        const startTime = Date.now();
+        try {
+            debug.trace('previewImage', '预览图片', { urls, current });
+            await bridge.call('previewImage', { urls, current });
+            const duration = Date.now() - startTime;
+            monitor.record('previewImage', duration, true);
+            debug.trace('previewImage', '预览完成');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('previewImage', duration, false, error.message);
+            debug.trace('previewImage', '预览失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取图片信息
+     * 参考：JsBridgeHandlers.ts line 106-111
+     *
+     * @param path 图片路径
+     */
+    async function getImageInfo(path) {
+        const startTime = Date.now();
+        try {
+            debug.trace('getImageInfo', '获取图片信息', { path });
+            const result = await bridge.call('getImageInfo', { path });
+            const imageInfo = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            monitor.record('getImageInfo', duration, true);
+            debug.trace('getImageInfo', '获取成功', imageInfo);
+            return imageInfo;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('getImageInfo', duration, false, error.message);
+            debug.trace('getImageInfo', '获取失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 蓝牙打印
+     * 参考：JsBridgeHandlers.ts line 182-194
+     *
+     * @param request 打印请求
+     */
+    async function bluetoothPrint(request) {
+        const startTime = Date.now();
+        try {
+            debug.trace('bluetoothPrint', '蓝牙打印', request);
+            const result = await bridge.call('bluetoothPrint', request);
+            // 处理返回结果
+            let parsedResult = result;
+            if (result && typeof result === 'string') {
+                try {
+                    parsedResult = JSON.parse(result);
+                }
+                catch (_a) {
+                    // 如果解析失败，返回原始字符串
+                }
+            }
+            const duration = Date.now() - startTime;
+            monitor.record('bluetoothPrint', duration, true);
+            debug.trace('bluetoothPrint', '打印完成', parsedResult);
+            return parsedResult;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('bluetoothPrint', duration, false, error.message);
+            monitor.reportError('bluetoothPrint', error.message, request);
+            debug.trace('bluetoothPrint', '打印失败', error);
+            throw error;
+        }
+    }
+
+    /**
+     * 路由相关 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts
+     */
+    /**
+     * 设置导航栏样式
+     * 参考：JsBridgeHandlers.ts line 144-146
+     *
+     * @example
+     * await setNavigationBar({
+     *   navigationBarTitleText: '订单详情',
+     *   backgroundColor: '#ffffff',
+     *   textColor: '#000000'
+     * })
+     */
+    async function setNavigationBar(style) {
+        const startTime = Date.now();
+        try {
+            debug.trace('setNavigationBar', '设置导航栏', style);
+            await bridge.call('setNavigationBar', style);
+            const duration = Date.now() - startTime;
+            monitor.record('setNavigationBar', duration, true);
+            debug.trace('setNavigationBar', '设置成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('setNavigationBar', duration, false, error.message);
+            debug.trace('setNavigationBar', '设置失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 关闭当前 WebView
+     * 参考：JsBridgeHandlers.ts line 128-130
+     *
+     * @example
+     * await closeWebView()
+     */
+    async function closeWebView() {
+        const startTime = Date.now();
+        try {
+            debug.trace('closeWebView', '关闭页面');
+            await bridge.call('closeWebView');
+            const duration = Date.now() - startTime;
+            monitor.record('closeWebView', duration, true);
+            debug.trace('closeWebView', '关闭成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('closeWebView', duration, false, error.message);
+            debug.trace('closeWebView', '关闭失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 注册路由跳转回调
+     * 参考：JsBridgeHandlers.ts line 44-46
+     *
+     * @example
+     * onRoute((data, callback) => {
+     *   console.log('路由跳转:', data)
+     *   router.push(data.path)
+     *   callback({ success: true })
+     * })
+     */
+    async function onRoute(handler) {
+        try {
+            debug.trace('onRoute', '注册路由跳转回调');
+            await bridge.register('route', handler);
+            debug.trace('onRoute', '注册成功');
+        }
+        catch (error) {
+            debug.trace('onRoute', '注册失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 注册获取路由信息回调
+     * 参考：JsBridgeHandlers.ts line 51-53
+     *
+     * @example
+     * onGetRouteInfo((data, callback) => {
+     *   callback({ routes: routeConfig })
+     * })
+     */
+    async function onGetRouteInfo(handler) {
+        try {
+            debug.trace('onGetRouteInfo', '注册获取路由信息回调');
+            await bridge.register('getRouteInfo', handler);
+            debug.trace('onGetRouteInfo', '注册成功');
+        }
+        catch (error) {
+            debug.trace('onGetRouteInfo', '注册失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 通知原生路由变化
+     * 参考：JsBridgeHandlers.ts line 21-23
+     *
+     * @param to 目标路由
+     * @param from 来源路由
+     */
+    async function notifyRouteChange(to, from) {
+        const startTime = Date.now();
+        try {
+            debug.trace('notifyRouteChange', '通知路由变化', { to, from });
+            await bridge.call('routerAfterEach', { to, from });
+            const duration = Date.now() - startTime;
+            monitor.record('notifyRouteChange', duration, true);
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('notifyRouteChange', duration, false, error.message);
+            debug.trace('notifyRouteChange', '通知失败', error);
+            // 路由变化通知失败不应该阻塞业务
+            console.warn('[JSBridge] 路由变化通知失败:', error);
+        }
+    }
+
+    /**
+     * 存储相关 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts
+     */
+    /**
+     * 获取 App 信息
+     * 参考：JsBridgeHandlers.ts line 28-30
+     *
+     * @example
+     * const appInfo = await getAppInfo()
+     * console.log('App 版本:', appInfo.version)
+     */
+    async function getAppInfo() {
+        const startTime = Date.now();
+        try {
+            debug.trace('getAppInfo', '获取 App 信息');
+            const result = await bridge.call('getAppInfo');
+            const appInfo = typeof result === 'string'
+                ? JSON.parse(result)
+                : result;
+            const duration = Date.now() - startTime;
+            monitor.record('getAppInfo', duration, true);
+            debug.trace('getAppInfo', '获取成功', appInfo);
+            return appInfo;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('getAppInfo', duration, false, error.message);
+            debug.trace('getAppInfo', '获取失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 获取存储数据
+     *
+     * @param key 存储键
+     */
+    async function getStorage(key) {
+        const startTime = Date.now();
+        try {
+            debug.trace('getStorage', '获取存储数据', { key });
+            const result = await bridge.call('getStorage', { key });
+            const duration = Date.now() - startTime;
+            monitor.record('getStorage', duration, true);
+            debug.trace('getStorage', '获取成功', result);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('getStorage', duration, false, error.message);
+            debug.trace('getStorage', '获取失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 设置存储数据
+     *
+     * @param key 存储键
+     * @param data 存储数据
+     */
+    async function setStorage(key, data) {
+        const startTime = Date.now();
+        try {
+            debug.trace('setStorage', '设置存储数据', { key, data });
+            await bridge.call('setStorage', { key, data });
+            const duration = Date.now() - startTime;
+            monitor.record('setStorage', duration, true);
+            debug.trace('setStorage', '设置成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('setStorage', duration, false, error.message);
+            debug.trace('setStorage', '设置失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 注册刷新 store 数据回调
+     * 参考：JsBridgeHandlers.ts line 59-61
+     *
+     * @example
+     * onRefreshStore((data, callback) => {
+     *   store.dispatch('refresh', data)
+     *   callback({ success: true })
+     * })
+     */
+    async function onRefreshStore(handler) {
+        try {
+            debug.trace('onRefreshStore', '注册刷新 store 回调');
+            await bridge.register('refreshStore', handler);
+            debug.trace('onRefreshStore', '注册成功');
+        }
+        catch (error) {
+            debug.trace('onRefreshStore', '注册失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 通知原生 App 已加载完成
+     * 参考：JsBridgeHandlers.ts line 160-162
+     *
+     * @param data 启动数据
+     */
+    async function notifyAppOnload(data) {
+        const startTime = Date.now();
+        try {
+            debug.trace('notifyAppOnload', '通知 App 加载完成', data);
+            await bridge.call('uniPageLifeCycle', {
+                lifecycle: 'appOnLaunch',
+                data
+            });
+            const duration = Date.now() - startTime;
+            monitor.record('notifyAppOnload', duration, true);
+            debug.trace('notifyAppOnload', '通知成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('notifyAppOnload', duration, false, error.message);
+            debug.trace('notifyAppOnload', '通知失败', error);
+            // 生命周期通知失败不应该阻塞业务
+            console.warn('[JSBridge] App 加载通知失败:', error);
+        }
+    }
+
+    /**
+     * 系统相关 API
+     *
+     * 参考：context/soa/src/jsBridge/JsBridgeHandlers.ts
+     */
+    /**
+     * 拨打电话
+     * 参考：JsBridgeHandlers.ts line 136-138
+     *
+     * @example
+     * await makePhoneCall({ phoneNumber: '10086' })
+     */
+    async function makePhoneCall(request) {
+        const startTime = Date.now();
+        try {
+            debug.trace('makePhoneCall', '拨打电话', request);
+            await bridge.call('makePhoneCall', request);
+            const duration = Date.now() - startTime;
+            monitor.record('makePhoneCall', duration, true);
+            debug.trace('makePhoneCall', '拨号成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('makePhoneCall', duration, false, error.message);
+            monitor.reportError('makePhoneCall', error.message, request);
+            debug.trace('makePhoneCall', '拨号失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 注册 PDA 扫码回调
+     * 参考：JsBridgeHandlers.ts line 67-69
+     *
+     * @example
+     * onPdaScan((data, callback) => {
+     *   console.log('PDA 扫码结果:', data)
+     *   callback({ success: true })
+     * })
+     */
+    async function onPdaScan(handler) {
+        try {
+            debug.trace('onPdaScan', '注册 PDA 扫码回调');
+            await bridge.register('pdaScan', handler);
+            debug.trace('onPdaScan', '注册成功');
+        }
+        catch (error) {
+            debug.trace('onPdaScan', '注册失败', error);
+            throw error;
+        }
+    }
+    /**
+     * 退出登录
+     *
+     * @example
+     * await logout()
+     */
+    async function logout() {
+        const startTime = Date.now();
+        try {
+            debug.trace('logout', '退出登录');
+            await bridge.call('logout');
+            const duration = Date.now() - startTime;
+            monitor.record('logout', duration, true);
+            debug.trace('logout', '退出成功');
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            monitor.record('logout', duration, false, error.message);
+            debug.trace('logout', '退出失败', error);
+            throw error;
+        }
+    }
+
+    /**
+     * JSBridge SDK
+     * 统一的原生能力封装
+     *
+     * @author HD Digital
+     * @version 1.0.0
+     */
+    /**
+     * 初始化 JSBridge SDK
+     *
+     * @example
+     * const success = await init({
+     *   debug: {
+     *     enabled: true,
+     *     useVConsole: true
+     *   },
+     *   monitor: {
+     *     enabled: true,
+     *     autoReport: true
+     *   }
+     * })
+     */
+    async function init(config) {
+        try {
+            // 1. 初始化 Debug 模式
+            if (config === null || config === void 0 ? void 0 : config.debug) {
+                await debug.init(config.debug);
+                debug.trace('init', 'Debug 模式已启用', config.debug);
+            }
+            // 2. 初始化 Monitor
+            if (config === null || config === void 0 ? void 0 : config.monitor) {
+                monitor.init(config.monitor);
+                debug.trace('init', 'Monitor 已启用', config.monitor);
+            }
+            // 3. 初始化 Bridge
+            const success = await bridge.init();
+            if (success) {
+                // 记录初始化成功日志
+                try {
+                    await writeLog({
+                        level: exports.LogLevel.INFO,
+                        message: `JSBridge 初始化成功 [${bridge.getPlatform()}]`
+                    });
+                }
+                catch (e) {
+                    // 忽略日志上报失败
+                }
+                debug.trace('init', 'JSBridge 初始化成功', {
+                    platform: bridge.getPlatform()
+                });
+            }
+            else {
+                debug.trace('init', 'JSBridge 初始化失败：不在 App 环境中');
+            }
+            return success;
+        }
+        catch (error) {
+            // 记录初始化失败日志
+            try {
+                await writeLog({
+                    level: exports.LogLevel.ERROR,
+                    message: `JSBridge 初始化失败: ${error.message}`
+                });
+            }
+            catch (e) {
+                // 忽略日志上报失败
+            }
+            debug.trace('init', 'JSBridge 初始化异常', error);
+            console.error('[JSBridge] 初始化失败:', error);
+            return false;
+        }
+    }
+    /**
+     * 检查是否在 App 内
+     */
+    function inApp() {
+        return bridge.inApp();
+    }
+    /**
+     * 获取平台类型
+     */
+    function getPlatform() {
+        return bridge.getPlatform();
+    }
+    /**
+     * 检查是否已初始化
+     */
+    function isReady() {
+        return bridge.isReady();
+    }
+    /**
+     * JSBridge API
+     * 所有可用的原生能力
+     */
+    const JSBridge = {
+        // ==================== 设备相关 ====================
+        /**
+         * 扫码
+         * @example
+         * const result = await JSBridge.scan({ scanType: ['qrCode'] })
+         */
+        scan: scan,
+        /**
+         * 震动
+         * @example
+         * await JSBridge.vibrate(400)
+         */
+        vibrate: vibrate,
+        /**
+         * 获取设备信息
+         * @example
+         * const info = await JSBridge.getDeviceInfo()
+         */
+        getDeviceInfo: getDeviceInfo,
+        /**
+         * 获取网络类型
+         * @example
+         * const network = await JSBridge.getNetworkType()
+         */
+        getNetworkType: getNetworkType,
+        // ==================== 媒体相关 ====================
+        /**
+         * 选择图片/视频
+         * @example
+         * const result = await JSBridge.chooseMedia({ count: 9, mediaType: ['image'] })
+         */
+        chooseMedia: chooseMedia,
+        /**
+         * 上传文件
+         * @example
+         * const result = await JSBridge.uploadFile({ url, filePath, name: 'file' })
+         */
+        uploadFile: uploadFile,
+        /**
+         * 预览图片
+         * @example
+         * await JSBridge.previewImage(['url1', 'url2'], 0)
+         */
+        previewImage: previewImage,
+        /**
+         * 获取图片信息
+         * @example
+         * const info = await JSBridge.getImageInfo(path)
+         */
+        getImageInfo: getImageInfo,
+        /**
+         * 蓝牙打印
+         * @example
+         * await JSBridge.bluetoothPrint({ data: printData })
+         */
+        bluetoothPrint: bluetoothPrint,
+        // ==================== 路由相关 ====================
+        /**
+         * 设置导航栏
+         * @example
+         * await JSBridge.setNavigationBar({ navigationBarTitleText: '标题' })
+         */
+        setNavigationBar: setNavigationBar,
+        /**
+         * 关闭当前页面
+         * @example
+         * await JSBridge.closeWebView()
+         */
+        closeWebView: closeWebView,
+        /**
+         * 注册路由跳转回调
+         * @example
+         * JSBridge.onRoute((data, callback) => { router.push(data.path) })
+         */
+        onRoute: onRoute,
+        /**
+         * 注册获取路由信息回调
+         * @example
+         * JSBridge.onGetRouteInfo((data, callback) => { callback(routeConfig) })
+         */
+        onGetRouteInfo: onGetRouteInfo,
+        /**
+         * 通知路由变化
+         * @example
+         * await JSBridge.notifyRouteChange(to, from)
+         */
+        notifyRouteChange: notifyRouteChange,
+        // ==================== 存储相关 ====================
+        /**
+         * 获取 App 信息
+         * @example
+         * const appInfo = await JSBridge.getAppInfo()
+         */
+        getAppInfo: getAppInfo,
+        /**
+         * 获取存储数据
+         * @example
+         * const data = await JSBridge.getStorage('key')
+         */
+        getStorage: getStorage,
+        /**
+         * 设置存储数据
+         * @example
+         * await JSBridge.setStorage('key', data)
+         */
+        setStorage: setStorage,
+        /**
+         * 注册刷新 store 回调
+         * @example
+         * JSBridge.onRefreshStore((data, callback) => { store.dispatch('refresh') })
+         */
+        onRefreshStore: onRefreshStore,
+        /**
+         * 通知 App 加载完成
+         * @example
+         * await JSBridge.notifyAppOnload()
+         */
+        notifyAppOnload: notifyAppOnload,
+        // ==================== 系统相关 ====================
+        /**
+         * 拨打电话
+         * @example
+         * await JSBridge.makePhoneCall({ phoneNumber: '10086' })
+         */
+        makePhoneCall: makePhoneCall,
+        /**
+         * 注册 PDA 扫码回调
+         * @example
+         * JSBridge.onPdaScan((data, callback) => { console.log(data) })
+         */
+        onPdaScan: onPdaScan,
+        /**
+         * 退出登录
+         * @example
+         * await JSBridge.logout()
+         */
+        logout: logout,
+        // ==================== 日志相关 ====================
+        /**
+         * 写入日志
+         * @example
+         * await JSBridge.writeLog({ level: LogLevel.INFO, message: '日志' })
+         */
+        writeLog,
+        /**
+         * 便捷日志方法
+         * @example
+         * await JSBridge.log.info('用户登录', 'Auth')
+         * await JSBridge.log.error('请求失败', 'Network')
+         */
+        log
+    };
+    /**
+     * 监控 API
+     */
+    const Monitor = {
+        /**
+         * 获取统计信息
+         * @example
+         * const stats = Monitor.getStats()
+         */
+        getStats: monitor.getStats.bind(monitor),
+        /**
+         * 获取所有记录
+         * @example
+         * const records = Monitor.getRecords()
+         */
+        getRecords: monitor.getRecords.bind(monitor),
+        /**
+         * 清空记录
+         * @example
+         * Monitor.clear()
+         */
+        clear: monitor.clear.bind(monitor),
+        /**
+         * 手动上报
+         * @example
+         * await Monitor.report()
+         */
+        report: monitor.report.bind(monitor),
+        /**
+         * 上报错误
+         * @example
+         * await Monitor.reportError('api', 'error message')
+         */
+        reportError: monitor.reportError.bind(monitor)
+    };
+    /**
+     * Debug API
+     */
+    const Debug = {
+        /**
+         * 记录追踪日志
+         * @example
+         * Debug.trace('api', 'message', data)
+         */
+        trace: debug.trace.bind(debug),
+        /**
+         * 获取所有日志
+         * @example
+         * const logs = Debug.getLogs()
+         */
+        getLogs: debug.getLogs.bind(debug),
+        /**
+         * 清空日志
+         * @example
+         * Debug.clearLogs()
+         */
+        clearLogs: debug.clearLogs.bind(debug)
+    };
+
+    exports.Debug = Debug;
+    exports.JSBridge = JSBridge;
+    exports.Monitor = Monitor;
+    exports.getPlatform = getPlatform;
+    exports.inApp = inApp;
+    exports.init = init;
+    exports.isReady = isReady;
+
+}));
+//# sourceMappingURL=index.umd.js.map