@pluve/logger-sdk 0.0.6 → 0.0.7

package/dist/loggerSDK.js

@@ -9,14 +9,16 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { defaultTransport } from "./transportAdapter";
-import { isBrowser, isWeChatMiniProgram, now, getSessionId, getCurrentUrl, getEnvironmentInfo, parseBrowserInfo, generateUUID } from "./utils";
+import { isBrowser, isWeChatMiniProgram, now, getSessionId, getCurrentUrl, collectEnvironmentTags, generateUUID, logDebug } from "./utils";
 import { QueueManager } from "./queueManager";
 import { RetryManager } from "./retryManager";
 export var LoggerSDK = /*#__PURE__*/function () {
-  function LoggerSDK(options) {
+  function LoggerSDK() {
     _classCallCheck(this, LoggerSDK);
     _defineProperty(this, "opts", void 0);
+    /** 事件序列编号，用于事件去重 */
     _defineProperty(this, "seq", 0);
+    /** 是否已关闭 */
     _defineProperty(this, "closed", false);
     /** 预收集的环境信息 tags（仅用于初始化上报） */
     _defineProperty(this, "envTags", {});
@@ -32,9 +34,8 @@ export var LoggerSDK = /*#__PURE__*/function () {
     _defineProperty(this, "batchTimer", void 0);
     /** 是否正在上报 */
     _defineProperty(this, "isSending", false);
-    if (options) {
-      this.init(options);
-    }
+    // 初始化时生成并锁定会话标识
+    this.sessionId = getSessionId();
   }
   _createClass(LoggerSDK, [{
     key: "init",
@@ -43,15 +44,16 @@ export var LoggerSDK = /*#__PURE__*/function () {
      * 初始化：配置参数、收集环境信息与 UA，并生成 sessionId，完成初始上报
      */
     function init(options) {
-      var _this = this;
       this.opts = {
         endpoint: options.endpoint,
         appId: options.appId || 'unknown',
         env: options.env || 'dev',
         debug: !!options.debug,
-        pixelParam: options.pixelParam || 'data',
-        maxPixelUrlLen: options.maxPixelUrlLen || 1900,
-        enableGzip: !!options.enableGzip,
+        /** 是否启用 gzip 压缩，默认 true */
+        enableGzip: options.enableGzip !== false,
+        // 默认启用
+        /** 最大像素图 URL 长度，默认 1900 */
+        maxPixelUrlLen: options.maxPixelUrlLen || 4096,
         // 批量上报配置（默认关闭，需显式开启）
         enableBatch: options.enableBatch === true,
         batchSize: options.batchSize || 10,
@@ -93,16 +95,20 @@ export var LoggerSDK = /*#__PURE__*/function () {
       this.attachUnloadHandlers();
 
       // 生成并缓存 sessionId（便于 UV 统计），并锁定到实例生命周期
+      // TODO 通过后端接口获取 sessionId
       this.sessionId = getSessionId();
 
       // 收集 UA / 环境信息并完成初始上报（便于后端统计 UA 和 UV）
-      this.envTags = this.collectEnvironmentTags();
-      this.track('session_start', 'Session started', undefined, {
-        level: 'info',
-        tags: this.envTags
-      }).catch(function (err) {
-        _this.logDebug('Failed to report session_start', err);
-      });
+      this.envTags = collectEnvironmentTags(this.opts.debug);
+
+      // 调用接口初始化
+
+      // this.track('session_start', 'Session started', undefined, {
+      //   level: 'info',
+      //   tags: this.envTags,
+      // }).catch((err) => {
+      //   logDebug(this.opts.debug, 'Failed to report session_start', err);
+      // });
 
       // 启动批量上报定时器
       if (this.opts.enableBatch) {
@@ -110,51 +116,25 @@ export var LoggerSDK = /*#__PURE__*/function () {
       }
       this.initialized = true;
     }
-  }, {
-    key: "logDebug",
-    value: function logDebug() {
-      var _this$opts, _console;
-      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-        args[_key] = arguments[_key];
-      }
-      if ((_this$opts = this.opts) !== null && _this$opts !== void 0 && _this$opts.debug) (_console = console).debug.apply(_console, ['[LoggerSDK]'].concat(args));
-    }
 
     /**
-     * 收集环境信息并生成 tags（仅在初始化时执行一次）
+     * 设置用户信息
      */
   }, {
-    key: "collectEnvironmentTags",
-    value: function collectEnvironmentTags() {
-      var envInfo = getEnvironmentInfo();
-      var tags = {
-        platform: envInfo.platform
-      };
-
-      // 浏览器环境
-      if (envInfo.platform === 'browser' && envInfo.userAgent) {
-        var browserInfo = parseBrowserInfo(envInfo.userAgent);
-        tags.browser = browserInfo.browser;
-        tags.browserVersion = browserInfo.browserVersion;
-        tags.os = browserInfo.os;
-        tags.osVersion = browserInfo.osVersion;
-        tags.screenWidth = envInfo.screenWidth;
-        tags.screenHeight = envInfo.screenHeight;
-        tags.language = envInfo.language;
+    key: "identify",
+    value: function identify(userId) {
+      logDebug(this.opts.debug, 'identify', userId);
+      if (this.opts) {
+        this.opts.userId = userId;
       }
-      // 微信小程序环境
-      else if (envInfo.platform === 'wechat' && envInfo.systemInfo) {
-        tags.brand = envInfo.systemInfo.brand;
-        tags.model = envInfo.systemInfo.model;
-        tags.system = envInfo.systemInfo.system;
-        tags.wechatVersion = envInfo.systemInfo.version;
-        tags.SDKVersion = envInfo.systemInfo.SDKVersion;
-        tags.screenWidth = envInfo.screenWidth;
-        tags.screenHeight = envInfo.screenHeight;
-        tags.language = envInfo.language;
+    }
+  }, {
+    key: "setStoreCode",
+    value: function setStoreCode(storeCode) {
+      logDebug(this.opts.debug, 'setStoreCode', storeCode);
+      if (this.opts) {
+        this.opts.storeCode = storeCode;
       }
-      this.logDebug('Environment tags collected:', tags);
-      return tags;
     }
 
     /**
@@ -163,100 +143,105 @@ export var LoggerSDK = /*#__PURE__*/function () {
   }, {
     key: "track",
     value: (function () {
-      var _track = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(eventType, message, traceId, options) {
-        var logEvent;
+      var _track = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(_ref) {
+        var _error$stack;
+        var message, error, traceId, logLevel, logEvent;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
+              message = _ref.message, error = _ref.error, traceId = _ref.traceId, logLevel = _ref.logLevel;
               if (!this.closed) {
-                _context.next = 2;
+                _context.next = 3;
                 break;
               }
               return _context.abrupt("return");
-            case 2:
+            case 3:
               if (this.initialized) {
-                _context.next = 5;
+                _context.next = 6;
                 break;
               }
-              this.logDebug('SDK not initialized, skip track');
+              logDebug(this.opts.debug, 'SDK not initialized, skip track');
               return _context.abrupt("return");
-            case 5:
+            case 6:
               this.seq += 1;
 
               // 构建标准化日志格式
               logEvent = {
+                /** 日志 ID */
                 logId: "".concat(this.opts.appId).concat(generateUUID()).concat(now()),
                 // UUID
-                traceId: traceId,
-                eventType: eventType,
-                ts: now(),
+                /** 应用标识 */
                 appId: this.opts.appId || 'unknown',
-                env: this.opts.env || 'dev',
-                level: (options === null || options === void 0 ? void 0 : options.level) || 'info',
-                message: message,
-                stack: options === null || options === void 0 ? void 0 : options.stack,
+                /** 环境标识 */
+                stage: this.opts.env || 'dev',
+                /** 日志级别：info/warn/error/fatal */
+                level: logLevel || 'info',
+                /** 可选：跟踪 ID（跨服务调用链跟踪） */
+                traceId: traceId,
+                /** 会话标识，同 sessionId */
+                frontendId: this.sessionId,
+                // 同 sessionId
+                /** 发生页面 URL */
                 url: getCurrentUrl(),
-                userId: options === null || options === void 0 ? void 0 : options.userId,
-                sessionId: this.sessionId,
-                // 单次事件只携带自定义 tags，不再包含环境数据，节省流量
-                tags: (options === null || options === void 0 ? void 0 : options.tags) || {}
+                /** 异常发生位置，结构待定 */
+                location: (error === null || error === void 0 || (_error$stack = error.stack) === null || _error$stack === void 0 ? void 0 : _error$stack.split('\n')[2]) || '',
+                /** 异常信息 */
+                message: message,
+                /** 可选：堆栈信息（长字符串） */
+                throwable: error === null || error === void 0 ? void 0 : error.stack,
+                /** 可选：用户 ID（脱敏） */
+                userId: this.opts.userId,
+                /** 可选：店铺编码 */
+                storeCode: this.opts.storeCode,
+                /** 可选的结构化额外信息 */
+                tags: this.envTags
               };
-              this.logDebug('track', logEvent);
+              logDebug(this.opts.debug, 'track', logEvent);
 
               // 如果启用批量上报，添加到队列
               if (!(this.opts.enableBatch && this.queueManager)) {
-                _context.next = 16;
+                _context.next = 17;
                 break;
               }
               this.queueManager.enqueue(logEvent);
               // 如果队列已满，立即上报
               if (!(this.queueManager.size() >= this.opts.batchSize)) {
-                _context.next = 14;
+                _context.next = 15;
                 break;
               }
-              this.logDebug('Queue size reached batch size, flushing immediately');
-              _context.next = 14;
+              logDebug(this.opts.debug, 'Queue size reached batch size, flushing immediately');
+              _context.next = 15;
               return this.flush();
-            case 14:
-              _context.next = 24;
+            case 15:
+              _context.next = 25;
               break;
-            case 16:
-              _context.prev = 16;
-              _context.next = 19;
+            case 17:
+              _context.prev = 17;
+              _context.next = 20;
               return this.sendEvent(logEvent);
-            case 19:
-              _context.next = 24;
+            case 20:
+              _context.next = 25;
               break;
-            case 21:
-              _context.prev = 21;
-              _context.t0 = _context["catch"](16);
-              this.logDebug('track failed', _context.t0);
+            case 22:
+              _context.prev = 22;
+              _context.t0 = _context["catch"](17);
+              logDebug(this.opts.debug, 'track failed', _context.t0);
               // 静默失败，不影响主流程
-            case 24:
+            case 25:
             case "end":
               return _context.stop();
           }
-        }, _callee, this, [[16, 21]]);
+        }, _callee, this, [[17, 22]]);
       }));
-      function track(_x, _x2, _x3, _x4) {
+      function track(_x) {
         return _track.apply(this, arguments);
       }
       return track;
     }()
-    /**
-     * 设置用户信息
-     */
-    )
-  }, {
-    key: "identify",
-    value: function identify(userId) {
-      this.logDebug('identify', userId);
-      // userId 将在 track 时传入
-    }
-
     /**
      * 手动刷新队列，立即上报所有待发送日志
      */
+    )
   }, {
     key: "flush",
     value: (function () {
@@ -275,11 +260,11 @@ export var LoggerSDK = /*#__PURE__*/function () {
                 _context2.next = 5;
                 break;
               }
-              this.logDebug('Already sending, skip flush');
+              logDebug(this.opts.debug, 'Already sending, skip flush');
               return _context2.abrupt("return");
             case 5:
               this.isSending = true;
-              this.logDebug("Flushing ".concat(this.queueManager.size(), " events"));
+              logDebug(this.opts.debug, "Flushing ".concat(this.queueManager.size(), " events"));
               _context2.prev = 7;
               // 获取所有待发送的日志（不移除）
               events = this.queueManager.peek(this.queueManager.size());
@@ -294,13 +279,13 @@ export var LoggerSDK = /*#__PURE__*/function () {
             case 13:
               // 发送成功后，从队列中移除
               this.queueManager.dequeue(events.length);
-              this.logDebug("Flushed ".concat(events.length, " events successfully"));
+              logDebug(this.opts.debug, "Flushed ".concat(events.length, " events successfully"));
               _context2.next = 20;
               break;
             case 17:
               _context2.prev = 17;
               _context2.t0 = _context2["catch"](7);
-              this.logDebug('Flush failed', _context2.t0);
+              logDebug(this.opts.debug, 'Flush failed', _context2.t0);
               // 失败不移除队列，下次继续重试
             case 20:
               _context2.prev = 20;
@@ -369,18 +354,18 @@ export var LoggerSDK = /*#__PURE__*/function () {
     key: "sendEvent",
     value: function () {
       var _sendEvent = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(event) {
-        var _this2 = this;
+        var _this = this;
         var sendFn;
         return _regeneratorRuntime().wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
               sendFn = /*#__PURE__*/function () {
-                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+                var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
                   return _regeneratorRuntime().wrap(function _callee4$(_context4) {
                     while (1) switch (_context4.prev = _context4.next) {
                       case 0:
                         _context4.next = 2;
-                        return defaultTransport(event, _this2.opts);
+                        return defaultTransport(event, _this.opts);
                       case 2:
                       case "end":
                         return _context4.stop();
@@ -388,7 +373,7 @@ export var LoggerSDK = /*#__PURE__*/function () {
                   }, _callee4);
                 }));
                 return function sendFn() {
-                  return _ref.apply(this, arguments);
+                  return _ref2.apply(this, arguments);
                 };
               }(); // 如果启用重试
               if (!(this.opts.enableRetry && this.retryManager)) {
@@ -409,7 +394,7 @@ export var LoggerSDK = /*#__PURE__*/function () {
           }
         }, _callee5, this);
       }));
-      function sendEvent(_x5) {
+      function sendEvent(_x2) {
         return _sendEvent.apply(this, arguments);
       }
       return sendEvent;
@@ -421,7 +406,7 @@ export var LoggerSDK = /*#__PURE__*/function () {
     key: "sendBatch",
     value: (function () {
       var _sendBatch = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(events) {
-        var _this3 = this;
+        var _this2 = this;
         var batchId, sendFn;
         return _regeneratorRuntime().wrap(function _callee7$(_context7) {
           while (1) switch (_context7.prev = _context7.next) {
@@ -435,12 +420,12 @@ export var LoggerSDK = /*#__PURE__*/function () {
               // 生成批次 ID
               batchId = "batch_".concat(now(), "_").concat(Math.random().toString(36).substring(2, 9));
               sendFn = /*#__PURE__*/function () {
-                var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
+                var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
                   return _regeneratorRuntime().wrap(function _callee6$(_context6) {
                     while (1) switch (_context6.prev = _context6.next) {
                       case 0:
                         _context6.next = 2;
-                        return defaultTransport(events, _this3.opts);
+                        return defaultTransport(events, _this2.opts);
                       case 2:
                       case "end":
                         return _context6.stop();
@@ -448,7 +433,7 @@ export var LoggerSDK = /*#__PURE__*/function () {
                   }, _callee6);
                 }));
                 return function sendFn() {
-                  return _ref2.apply(this, arguments);
+                  return _ref3.apply(this, arguments);
                 };
               }(); // 如果启用重试
               if (!(this.opts.enableRetry && this.retryManager)) {
@@ -469,7 +454,7 @@ export var LoggerSDK = /*#__PURE__*/function () {
           }
         }, _callee7, this);
       }));
-      function sendBatch(_x6) {
+      function sendBatch(_x3) {
         return _sendBatch.apply(this, arguments);
       }
       return sendBatch;
@@ -481,17 +466,17 @@ export var LoggerSDK = /*#__PURE__*/function () {
   }, {
     key: "startBatchTimer",
     value: function startBatchTimer() {
-      var _this4 = this;
+      var _this3 = this;
       if (this.batchTimer) return;
       this.batchTimer = setInterval(function () {
-        if (!_this4.closed && _this4.queueManager && _this4.queueManager.size() > 0) {
-          _this4.logDebug('Batch timer triggered, flushing queue');
-          _this4.flush().catch(function (error) {
-            _this4.logDebug('Batch timer flush failed', error);
+        if (!_this3.closed && _this3.queueManager && _this3.queueManager.size() > 0) {
+          logDebug(_this3.opts.debug, 'Batch timer triggered, flushing queue');
+          _this3.flush().catch(function (error) {
+            logDebug(_this3.opts.debug, 'Batch timer flush failed', error);
           });
         }
       }, this.opts.batchInterval);
-      this.logDebug("Batch timer started with interval ".concat(this.opts.batchInterval, "ms"));
+      logDebug(this.opts.debug, "Batch timer started with interval ".concat(this.opts.batchInterval, "ms"));
     }
 
     // ========== 自动采集 ===========
@@ -502,12 +487,12 @@ export var LoggerSDK = /*#__PURE__*/function () {
   }, {
     key: "attachUnloadHandlers",
     value: function attachUnloadHandlers() {
-      var _this5 = this;
+      var _this4 = this;
       // 微信小程序环境
       if (isWeChatMiniProgram()) {
         // 微信小程序使用 App 生命周期
         // 注意：这里需要在 App() 中配置，此处仅做示意
-        this.logDebug('WeChat MiniProgram environment detected');
+        logDebug(this.opts.debug, 'WeChat MiniProgram environment detected');
         return;
       }
 
@@ -520,10 +505,10 @@ export var LoggerSDK = /*#__PURE__*/function () {
         try {
           if (document.visibilityState === 'hidden') {
             // 页面隐藏时刷新队列
-            _this5.flush().catch(function () {
+            _this4.flush().catch(function () {
               // 忽略错误
             });
-            console.log('Page hidden, flushed queue');
+            logDebug(_this4.opts.debug, 'Page hidden, flushed queue');
           }
         } catch (_unused) {
           //
@@ -534,10 +519,11 @@ export var LoggerSDK = /*#__PURE__*/function () {
       win.addEventListener && win.addEventListener('pagehide', function () {
         try {
           // 页面隐藏时刷新队列（同步）
-          _this5.flush().catch(function () {
+          logDebug(_this4.opts.debug, 'Page hide, flushed queue');
+          _this4.flush().catch(function () {
             // 忽略错误
           });
-          console.log('Page hide, flushed queue');
+          logDebug(_this4.opts.debug, 'Page hide, flushed queue');
         } catch (_unused2) {
           //
         }
@@ -547,10 +533,11 @@ export var LoggerSDK = /*#__PURE__*/function () {
       win.addEventListener && win.addEventListener('beforeunload', function () {
         try {
           // 页面卸载前刷新队列（同步）
-          _this5.flush().catch(function () {
+          logDebug(_this4.opts.debug, 'Page unload, flushed queue');
+          _this4.flush().catch(function () {
             // 忽略错误
           });
-          console.log('Page unload, flushed queue');
+          logDebug(_this4.opts.debug, 'Page unload, flushed queue');
         } catch (_unused3) {
           //
         }

package/dist/queueManager.d.ts

@@ -52,8 +52,4 @@ export declare class QueueManager {
      * 从持久化存储移除队列
      */
     private removeFromStorage;
-    /**
-     * 调试日志
-     */
-    private logDebug;
 }

package/dist/queueManager.js

@@ -9,12 +9,12 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * @Author       : 黄震 huangzhen@yfpharmacy.com
  * @Date         : 2025-12-18
  * @LastEditors  : 黄震 huangzhen@yfpharmacy.com
- * @LastEditTime : 2025-12-18
+ * @LastEditTime : 2026-01-14 09:33:41
  * @Description  : 队列管理器 - 支持内存队列和持久化存储
  * Copyright (c) 2025 by 益丰大药房连锁股份有限公司, All Rights Reserved.
  */
 
-import { isBrowser, isWeChatMiniProgram, safeStringify } from "./utils";
+import { isBrowser, isWeChatMiniProgram, logDebug, safeStringify } from "./utils";
 
 /** 队列配置选项 */
 
@@ -47,10 +47,10 @@ export var QueueManager = /*#__PURE__*/function () {
       // 队列已满，丢弃最旧的日志
       if (this.queue.length >= this.opts.maxSize) {
         this.queue.shift();
-        this.logDebug('Queue full, dropped oldest event');
+        logDebug(this.opts.debug, 'Queue full, dropped oldest event');
       }
       this.queue.push(event);
-      this.logDebug('Enqueued event', event.logId);
+      logDebug(this.opts.debug, 'Enqueued event', event);
 
       // 持久化到存储
       if (this.opts.enableStorage) {
@@ -75,7 +75,7 @@ export var QueueManager = /*#__PURE__*/function () {
     key: "dequeue",
     value: function dequeue(count) {
       var items = this.queue.splice(0, count);
-      this.logDebug("Dequeued ".concat(items.length, " events"));
+      logDebug(this.opts.debug, "Dequeued ".concat(items.length, " events"));
 
       // 更新持久化存储
       if (this.opts.enableStorage) {
@@ -100,7 +100,7 @@ export var QueueManager = /*#__PURE__*/function () {
     key: "clear",
     value: function clear() {
       this.queue = [];
-      this.logDebug('Queue cleared');
+      logDebug(this.opts.debug, 'Queue cleared');
       if (this.opts.enableStorage) {
         this.removeFromStorage();
       }
@@ -128,11 +128,11 @@ export var QueueManager = /*#__PURE__*/function () {
           var parsed = JSON.parse(stored);
           if (Array.isArray(parsed)) {
             this.queue = parsed.slice(0, this.opts.maxSize);
-            this.logDebug("Loaded ".concat(this.queue.length, " events from storage"));
+            logDebug(this.opts.debug, "Loaded ".concat(this.queue.length, " events from storage"));
           }
         }
       } catch (error) {
-        this.logDebug('Failed to load queue from storage', error);
+        logDebug(this.opts.debug, 'Failed to load queue from storage', error);
         // 加载失败不影响运行，使用空队列
       }
     }
@@ -156,7 +156,7 @@ export var QueueManager = /*#__PURE__*/function () {
           localStorage.setItem(this.storageKey, data);
         }
       } catch (error) {
-        this.logDebug('Failed to save queue to storage', error);
+        logDebug(this.opts.debug, 'Failed to save queue to storage', error);
         // 保存失败不影响运行
       }
     }
@@ -178,22 +178,7 @@ export var QueueManager = /*#__PURE__*/function () {
           localStorage.removeItem(this.storageKey);
         }
       } catch (error) {
-        this.logDebug('Failed to remove queue from storage', error);
-      }
-    }
-
-    /**
-     * 调试日志
-     */
-  }, {
-    key: "logDebug",
-    value: function logDebug() {
-      if (this.opts.debug) {
-        var _console;
-        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-          args[_key] = arguments[_key];
-        }
-        (_console = console).debug.apply(_console, ['[QueueManager]'].concat(args));
+        logDebug(this.opts.debug, 'Failed to remove queue from storage', error);
       }
     }
   }]);

package/dist/retryManager.d.ts

@@ -37,11 +37,11 @@ export declare class RetryManager {
      * @param useBackoff - 是否使用指数退避
      * @returns 延迟时间（毫秒）
      */
-    private calculateDelay;
+    private static calculateDelay;
     /**
      * 睡眠函数
      */
-    private sleep;
+    private static sleep;
     /**
      * 获取正在重试的任务数量
      */