@pluve/logger-sdk 0.0.1 → 0.0.2

package/dist/esm/transportAdapter.d.ts

@@ -1,5 +1,51 @@
-import { SDKOptions } from "./types";
-export declare function defaultTransport(payload: any, opts?: SDKOptions & {
-    endpoint?: string;
-    headers?: Record<string, string>;
-}): Promise<void>;
+import { SDKOptions } from './types';
+/** 传输选项接口 */
+export interface TransportOptions extends Omit<SDKOptions, 'endpoint'> {
+    endpoint: string;
+}
+/** 传输适配器接口 */
+export interface TransportAdapter {
+    /** 适配器名称 */
+    name: string;
+    /** 是否支持当前环境 */
+    isSupported(opts?: TransportOptions): boolean;
+    /** 发送数据 */
+    send(payload: any, opts?: TransportOptions): Promise<void>;
+}
+/**
+ * Beacon 传输适配器
+ * - 兼容性：现代浏览器（Chrome 39+, Firefox 31+, Edge 14+）
+ * - 健壮性：页面卸载时可靠传输、不阻塞页面卸载
+ * - 适用场景：页面关闭、visibilitychange、pagehide、beforeunload 事件
+ * - 限制：无法获取响应、队列有大小限制（通常 64KB）
+ */
+export declare const beaconTransport: TransportAdapter;
+/**
+ * 微信小程序传输适配器
+ * - 兼容性：微信小程序环境
+ * - 健壮性：支持超时控制、完善的错误处理
+ * - 适用场景：微信小程序环境下的日志上报
+ */
+export declare const wechatTransport: TransportAdapter;
+/**
+ * Image 像素上报适配器
+ * - 兼容性：所有浏览器
+ * - 健壮性：轻量级、无跨域限制、支持超时控制
+ * - 适用场景：数据量小的快速上报、跨域场景、降级方案
+ * - 限制：URL 长度限制（默认 1900 字符）
+ */
+export declare const imageTransport: TransportAdapter;
+/**
+ * 默认传输函数 - 按环境选择最佳传输方式
+ * 浏览器策略：Beacon（可靠） > Image（兼容）
+ * 微信小程序策略：WeChat Request
+ */
+export declare function defaultTransport(payload: any, opts?: TransportOptions): Promise<void>;
+/**
+ * 导出所有适配器，方便自定义使用
+ */
+export declare const TransportAdapters: {
+    beacon: TransportAdapter;
+    wechat: TransportAdapter;
+    image: TransportAdapter;
+};

package/dist/esm/transportAdapter.js

@@ -1,142 +1,291 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-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); }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 /*
  * @Author       : 黄震 huangzhen@yfpharmacy.com
  * @Date         : 2025-11-21 14:35:48
  * @LastEditors  : 黄震 huangzhen@yfpharmacy.com
- * @LastEditTime : 2025-12-02 15:18:05
- * @Description  : 传输适配器接口，用于发送日志到服务器
+ * @LastEditTime : 2025-12-04 14:30:00
+ * @Description  : 传输适配器 - Beacon、像素图和微信小程序方式
  * Copyright (c) 2025 by 益丰大药房连锁股份有限公司, All Rights Reserved.
  */
 
-import { isWeChatMiniProgram, safeStringify, isBrowser, now } from "./utils";
+import { safeStringify, isBrowser, isWeChatMiniProgram, now } from "./utils";
+
+/** 传输选项接口 */
+
+/** 传输适配器接口 */
+
+// ==================== 辅助函数 ====================
+
+/** 获取端点 URL */
+function getEndpoint(opts) {
+  return (opts === null || opts === void 0 ? void 0 : opts.endpoint) || '';
+}
+
+// ==================== 1. Beacon 传输适配器（页面卸载场景首选）====================
+
+/**
+ * Beacon 传输适配器
+ * - 兼容性：现代浏览器（Chrome 39+, Firefox 31+, Edge 14+）
+ * - 健壮性：页面卸载时可靠传输、不阻塞页面卸载
+ * - 适用场景：页面关闭、visibilitychange、pagehide、beforeunload 事件
+ * - 限制：无法获取响应、队列有大小限制（通常 64KB）
+ */
+export var beaconTransport = {
+  name: 'beacon',
+  isSupported: function isSupported() {
+    return isBrowser() && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function';
+  },
+  send: function send(payload, opts) {
+    return _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+      var body, endpoint, blob, success;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            body = typeof payload === 'string' ? payload : safeStringify(payload);
+            endpoint = getEndpoint(opts); // sendBeacon 使用 Blob 确保正确的 Content-Type
+            blob = new Blob([body], {
+              type: 'application/json'
+            });
+            success = navigator.sendBeacon(endpoint, blob);
+            if (success) {
+              _context.next = 6;
+              break;
+            }
+            throw new Error('sendBeacon failed (queue full or other error)');
+          case 6:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }))();
+  }
+};
+
+// ==================== 2. 微信小程序传输适配器（微信环境专用）====================
+
+/**
+ * 微信小程序传输适配器
+ * - 兼容性：微信小程序环境
+ * - 健壮性：支持超时控制、完善的错误处理
+ * - 适用场景：微信小程序环境下的日志上报
+ */
+export var wechatTransport = {
+  name: 'wechat',
+  isSupported: function isSupported() {
+    return isWeChatMiniProgram();
+  },
+  send: function send(payload, opts) {
+    return _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+      var body, endpoint, timeout;
+      return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            body = typeof payload === 'string' ? payload : safeStringify(payload);
+            endpoint = getEndpoint(opts);
+            timeout = 10000; // 10秒超时
+            return _context2.abrupt("return", new Promise(function (resolve, reject) {
+              var timeoutId = null;
+              var settled = false;
+
+              // 超时处理
+              timeoutId = setTimeout(function () {
+                if (!settled) {
+                  settled = true;
+                  reject(new Error("WeChat request timeout after ".concat(timeout, "ms")));
+                }
+              }, timeout);
+
+              // @ts-ignore
+              wx.request({
+                url: endpoint,
+                method: 'POST',
+                data: body,
+                header: {
+                  'Content-Type': 'application/json'
+                },
+                success: function success(res) {
+                  if (timeoutId) clearTimeout(timeoutId);
+                  if (!settled) {
+                    settled = true;
+                    if (res.statusCode >= 200 && res.statusCode < 300) {
+                      resolve();
+                    } else {
+                      reject(new Error("HTTP ".concat(res.statusCode)));
+                    }
+                  }
+                },
+                fail: function fail(err) {
+                  if (timeoutId) clearTimeout(timeoutId);
+                  if (!settled) {
+                    settled = true;
+                    reject(new Error("WeChat request failed: ".concat(err.errMsg || 'unknown error')));
+                  }
+                }
+              });
+            }));
+          case 4:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2);
+    }))();
+  }
+};
+
+// ==================== 3. Image 像素上报适配器（兼容性最好）====================
+
+/**
+ * Image 像素上报适配器
+ * - 兼容性：所有浏览器
+ * - 健壮性：轻量级、无跨域限制、支持超时控制
+ * - 适用场景：数据量小的快速上报、跨域场景、降级方案
+ * - 限制：URL 长度限制（默认 1900 字符）
+ */
+export var imageTransport = {
+  name: 'image',
+  isSupported: function isSupported() {
+    return isBrowser() && typeof Image !== 'undefined';
+  },
+  send: function send(payload, opts) {
+    return _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+      var body, endpoint, param, maxLen, cacheBuster, qs, url;
+      return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            body = typeof payload === 'string' ? payload : safeStringify(payload);
+            endpoint = getEndpoint(opts);
+            param = (opts === null || opts === void 0 ? void 0 : opts.pixelParam) || 'data';
+            maxLen = (opts === null || opts === void 0 ? void 0 : opts.maxPixelUrlLen) || 1900; // 构建 URL
+            cacheBuster = "_=".concat(now());
+            qs = "".concat(param, "=").concat(encodeURIComponent(body), "&").concat(cacheBuster);
+            url = endpoint.includes('?') ? "".concat(endpoint, "&").concat(qs) : "".concat(endpoint, "?").concat(qs); // URL 长度检查
+            if (!(url.length > maxLen)) {
+              _context3.next = 9;
+              break;
+            }
+            throw new Error("URL too long (".concat(url.length, " > ").concat(maxLen, ")"));
+          case 9:
+            return _context3.abrupt("return", new Promise(function (resolve, reject) {
+              var img = new Image();
+              var timeoutId = null;
+              var settled = false;
+
+              // 超时处理（5秒）
+              timeoutId = setTimeout(function () {
+                if (!settled) {
+                  settled = true;
+                  img.src = ''; // 取消请求
+                  reject(new Error('Image request timeout after 5000ms'));
+                }
+              }, 5000);
+              img.onload = function () {
+                if (timeoutId) clearTimeout(timeoutId);
+                if (!settled) {
+                  settled = true;
+                  resolve();
+                }
+              };
+              img.onerror = function () {
+                if (timeoutId) clearTimeout(timeoutId);
+                if (!settled) {
+                  settled = true;
+                  reject(new Error('Image request failed'));
+                }
+              };
+
+              // 发起请求
+              img.src = url;
+            }));
+          case 10:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3);
+    }))();
+  }
+};
+
+// ==================== 默认传输策略 ====================
+
+/**
+ * 默认传输函数 - 按环境选择最佳传输方式
+ * 浏览器策略：Beacon（可靠） > Image（兼容）
+ * 微信小程序策略：WeChat Request
+ */
 export function defaultTransport(_x, _x2) {
   return _defaultTransport.apply(this, arguments);
 }
+
+/**
+ * 导出所有适配器，方便自定义使用
+ */
 function _defaultTransport() {
-  _defaultTransport = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(payload, opts) {
-    var _endpoints;
-    var body, timeout, endpoint, blob, ok, param, cacheBuster, urlBase, qs, url, maxLen, img, controller;
-    return _regeneratorRuntime().wrap(function _callee$(_context) {
-      while (1) switch (_context.prev = _context.next) {
+  _defaultTransport = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(payload, opts) {
+    var transports, adapter;
+    return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
         case 0:
-          body = typeof payload === 'string' ? payload : safeStringify(payload);
-          timeout = (opts === null || opts === void 0 ? void 0 : opts.timeout) || 10000;
-          endpoint = opts && opts.endpoint ? opts.endpoint : ((_endpoints = opts.endpoints) === null || _endpoints === void 0 ? void 0 : _endpoints.default) || '';
-          if (!(isBrowser() && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function' && opts !== null && opts !== void 0 && opts.useBeacon)) {
-            _context.next = 9;
-            break;
-          }
-          blob = new Blob([body], {
-            type: 'application/json'
-          });
-          ok = navigator.sendBeacon(endpoint || '', blob);
-          if (!ok) {
-            _context.next = 8;
-            break;
-          }
-          return _context.abrupt("return", Promise.resolve());
-        case 8:
-          return _context.abrupt("return", Promise.reject(new Error('sendBeacon failed')));
-        case 9:
           if (!isWeChatMiniProgram()) {
-            _context.next = 11;
+            _context4.next = 5;
             break;
           }
-          return _context.abrupt("return", new Promise(function (resolve, reject) {
-            var timer = null;
-            // @ts-ignore
-            wx.request({
-              url: endpoint || '',
-              method: 'POST',
-              data: body,
-              header: _objectSpread({
-                'Content-Type': 'application/json'
-              }, opts && opts.globalHeaders ? opts.globalHeaders : {}),
-              success: function success() {
-                if (timer) clearTimeout(timer);
-                resolve();
-              },
-              fail: function fail(err) {
-                if (timer) clearTimeout(timer);
-                reject(err);
-              }
-            });
-            timer = setTimeout(function () {
-              return reject(new Error('timeout'));
-            }, timeout);
-          }));
-        case 11:
-          if (!(isBrowser() && opts !== null && opts !== void 0 && opts.usePixel)) {
-            _context.next = 23;
+          if (!wechatTransport.isSupported(opts)) {
+            _context4.next = 5;
             break;
           }
-          param = (opts === null || opts === void 0 ? void 0 : opts.pixelParam) || 'data';
-          cacheBuster = "_=".concat(now());
-          urlBase = endpoint || '';
-          qs = "".concat(param, "=").concat(encodeURIComponent(body), "&").concat(cacheBuster);
-          url = urlBase.includes('?') ? "".concat(urlBase, "&").concat(qs) : "".concat(urlBase, "?").concat(qs);
-          maxLen = (opts === null || opts === void 0 ? void 0 : opts.maxPixelUrlLen) || 1900;
-          if (!(url.length > maxLen)) {
-            _context.next = 21;
+          _context4.next = 4;
+          return wechatTransport.send(payload, opts);
+        case 4:
+          return _context4.abrupt("return");
+        case 5:
+          // 浏览器环境使用 Beacon 或 Image
+          transports = [beaconTransport, imageTransport]; // 尝试找到第一个支持的适配器
+          adapter = transports.find(function (t) {
+            return t.isSupported(opts);
+          });
+          if (adapter) {
+            _context4.next = 9;
             break;
           }
-          _context.next = 23;
+          throw new Error('No supported transport adapter available');
+        case 9:
+          _context4.prev = 9;
+          _context4.next = 12;
+          return adapter.send(payload, opts);
+        case 12:
+          _context4.next = 27;
           break;
-        case 21:
-          // 使用 Image 像素上报
-          img = new Image();
-          return _context.abrupt("return", new Promise(function (resolve, reject) {
-            var timer = null;
-            img.onload = function () {
-              if (timer) clearTimeout(timer);
-              resolve();
-            };
-            img.onerror = function () {
-              if (timer) clearTimeout(timer);
-              reject(new Error('pixel error'));
-            };
-            timer = setTimeout(function () {
-              return reject(new Error('timeout'));
-            }, timeout);
-            img.src = url;
-          }));
-        case 23:
-          if (!(typeof fetch === 'function')) {
-            _context.next = 27;
+        case 14:
+          _context4.prev = 14;
+          _context4.t0 = _context4["catch"](9);
+          if (!(adapter.name === 'beacon' && imageTransport.isSupported(opts))) {
+            _context4.next = 26;
             break;
           }
-          controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
-          if (controller) setTimeout(function () {
-            return controller.abort();
-          }, timeout);
-          return _context.abrupt("return", fetch(endpoint || '', {
-            method: 'POST',
-            headers: _objectSpread(_objectSpread({
-              'Content-Type': 'application/json'
-            }, opts && opts.globalHeaders ? opts.globalHeaders : {}), opts && opts.headers ? opts.headers : {}),
-            body: body,
-            // 在页面关闭场景提供尽力传输能力（非标准环境忽略）
-            // @ts-ignore
-            keepalive: opts !== null && opts !== void 0 && opts.useBeacon ? true : undefined,
-            signal: controller ? controller.signal : undefined
-          }).then(function (res) {
-            if (!res.ok) throw new Error('network response not ok');
-          }));
+          _context4.prev = 17;
+          _context4.next = 20;
+          return imageTransport.send(payload, opts);
+        case 20:
+          return _context4.abrupt("return");
+        case 23:
+          _context4.prev = 23;
+          _context4.t1 = _context4["catch"](17);
+          throw _context4.t0;
+        case 26:
+          throw _context4.t0;
         case 27:
-          return _context.abrupt("return", Promise.reject(new Error('no transport available')));
-        case 28:
         case "end":
-          return _context.stop();
+          return _context4.stop();
       }
-    }, _callee);
+    }, _callee4, null, [[9, 14], [17, 23]]);
   }));
   return _defaultTransport.apply(this, arguments);
-}
+}
+export var TransportAdapters = {
+  beacon: beaconTransport,
+  wechat: wechatTransport,
+  image: imageTransport
+};

package/dist/esm/types.d.ts

@@ -1,35 +1,46 @@
-export type Env = 'h5' | 'wechat' | 'unknown';
-export type LogEventType = 'event' | 'error' | 'pageview' | 'perf' | 'custom';
-export type LogEventLevel = 'info' | 'warn' | 'error' | 'debug';
+/** 环境类型 */
+export type Env = 'prod' | 'stage' | 'dev';
+/** 事件类型 */
+export type LogEventType = 'error' | 'crash' | 'pageview' | 'custom';
+/** 日志级别 */
+export type LogEventLevel = 'info' | 'warn' | 'error' | 'fatal';
+/** SDK 配置选项 */
 export interface SDKOptions {
-    endpoints: Partial<Record<'info' | 'warn' | 'error' | 'default', string>>;
+    /** 上报端点 URL */
+    endpoint: string;
+    /** 应用 ID */
     appId?: string;
+    /** 环境标识 */
     env?: Env;
-    batchSize?: number;
-    flushInterval?: number;
-    retryCount?: number;
-    retryBase?: number;
-    storageKey?: string;
-    maxCacheSize?: number;
-    timeout?: number;
+    /** 是否开启调试模式 */
     debug?: boolean;
-    transport?: (payload: any, opts?: SDKOptions & {
-        endpoint?: string;
-        headers?: Record<string, string>;
-    }) => Promise<void>;
-    globalHeaders?: Record<string, string>;
-    enableAutoPV?: boolean;
-    enablePerf?: boolean;
-    useBeacon?: boolean;
-    usePixel?: boolean;
+    /** 像素上报参数名，默认 'data' */
     pixelParam?: string;
+    /** 像素上报 URL 最大长度，默认 1900 */
     maxPixelUrlLen?: number;
 }
+/** 标准化日志上报格式 */
 export interface LogEvent {
-    type: LogEventType;
-    time: number;
-    user?: Record<string, any>;
-    ctx?: Record<string, any>;
-    level?: LogEventLevel;
-    seq?: number;
+    /** 事件类型：error/crash/pageview/custom */
+    eventType: LogEventType;
+    /** 毫秒时间戳 */
+    ts: number;
+    /** 应用标识 */
+    appId: string;
+    /** 环境标识：prod/stage/dev */
+    env: Env;
+    /** 日志级别：info/warn/error/fatal */
+    level: LogEventLevel;
+    /** 摘要信息 */
+    message: string;
+    /** 可选：堆栈信息（长字符串） */
+    stack?: string;
+    /** 发生页面 URL */
+    url: string;
+    /** 可选：用户 ID（脱敏） */
+    userId?: string;
+    /** 会话标识 */
+    sessionId: string;
+    /** 可选的结构化额外信息 */
+    tags?: Record<string, any>;
 }

package/dist/esm/utils.d.ts

@@ -1,5 +1,30 @@
 export declare const now: () => number;
-export declare function isWeChatMiniProgram(): boolean;
 export declare function isBrowser(): boolean;
+export declare function isWeChatMiniProgram(): boolean;
 export declare function safeStringify(obj: any): string;
-export declare function isIndexedDBAvailable(): boolean;
+export declare function getSessionId(): string;
+export declare function getCurrentUrl(): string;
+/** 平台类型 */
+export type PlatformType = 'browser' | 'wechat' | 'unknown';
+/** 环境信息 */
+export interface EnvironmentInfo {
+    platform: PlatformType;
+    userAgent?: string;
+    screenWidth?: number;
+    screenHeight?: number;
+    language?: string;
+    systemInfo?: any;
+}
+/**
+ * 获取环境信息
+ */
+export declare function getEnvironmentInfo(): EnvironmentInfo;
+/**
+ * 解析浏览器信息
+ */
+export declare function parseBrowserInfo(userAgent: string): {
+    browser: string;
+    browserVersion: string;
+    os: string;
+    osVersion: string;
+};