@microbt/environment 1.1.1 → 1.2.0

package/README.md

@@ -292,3 +292,57 @@ if (ruid) {
 ### 参考链接
 
 - [阿里云 ARMS 文档 - API 参考](https://help.aliyun.com/zh/arms/browser-monitoring/developer-reference/api-reference)
+
+## 日志管理
+
+### Logger
+
+提供统一的日志管理功能，支持不同级别的日志输出和配置。
+
+#### 配置选项
+
+```typescript
+interface LoggerConfig {
+  level: 'debug' | 'info' | 'warn' | 'error' | 'none';
+  prefix?: string;
+}
+```
+
+- `level` : 日志级别，默认在生产环境为 'info'，开发环境为 'debug'
+- `prefix` : 日志前缀，默认为 '@microbt/shared'
+
+#### 可用方法
+
+- `Logger.configure(config: Partial<LoggerConfig>)`: 配置日志选项
+- `Logger.debug(...args: any[])`: 输出调试级别日志
+- `Logger.info(...args: any[])`: 输出信息级别日志
+- `Logger.warn(...args: any[])`: 输出警告级别日志
+- `Logger.error(...args: any[])`: 输出错误级别日志
+
+#### 示例
+
+```typescript
+import { Logger } from '@microbt/environment';
+
+// 配置日志级别和前缀
+Logger.configure({
+  level: process.env.NODE_ENV === 'production' ? 'error' : 'debug',
+  prefix: '自定义前缀',
+});
+
+// 使用不同级别的日志
+Logger.debug('调试信息');
+Logger.info('普通信息');
+Logger.warn('警告信息');
+Logger.error('错误信息');
+```
+
+#### 日志级别说明
+
+日志级别从低到高依次为：
+
+- `debug` : 调试信息，仅在开发环境下显示
+- `info` : 普通信息
+- `warn` : 警告信息
+- `error` : 错误信息
+- `none` : 禁用所有日志输出较高级别的日志会包含所有较低级别的日志输出。例如，设置 level 为 'warn' 时，将输出 'warn' 和 'error' 级别的日志。

package/dist/esm/arms.d.ts

@@ -19,21 +19,21 @@ export declare const arms: {
         traceId?: string;
         sid?: string;
     }) => void;
-    error: (e: Error, pos: {
+    error: (e: Error, pos?: {
         filename: string;
         lineno: number;
         colno: number;
     }) => void;
-    sum: (key: string, value: number) => void;
-    avg: (key: string, value: number) => void;
+    sum: (key: string, value?: number) => void;
+    avg: (key: string, value?: number) => void;
     reportBehavior: () => void;
     performance: (params: unknown) => void;
     setConfig: (params: unknown) => void;
-    setPage: (page: string, sendPv: boolean) => void;
+    setPage: (page: string, sendPv?: boolean) => void;
     setCommonInfo: (params: unknown) => void;
     addBehavior: (data: {
         name: string;
         message: string;
-    }, page: string) => void;
+    }, page?: string) => void;
 };
 export {};

package/dist/esm/global.d.ts

@@ -28,15 +28,15 @@ declare global {
         traceId?: string;
         sid?: string;
       }): void;
-      error(e: Error, pos: { filename: string; lineno: number; colno: number }): void;
-      sum(key: string, value: number): void;
-      avg(key: string, value: number): void;
+      error(e: Error, pos?: { filename: string; lineno: number; colno: number }): void;
+      sum(key: string, value?: number): void;
+      avg(key: string, value?: number): void;
       reportBehavior(): void;
       performance(params: unknown): void;
       setConfig(params: unknown): void;
-      setPage(page: string, sendPv: boolean): void;
+      setPage(page: string, sendPv?: boolean): void;
       setCommonInfo(params: unknown): void;
-      addBehavior(data: { name: string; message: string }, page: string): void;
+      addBehavior(data: { name: string; message: string }, page?: string): void;
     };
   }
 

package/dist/esm/hybrid.js

@@ -1,4 +1,5 @@
 // src/hybrid.ts
+import Logger from "./logger";
 import { iOSWebview } from "./platform";
 var queue = [];
 document.addEventListener("WebViewJavascriptBridgeReady", () => {
@@ -11,6 +12,7 @@ document.addEventListener("WebViewJavascriptBridgeReady", () => {
 });
 function bridgeCall(method, params, callback) {
   var _a;
+  Logger.info("bridgeCall", method, params);
   try {
     if (((_a = window.SuperAcme) == null ? void 0 : _a.call) && typeof window.SuperAcme.call === "function") {
       window.SuperAcme.call(method, params, callback);
@@ -18,7 +20,7 @@ function bridgeCall(method, params, callback) {
       queue.push({ method, params, callback });
     }
   } catch (error) {
-    console.error("Bridge call failed:", error);
+    Logger.error("bridgeCall failed:", error);
     const errorResponse = {
       success: false,
       error: {

package/dist/esm/index.d.ts

@@ -4,4 +4,5 @@ export * from './environment/index';
 export * from './gateway/index';
 export * from './hybrid';
 export * from './local';
+export { default as Logger } from './logger';
 export * from './platform';

package/dist/esm/index.js

@@ -5,4 +5,8 @@ export * from "./environment/index";
 export * from "./gateway/index";
 export * from "./hybrid";
 export * from "./local";
+import { default as default2 } from "./logger";
 export * from "./platform";
+export {
+  default2 as Logger
+};

package/dist/esm/logger.d.ts

@@ -0,0 +1,16 @@
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+interface LoggerConfig {
+    level: LogLevel;
+    prefix?: string;
+}
+declare class Logger {
+    private static config;
+    private static readonly LOG_LEVELS;
+    static configure(config: Partial<LoggerConfig>): void;
+    static debug(...args: any[]): void;
+    static info(...args: any[]): void;
+    static warn(...args: any[]): void;
+    static error(...args: any[]): void;
+    private static shouldLog;
+}
+export default Logger;

package/dist/esm/logger.js

@@ -0,0 +1,62 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/logger.ts
+var _Logger = class {
+  static configure(config) {
+    _Logger.config = __spreadValues(__spreadValues({}, _Logger.config), config);
+  }
+  static debug(...args) {
+    if (_Logger.shouldLog("debug")) {
+      console.debug(`[${_Logger.config.prefix}]`, ...args);
+    }
+  }
+  static info(...args) {
+    if (_Logger.shouldLog("info")) {
+      console.info(`[${_Logger.config.prefix}]`, ...args);
+    }
+  }
+  static warn(...args) {
+    if (_Logger.shouldLog("warn")) {
+      console.warn(`[${_Logger.config.prefix}]`, ...args);
+    }
+  }
+  static error(...args) {
+    if (_Logger.shouldLog("error")) {
+      console.error(`[${_Logger.config.prefix}]`, ...args);
+    }
+  }
+  static shouldLog(level) {
+    return _Logger.LOG_LEVELS[level] >= _Logger.LOG_LEVELS[_Logger.config.level];
+  }
+};
+var Logger = _Logger;
+Logger.config = {
+  level: false ? "info" : "debug",
+  prefix: "@microbt/shared"
+};
+Logger.LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  none: 4
+};
+var logger_default = Logger;
+export {
+  logger_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microbt/environment",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "microbt app library for environment",
   "keywords": [],
   "license": "MIT",
@@ -37,6 +37,7 @@
     "@commitlint/cli": "^17.4.4",
     "@commitlint/config-conventional": "^17.4.4",
     "@types/jest": "^29.5.14",
+    "@types/node": "^22.13.4",
     "@typescript-eslint/eslint-plugin": "^5.54.1",
     "@typescript-eslint/parser": "^5.54.1",
     "eslint": "^8.36.0",