@pluve/logger-sdk 0.0.13 → 0.0.14

package/README.md

@@ -12,33 +12,26 @@
 ## 快速开始
 
 ```ts
-import { LoggerSDK } from './core/loggerSDK';
+import { LoggerSDK } from '@pluve/logger-sdk';
 
 const sdk = LoggerSDK.getInstance();
 
 sdk.init({
-  // endpoint: 'https://logger.yfpharmacy.com/log', // 实际使用以 config 中 API 为准
-  appId: 'fe-vue-pc-seed-frontend',
-  env: 'develop',
-  logStage: 'develop',
-  debug: true,
-  // 采集与性能
+  appId: 'app',
+  logStage: 'product',
+  debug: false,
   enableGzip: true,
-  enableBatch: true,
-  batchSize: 10,
+  enableBatch: false,
+  batchSize: 20,
   batchInterval: 15000,
   maxPixelUrlLen: 8192,
-  // 重试
-  enableRetry: true,
-  maxRetries: 3,
-  retryDelay: 1000,
-  retryBackoff: true,
-  // 身份与鉴权
+  enableRetry: false,
   userId: 'u-001',
   storeCode: 's-001',
   token: '<token>',
-  // 采样率（可选）
   sampleRate: 1,
+  enableAutoCapture: true,
+  autoCapture: { js: true, promise: true, resource: true, wechat: true },
 });
 
 // 业务日志
@@ -64,16 +57,18 @@ sdk.setStage('testing');
 - enableStorage：队列持久化开关（默认 true）
 - enableRetry/maxRetries/retryDelay/retryBackoff：重试相关配置
 - sampleRate/levelSampleRate/sourceSampleRate/pathSampleRate：采样配置
+- enableAutoCapture：自动采集总开关（默认开启）
+- autoCapture：细粒度开关 { js, promise, resource, wechat }
 
-详细定义参考类型文件：[sdkOptions.ts](src/pages/logger-sdk-tester/logger-sdk-v2/types/sdkOptions.ts).
+详细定义参考类型文件：[sdkOptions.ts](./src/types/sdkOptions.ts).
 
 ## 压缩实现
 
 - gzipCompress(data)
   - 浏览器支持 CompressionStream 时，流式 gzip 压缩，再转 Base64 字符串
-  - 不支持时，回退到 fflate.gzipSync(默认压缩级别)，转 Base64
+  - 不支持时，回退到 fflate.gzipSync，使用 btoa/Buffer 生成 Base64
   - 返回值为 Base64 字符串，适用于传输（像素图 URL/JSON 体）
-- 代码参考：[compression.ts](src/pages/logger-sdk-tester/logger-sdk-v2/compress/compression.ts).
+- 代码参考：[compression.ts](./src/compress/compression.ts).
 - 备注：当前默认压缩级别，无级别可调参数暴露；如需级别控制可在 fflate 路径引入配置。
 
 ## 传输适配
@@ -85,7 +80,7 @@ sdk.setStage('testing');
   - 请求体字符串化 safeStringify
   - enableGzip 时使用 gzipCompress 生成 Base64，Content-Type 设为 `application/json; charset=utf-8`
 - PixelImageTransport
-  - 字符串化 items，enableGzip 时压缩为 Base64，URL 参数附带 `gzip=1`
+  - 字符串化 items，enableGzip 时压缩为 Base64；非 gzip 情况下优先使用全局 Base64，其次 btoa，再次 encodeURIComponent；URL 参数附带 `gzip=1`
   - 构造像素上报 URL（含 appId、appStage、items、cacheBuster）
   - URL 超长打印警告
 - BeaconTransport
@@ -93,26 +88,26 @@ sdk.setStage('testing');
 
 代码参考：
 
-- 适配器选择：[transportAdapter.ts](src/pages/logger-sdk-tester/logger-sdk-v2/transport/transportAdapter.ts)
-- WeChat：[wechatTransport.ts](src/pages/logger-sdk-tester/logger-sdk-v2/transport/wechatTransport.ts)
-- Pixel Image：[pixelImageTransport.ts](src/pages/logger-sdk-tester/logger-sdk-v2/transport/pixelImageTransport.ts)
-- Beacon：[beaconTransport.ts](src/pages/logger-sdk-tester/logger-sdk-v2/transport/beaconTransport.ts)
+- 适配器选择：[transportAdapter.ts](./src/transport/transportAdapter.ts)
+- WeChat：[wechatTransport.ts](./src/transport/wechatTransport.ts)
+- Pixel Image：[pixelImageTransport.ts](./src/transport/pixelImageTransport.ts)
+- Beacon：[beaconTransport.ts](./src/transport/beaconTransport.ts)
 
 ## 批量与队列
 
 - 启用批量后，事件入队，当队列大小达到 batchSize 或定时器触发时 flush
 - flush：按 appId|stage 分组与分块（最多 200/块），批量发送成功后出队
-- 队列持久化：localforage 存储，页面刷新/卸载可恢复
+- 队列持久化：优先 IndexedDB（localforage），失败回退 localStorage；仅在浏览器环境启用
 - 页面事件触发 flush：visibilitychange（hidden）、pagehide、beforeunload
 - 代码参考：
-  - [queueManager.ts](src/pages/logger-sdk-tester/logger-sdk-v2/core/queueManager.ts)
-  - [loggerSDK.ts（flush/sendBatch）](src/pages/logger-sdk-tester/logger-sdk-v2/core/loggerSDK.ts#L452-L485)
+  - [queueManager.ts](./src/core/queueManager.ts)
+  - [loggerSDK.ts（flush/sendBatch）](./src/core/loggerSDK.ts#L394-L467)
 
 ## 重试策略
 
 - 单个事件 sendEvent 与批量 sendBatch 均支持 executeWithRetry
 - 可配置最大次数、基础延迟、指数退避
-- 代码参考：[retryManager.ts](src/pages/logger-sdk-tester/logger-sdk-v2/core/retryManager.ts)
+- 代码参考：[retryManager.ts](./src/core/retryManager.ts)
 
 ## 采样与开关
 
@@ -124,13 +119,13 @@ sdk.setStage('testing');
   - 综合 level/source/path/global 采样率
   - 基于 seed 哈希概率决定是否发送
 - 参考：
-  - [loggerSDK.ts（shouldSend）](src/pages/logger-sdk-tester/logger-sdk-v2/core/loggerSDK.ts#L348-L411)
-  - [api.ts](src/pages/logger-sdk-tester/logger-sdk-v2/types/api.ts)
+  - [loggerSDK.ts（shouldSend）](./src/core/loggerSDK.ts#L324-L365)
+  - [api.ts](./src/types/api.ts)
 
 ## 数据格式
 
 - LogEvent：标准化日志格式（logId/seq/appId/stage/level/traceId/frontendId/url/location/message/throwable/userId/storeCode/tags）
-  - 类型参考：[logEvent.ts](src/pages/logger-sdk-tester/logger-sdk-v2/types/logEvent.ts)
+  - 类型参考：[logEvent.ts](./src/types/logEvent.ts)
 - ReportData：上报批次（appId/appStage/items[]）
 
 ## 限制与注意
@@ -139,8 +134,16 @@ sdk.setStage('testing');
 - 像素图：URL 长度受限；压缩可显著降低长度但 Base64 会比二进制略增
 - 压缩：CompressionStream 不提供压缩级别参数；fflate 同步压缩适合小批量数据
 - 安全：不要在日志中包含敏感数据（token、密码、隐私信息等）
+- 依赖：js-base64、localforage 均为 peerDependencies；UMD 外部化由应用或 CDN 提供全局；ESM/CJS 下由应用安装解析
 
 ## 流程图
 
 - 完整 Mermaid 流程图见文件：
-  - [logger-sdk.mermaid](src/pages/logger-sdk-tester/logger-sdk-v2/logger-sdk.mermaid)
+  - [logger-sdk.mermaid](./src/logger-sdk.mermaid)
+  - [logger-sdk.svg](./src/logger-sdk.svg)
+
+## 类型与打包
+
+- 类型入口：package.json exports.types 与 typesVersions 指向 dist/types
+- TypeScript 解析：推荐在应用设置 moduleResolution: "bundler" 或 "nodenext"/"node16"
+- 声明构建：`yarn build-types`（tsconfig.types.json 禁用默认 @types 扫描，避免冲突）

package/dist/esm/compress/compression.js

@@ -40,7 +40,7 @@ async function gzipCompress(data) {
   } catch (e) {
     console.log("gzipCompress 压缩失败", e);
   }
-  return data;
+  throw new Error("gzipCompress 不支持压缩");
 }
 function convert2Base64FromArray(data) {
   let binary = "";
@@ -55,7 +55,7 @@ function convert2Base64FromArray(data) {
   }
   throw new Error("convert2Base64FromArray 不支持转换");
 }
-function convert2Base64(data) {
+async function convert2Base64(data) {
   if (typeof btoa !== "undefined") {
     try {
       return btoa(data);
@@ -65,6 +65,12 @@ function convert2Base64(data) {
   if (typeof Buffer !== "undefined") {
     return Buffer.from(data, "base64").toString("base64");
   }
+  try {
+    const mod = await import("js-base64");
+    return mod.Base64.encode(data);
+  } catch (e) {
+    console.log("convert2Base64 动态引入 js-base64 库失败", e);
+  }
   return data;
 }
 function isGzipSupported() {

package/dist/esm/core/queueManager.js

@@ -23,10 +23,7 @@ var QueueManager = class {
         return this.localforage;
       }
       try {
-        const mod = await import(
-          /* @vite-ignore */
-          "localforage"
-        );
+        const mod = await import("localforage");
         this.localforage = mod;
         return this.localforage;
       } catch (e) {

package/dist/esm/transport/pixelImageTransport.js

@@ -24,11 +24,12 @@ var PixelImageTransport = class {
       const t = now();
       logDebug(!!((_e = this.opts) == null ? void 0 : _e.debug), "PixelImage request gzip compress body: ", body);
       compressedBody = await gzipCompress(body);
+      compressedBody = await convert2Base64(compressedBody);
       logDebug(!!((_f = this.opts) == null ? void 0 : _f.debug), "PixelImage request gzip compress cost: ", now() - t);
       logDebug(!!((_g = this.opts) == null ? void 0 : _g.debug), `original body size: ${body.length}, compressed body size: ${compressedBody.length}`);
       logDebug(!!((_h = this.opts) == null ? void 0 : _h.debug), "PixelImage request gzip compress body: ", compressedBody);
     } else {
-      compressedBody = convert2Base64(body);
+      compressedBody = await convert2Base64(body);
     }
     const cacheBuster = `_=${Date.now()}`;
     const qs = `appId=${((_i = this.opts) == null ? void 0 : _i.appId) || ""}&appStage=${((_j = this.opts) == null ? void 0 : _j.logStage) || ""}&${param}=${encodeURIComponent(compressedBody)}&gzip=${((_k = this.opts) == null ? void 0 : _k.enableGzip) ? 1 : 0}&${cacheBuster}`;

package/dist/types/compress/compression.d.ts

@@ -5,7 +5,7 @@
  */
 export declare function gzipCompress(data: string): Promise<string>;
 export declare function convert2Base64FromArray(data: any): any;
-export declare function convert2Base64(data: string): string;
+export declare function convert2Base64(data: string): Promise<string>;
 /**
  * 检查是否支持 gzip 压缩
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluve/logger-sdk",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "description": "logger sdk",
   "keywords": [
     "logger"
@@ -59,7 +59,6 @@
   "devDependencies": {
     "jsdom": "^27.4.0",
     "vitest": "^4.0.15",
-    "localforage": "^1.10.0",
     "@mermaid-js/mermaid-cli": "^10.9.1"
   },
   "dependencies": {
@@ -67,6 +66,7 @@
     "stacktrace-js": "^2.0.2"
   },
   "peerDependencies": {
-    "localforage": "^1.10.0"
+    "localforage": "^1.10.0",
+    "js-base64": "^3.7.8"
   }
 }