@be-link/cls-logger 1.0.1-beta.1 → 1.0.1-beta.11

package/dist/index.esm.js

@@ -1,5 +1,3 @@
-import { AsyncClient, LogGroup, Log, PutLogsRequest } from 'tencentcloud-cls-sdk-js-web';
-
 function isPlainObject(value) {
     return Object.prototype.toString.call(value) === '[object Object]';
 }
@@ -536,6 +534,8 @@ function installRequestMonitor(report, opts = {}) {
 }
 
 const DEFAULT_MAX_TEXT = 4000;
+const DEFAULT_DEDUPE_WINDOW_MS = 3000;
+const DEFAULT_DEDUPE_MAX_KEYS = 200;
 function truncate$2(s, maxLen) {
     if (!s)
         return s;
@@ -561,7 +561,17 @@ function getPagePath$1() {
 function normalizeErrorLike(err, maxTextLength) {
     if (err && typeof err === 'object') {
         const anyErr = err;
-        const message = truncate$2(String(anyErr.message ?? anyErr.toString?.() ?? ''), maxTextLength);
+        let rawMsg = anyErr.message;
+        if (!rawMsg) {
+            const str = anyErr.toString?.();
+            if (!str || str === '[object Object]') {
+                rawMsg = stringifyLogValue(anyErr);
+            }
+            else {
+                rawMsg = str;
+            }
+        }
+        const message = truncate$2(String(rawMsg ?? ''), maxTextLength);
         const name = truncate$2(String(anyErr.name ?? ''), 200);
         const stack = truncate$2(String(anyErr.stack ?? ''), maxTextLength);
         return { message, name, stack };
@@ -569,6 +579,54 @@ function normalizeErrorLike(err, maxTextLength) {
     const message = truncate$2(stringifyLogValue(err), maxTextLength);
     return { message, name: '', stack: '' };
 }
+function createDedupeGuard(options) {
+    const cache = new Map(); // key -> lastReportAt
+    const maxKeys = Math.max(0, options.dedupeMaxKeys);
+    const windowMs = Math.max(0, options.dedupeWindowMs);
+    function touch(key, now) {
+        // refresh insertion order
+        if (cache.has(key))
+            cache.delete(key);
+        cache.set(key, now);
+        if (maxKeys > 0) {
+            while (cache.size > maxKeys) {
+                const first = cache.keys().next().value;
+                if (!first)
+                    break;
+                cache.delete(first);
+            }
+        }
+    }
+    return (key) => {
+        if (!key)
+            return true;
+        if (windowMs <= 0 || maxKeys === 0)
+            return true;
+        const now = Date.now();
+        const last = cache.get(key);
+        if (typeof last === 'number' && now - last < windowMs)
+            return false;
+        touch(key, now);
+        return true;
+    };
+}
+function buildErrorKey(type, payload) {
+    // 使用最核心、最稳定的字段构造签名，避免把瞬态字段（如 time）带入导致失效
+    const parts = [
+        type,
+        String(payload.source ?? ''),
+        String(payload.pagePath ?? ''),
+        String(payload.message ?? ''),
+        String(payload.errorName ?? ''),
+        String(payload.stack ?? ''),
+        String(payload.filename ?? ''),
+        String(payload.lineno ?? ''),
+        String(payload.colno ?? ''),
+        String(payload.tagName ?? ''),
+        String(payload.resourceUrl ?? ''),
+    ];
+    return parts.join('|');
+}
 function installBrowserErrorMonitor(report, options) {
     if (typeof window === 'undefined')
         return;
@@ -576,6 +634,7 @@ function installBrowserErrorMonitor(report, options) {
     if (w.__beLinkClsLoggerErrorInstalled__)
         return;
     w.__beLinkClsLoggerErrorInstalled__ = true;
+    const shouldReport = createDedupeGuard(options);
     window.addEventListener('error', (event) => {
         try {
             if (!sampleHit$1(options.sampleRate))
@@ -598,6 +657,8 @@ function installBrowserErrorMonitor(report, options) {
                     if (e.stack)
                         payload.stack = e.stack;
                 }
+                if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                    return;
                 report(options.reportType, payload);
                 return;
             }
@@ -609,6 +670,8 @@ function installBrowserErrorMonitor(report, options) {
                 payload.source = 'resource.error';
                 payload.tagName = tagName;
                 payload.resourceUrl = truncate$2(url, 2000);
+                if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                    return;
                 report(options.reportType, payload);
             }
         }
@@ -629,6 +692,8 @@ function installBrowserErrorMonitor(report, options) {
                 errorName: e.name,
                 stack: e.stack,
             };
+            if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                return;
             report(options.reportType, payload);
         }
         catch {
@@ -641,6 +706,7 @@ function installMiniProgramErrorMonitor(report, options) {
     if (g.__beLinkClsLoggerMpErrorInstalled__)
         return;
     g.__beLinkClsLoggerMpErrorInstalled__ = true;
+    const shouldReport = createDedupeGuard(options);
     const wxAny = globalThis.wx;
     // wx.* 事件（兼容在 App 已经创建后的场景）
     try {
@@ -649,10 +715,16 @@ function installMiniProgramErrorMonitor(report, options) {
                 try {
                     if (!sampleHit$1(options.sampleRate))
                         return;
-                    report(options.reportType, {
+                    const e = normalizeErrorLike(msg, options.maxTextLength);
+                    const payload = {
                         source: 'wx.onError',
-                        message: truncate$2(String(msg ?? ''), options.maxTextLength),
-                    });
+                        message: e.message,
+                        errorName: e.name,
+                        stack: e.stack,
+                    };
+                    if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
                 }
                 catch {
                     // ignore
@@ -670,12 +742,15 @@ function installMiniProgramErrorMonitor(report, options) {
                     if (!sampleHit$1(options.sampleRate))
                         return;
                     const e = normalizeErrorLike(res?.reason, options.maxTextLength);
-                    report(options.reportType, {
+                    const payload = {
                         source: 'wx.onUnhandledRejection',
                         message: e.message,
                         errorName: e.name,
                         stack: e.stack,
-                    });
+                    };
+                    if (!shouldReport(buildErrorKey(options.reportType, payload)))
+                        return;
+                    report(options.reportType, payload);
                 }
                 catch {
                     // ignore
@@ -697,10 +772,15 @@ function installMiniProgramErrorMonitor(report, options) {
                 next.onError = function (...args) {
                     try {
                         if (sampleHit$1(options.sampleRate)) {
-                            report(options.reportType, {
+                            const e = normalizeErrorLike(args?.[0], options.maxTextLength);
+                            const payload = {
                                 source: 'App.onError',
-                                message: truncate$2(String(args?.[0] ?? ''), options.maxTextLength),
-                            });
+                                message: e.message,
+                                errorName: e.name,
+                                stack: e.stack,
+                            };
+                            if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                report(options.reportType, payload);
                         }
                     }
                     catch {
@@ -716,12 +796,14 @@ function installMiniProgramErrorMonitor(report, options) {
                         if (sampleHit$1(options.sampleRate)) {
                             const reason = args?.[0]?.reason ?? args?.[0];
                             const e = normalizeErrorLike(reason, options.maxTextLength);
-                            report(options.reportType, {
+                            const payload = {
                                 source: 'App.onUnhandledRejection',
                                 message: e.message,
                                 errorName: e.name,
                                 stack: e.stack,
-                            });
+                            };
+                            if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                report(options.reportType, payload);
                         }
                     }
                     catch {
@@ -750,6 +832,8 @@ function installErrorMonitor(report, opts = {}) {
         sampleRate: raw.sampleRate ?? 1,
         captureResourceError: raw.captureResourceError ?? true,
         maxTextLength: raw.maxTextLength ?? DEFAULT_MAX_TEXT,
+        dedupeWindowMs: raw.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS,
+        dedupeMaxKeys: raw.dedupeMaxKeys ?? DEFAULT_DEDUPE_MAX_KEYS,
     };
     if (isMiniProgramEnv()) {
         installMiniProgramErrorMonitor(report, options);
@@ -1000,140 +1084,58 @@ function installBrowserPerformanceMonitor(report, options) {
         }
     }
 }
-function wrapMiniProgramRouteApi(report, reportType, apiName, options) {
-    const wxAny = globalThis.wx;
-    if (!wxAny || typeof wxAny[apiName] !== 'function')
-        return;
-    const flagKey = `__beLinkClsLoggerMpRouteWrapped__${apiName}`;
-    if (wxAny[flagKey])
-        return;
-    wxAny[flagKey] = true;
-    const raw = wxAny[apiName].bind(wxAny);
-    wxAny[apiName] = (opts) => {
-        const start = Date.now();
-        const url = opts?.url ? String(opts.url) : '';
-        const wrapCb = (cb, success) => {
-            return (...args) => {
-                try {
-                    if (sampleHit(options.sampleRate)) {
-                        report(reportType, {
-                            metric: 'route',
-                            api: apiName,
-                            url,
-                            duration: Date.now() - start,
-                            success: success ? 1 : 0,
-                            error: success ? '' : truncate$1(stringifyLogValue(args?.[0]), options.maxTextLength),
-                            unit: 'ms',
-                        });
-                    }
-                }
-                catch {
-                    // ignore
-                }
-                if (typeof cb === 'function')
-                    return cb(...args);
-                return undefined;
-            };
-        };
-        const next = { ...(opts ?? {}) };
-        next.success = wrapCb(next.success, true);
-        next.fail = wrapCb(next.fail, false);
-        return raw(next);
-    };
-}
-function installMiniProgramPageRenderMonitor(report, reportType, options) {
-    const g = globalThis;
-    if (typeof g.Page !== 'function')
-        return;
-    if (g.__beLinkClsLoggerPageWrapped__)
-        return;
-    g.__beLinkClsLoggerPageWrapped__ = true;
-    const rawPage = g.Page;
-    g.Page = (pageOptions) => {
-        const next = { ...(pageOptions ?? {}) };
-        const rawOnLoad = next.onLoad;
-        const rawOnReady = next.onReady;
-        next.onLoad = function (...args) {
-            try {
-                this.__beLinkClsLoggerPageLoadTs__ = Date.now();
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnLoad === 'function')
-                return rawOnLoad.apply(this, args);
-            return undefined;
-        };
-        next.onReady = function (...args) {
-            try {
-                const start = this.__beLinkClsLoggerPageLoadTs__;
-                if (typeof start === 'number' && sampleHit(options.sampleRate)) {
-                    report(reportType, {
-                        metric: 'page-render',
-                        route: this?.route ? String(this.route) : '',
-                        duration: Date.now() - start,
-                        unit: 'ms',
-                    });
-                }
-            }
-            catch {
-                // ignore
-            }
-            if (typeof rawOnReady === 'function')
-                return rawOnReady.apply(this, args);
-            return undefined;
-        };
-        return rawPage(next);
-    };
-}
 function installMiniProgramPerformanceMonitor(report, options) {
     const g = globalThis;
+    const ctx = g.wx || g.Taro;
+    if (!ctx || typeof ctx.getPerformance !== 'function')
+        return;
     if (g.__beLinkClsLoggerMpPerfInstalled__)
         return;
     g.__beLinkClsLoggerMpPerfInstalled__ = true;
-    // 路由切换耗时（用 API 回调近似）
-    for (const apiName of ['navigateTo', 'redirectTo', 'switchTab', 'reLaunch']) {
-        try {
-            wrapMiniProgramRouteApi(report, options.reportType, apiName, options);
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 页面渲染耗时（onLoad -> onReady）
-    try {
-        installMiniProgramPageRenderMonitor(report, options.reportType, options);
-    }
-    catch {
-        // ignore
-    }
-    // wx.getPerformance()（若可用，尝试读取已有 entries）
     try {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getPerformance === 'function') {
-            const perf = wxAny.getPerformance();
-            if (perf && isPlainObject(perf)) {
-                // 不同基础库实现差异较大：尽量容错
-                setTimeout(() => {
-                    try {
-                        if (!sampleHit(options.sampleRate))
-                            return;
-                        const entries = typeof perf.getEntries === 'function'
-                            ? perf.getEntries()
-                            : typeof perf.getEntriesByType === 'function'
-                                ? perf.getEntriesByType('navigation')
-                                : [];
+        const perf = ctx.getPerformance();
+        if (!perf || typeof perf.createObserver !== 'function')
+            return;
+        const observer = perf.createObserver((entryList) => {
+            try {
+                const entries = entryList.getEntries();
+                for (const entry of entries) {
+                    if (!sampleHit(options.sampleRate))
+                        continue;
+                    // Page Render: firstRender
+                    if (entry.entryType === 'render' && entry.name === 'firstRender') {
                         report(options.reportType, {
-                            metric: 'mp-performance',
-                            entries: truncate$1(stringifyLogValue(entries), options.maxTextLength),
+                            metric: 'page-render',
+                            duration: entry.duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
                         });
                     }
-                    catch {
-                        // ignore
+                    // Route Switch: route
+                    else if (entry.entryType === 'navigation' && entry.name === 'route') {
+                        report(options.reportType, {
+                            metric: 'route',
+                            duration: entry.duration,
+                            pagePath: entry.path || '',
+                            unit: 'ms',
+                        });
+                    }
+                    // App Launch: appLaunch (Cold)
+                    else if (entry.entryType === 'navigation' && entry.name === 'appLaunch') {
+                        report(options.reportType, {
+                            metric: 'app-launch',
+                            duration: entry.duration,
+                            launchType: 'cold',
+                            unit: 'ms',
+                        });
                     }
-                }, 0);
+                }
             }
-        }
+            catch {
+                // ignore
+            }
+        });
+        observer.observe({ entryTypes: ['navigation', 'render'] });
     }
     catch {
         // ignore
@@ -1457,7 +1459,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)
@@ -1498,8 +1500,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）
@@ -1835,9 +1841,20 @@ function enterClsSendingGuard() {
         g.__beLinkClsLoggerSendingCount__ = cur > 0 ? cur - 1 : 0;
     };
 }
-class ClsLogger {
+/**
+ * CLS Logger 核心基类
+ * - 负责所有上报、队列、监控逻辑
+ * - 不包含具体的 SDK 加载实现（由子类负责）
+ * - 这样可以把 web/mini 的 SDK 依赖彻底解耦到子入口
+ */
+class ClsLoggerCore {
     constructor() {
+        this.sdk = null;
+        this.sdkPromise = null;
+        this.sdkOverride = null;
+        this.sdkLoaderOverride = null;
         this.client = null;
+        this.clientPromise = null;
         this.topicId = null;
         this.endpoint = 'ap-shanghai.cls.tencentcs.com';
         this.retryTimes = 10;
@@ -1868,6 +1885,20 @@ class ClsLogger {
         this.behaviorMonitorStarted = false;
         this.behaviorMonitorCleanup = null;
     }
+    /**
+     * 子类可按需重写（默认检测 wx）
+     */
+    detectEnvType() {
+        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) {
         this.initTs = Date.now();
         const topicId = options?.tencentCloud?.topicID ?? options?.topic_id ?? options?.topicID ?? this.topicId ?? null;
@@ -1879,15 +1910,33 @@ class ClsLogger {
             console.warn('ClsLogger.init 没有传 topicID/topic_id');
             return;
         }
+        const nextEnvType = options.envType ?? this.detectEnvType();
+        // envType/endpoint/retryTimes 变化时：重置 client（以及可能的 sdk）
+        const envChanged = nextEnvType !== this.envType;
+        const endpointChanged = endpoint !== this.endpoint;
+        const retryChanged = retryTimes !== this.retryTimes;
+        if (envChanged || endpointChanged || retryChanged) {
+            this.client = null;
+            this.clientPromise = null;
+        }
+        if (envChanged) {
+            this.sdk = null;
+            this.sdkPromise = null;
+        }
         this.topicId = topicId;
         this.endpoint = endpoint;
         this.retryTimes = retryTimes;
         this.source = source;
+        this.userId = options.userId ?? this.userId;
+        this.userName = options.userName ?? this.userName;
         this.projectId = options.projectId ?? this.projectId;
         this.projectName = options.projectName ?? this.projectName;
         this.appId = options.appId ?? this.appId;
         this.appVersion = options.appVersion ?? this.appVersion;
-        this.envType = options.envType ?? this.detectEnvType();
+        this.envType = nextEnvType;
+        // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
+        this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
+        this.sdkOverride = options.sdk ?? this.sdkOverride;
         this.userGenerateBaseFields = options.generateBaseFields ?? this.userGenerateBaseFields;
         this.autoGenerateBaseFields = createAutoDeviceInfoBaseFields(this.envType, options.deviceInfo);
         this.storageKey = options.storageKey ?? this.storageKey;
@@ -1897,8 +1946,10 @@ class ClsLogger {
         this.startupDelayMs = options.batch?.startupDelayMs ?? this.startupDelayMs;
         this.failedCacheKey = options.failedCacheKey ?? this.failedCacheKey;
         this.failedCacheMax = options.failedCacheMax ?? this.failedCacheMax;
-        // 预热 client
-        this.getInstance();
+        // 预热（避免首条日志触发 import/初始化开销）
+        void this.getInstance().catch(() => {
+            // ignore
+        });
         // 启动时尝试发送失败缓存
         this.flushFailed();
         // 初始化后立即启动请求监听
@@ -1923,7 +1974,7 @@ class ClsLogger {
         try {
             const userRaw = this.userGenerateBaseFields ? this.userGenerateBaseFields() : undefined;
             if (userRaw && isPlainObject(userRaw))
-                user = normalizeFlatFields(userRaw, 'generateBaseFields');
+                user = normalizeFlatFields({ ...userRaw }, 'generateBaseFields');
         }
         catch {
             user = undefined;
@@ -2002,20 +2053,29 @@ class ClsLogger {
         this.behaviorMonitorCleanup = null;
         this.behaviorMonitorStarted = false;
     }
-    getInstance() {
+    /**
+     * 获取 CLS client（按环境懒加载 SDK）
+     */
+    async getInstance() {
         if (this.client)
             return this.client;
-        this.client = new AsyncClient({
-            endpoint: this.endpoint,
-            retry_times: this.retryTimes,
+        if (this.clientPromise)
+            return this.clientPromise;
+        this.clientPromise = this.loadSdk()
+            .then(({ AsyncClient }) => {
+            const client = new AsyncClient({
+                endpoint: this.endpoint,
+                retry_times: this.retryTimes,
+            });
+            this.client = client;
+            return client;
+        })
+            .catch((err) => {
+            // 失败后允许下次重试
+            this.clientPromise = null;
+            throw err;
         });
-        return this.client;
-    }
-    detectEnvType() {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
-            return 'miniprogram';
-        return 'browser';
+        return this.clientPromise;
     }
     /**
      * 直接上报：埋点入参必须是一维（扁平）Object
@@ -2041,22 +2101,33 @@ class ClsLogger {
             appVersion: this.appVersion || undefined,
             ...normalizedFields,
         });
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
+        // 同步 API：内部异步发送，避免把网络异常冒泡到业务（尤其小程序）
+        void this.putAsync(finalFields).catch(() => {
+            // ignore
+        });
+    }
+    async putAsync(finalFields) {
+        if (!this.topicId)
+            return;
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
         logGroup.setSource(this.source);
-        const log = new Log(Date.now());
+        const log = new sdk.Log(Date.now());
         for (const key of Object.keys(finalFields)) {
             log.addContent(key, stringifyLogValue(finalFields[key]));
         }
         logGroup.addLog(log);
-        const request = new PutLogsRequest(this.topicId, logGroup);
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
         const exit = enterClsSendingGuard();
+        let p;
         try {
-            client.PutLogs(request);
+            p = client.PutLogs(request);
         }
         finally {
             exit();
         }
+        await p;
     }
     /**
      * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
@@ -2115,11 +2186,19 @@ class ClsLogger {
             console.warn('ClsLogger.putBatch：未初始化 topic_id');
             return;
         }
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
+        void this.putBatchAsync(queue).catch(() => {
+            // ignore
+        });
+    }
+    async putBatchAsync(queue) {
+        if (!this.topicId)
+            return;
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
         logGroup.setSource(this.source);
         for (const item of queue) {
-            const log = new Log(item.time);
+            const log = new sdk.Log(item.time);
             const data = item.data ?? {};
             for (const key of Object.keys(data)) {
                 log.addContent(key, stringifyLogValue(data[key]));
@@ -2128,14 +2207,16 @@ class ClsLogger {
         }
         if (logGroup.getLogs().length === 0)
             return;
-        const request = new PutLogsRequest(this.topicId, logGroup);
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
         const exit = enterClsSendingGuard();
+        let p;
         try {
-            client.PutLogs(request);
+            p = client.PutLogs(request);
         }
         finally {
             exit();
         }
+        await p;
     }
     /**
      * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
@@ -2248,12 +2329,13 @@ class ClsLogger {
     async sendReportLogs(logs) {
         if (!this.topicId)
             return;
-        const client = this.getInstance();
-        const logGroup = new LogGroup('127.0.0.1');
+        const sdk = await this.loadSdk();
+        const client = await this.getInstance();
+        const logGroup = new sdk.LogGroup('127.0.0.1');
         logGroup.setSource(this.source);
         for (const item of logs) {
             const fields = this.buildReportFields(item);
-            const log = new Log(fields.timestamp);
+            const log = new sdk.Log(fields.timestamp);
             for (const key of Object.keys(fields)) {
                 if (key === 'timestamp')
                     continue;
@@ -2261,7 +2343,7 @@ class ClsLogger {
             }
             logGroup.addLog(log);
         }
-        const request = new PutLogsRequest(this.topicId, logGroup);
+        const request = new sdk.PutLogsRequest(this.topicId, logGroup);
         // 只在“发起网络请求”的同步阶段打标记，避免 requestMonitor 监控 CLS 上报请求导致递归
         const exit = enterClsSendingGuard();
         let p;
@@ -2337,6 +2419,162 @@ class ClsLogger {
     }
 }
 
+function readGlobal(key) {
+    try {
+        const g = globalThis;
+        return g[key] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryRequire(moduleName) {
+    try {
+        // 说明：
+        // - ESM 构建（exports.import/module）里通常不存在模块作用域的 require
+        // - 一些小程序运行时/构建链路会把 require 挂到 globalThis 上
+        // 因此这里同时探测“模块作用域 require”与 “globalThis.require”
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const localReq = (typeof require === 'function' ? require : null);
+        const globalReq = readGlobal('require');
+        const candidates = [localReq, globalReq].filter((fn) => typeof fn === 'function');
+        for (const fn of candidates) {
+            try {
+                return fn(moduleName);
+            }
+            catch {
+                // continue
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+
+/**
+ * 兼容版 ClsLogger（默认入口）
+ * - 保留了自动识别环境 + 动态 import 的逻辑
+ * - 如果业务想瘦身，建议改用 @be-link/cls-logger/web 或 /mini
+ */
+class ClsLogger extends ClsLoggerCore {
+    async loadSdk() {
+        if (this.sdk)
+            return this.sdk;
+        if (this.sdkPromise)
+            return this.sdkPromise;
+        const normalizeSdk = (m) => {
+            const mod = (m?.default && m.default.AsyncClient ? m.default : m);
+            if (mod?.AsyncClient && mod?.Log && mod?.LogGroup && mod?.PutLogsRequest) {
+                return {
+                    AsyncClient: mod.AsyncClient,
+                    Log: mod.Log,
+                    LogGroup: mod.LogGroup,
+                    PutLogsRequest: mod.PutLogsRequest,
+                };
+            }
+            return null;
+        };
+        // 1) 外部注入的 loader（最高优先级）
+        if (this.sdkLoaderOverride) {
+            try {
+                const loaded = await this.sdkLoaderOverride();
+                const sdk = normalizeSdk(loaded);
+                if (sdk) {
+                    this.sdk = sdk;
+                    return sdk;
+                }
+            }
+            catch {
+                // ignore and fallback
+            }
+        }
+        // 2) 外部直接注入的 sdk
+        if (this.sdkOverride) {
+            const sdk = normalizeSdk(this.sdkOverride);
+            if (sdk) {
+                this.sdk = sdk;
+                return sdk;
+            }
+        }
+        const isMini = this.envType === 'miniprogram';
+        // 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;
+            });
+        }
+        return this.sdkPromise;
+    }
+}
+
 const clsLogger = new ClsLogger();
 
 export { ClsLogger, clsLogger, clsLogger as default };