@arms/rum-core 0.1.5 → 0.1.6

package/lib/monitor/types.d.ts

@@ -0,0 +1,46 @@
+export type MonitorLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'crash';
+export interface MonitorLogEvent {
+    level: MonitorLogLevel;
+    content: string;
+    stack?: string;
+    type?: string;
+    [key: string]: unknown;
+}
+export interface MonitorEventBundle {
+    'app.type': string;
+    _v: string;
+    endpoint: string;
+    'session.id'?: string;
+    'view.id'?: string;
+    timestamp: number;
+    event_type: 'log';
+    log?: MonitorLogEvent;
+    [key: string]: unknown;
+}
+export interface IMonitorReporter {
+    send(data: MonitorEventBundle[]): void;
+}
+/**
+ * 自监控配置
+ */
+export interface ISelfMonitorConfig {
+    /**
+     * 是否启用自监控，默认 true
+     */
+    enable?: boolean;
+    /**
+     * 采样率，取值范围 0 - 100，支持小数（如 50.5 表示 50.5%）
+     * 所有级别日志统一受采样率控制
+     */
+    sampling?: number;
+    /**
+     * 是否在浏览器控制台输出自监控日志，默认 false
+     * 设为 true 时，所有级别日志会同时输出到控制台
+     */
+    console?: boolean;
+    /**
+     * 需要上报到 Telemetry 的日志级别列表
+     * 默认值: ['debug', 'error', 'crash']
+     */
+    reportLevels?: MonitorLogLevel[];
+}

package/lib/monitor/types.js

@@ -0,0 +1,3 @@
+"use strict";
+
+exports.__esModule = true;

package/lib/types/client.d.ts

@@ -5,6 +5,7 @@ import { RumEvent, RumEventBundle, IViewData } from './rum-event';
 import { MatchOption } from '../utils/match';
 import { IConfigManager } from './config';
 import { EventEmitter } from '../utils/events';
+import { ISelfMonitorConfig, IMonitorReporter } from '../monitor/types';
 export declare enum EventType {
     /**
      * 收集数据
@@ -54,6 +55,10 @@ export interface IReportConfig {
 }
 export interface IRumSession {
     init(ctx: IContext): void;
+    /** 平台类型标识，如 'browser'/'miniapp' */
+    appType: string;
+    /** SDK 版本号 */
+    sdkVersion: string;
     sessionConfig: SessionConfig;
     getSessionId: () => string;
     getSampled: () => boolean;
@@ -110,7 +115,7 @@ export interface IClient {
     /**
      * 初始化
      */
-    init: (configuration: IConfiguration, rumSession?: IRumSession, configManager?: IConfigManager) => void;
+    init: (configuration: IConfiguration, rumSession?: IRumSession, configManager?: IConfigManager, monitorReporter?: IMonitorReporter) => void;
     /**
      * 业务自定义上传数据
      */
@@ -235,5 +240,13 @@ export interface IConfiguration {
         attributeName: string;
         attributeValue?: Array<string | RegExp> | null;
     }>;
+    /**
+     * 自监控（Self-Monitor）配置
+     * 用于控制 SDK 内部异常和错误的自动上报行为
+     * - `boolean`: 简单启用/禁用自监控
+     * - `ISelfMonitorConfig`: 详细配置，可指定采样率等
+     * @default true
+     */
+    selfMonitor?: boolean | ISelfMonitorConfig;
     [key: string]: unknown;
 }

package/lib/utils/base.js

@@ -38,9 +38,9 @@ function interceptFunction(target, name, callback, isPrototype) {
  */
 function restoreFunction(target, name) {
   var proxyMethod = target[name];
-  if ((0, _is.isFunction)(proxyMethod)) return;
+  if (!(0, _is.isFunction)(proxyMethod)) return;
   var originalMethod = proxyMethod._rum_intercepted;
-  if ((0, _is.isFunction)(originalMethod)) return;
+  if (!(0, _is.isFunction)(originalMethod)) return;
   target[name] = originalMethod;
 }
 

package/lib/utils/events.js

@@ -2,6 +2,7 @@
 
 exports.__esModule = true;
 exports.EventEmitter = void 0;
+var _logger = require("../monitor/logger");
 var EventEmitter = exports.EventEmitter = /*#__PURE__*/function () {
   function EventEmitter() {
     this.events = {};
@@ -36,7 +37,7 @@ var EventEmitter = exports.EventEmitter = /*#__PURE__*/function () {
         try {
           handlersCopy[i].apply(handlersCopy, args);
         } catch (err) {
-          console.error("Error in handler for \"" + eventName + "\":", err);
+          _logger.logger.error('EventEmitter', "Error in handler for \"" + eventName + "\"", err);
         }
       }
     }

package/lib/utils/protobuf.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SLS LogGroup Protobuf 编码器（最小化实现，零外部依赖）
+ *
+ * Schema:
+ *   message Log {
+ *     required uint32 Time = 1;
+ *     message Content { required string Key = 1; required string Value = 2; }
+ *     repeated Content Contents = 2;
+ *   }
+ *   message LogTag { required string Key = 1; required string Value = 2; }
+ *   message LogGroup {
+ *     repeated Log Logs = 1;
+ *     optional string Topic = 3;
+ *     optional string Source = 4;
+ *     repeated LogTag LogTags = 6;
+ *   }
+ */
+export declare function encodeLogGroup(logs: Array<{
+    time: number;
+    contents: Array<{
+        key: string;
+        value: string;
+    }>;
+}>, topic?: string, source?: string): Uint8Array;

package/lib/utils/protobuf.js

@@ -0,0 +1,127 @@
+"use strict";
+
+exports.__esModule = true;
+exports.encodeLogGroup = encodeLogGroup;
+/**
+ * SLS LogGroup Protobuf 编码器（最小化实现，零外部依赖）
+ *
+ * Schema:
+ *   message Log {
+ *     required uint32 Time = 1;
+ *     message Content { required string Key = 1; required string Value = 2; }
+ *     repeated Content Contents = 2;
+ *   }
+ *   message LogTag { required string Key = 1; required string Value = 2; }
+ *   message LogGroup {
+ *     repeated Log Logs = 1;
+ *     optional string Topic = 3;
+ *     optional string Source = 4;
+ *     repeated LogTag LogTags = 6;
+ *   }
+ */
+
+var WIRE_TYPE_VARINT = 0;
+var WIRE_TYPE_LEN = 2;
+
+/**
+ * UTF-8 编码 fallback（当 TextEncoder 不可用时使用，如部分小程序环境）
+ */
+function encodeUtf8Fallback(str) {
+  var bytes = [];
+  for (var i = 0; i < str.length; i++) {
+    var charCode = str.charCodeAt(i);
+    if (charCode < 0x80) {
+      bytes.push(charCode);
+    } else if (charCode < 0x800) {
+      bytes.push(0xc0 | charCode >> 6);
+      bytes.push(0x80 | charCode & 0x3f);
+    } else if (charCode >= 0xd800 && charCode <= 0xdbff) {
+      // 代理对处理
+      i++;
+      var low = str.charCodeAt(i);
+      charCode = 0x10000 + (charCode - 0xd800 << 10) + (low - 0xdc00);
+      bytes.push(0xf0 | charCode >> 18);
+      bytes.push(0x80 | charCode >> 12 & 0x3f);
+      bytes.push(0x80 | charCode >> 6 & 0x3f);
+      bytes.push(0x80 | charCode & 0x3f);
+    } else {
+      bytes.push(0xe0 | charCode >> 12);
+      bytes.push(0x80 | charCode >> 6 & 0x3f);
+      bytes.push(0x80 | charCode & 0x3f);
+    }
+  }
+  return new Uint8Array(bytes);
+}
+var utf8Encoder = typeof TextEncoder !== 'undefined' ? new TextEncoder() : {
+  encode: encodeUtf8Fallback
+};
+var ProtobufWriter = /*#__PURE__*/function () {
+  function ProtobufWriter() {
+    this.buf = [];
+  }
+  var _proto = ProtobufWriter.prototype;
+  _proto.writeVarint = function writeVarint(value) {
+    // Base-128 可变长整数编码（仅处理非负整数）
+    var v = value >>> 0;
+    while (v > 0x7f) {
+      this.buf.push(v & 0x7f | 0x80);
+      v = v >>> 7;
+    }
+    this.buf.push(v & 0x7f);
+  };
+  _proto.writeTag = function writeTag(fieldNumber, wireType) {
+    this.writeVarint(fieldNumber << 3 | wireType);
+  };
+  _proto.writeString = function writeString(fieldNumber, value) {
+    var bytes = utf8Encoder.encode(value);
+    this.writeTag(fieldNumber, WIRE_TYPE_LEN);
+    this.writeVarint(bytes.length);
+    for (var i = 0; i < bytes.length; i++) {
+      this.buf.push(bytes[i]);
+    }
+  };
+  _proto.writeUint32 = function writeUint32(fieldNumber, value) {
+    this.writeTag(fieldNumber, WIRE_TYPE_VARINT);
+    this.writeVarint(value);
+  };
+  _proto.writeBytes = function writeBytes(fieldNumber, data) {
+    this.writeTag(fieldNumber, WIRE_TYPE_LEN);
+    this.writeVarint(data.length);
+    for (var i = 0; i < data.length; i++) {
+      this.buf.push(data[i]);
+    }
+  };
+  _proto.finish = function finish() {
+    return new Uint8Array(this.buf);
+  };
+  return ProtobufWriter;
+}();
+function encodeContent(key, value) {
+  var w = new ProtobufWriter();
+  w.writeString(1, key);
+  w.writeString(2, value);
+  return w.finish();
+}
+function encodeLog(time, contents) {
+  var w = new ProtobufWriter();
+  w.writeUint32(1, time);
+  for (var i = 0; i < contents.length; i++) {
+    var c = contents[i];
+    w.writeBytes(2, encodeContent(c.key, c.value));
+  }
+  return w.finish();
+}
+function encodeLogGroup(logs, topic, source) {
+  var w = new ProtobufWriter();
+  for (var i = 0; i < logs.length; i++) {
+    var log = logs[i];
+    w.writeBytes(1, encodeLog(log.time, log.contents));
+  }
+  if (topic !== undefined) {
+    w.writeString(3, topic);
+  }
+  if (source !== undefined) {
+    w.writeString(4, source);
+  }
+  return w.finish();
+}

package/package.json

@@ -1,11 +1,20 @@
 {
   "name": "@arms/rum-core",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "arms rum javascript sdk core",
   "author": "guangli.fj <guangli.fj@alibaba-inc.com>",
   "license": "ISC",
   "main": "lib/index.js",
   "module": "es/index.js",
+  "types": "es/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./es/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.js"
+    }
+  },
   "directories": {
     "lib": "lib",
     "es": "es",