@guomain/monitor-web 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# @gm Monitor SDK
+
+前端错误监控：运行时错误、Promise、资源加载、接口异常、Vue/React、手动上报、catch 自动采集（需 Vite 插件）。
+
+## 安装
+
+```sh
+pnpm add @guomain/monitor-web
+pnpm add -D @guomain/monitor-plugins @guomain/monitor-types
+```
+
+## 快速开始
+
+```ts
+import { createWebMonitor } from '@guomain/monitor-web'
+
+const monitor = createWebMonitor({
+  appId: 'your-app',
+  dsn: '/api/monitor',
+  vue: { app }
+})
+
+globalThis.__GM_MONITOR__ = monitor
+monitor.start()
+```
+
+完整说明见仓库内 `SDK.md` 与 `PUBLISH.md`。

package/error/index.d.ts

@@ -0,0 +1,8 @@
+import type { MonitorInstance } from '@guomain/monitor-types';
+import type { Teardown } from '../shared/browser';
+/**
+ * 安装 Web 错误监控能力。
+ * @param monitor 当前监控实例。
+ */
+export declare function setupWebError(monitor: MonitorInstance): Teardown;
+//# sourceMappingURL=index.d.ts.map

package/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAMjD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA+BhE"}

package/error/promise.d.ts

@@ -0,0 +1,7 @@
+import type { MonitorInstance } from '@guomain/monitor-types';
+/**
+ * 监听未处理的 Promise rejection。
+ * @param monitor 当前监控实例。
+ */
+export declare function setupPromiseError(monitor: MonitorInstance): import("../shared/browser").Teardown;
+//# sourceMappingURL=promise.d.ts.map

package/error/promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../src/error/promise.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,wCAIzD"}

package/error/request.d.ts

@@ -0,0 +1,15 @@
+import type { MonitorInstance } from '@guomain/monitor-types';
+/**
+ * 标记一次 transport 调用开始，由 monitor-web 在执行用户 transport 前调用。
+ */
+export declare function beginTransportScope(): void;
+/**
+ * 标记一次 transport 调用结束。
+ */
+export declare function endTransportScope(): void;
+/**
+ * 安装请求错误监控。
+ * @param monitor 当前监控实例。
+ */
+export declare function setupRequestError(monitor: MonitorInstance): () => void;
+//# sourceMappingURL=request.d.ts.map

package/error/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/error/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAoB7D;;GAEG;AACH,wBAAgB,mBAAmB,SAElC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,SAIhC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,cASzD"}

package/error/resource.d.ts

@@ -0,0 +1,7 @@
+import type { MonitorInstance } from '@guomain/monitor-types';
+/**
+ * 监听资源加载错误。
+ * @param monitor 当前监控实例。
+ */
+export declare function setupResourceError(monitor: MonitorInstance): import("../shared/browser").Teardown;
+//# sourceMappingURL=resource.d.ts.map

package/error/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/error/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,wCAuB1D"}

package/error/runtime.d.ts

@@ -0,0 +1,7 @@
+import type { MonitorInstance } from '@guomain/monitor-types';
+/**
+ * 监听 JS 运行时错误。
+ * @param monitor 当前监控实例。
+ */
+export declare function setupRuntimeError(monitor: MonitorInstance): import("../shared/browser").Teardown;
+//# sourceMappingURL=runtime.d.ts.map

package/error/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/error/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,wCAqBzD"}

package/index.d.ts

@@ -0,0 +1,8 @@
+import type { MonitorConfig, MonitorInstance } from '@guomain/monitor-types';
+/**
+ * 创建 Web 端监控实例。
+ * @param config SDK 初始化配置，包含应用标识、Web 错误开关、Vue app、transport 等。
+ */
+export declare function createWebMonitor(config: MonitorConfig): MonitorInstance;
+export type { MonitorConfig, MonitorEvent, MonitorEventMeta, MonitorInstance, MonitorPayload, MonitorTransport } from '@guomain/monitor-types';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAA;AAK9F;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAsDvE;AA2HD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,gBAAgB,EACjB,MAAM,wBAAwB,CAAA"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "version": "0.1.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+http://192.168.200.220/GomainFE/stamp.git",
+    "directory": "monitor/packages/monitor-web"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "name": "@guomain/monitor-web",
+  "description": "Web error monitoring SDK (Vue/React, fetch/XHR, global errors)",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./web.cjs.js",
+  "module": "./web.es.js",
+  "unpkg": "./web.umd.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./web.es.js",
+      "require": "./web.cjs.js",
+      "default": "./web.es.js"
+    }
+  },
+  "dependencies": {
+    "@guomain/monitor-types": "^0.1.0"
+  },
+  "files": [
+    "**/*"
+  ]
+}

package/shared/browser.d.ts

@@ -0,0 +1,15 @@
+export type Teardown = () => void;
+/**
+ * 注册浏览器事件并返回清理函数。
+ * @param target 事件目标，目前只处理 window。
+ * @param type 事件类型。
+ * @param listener 事件监听函数。
+ * @param options addEventListener 配置。
+ */
+export declare function on<K extends keyof WindowEventMap>(target: Window, type: K, listener: (event: WindowEventMap[K]) => void, options?: boolean | AddEventListenerOptions): Teardown;
+/**
+ * 从资源节点读取加载地址。
+ * @param target 触发 error 事件的资源节点。
+ */
+export declare function getResourceUrl(target: EventTarget | null): string | undefined;
+//# sourceMappingURL=browser.d.ts.map

package/shared/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/shared/browser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAA;AAEjC;;;;;;GAMG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAC/C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,QAAQ,CAGV;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,sBAWxD"}