@fz-firefly/vue-plugin 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @fz-firefly/vue-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Firefly 的 Vue 2 / Vue 3 错误处理与路由面包屑插件。
+
+这是 `@fz-firefly/vue` 和 `@fz-firefly/uniapp` 的内部依赖，通常不需要直接安装或使用。
+
+如果你已经自己创建了 Firefly 客户端，想手动安装 Vue 插件，可以使用：
+
+```ts
+import { fireflyVue, fireflyVue2 } from '@fz-firefly/vue-plugin'
+```
+
+普通 Vue 项目建议直接使用 `@fz-firefly/vue`，uni-app 项目使用 `@fz-firefly/uniapp`。

package/dist/index.cjs

@@ -0,0 +1,239 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// \0@oxc-project+runtime@0.155.0/helpers/esm/typeof.js
+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);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPrimitive.js
+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);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/objectSpread2.js
+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 _objectSpread2(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;
+}
+// src/router.ts
+/** 安全还原 URL 百分号编码；格式不合法时保留原值，避免 SDK 抛错。 */
+function decodePath(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch (_unused) {
+		return value;
+	}
+}
+/** 路由对象转成可读路径，拿不到时回退为空串。 */
+function pathOf(route) {
+	var _ref, _route$fullPath;
+	return decodePath((_ref = (_route$fullPath = route === null || route === void 0 ? void 0 : route.fullPath) !== null && _route$fullPath !== void 0 ? _route$fullPath : route === null || route === void 0 ? void 0 : route.path) !== null && _ref !== void 0 ? _ref : "");
+}
+/**
+* 路由参数只保留可序列化的原始值。
+*
+* query 里可能出现 null、函数或循环引用，直接上报会让信封序列化失败。
+*/
+function plainValues(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const result = {};
+	for (const [key, item] of Object.entries(value).slice(0, 20)) if (typeof item === "string" || typeof item === "number" || typeof item === "boolean") result[key] = item;
+	else if (Array.isArray(item)) {
+		const list = item.filter((entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean");
+		if (list.length > 0) result[key] = list;
+	}
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/**
+* 挂载路由相关钩子。
+*
+* - onError：路由懒加载、导航守卫里的异常；
+* - afterEach：导航面包屑，并在导航失败对象是 Error 时补报一条。
+*
+* 所有注册都做容错，SDK 不能因为路由实现差异阻断业务启动。
+*/
+function installRouterHooks(router, client) {
+	try {
+		var _router$onError;
+		(_router$onError = router.onError) === null || _router$onError === void 0 || _router$onError.call(router, (error, to, from) => {
+			try {
+				client.captureException(error, {
+					tags: { source: "router" },
+					contexts: { route: {
+						to: pathOf(to),
+						from: pathOf(from)
+					} }
+				});
+			} catch (_unused2) {}
+		});
+	} catch (_unused3) {}
+	try {
+		var _router$afterEach;
+		(_router$afterEach = router.afterEach) === null || _router$afterEach === void 0 || _router$afterEach.call(router, (to, from, failure) => {
+			try {
+				const toPath = pathOf(to) || "/";
+				const fromPath = pathOf(from) || "/";
+				const toParams = plainValues(to === null || to === void 0 ? void 0 : to.params);
+				const toQuery = plainValues(to === null || to === void 0 ? void 0 : to.query);
+				const fromParams = plainValues(from === null || from === void 0 ? void 0 : from.params);
+				const fromQuery = plainValues(from === null || from === void 0 ? void 0 : from.query);
+				if (fromPath !== toPath) {
+					var _client$startPageSess;
+					(_client$startPageSess = client.startPageSession) === null || _client$startPageSess === void 0 || _client$startPageSess.call(client, toPath, _objectSpread2(_objectSpread2({
+						navigation_type: "router",
+						from: fromPath
+					}, typeof (to === null || to === void 0 ? void 0 : to.name) === "string" ? { route_name: to.name } : {}), toQuery ? { query: toQuery } : {}));
+					client.addBreadcrumb({
+						type: "navigation",
+						category: "router",
+						level: "info",
+						timestamp: Date.now(),
+						message: `${fromPath} -> ${toPath}`,
+						data: _objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({
+							to: toPath,
+							from: fromPath
+						}, toParams ? { to_params: toParams } : {}), toQuery ? { to_query: toQuery } : {}), fromParams ? { from_params: fromParams } : {}), fromQuery ? { from_query: fromQuery } : {})
+					});
+				}
+				if (failure instanceof Error) client.captureException(failure, { tags: { source: "router" } });
+			} catch (_unused4) {}
+		});
+	} catch (_unused5) {}
+}
+// src/vue3.ts
+/** 记录 firefly 安装过的 errorHandler 对应的原始 handler，避免重复包装。 */
+const previousHandlers$1 = /* @__PURE__ */ new WeakMap();
+/**
+* Vue 3 插件。
+*
+* 用法：
+* ```ts
+* app.use(fireflyVue, { client: firefly.client, router })
+* ```
+*/
+const fireflyVue = { install(app, options) {
+	if (!(options === null || options === void 0 ? void 0 : options.client)) throw new Error("Firefly: fireflyVue 需要传入 client");
+	const { client, router } = options;
+	const current = app.config.errorHandler;
+	const previous = current && previousHandlers$1.has(current) ? previousHandlers$1.get(current) : current;
+	const errorHandler = (err, instance, info) => {
+		try {
+			client.captureException(err, { tags: {
+				source: "vue",
+				info
+			} });
+		} catch (_unused) {}
+		previous === null || previous === void 0 || previous(err, instance, info);
+	};
+	previousHandlers$1.set(errorHandler, previous);
+	app.config.errorHandler = errorHandler;
+	app.config.globalProperties.$firefly = client;
+	if (router) installRouterHooks(router, client);
+} };
+// src/vue2.ts
+/**
+* 记录 firefly 安装过的 errorHandler 对应的原始 handler。
+*
+* 重复安装时替换旧 handler，而不是把旧 firefly handler 再包一层，
+* 否则同一个组件错误会被上报多次。
+*/
+const previousHandlers = /* @__PURE__ */ new WeakMap();
+/**
+* Vue 2 插件。
+*
+* 用法：
+* ```ts
+* Vue.use(fireflyVue2, { client: firefly.client, router })
+* ```
+*/
+const fireflyVue2 = { install(Vue, options) {
+	if (!(options === null || options === void 0 ? void 0 : options.client)) throw new Error("Firefly: fireflyVue2 需要传入 client");
+	const { client, router } = options;
+	const current = Vue.config.errorHandler;
+	const previous = current && previousHandlers.has(current) ? previousHandlers.get(current) : current;
+	const errorHandler = (err, vm, info) => {
+		try {
+			client.captureException(err, { tags: {
+				source: "vue",
+				info
+			} });
+		} catch (_unused) {}
+		previous === null || previous === void 0 || previous(err, vm, info);
+	};
+	previousHandlers.set(errorHandler, previous);
+	Vue.config.errorHandler = errorHandler;
+	Vue.prototype.$firefly = client;
+	if (router) installRouterHooks(router, client);
+} };
+// src/index.ts
+/**
+* 把 Firefly 挂到 Vue 2 / Vue 3 上。
+*
+* 传 `app` 走 Vue 3，传 `Vue` 走 Vue 2；两个都不传时不做任何事，
+* 方便 uni-app 等只需要平台钩子的场景复用。
+*
+* @returns 是否安装了 Vue 插件。
+*/
+function installVue(options) {
+	if (options.app && options.Vue) throw new Error("Firefly: app 和 Vue 只能传一个");
+	if (options.app) {
+		fireflyVue.install(options.app, {
+			client: options.client,
+			router: options.router
+		});
+		return true;
+	}
+	if (options.Vue) {
+		fireflyVue2.install(options.Vue, {
+			client: options.client,
+			router: options.router
+		});
+		return true;
+	}
+	return false;
+}
+exports.fireflyVue = fireflyVue;
+exports.fireflyVue2 = fireflyVue2;
+exports.installVue = installVue;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -0,0 +1,98 @@
+import { FireflyClient, FireflyClient as FireflyClient$1 } from "@fz-firefly/core";
+/**
+ * 路由对象的最小结构。
+ *
+ * 只描述插件真正用到的字段，兼容 vue-router 2 / 3 / 4，
+ * 也避免 SDK 直接依赖某个 vue-router 版本。
+ */
+interface RouteLike {
+  /** 完整路径，例如 /orders/42?tab=detail。 */
+  fullPath?: string;
+  /** 基础路径。 */
+  path?: string;
+  /** 路由名称。 */
+  name?: unknown;
+  /** 路由参数，例如 { id: '42' }。 */
+  params?: Record<string, unknown>;
+  /** 查询参数，例如 { tab: 'detail' }。 */
+  query?: Record<string, unknown>;
+}
+/** 路由钩子所需的最小接口。 */
+interface RouterLike {
+  /** 注册路由错误钩子。vue-router 2/3/4 都有这个方法。 */
+  onError?(handler: (error: unknown, to?: RouteLike, from?: RouteLike) => void): void;
+  /** 注册导航完成钩子，用于记录面包屑。 */
+  afterEach?(hook: (to: RouteLike, from: RouteLike, failure?: unknown) => void): void;
+}
+/** Vue 插件公共参数。 */
+interface FireflyVueOptions {
+  /** 已初始化的客户端，由业务传入。 */
+  client: FireflyClient$1;
+  /** 可选路由实例，用于捕获路由错误与记录导航面包屑。 */
+  router?: RouterLike;
+}
+/**
+ * Vue 3 app 的最小结构，避免插件直接依赖 Vue 类型。
+ *
+ * errorHandler 用 unknown 接收，兼容 Vue 3 的 ComponentPublicInstance
+ * 类型参数；插件内部会按统一签名收窄。
+ */
+interface Vue3AppLike {
+  config: {
+    errorHandler?: unknown;
+    globalProperties: Record<string, unknown>;
+  };
+}
+/** Vue 2 构造函数的最小结构，避免插件直接依赖 Vue 类型。 */
+interface Vue2ConstructorLike {
+  config: {
+    errorHandler?: unknown;
+  };
+  prototype: {
+    $firefly?: FireflyClient$1;
+  };
+}
+/**
+ * Vue 3 插件。
+ *
+ * 用法：
+ * ```ts
+ * app.use(fireflyVue, { client: firefly.client, router })
+ * ```
+ */
+export declare const fireflyVue: {
+  install(app: Vue3AppLike, options?: FireflyVueOptions): void;
+};
+/**
+ * Vue 2 插件。
+ *
+ * 用法：
+ * ```ts
+ * Vue.use(fireflyVue2, { client: firefly.client, router })
+ * ```
+ */
+export declare const fireflyVue2: {
+  install(Vue: Vue2ConstructorLike, options?: FireflyVueOptions): void;
+};
+/** 安装 Vue 插件所需的参数。 */
+export interface InstallVueOptions {
+  /** 已经初始化的 Firefly 客户端。 */
+  client: FireflyClient$1;
+  /** 可选：vue-router 实例，用于捕获路由错误和记录导航面包屑。 */
+  router?: RouterLike;
+  /** Vue 3 app；与 Vue 二选一。 */
+  app?: Vue3AppLike;
+  /** Vue 2 构造函数；与 app 二选一。 */
+  Vue?: Vue2ConstructorLike;
+}
+/**
+ * 把 Firefly 挂到 Vue 2 / Vue 3 上。
+ *
+ * 传 `app` 走 Vue 3，传 `Vue` 走 Vue 2；两个都不传时不做任何事，
+ * 方便 uni-app 等只需要平台钩子的场景复用。
+ *
+ * @returns 是否安装了 Vue 插件。
+ */
+export declare function installVue(options: InstallVueOptions): boolean;
+export type { FireflyClient, FireflyVueOptions, RouteLike, RouterLike, Vue2ConstructorLike, Vue3AppLike };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+import { FireflyClient, FireflyClient as FireflyClient$1 } from "@fz-firefly/core";
+/**
+ * 路由对象的最小结构。
+ *
+ * 只描述插件真正用到的字段，兼容 vue-router 2 / 3 / 4，
+ * 也避免 SDK 直接依赖某个 vue-router 版本。
+ */
+interface RouteLike {
+  /** 完整路径，例如 /orders/42?tab=detail。 */
+  fullPath?: string;
+  /** 基础路径。 */
+  path?: string;
+  /** 路由名称。 */
+  name?: unknown;
+  /** 路由参数，例如 { id: '42' }。 */
+  params?: Record<string, unknown>;
+  /** 查询参数，例如 { tab: 'detail' }。 */
+  query?: Record<string, unknown>;
+}
+/** 路由钩子所需的最小接口。 */
+interface RouterLike {
+  /** 注册路由错误钩子。vue-router 2/3/4 都有这个方法。 */
+  onError?(handler: (error: unknown, to?: RouteLike, from?: RouteLike) => void): void;
+  /** 注册导航完成钩子，用于记录面包屑。 */
+  afterEach?(hook: (to: RouteLike, from: RouteLike, failure?: unknown) => void): void;
+}
+/** Vue 插件公共参数。 */
+interface FireflyVueOptions {
+  /** 已初始化的客户端，由业务传入。 */
+  client: FireflyClient$1;
+  /** 可选路由实例，用于捕获路由错误与记录导航面包屑。 */
+  router?: RouterLike;
+}
+/**
+ * Vue 3 app 的最小结构，避免插件直接依赖 Vue 类型。
+ *
+ * errorHandler 用 unknown 接收，兼容 Vue 3 的 ComponentPublicInstance
+ * 类型参数；插件内部会按统一签名收窄。
+ */
+interface Vue3AppLike {
+  config: {
+    errorHandler?: unknown;
+    globalProperties: Record<string, unknown>;
+  };
+}
+/** Vue 2 构造函数的最小结构，避免插件直接依赖 Vue 类型。 */
+interface Vue2ConstructorLike {
+  config: {
+    errorHandler?: unknown;
+  };
+  prototype: {
+    $firefly?: FireflyClient$1;
+  };
+}
+/**
+ * Vue 3 插件。
+ *
+ * 用法：
+ * ```ts
+ * app.use(fireflyVue, { client: firefly.client, router })
+ * ```
+ */
+export declare const fireflyVue: {
+  install(app: Vue3AppLike, options?: FireflyVueOptions): void;
+};
+/**
+ * Vue 2 插件。
+ *
+ * 用法：
+ * ```ts
+ * Vue.use(fireflyVue2, { client: firefly.client, router })
+ * ```
+ */
+export declare const fireflyVue2: {
+  install(Vue: Vue2ConstructorLike, options?: FireflyVueOptions): void;
+};
+/** 安装 Vue 插件所需的参数。 */
+export interface InstallVueOptions {
+  /** 已经初始化的 Firefly 客户端。 */
+  client: FireflyClient$1;
+  /** 可选：vue-router 实例，用于捕获路由错误和记录导航面包屑。 */
+  router?: RouterLike;
+  /** Vue 3 app；与 Vue 二选一。 */
+  app?: Vue3AppLike;
+  /** Vue 2 构造函数；与 app 二选一。 */
+  Vue?: Vue2ConstructorLike;
+}
+/**
+ * 把 Firefly 挂到 Vue 2 / Vue 3 上。
+ *
+ * 传 `app` 走 Vue 3，传 `Vue` 走 Vue 2；两个都不传时不做任何事，
+ * 方便 uni-app 等只需要平台钩子的场景复用。
+ *
+ * @returns 是否安装了 Vue 插件。
+ */
+export declare function installVue(options: InstallVueOptions): boolean;
+export type { FireflyClient, FireflyVueOptions, RouteLike, RouterLike, Vue2ConstructorLike, Vue3AppLike };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,236 @@
+// \0@oxc-project+runtime@0.155.0/helpers/esm/typeof.js
+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);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPrimitive.js
+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);
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+// \0@oxc-project+runtime@0.155.0/helpers/esm/objectSpread2.js
+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 _objectSpread2(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;
+}
+// src/router.ts
+/** 安全还原 URL 百分号编码；格式不合法时保留原值，避免 SDK 抛错。 */
+function decodePath(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch (_unused) {
+		return value;
+	}
+}
+/** 路由对象转成可读路径，拿不到时回退为空串。 */
+function pathOf(route) {
+	var _ref, _route$fullPath;
+	return decodePath((_ref = (_route$fullPath = route === null || route === void 0 ? void 0 : route.fullPath) !== null && _route$fullPath !== void 0 ? _route$fullPath : route === null || route === void 0 ? void 0 : route.path) !== null && _ref !== void 0 ? _ref : "");
+}
+/**
+* 路由参数只保留可序列化的原始值。
+*
+* query 里可能出现 null、函数或循环引用，直接上报会让信封序列化失败。
+*/
+function plainValues(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const result = {};
+	for (const [key, item] of Object.entries(value).slice(0, 20)) if (typeof item === "string" || typeof item === "number" || typeof item === "boolean") result[key] = item;
+	else if (Array.isArray(item)) {
+		const list = item.filter((entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean");
+		if (list.length > 0) result[key] = list;
+	}
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/**
+* 挂载路由相关钩子。
+*
+* - onError：路由懒加载、导航守卫里的异常；
+* - afterEach：导航面包屑，并在导航失败对象是 Error 时补报一条。
+*
+* 所有注册都做容错，SDK 不能因为路由实现差异阻断业务启动。
+*/
+function installRouterHooks(router, client) {
+	try {
+		var _router$onError;
+		(_router$onError = router.onError) === null || _router$onError === void 0 || _router$onError.call(router, (error, to, from) => {
+			try {
+				client.captureException(error, {
+					tags: { source: "router" },
+					contexts: { route: {
+						to: pathOf(to),
+						from: pathOf(from)
+					} }
+				});
+			} catch (_unused2) {}
+		});
+	} catch (_unused3) {}
+	try {
+		var _router$afterEach;
+		(_router$afterEach = router.afterEach) === null || _router$afterEach === void 0 || _router$afterEach.call(router, (to, from, failure) => {
+			try {
+				const toPath = pathOf(to) || "/";
+				const fromPath = pathOf(from) || "/";
+				const toParams = plainValues(to === null || to === void 0 ? void 0 : to.params);
+				const toQuery = plainValues(to === null || to === void 0 ? void 0 : to.query);
+				const fromParams = plainValues(from === null || from === void 0 ? void 0 : from.params);
+				const fromQuery = plainValues(from === null || from === void 0 ? void 0 : from.query);
+				if (fromPath !== toPath) {
+					var _client$startPageSess;
+					(_client$startPageSess = client.startPageSession) === null || _client$startPageSess === void 0 || _client$startPageSess.call(client, toPath, _objectSpread2(_objectSpread2({
+						navigation_type: "router",
+						from: fromPath
+					}, typeof (to === null || to === void 0 ? void 0 : to.name) === "string" ? { route_name: to.name } : {}), toQuery ? { query: toQuery } : {}));
+					client.addBreadcrumb({
+						type: "navigation",
+						category: "router",
+						level: "info",
+						timestamp: Date.now(),
+						message: `${fromPath} -> ${toPath}`,
+						data: _objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({
+							to: toPath,
+							from: fromPath
+						}, toParams ? { to_params: toParams } : {}), toQuery ? { to_query: toQuery } : {}), fromParams ? { from_params: fromParams } : {}), fromQuery ? { from_query: fromQuery } : {})
+					});
+				}
+				if (failure instanceof Error) client.captureException(failure, { tags: { source: "router" } });
+			} catch (_unused4) {}
+		});
+	} catch (_unused5) {}
+}
+// src/vue3.ts
+/** 记录 firefly 安装过的 errorHandler 对应的原始 handler，避免重复包装。 */
+const previousHandlers$1 = /* @__PURE__ */ new WeakMap();
+/**
+* Vue 3 插件。
+*
+* 用法：
+* ```ts
+* app.use(fireflyVue, { client: firefly.client, router })
+* ```
+*/
+const fireflyVue = { install(app, options) {
+	if (!(options === null || options === void 0 ? void 0 : options.client)) throw new Error("Firefly: fireflyVue 需要传入 client");
+	const { client, router } = options;
+	const current = app.config.errorHandler;
+	const previous = current && previousHandlers$1.has(current) ? previousHandlers$1.get(current) : current;
+	const errorHandler = (err, instance, info) => {
+		try {
+			client.captureException(err, { tags: {
+				source: "vue",
+				info
+			} });
+		} catch (_unused) {}
+		previous === null || previous === void 0 || previous(err, instance, info);
+	};
+	previousHandlers$1.set(errorHandler, previous);
+	app.config.errorHandler = errorHandler;
+	app.config.globalProperties.$firefly = client;
+	if (router) installRouterHooks(router, client);
+} };
+// src/vue2.ts
+/**
+* 记录 firefly 安装过的 errorHandler 对应的原始 handler。
+*
+* 重复安装时替换旧 handler，而不是把旧 firefly handler 再包一层，
+* 否则同一个组件错误会被上报多次。
+*/
+const previousHandlers = /* @__PURE__ */ new WeakMap();
+/**
+* Vue 2 插件。
+*
+* 用法：
+* ```ts
+* Vue.use(fireflyVue2, { client: firefly.client, router })
+* ```
+*/
+const fireflyVue2 = { install(Vue, options) {
+	if (!(options === null || options === void 0 ? void 0 : options.client)) throw new Error("Firefly: fireflyVue2 需要传入 client");
+	const { client, router } = options;
+	const current = Vue.config.errorHandler;
+	const previous = current && previousHandlers.has(current) ? previousHandlers.get(current) : current;
+	const errorHandler = (err, vm, info) => {
+		try {
+			client.captureException(err, { tags: {
+				source: "vue",
+				info
+			} });
+		} catch (_unused) {}
+		previous === null || previous === void 0 || previous(err, vm, info);
+	};
+	previousHandlers.set(errorHandler, previous);
+	Vue.config.errorHandler = errorHandler;
+	Vue.prototype.$firefly = client;
+	if (router) installRouterHooks(router, client);
+} };
+// src/index.ts
+/**
+* 把 Firefly 挂到 Vue 2 / Vue 3 上。
+*
+* 传 `app` 走 Vue 3，传 `Vue` 走 Vue 2；两个都不传时不做任何事，
+* 方便 uni-app 等只需要平台钩子的场景复用。
+*
+* @returns 是否安装了 Vue 插件。
+*/
+function installVue(options) {
+	if (options.app && options.Vue) throw new Error("Firefly: app 和 Vue 只能传一个");
+	if (options.app) {
+		fireflyVue.install(options.app, {
+			client: options.client,
+			router: options.router
+		});
+		return true;
+	}
+	if (options.Vue) {
+		fireflyVue2.install(options.Vue, {
+			client: options.client,
+			router: options.router
+		});
+		return true;
+	}
+	return false;
+}
+export { fireflyVue, fireflyVue2, installVue };
+
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@fz-firefly/vue-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "萤火虫 SDK 的 Vue 2 / Vue 3 错误处理与路由面包屑插件（内部包）。",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fz-firefly/core": "0.2.0"
+  },
+  "devDependencies": {
+    "tsdown": "0.23.2",
+    "typescript": "^5.6.0",
+    "vitest": "^5.0.5",
+    "vue": "^3.5.0"
+  },
+  "peerDependencies": {
+    "vue": "^2.0.0 || ^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }