@arms/rum-browser-nuxt 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -7,7 +7,7 @@
 ### 视图追踪（文件路由命名）
 
 - `initNuxtPlugin(shell, { router, nuxtApp? })`：单入口初始化 API；注册 `nuxt` collector（`ICollector`）并无条件注入 `trackViewsManually`（router 必填）—— view 的创建、命名与计时完全由路由变化驱动（内部调用 `shell.startView`）
-- **Nuxt 文件路由名归一化**（本包核心差异化能力）：view.name 按 `to.matched` 尾向头取第一个非空 `path`，再反向归一化为 Nuxt 文件路由风格（`:id()` → `[id]`、`:id?` → `[[id]]`、`:slug(.*)*` → `[...slug]`、转义还原），与 `pages/` 目录心智一致（算法与正则从 Datadog browser-rum-nuxt 源码原样移植，14+ 参数化单测对齐）
+- **Nuxt 文件路由名归一化**（本包核心差异化能力）：view.name 按 `to.matched` 尾向头取第一个非空 `path`，再反向归一化为 Nuxt 文件路由风格（`:id()` → `[id]`、`:id?` → `[[id]]`、`:slug(.*)*` → `[...slug]`、转义还原），与 `pages/` 目录心智一致（14+ 参数化单测覆盖）
 - 初始视图补偿：`router.currentRoute.matched` 非空（插件晚于首个导航接入）时立即补报首屏 view；router 未就绪时由 afterEach 覆盖首个导航
 - 导航语义：query-only 变化不开新视图、hash 变化不开新视图（afterEach 放行但视图名不变，经 `Shell.startView` 同名去重，净效果与 browser-vue 一致）、导航失败（afterEach 第三参 `failure`）不开新视图、同名 view 去重由 `Shell.startView` 内建
 - `loading_type` 语义对齐 browser-vue：ctx 已有 view 时 `route_change`，否则 `initial_load`

package/README.md

@@ -171,7 +171,7 @@ onErrorCaptured(function (err, instance, info) {
 | `vue`               | `^3.5.0`             | optional peer；本包经 `nuxtApp.vueApp.config.errorHandler` duck typing 访问，不直接依赖 vue 模块 |
 | `vue-router`        | `^4.0.0 \|\| ^5.0.0` | optional peer；仅依赖 `afterEach` / `currentRoute` 最小接口                                      |
 
-> **版本口径说明**：peerDependencies 中 `nuxt` 声明为 `3 || 4`（对齐 Datadog 实践），实际支持基线为 Nuxt ≥3.7 —— 更早版本的 `defineNuxtPlugin` 对象语法与 `enforce` 不稳定。`vue` peer 为 `^3.5.0`，而 Nuxt 3.7-3.12 生态常配 vue 3.3 / 3.4 —— 三项框架 peer 均 optional（`peerDependenciesMeta` 标记），版本不满足仅产生安装告警、不阻塞安装（插件对框架实例 duck typing，实际兼容宽于声明口径）。
+> **版本口径说明**：peerDependencies 中 `nuxt` 声明为 `3 || 4`，实际支持基线为 Nuxt ≥3.7 —— 更早版本的 `defineNuxtPlugin` 对象语法与 `enforce` 不稳定。`vue` peer 为 `^3.5.0`，而 Nuxt 3.7-3.12 生态常配 vue 3.3 / 3.4 —— 三项框架 peer 均 optional（`peerDependenciesMeta` 标记），版本不满足仅产生安装告警、不阻塞安装（插件对框架实例 duck typing，实际兼容宽于声明口径）。
 
 ### Nuxt 2 用户
 

package/es/domain/error/addNuxtError.d.ts

@@ -34,7 +34,7 @@ export interface NuxtErrorContext {
  * 时序行为：
  * - 插件未接入（initNuxtPlugin 未调用）：logger.warn + skip（对齐家族）
  * - 插件已接入但 init 未完成（sendEvent 未就绪）：排队待
- *   collector.setup 时 flush 补发（对齐 Datadog onRumStart 订阅机制）
+ *   collector.setup 时 flush 补发
  *
  * 事件基础字段（session / view / user 等）由 core reporter 事件处理链路补齐。
  *

package/es/domain/router/computeNuxtViewName.d.ts

@@ -3,7 +3,7 @@ import type { AnyRouteRecord } from '../../types';
  * 根据 vue-router 的 matched 数组计算 Nuxt 文件路由风格的 view 名称。
  *
  * 两步：
- * 1. matched **尾向头**取第一个非空 path（对齐 Datadog：嵌套路由的
+ * 1. matched **尾向头**取第一个非空 path（嵌套路由的
  *    matched 链即文件路径层级，最深非空段即页面本身的模板；区别于
  *    browser-vue computeViewName 的「逐段拼接 + catch-all 展开」策略
  *    —— 本包以 Nuxt 文件心智为准，模板原样归一化）

package/es/domain/state.d.ts

@@ -9,8 +9,7 @@ import type { NuxtErrorContext } from './error/addNuxtError';
  * - cachedCtx / cachedSendEvent：nuxtCollector.setup 时缓存，
  *   供 addNuxtError 与路由 startView 使用
  * - pendingErrors：init 完成前（sendEvent 未就绪）的 addNuxtError 排队
- *   （对齐 Datadog nuxtPlugin.ts 的 onRumStart 订阅延迟机制，按 ARMS
- *   家族形态实现为「shell 已缓存但 collector 未 setup」短窗口内的排队，
+ *   （「shell 已缓存但 collector 未 setup」短窗口内的排队，
  *   setup 时统一 flush），仅保留最近 MAX_PENDING_ERRORS 条
  */
 interface PendingNuxtError {

package/es/types/index.d.ts

@@ -30,8 +30,7 @@ export interface NuxtVueAppLike {
     [key: string]: any;
 }
 /**
- * NuxtApp 的最小结构（duck typing，对齐 Datadog browser-rum-nuxt
- * setupNuxtErrorHandling.ts 的 NuxtApp 接口）。
+ * NuxtApp 的最小结构（duck typing）。
  *
  * 仅声明错误双通道实际用到的两个成员：
  * - vueApp：通道 1 链式包装 vueApp.config.errorHandler

package/lib/domain/error/addNuxtError.d.ts

@@ -34,7 +34,7 @@ export interface NuxtErrorContext {
  * 时序行为：
  * - 插件未接入（initNuxtPlugin 未调用）：logger.warn + skip（对齐家族）
  * - 插件已接入但 init 未完成（sendEvent 未就绪）：排队待
- *   collector.setup 时 flush 补发（对齐 Datadog onRumStart 订阅机制）
+ *   collector.setup 时 flush 补发
  *
  * 事件基础字段（session / view / user 等）由 core reporter 事件处理链路补齐。
  *

package/lib/domain/router/computeNuxtViewName.d.ts

@@ -3,7 +3,7 @@ import type { AnyRouteRecord } from '../../types';
  * 根据 vue-router 的 matched 数组计算 Nuxt 文件路由风格的 view 名称。
  *
  * 两步：
- * 1. matched **尾向头**取第一个非空 path（对齐 Datadog：嵌套路由的
+ * 1. matched **尾向头**取第一个非空 path（嵌套路由的
  *    matched 链即文件路径层级，最深非空段即页面本身的模板；区别于
  *    browser-vue computeViewName 的「逐段拼接 + catch-all 展开」策略
  *    —— 本包以 Nuxt 文件心智为准，模板原样归一化）

package/lib/domain/state.d.ts

@@ -9,8 +9,7 @@ import type { NuxtErrorContext } from './error/addNuxtError';
  * - cachedCtx / cachedSendEvent：nuxtCollector.setup 时缓存，
  *   供 addNuxtError 与路由 startView 使用
  * - pendingErrors：init 完成前（sendEvent 未就绪）的 addNuxtError 排队
- *   （对齐 Datadog nuxtPlugin.ts 的 onRumStart 订阅延迟机制，按 ARMS
- *   家族形态实现为「shell 已缓存但 collector 未 setup」短窗口内的排队，
+ *   （「shell 已缓存但 collector 未 setup」短窗口内的排队，
  *   setup 时统一 flush），仅保留最近 MAX_PENDING_ERRORS 条
  */
 interface PendingNuxtError {

package/lib/types/index.d.ts

@@ -30,8 +30,7 @@ export interface NuxtVueAppLike {
     [key: string]: any;
 }
 /**
- * NuxtApp 的最小结构（duck typing，对齐 Datadog browser-rum-nuxt
- * setupNuxtErrorHandling.ts 的 NuxtApp 接口）。
+ * NuxtApp 的最小结构（duck typing）。
  *
  * 仅声明错误双通道实际用到的两个成员：
  * - vueApp：通道 1 链式包装 vueApp.config.errorHandler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-browser-nuxt",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Nuxt plugin for @arms/rum-browser SDK (Nuxt 3/4 file-route view tracking + dual-channel error capture, zero nuxt/vue/vue-router imports)",
   "author": "guangli.fj <guangli.fj@alibaba-inc.com>",
   "license": "ISC",