@be-link/cls-logger 1.0.1-beta.9 → 1.0.4

package/dist/index.umd.js

@@ -564,6 +564,19 @@
             return '';
         }
     }
+    function getMpPagePath() {
+        try {
+            const pages = globalThis.getCurrentPages?.();
+            if (Array.isArray(pages) && pages.length > 0) {
+                const page = pages[pages.length - 1];
+                return page.route || page.__route__ || '';
+            }
+            return '';
+        }
+        catch {
+            return '';
+        }
+    }
     function normalizeErrorLike(err, maxTextLength) {
         if (err && typeof err === 'object') {
             const anyErr = err;
@@ -723,6 +736,7 @@
                             return;
                         const e = normalizeErrorLike(msg, options.maxTextLength);
                         const payload = {
+                            pagePath: getMpPagePath(),
                             source: 'wx.onError',
                             message: e.message,
                             errorName: e.name,
@@ -749,6 +763,7 @@
                             return;
                         const e = normalizeErrorLike(res?.reason, options.maxTextLength);
                         const payload = {
+                            pagePath: getMpPagePath(),
                             source: 'wx.onUnhandledRejection',
                             message: e.message,
                             errorName: e.name,
@@ -780,6 +795,7 @@
                             if (sampleHit$1(options.sampleRate)) {
                                 const e = normalizeErrorLike(args?.[0], options.maxTextLength);
                                 const payload = {
+                                    pagePath: getMpPagePath(),
                                     source: 'App.onError',
                                     message: e.message,
                                     errorName: e.name,
@@ -803,6 +819,7 @@
                                 const reason = args?.[0]?.reason ?? args?.[0];
                                 const e = normalizeErrorLike(reason, options.maxTextLength);
                                 const payload = {
+                                    pagePath: getMpPagePath(),
                                     source: 'App.onUnhandledRejection',
                                     message: e.message,
                                     errorName: e.name,
@@ -1110,18 +1127,28 @@
                             continue;
                         // Page Render: firstRender
                         if (entry.entryType === 'render' && entry.name === 'firstRender') {
+                            const duration = typeof entry.duration === 'number'
+                                ? entry.duration
+                                : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                    ? entry.endTime - entry.startTime
+                                    : 0;
                             report(options.reportType, {
                                 metric: 'page-render',
-                                duration: entry.duration,
+                                duration,
                                 pagePath: entry.path || '',
                                 unit: 'ms',
                             });
                         }
                         // Route Switch: route
                         else if (entry.entryType === 'navigation' && entry.name === 'route') {
+                            const duration = typeof entry.duration === 'number'
+                                ? entry.duration
+                                : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                    ? entry.endTime - entry.startTime
+                                    : 0;
                             report(options.reportType, {
                                 metric: 'route',
-                                duration: entry.duration,
+                                duration,
                                 pagePath: entry.path || '',
                                 unit: 'ms',
                             });
@@ -1465,7 +1492,7 @@
                 const tag = (el.tagName || '').toLowerCase();
                 const trackId = getAttr(el, clickTrackIdAttr);
                 // 过滤无效点击：白名单 tag + 没有 trackId
-                if (clickWhiteList.includes(tag) && !trackId)
+                if (clickWhiteList.includes(tag) || !trackId)
                     return;
                 void uvStatePromise.then(({ uvId, meta }) => {
                     if (destroyed)
@@ -1506,8 +1533,12 @@
                     g.Page = function patchedPage(conf) {
                         const originalOnShow = conf?.onShow;
                         conf.onShow = function (...args) {
-                            if (pvEnabled)
-                                reportPv(getPagePath());
+                            if (pvEnabled) {
+                                const pagePath = getPagePath();
+                                if (pagePath?.length > 0) {
+                                    reportPv(pagePath);
+                                }
+                            }
                             return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
                         };
                         // 点击：wrap 页面 methods（bindtap 等会调用到这里的 handler）
@@ -1861,6 +1892,7 @@
             this.endpoint = 'ap-shanghai.cls.tencentcs.com';
             this.retryTimes = 10;
             this.source = '127.0.0.1';
+            this.enabled = true;
             this.projectId = '';
             this.projectName = '';
             this.appId = '';
@@ -1891,9 +1923,14 @@
          * 子类可按需重写（默认检测 wx）
          */
         detectEnvType() {
-            const wxAny = globalThis.wx;
-            if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
+            const g = globalThis;
+            // 微信、支付宝、字节跳动、UniApp 等小程序环境通常都有特定全局变量
+            if ((g.wx && typeof g.wx.getSystemInfoSync === 'function') ||
+                (g.my && typeof g.my.getSystemInfoSync === 'function') ||
+                (g.tt && typeof g.tt.getSystemInfoSync === 'function') ||
+                (g.uni && typeof g.uni.getSystemInfoSync === 'function')) {
                 return 'miniprogram';
+            }
             return 'browser';
         }
         init(options) {
@@ -1931,6 +1968,7 @@
             this.appId = options.appId ?? this.appId;
             this.appVersion = options.appVersion ?? this.appVersion;
             this.envType = nextEnvType;
+            this.enabled = options.enabled ?? true;
             // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
             this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
             this.sdkOverride = options.sdk ?? this.sdkOverride;
@@ -1947,15 +1985,17 @@
             void this.getInstance().catch(() => {
                 // ignore
             });
-            // 启动时尝试发送失败缓存
-            this.flushFailed();
-            // 初始化后立即启动请求监听
-            this.startRequestMonitor(options.requestMonitor);
-            // 初始化后立即启动错误监控/性能监控
-            this.startErrorMonitor(options.errorMonitor);
-            this.startPerformanceMonitor(options.performanceMonitor);
-            // 初始化后立即启动行为埋点（PV/UV/点击）
-            this.startBehaviorMonitor(options.behaviorMonitor);
+            if (this.enabled) {
+                // 启动时尝试发送失败缓存
+                this.flushFailed();
+                // 初始化后立即启动请求监听
+                this.startRequestMonitor(options.requestMonitor);
+                // 初始化后立即启动错误监控/性能监控
+                this.startErrorMonitor(options.errorMonitor);
+                this.startPerformanceMonitor(options.performanceMonitor);
+                // 初始化后立即启动行为埋点（PV/UV/点击）
+                this.startBehaviorMonitor(options.behaviorMonitor);
+            }
         }
         getBaseFields() {
             let auto = undefined;
@@ -2080,6 +2120,8 @@
          * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
          */
         put(fields, options = {}) {
+            if (!this.enabled)
+                return;
             if (!fields)
                 return;
             if (!this.topicId) {
@@ -2138,6 +2180,8 @@
          * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
          */
         enqueue(fields, options = {}) {
+            if (!this.enabled)
+                return;
             if (!fields)
                 return;
             const time = Date.now();
@@ -2176,6 +2220,8 @@
          * 批量上报（每条 item.data 展开为 log content）
          */
         putBatch(queue) {
+            if (!this.enabled)
+                return;
             if (!queue || queue.length === 0)
                 return;
             if (!this.topicId) {
@@ -2219,6 +2265,8 @@
          * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
          */
         report(log) {
+            if (!this.enabled)
+                return;
             if (!log?.type)
                 return;
             if (!this.topicId) {
@@ -2266,15 +2314,57 @@
             return nowTs + this.batchIntervalMs;
         }
         info(message, data = {}) {
-            const payload = normalizeFlatFields({ message, ...data }, 'info');
+            let msg = '';
+            let extra = {};
+            if (message instanceof Error) {
+                msg = message.message;
+                extra = {
+                    stack: message.stack,
+                    name: message.name,
+                    ...data,
+                };
+            }
+            else {
+                msg = String(message);
+                extra = data;
+            }
+            const payload = normalizeFlatFields({ message: msg, ...extra }, 'info');
             this.report({ type: 'info', data: payload, timestamp: Date.now() });
         }
         warn(message, data = {}) {
-            const payload = normalizeFlatFields({ message, ...data }, 'warn');
+            let msg = '';
+            let extra = {};
+            if (message instanceof Error) {
+                msg = message.message;
+                extra = {
+                    stack: message.stack,
+                    name: message.name,
+                    ...data,
+                };
+            }
+            else {
+                msg = String(message);
+                extra = data;
+            }
+            const payload = normalizeFlatFields({ message: msg, ...extra }, 'warn');
             this.report({ type: 'warn', data: payload, timestamp: Date.now() });
         }
         error(message, data = {}) {
-            const payload = normalizeFlatFields({ message, ...data }, 'error');
+            let msg = '';
+            let extra = {};
+            if (message instanceof Error) {
+                msg = message.message;
+                extra = {
+                    stack: message.stack,
+                    name: message.name,
+                    ...data,
+                };
+            }
+            else {
+                msg = String(message);
+                extra = data;
+            }
+            const payload = normalizeFlatFields({ message: msg, ...extra }, 'error');
             this.report({ type: 'error', data: payload, timestamp: Date.now() });
         }
         track(trackType, data = {}) {
@@ -2381,6 +2471,8 @@
             writeStringStorage(this.failedCacheKey, JSON.stringify(next));
         }
         flushFailed() {
+            if (!this.enabled)
+                return;
             const raw = readStringStorage(this.failedCacheKey);
             if (!raw)
                 return;
@@ -2496,38 +2588,78 @@
                 }
             }
             const isMini = this.envType === 'miniprogram';
-            // 静态字面量，方便打包器识别（但在此兼容入口里，仍然可能被一起分析）
-            const WEB_SDK = 'tencentcloud-cls-sdk-js-web';
-            const MINI_SDK = 'tencentcloud-cls-sdk-js-mini';
-            // UMD（浏览器脚本）优先读全局变量
-            if (!isMini) {
+            // 3) 尝试 require / 全局变量
+            // Mini Program: 尝试直接 require
+            if (isMini) {
+                // 显式使用字面量 require，帮助打包工具识别依赖（尤其是 CJS 构建模式下）
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-var-requires
+                    const req = typeof require === 'function' ? require('tencentcloud-cls-sdk-js-mini') : null;
+                    const reqSdk = normalizeSdk(req);
+                    if (reqSdk) {
+                        this.sdk = reqSdk;
+                        return reqSdk;
+                    }
+                }
+                catch {
+                    // ignore
+                }
+                // 尝试使用 tryRequire（作为补充）
+                const reqMod = tryRequire('tencentcloud-cls-sdk-js-mini');
+                const reqSdk = normalizeSdk(reqMod);
+                if (reqSdk) {
+                    this.sdk = reqSdk;
+                    return reqSdk;
+                }
+            }
+            else {
+                // Web: 优先读全局变量 (UMD)
                 const g = readGlobal('tencentcloudClsSdkJsWeb');
                 const sdk = normalizeSdk(g);
                 if (sdk) {
                     this.sdk = sdk;
                     return sdk;
                 }
+                // Web: 尝试 require
+                const reqMod = tryRequire('tencentcloud-cls-sdk-js-web');
+                const reqSdk = normalizeSdk(reqMod);
+                if (reqSdk) {
+                    this.sdk = reqSdk;
+                    return reqSdk;
+                }
+            }
+            // 4) 动态 import
+            // 使用字符串字面量，确保 Bundler 能正确识别并进行 Code Splitting
+            if (isMini) {
+                this.sdkPromise = import('tencentcloud-cls-sdk-js-mini')
+                    .then((m) => {
+                    const sdk = normalizeSdk(m);
+                    if (!sdk)
+                        throw new Error(`ClsLogger.loadSdk: invalid sdk module for mini`);
+                    this.sdk = sdk;
+                    return sdk;
+                })
+                    .catch((err) => {
+                    this.sdkPromise = null;
+                    console.error('[ClsLogger] Failed to load mini sdk:', err);
+                    throw err;
+                });
+            }
+            else {
+                this.sdkPromise = import('tencentcloud-cls-sdk-js-web')
+                    .then((m) => {
+                    const sdk = normalizeSdk(m);
+                    if (!sdk)
+                        throw new Error(`ClsLogger.loadSdk: invalid sdk module for web`);
+                    this.sdk = sdk;
+                    return sdk;
+                })
+                    .catch((err) => {
+                    this.sdkPromise = null;
+                    console.error('[ClsLogger] Failed to load web sdk:', err);
+                    throw err;
+                });
             }
-            // 尽量同步 require
-            const reqMod = tryRequire(isMini ? MINI_SDK : WEB_SDK);
-            const reqSdk = normalizeSdk(reqMod);
-            if (reqSdk) {
-                this.sdk = reqSdk;
-                return reqSdk;
-            }
-            // 动态 import
-            this.sdkPromise = (isMini ? import(MINI_SDK) : import(WEB_SDK))
-                .then((m) => {
-                const sdk = normalizeSdk(m);
-                if (!sdk)
-                    throw new Error(`ClsLogger.loadSdk: invalid sdk module for ${isMini ? MINI_SDK : WEB_SDK}`);
-                this.sdk = sdk;
-                return sdk;
-            })
-                .catch((err) => {
-                this.sdkPromise = null;
-                throw err;
-            });
             return this.sdkPromise;
         }
     }

package/dist/mini.esm.js

@@ -560,6 +560,19 @@ function getPagePath$1() {
         return '';
     }
 }
+function getMpPagePath() {
+    try {
+        const pages = globalThis.getCurrentPages?.();
+        if (Array.isArray(pages) && pages.length > 0) {
+            const page = pages[pages.length - 1];
+            return page.route || page.__route__ || '';
+        }
+        return '';
+    }
+    catch {
+        return '';
+    }
+}
 function normalizeErrorLike(err, maxTextLength) {
     if (err && typeof err === 'object') {
         const anyErr = err;
@@ -719,6 +732,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         return;
                     const e = normalizeErrorLike(msg, options.maxTextLength);
                     const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onError',
                         message: e.message,
                         errorName: e.name,
@@ -745,6 +759,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         return;
                     const e = normalizeErrorLike(res?.reason, options.maxTextLength);
                     const payload = {
+                        pagePath: getMpPagePath(),
                         source: 'wx.onUnhandledRejection',
                         message: e.message,
                         errorName: e.name,
@@ -776,6 +791,7 @@ function installMiniProgramErrorMonitor(report, options) {
                         if (sampleHit$1(options.sampleRate)) {
                             const e = normalizeErrorLike(args?.[0], options.maxTextLength);
                             const payload = {
+                                pagePath: getMpPagePath(),
                                 source: 'App.onError',
                                 message: e.message,
                                 errorName: e.name,
@@ -799,6 +815,7 @@ function installMiniProgramErrorMonitor(report, options) {
                             const reason = args?.[0]?.reason ?? args?.[0];
                             const e = normalizeErrorLike(reason, options.maxTextLength);
                             const payload = {
+                                pagePath: getMpPagePath(),
                                 source: 'App.onUnhandledRejection',
                                 message: e.message,
                                 errorName: e.name,
@@ -1106,18 +1123,28 @@ function installMiniProgramPerformanceMonitor(report, options) {
                         continue;
                     // Page Render: firstRender
                     if (entry.entryType === 'render' && entry.name === 'firstRender') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
                         report(options.reportType, {
                             metric: 'page-render',
-                            duration: entry.duration,
+                            duration,
                             pagePath: entry.path || '',
                             unit: 'ms',
                         });
                     }
                     // Route Switch: route
                     else if (entry.entryType === 'navigation' && entry.name === 'route') {
+                        const duration = typeof entry.duration === 'number'
+                            ? entry.duration
+                            : typeof entry.startTime === 'number' && typeof entry.endTime === 'number'
+                                ? entry.endTime - entry.startTime
+                                : 0;
                         report(options.reportType, {
                             metric: 'route',
-                            duration: entry.duration,
+                            duration,
                             pagePath: entry.path || '',
                             unit: 'ms',
                         });
@@ -1461,7 +1488,7 @@ function installBehaviorMonitor(report, envType, options = {}) {
             const tag = (el.tagName || '').toLowerCase();
             const trackId = getAttr(el, clickTrackIdAttr);
             // 过滤无效点击：白名单 tag + 没有 trackId
-            if (clickWhiteList.includes(tag) && !trackId)
+            if (clickWhiteList.includes(tag) || !trackId)
                 return;
             void uvStatePromise.then(({ uvId, meta }) => {
                 if (destroyed)
@@ -1502,8 +1529,12 @@ function installBehaviorMonitor(report, envType, options = {}) {
                 g.Page = function patchedPage(conf) {
                     const originalOnShow = conf?.onShow;
                     conf.onShow = function (...args) {
-                        if (pvEnabled)
-                            reportPv(getPagePath());
+                        if (pvEnabled) {
+                            const pagePath = getPagePath();
+                            if (pagePath?.length > 0) {
+                                reportPv(pagePath);
+                            }
+                        }
                         return typeof originalOnShow === 'function' ? originalOnShow.apply(this, args) : undefined;
                     };
                     // 点击：wrap 页面 methods（bindtap 等会调用到这里的 handler）
@@ -1857,6 +1888,7 @@ class ClsLoggerCore {
         this.endpoint = 'ap-shanghai.cls.tencentcs.com';
         this.retryTimes = 10;
         this.source = '127.0.0.1';
+        this.enabled = true;
         this.projectId = '';
         this.projectName = '';
         this.appId = '';
@@ -1887,9 +1919,14 @@ class ClsLoggerCore {
      * 子类可按需重写（默认检测 wx）
      */
     detectEnvType() {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
+        const g = globalThis;
+        // 微信、支付宝、字节跳动、UniApp 等小程序环境通常都有特定全局变量
+        if ((g.wx && typeof g.wx.getSystemInfoSync === 'function') ||
+            (g.my && typeof g.my.getSystemInfoSync === 'function') ||
+            (g.tt && typeof g.tt.getSystemInfoSync === 'function') ||
+            (g.uni && typeof g.uni.getSystemInfoSync === 'function')) {
             return 'miniprogram';
+        }
         return 'browser';
     }
     init(options) {
@@ -1927,6 +1964,7 @@ class ClsLoggerCore {
         this.appId = options.appId ?? this.appId;
         this.appVersion = options.appVersion ?? this.appVersion;
         this.envType = nextEnvType;
+        this.enabled = options.enabled ?? true;
         // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
         this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
         this.sdkOverride = options.sdk ?? this.sdkOverride;
@@ -1943,15 +1981,17 @@ class ClsLoggerCore {
         void this.getInstance().catch(() => {
             // ignore
         });
-        // 启动时尝试发送失败缓存
-        this.flushFailed();
-        // 初始化后立即启动请求监听
-        this.startRequestMonitor(options.requestMonitor);
-        // 初始化后立即启动错误监控/性能监控
-        this.startErrorMonitor(options.errorMonitor);
-        this.startPerformanceMonitor(options.performanceMonitor);
-        // 初始化后立即启动行为埋点（PV/UV/点击）
-        this.startBehaviorMonitor(options.behaviorMonitor);
+        if (this.enabled) {
+            // 启动时尝试发送失败缓存
+            this.flushFailed();
+            // 初始化后立即启动请求监听
+            this.startRequestMonitor(options.requestMonitor);
+            // 初始化后立即启动错误监控/性能监控
+            this.startErrorMonitor(options.errorMonitor);
+            this.startPerformanceMonitor(options.performanceMonitor);
+            // 初始化后立即启动行为埋点（PV/UV/点击）
+            this.startBehaviorMonitor(options.behaviorMonitor);
+        }
     }
     getBaseFields() {
         let auto = undefined;
@@ -2076,6 +2116,8 @@ class ClsLoggerCore {
      * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
      */
     put(fields, options = {}) {
+        if (!this.enabled)
+            return;
         if (!fields)
             return;
         if (!this.topicId) {
@@ -2134,6 +2176,8 @@ class ClsLoggerCore {
      * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
      */
     enqueue(fields, options = {}) {
+        if (!this.enabled)
+            return;
         if (!fields)
             return;
         const time = Date.now();
@@ -2172,6 +2216,8 @@ class ClsLoggerCore {
      * 批量上报（每条 item.data 展开为 log content）
      */
     putBatch(queue) {
+        if (!this.enabled)
+            return;
         if (!queue || queue.length === 0)
             return;
         if (!this.topicId) {
@@ -2215,6 +2261,8 @@ class ClsLoggerCore {
      * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
      */
     report(log) {
+        if (!this.enabled)
+            return;
         if (!log?.type)
             return;
         if (!this.topicId) {
@@ -2262,15 +2310,57 @@ class ClsLoggerCore {
         return nowTs + this.batchIntervalMs;
     }
     info(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'info');
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'info');
         this.report({ type: 'info', data: payload, timestamp: Date.now() });
     }
     warn(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'warn');
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'warn');
         this.report({ type: 'warn', data: payload, timestamp: Date.now() });
     }
     error(message, data = {}) {
-        const payload = normalizeFlatFields({ message, ...data }, 'error');
+        let msg = '';
+        let extra = {};
+        if (message instanceof Error) {
+            msg = message.message;
+            extra = {
+                stack: message.stack,
+                name: message.name,
+                ...data,
+            };
+        }
+        else {
+            msg = String(message);
+            extra = data;
+        }
+        const payload = normalizeFlatFields({ message: msg, ...extra }, 'error');
         this.report({ type: 'error', data: payload, timestamp: Date.now() });
     }
     track(trackType, data = {}) {
@@ -2377,6 +2467,8 @@ class ClsLoggerCore {
         writeStringStorage(this.failedCacheKey, JSON.stringify(next));
     }
     flushFailed() {
+        if (!this.enabled)
+            return;
         const raw = readStringStorage(this.failedCacheKey);
         if (!raw)
             return;