@0xchain/telemetry 1.0.0 → 1.1.0-beta.10

package/README.md

@@ -1,11 +1,147 @@
 # telemetry
 
-This library was generated with [Nx](https://nx.dev).
+面向 Next.js 16 App Router 的链路追踪方案，提供巡检识别、请求过滤与多维采样能力，基于 OpenTelemetry 输出。
 
-## Building
+## 快速开始
 
-Run `nx build telemetry` to build the library.
+### 1. 安装依赖
 
-## Running unit tests
+```bash
+pnpm add @0xchain/telemetry
+```
 
-Run `nx test telemetry` to execute the unit tests via [Vitest](https://vitest.dev/).
+**Monorepo 内使用**：在应用包的 `package.json` 中添加 `"@0xchain/telemetry": "workspace:*"`，然后执行 `pnpm install`。使用前需先构建 telemetry 包：`pnpm nx run telemetry:build` 或 `cd packages/telemetry && pnpm exec vite build`。
+
+### 2. 初始化追踪 (instrumentation.ts)
+
+在项目根目录（或 `src` 目录）创建 `instrumentation.ts`，只需一行代码即可启用：
+
+> 注意：请从 `@0xchain/telemetry/instrumentation` 导入。此入口包含完整 Node SDK，仅在 `instrumentation.ts` 中加载，不影响 Edge 的 middleware bundle。
+
+```ts
+import { registerTelemetry } from "@0xchain/telemetry/instrumentation";
+
+export async function register() {
+  // 自动从环境变量加载配置
+  await registerTelemetry();
+}
+```
+
+或者自定义配置：
+
+```ts
+import { registerTelemetry } from "@0xchain/telemetry/instrumentation";
+
+export async function register() {
+  await registerTelemetry({
+    serviceName: "my-web-app",
+    environment: "production",
+    // 更多配置...
+  });
+}
+```
+
+### 3. 注入中间件 (middleware.ts)
+
+在 `middleware.ts` 中使用 `withTelemetryMiddleware` 包裹现有中间件，实现低侵入式集成：
+
+> 注意：请从 `@0xchain/telemetry/middleware` 或 `@0xchain/telemetry/next` 导入。此入口轻量，无 Node SDK 依赖，适用于 Edge Runtime。
+
+```ts
+import { NextResponse } from "next/server";
+import { withTelemetryMiddleware } from "@0xchain/telemetry/middleware";
+
+// 你的现有中间件逻辑
+const userMiddleware = async (req) => {
+  // ... 业务逻辑
+  return NextResponse.next();
+};
+
+// 使用 withTelemetryMiddleware 包裹
+export const middleware = withTelemetryMiddleware(userMiddleware);
+
+export const config = {
+  matcher: [
+    /* 你的 matcher 配置 */
+    '/((?!_next/static|_next/image|favicon.ico).*)',
+  ],
+};
+```
+
+如果你没有其他中间件，可以使用工厂方法：
+
+```ts
+import { createTelemetryMiddleware } from "@0xchain/telemetry/middleware";
+
+export const middleware = createTelemetryMiddleware();
+
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+};
+```
+
+## 环境变量配置
+
+支持通过环境变量实现零代码配置：
+
+| 变量名 | 描述 | 默认值 |
+|---|---|---|
+| `OTEL_SERVICE_NAME` | 服务名称 | `unknown-service` |
+| `OTEL_SERVICE_VERSION` | 服务版本 | `1.0.0` |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP 上报地址 | - |
+| `OTEL_EXPORTER_OTLP_HEADERS` | OTLP Headers (k=v,k2=v2) | - |
+| `TELEMETRY_ENVIRONMENT` | 环境名称 (dev/prod) | `development`，在 Vercel 上自动使用 `VERCEL_ENV` |
+| `TELEMETRY_SAMPLING_RATIO` | 默认采样率 (0.0-1.0) | `0.01` |
+| `TELEMETRY_IGNORE_PATHS` | 忽略路径 (逗号分隔) | 默认忽略静态资源 |
+| `TELEMETRY_INSPECTION_HEADER` | 巡检请求头 | `x-inspection` |
+| `TELEMETRY_CONFIG_FILE` | 配置文件路径，支持 JSON，异步读取不阻塞启动 | - |
+
+## Vercel 集成
+
+部署到 Vercel 时，将自动检测并注入以下 resource 属性：
+
+- `vercel.region`、`vercel.runtime`、`vercel.sha`、`vercel.host`、`vercel.deployment_id`
+- `environment` 优先使用 `VERCEL_ENV`（production / preview / development）
+
+## 核心特性
+
+1. **巡检识别**：自动识别 `x-inspection` 请求头，强制采样并全量记录。
+2. **智能过滤**：内置静态资源过滤规则，支持自定义路径、扩展名和方法过滤。
+3. **多维采样**：支持按路径、用户类型、状态码配置不同的采样率。
+4. **低侵入性**：通过 HOC 方式集成中间件，不破坏原有逻辑。
+5. **入口拆分**：`instrumentation` 含完整 Node SDK；`middleware` / `next` 轻量，仅注入请求头，适合 Edge。
+6. **按需加载**：仅启用 HTTP + Undici 检测，减少冷启动与内存占用。
+
+## 常见问题
+
+### Module not found: Can't resolve '@0xchain/telemetry/instrumentation'
+
+1. **确认依赖**：确保应用 `package.json` 中有 `@0xchain/telemetry` 依赖。
+2. **确认构建**：telemetry 包需先构建，`dist/` 目录需存在。在 monorepo 根目录执行 `pnpm nx run telemetry:build`。
+3. **Next.js 配置**：若仍有问题，可在 `next.config.js` 中添加 `transpilePackages: ['@0xchain/telemetry']`。
+
+## 高级配置
+
+### 采样规则配置 (Sampling Rules)
+
+可以通过 `samplingRules` 字段或 `TELEMETRY_SAMPLING_RULES` 环境变量（JSON 字符串）配置：
+
+```json
+[
+  {
+    "name": "critical-api",
+    "ratio": 1.0,
+    "when": { "path": ["/api/checkout", "/api/payment"] }
+  },
+  {
+    "name": "errors",
+    "ratio": 1.0,
+    "when": { "minStatusCode": 500 }
+  },
+  {
+    "name": "guest-users",
+    "ratio": 0.05,
+    "when": { "userType": ["guest"] }
+  }
+]
+```

package/dist/Instrumentations.d.ts

@@ -1,2 +1,6 @@
-export default function getInstrumentations(ignoredPaths: string[]): any;
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { UndiciInstrumentation } from '@opentelemetry/instrumentation-undici';
+import { TelemetryConfig } from './types';
+/** 按需加载 HTTP + Undici 检测，避免全量 auto-instrumentations 的启动开销 */
+export default function getInstrumentations(config: TelemetryConfig): (HttpInstrumentation | UndiciInstrumentation)[];
 //# sourceMappingURL=Instrumentations.d.ts.map

package/dist/Instrumentations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Instrumentations.d.ts","sourceRoot":"","sources":["../src/Instrumentations.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAG,CAiCvE"}
+{"version":3,"file":"Instrumentations.d.ts","sourceRoot":"","sources":["../src/Instrumentations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA4B/C,6DAA6D;AAC7D,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,MAAM,EAAE,eAAe,mDAoElE"}

package/dist/Sampler.d.ts

@@ -1,11 +1,22 @@
-import { Sampler, SamplingResult } from '@opentelemetry/sdk-trace-base';
-import { SpanKind, Attributes, Link, Context } from '@opentelemetry/api';
-declare class InspectionSampler implements Sampler {
-    private defaultSampler;
-    private inspectionSampler;
-    constructor(ratio: number);
-    shouldSample(context: Context, traceId: string, spanName: string, spanKind: SpanKind, attributes: Attributes, links: Link[]): SamplingResult;
-    toString(): string;
+import { Sampler, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { Attributes } from '@opentelemetry/api';
+import { SamplingRule, TelemetryRuntime } from './types';
+export interface SamplingContext {
+    path?: string;
+    method?: string;
+    userType?: string;
+    statusCode?: number;
+    inspection?: boolean;
 }
-export default InspectionSampler;
+/** 基于 span attributes 构建采样上下文 */
+export declare const buildSamplingContextFromAttributes: (attributes: Attributes) => SamplingContext;
+/** 判断采样规则是否命中 */
+export declare const matchSamplingRule: (rule: SamplingRule, context: SamplingContext) => boolean;
+/** 根据规则解析采样比例 */
+export declare const resolveSamplingRatio: (rules: SamplingRule[] | undefined, context: SamplingContext, defaultRatio: number) => number;
+/** 创建基于规则的采样器 */
+export declare const createRuleBasedSampler: (runtime: TelemetryRuntime) => Sampler;
+/** 导出器直接透传，采样决策由 createRuleBasedSampler 在 span 创建时统一完成，避免 export 阶段重复计算 */
+export declare const createFilteringTraceExporter: (exporter: SpanExporter) => SpanExporter;
+export default createRuleBasedSampler;
 //# sourceMappingURL=Sampler.d.ts.map

package/dist/Sampler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sampler.d.ts","sourceRoot":"","sources":["../src/Sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAA+D,MAAM,+BAA+B,CAAC;AACrI,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAqB,MAAM,oBAAoB,CAAC;AAG5F,cAAM,iBAAkB,YAAW,OAAO;IACtC,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,iBAAiB,CAAU;gBAEvB,KAAK,EAAE,MAAM;IAKzB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,cAAc;IAuB5I,QAAQ;CAGT;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"Sampler.d.ts","sourceRoot":"","sources":["../src/Sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIP,YAAY,EACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAY,UAAU,EAAoC,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAoCD,iCAAiC;AACjC,eAAO,MAAM,kCAAkC,GAAI,YAAY,UAAU,KAAG,eA4B3E,CAAC;AAcF,iBAAiB;AACjB,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,EAAE,SAAS,eAAe,YAiC7E,CAAC;AAKF,iBAAiB;AACjB,eAAO,MAAM,oBAAoB,GAC/B,OAAO,YAAY,EAAE,GAAG,SAAS,EACjC,SAAS,eAAe,EACxB,cAAc,MAAM,WASrB,CAAC;AAoBF,iBAAiB;AACjB,eAAO,MAAM,sBAAsB,GAAI,SAAS,gBAAgB,KAAG,OAyBlE,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,GAAI,UAAU,YAAY,KAAG,YAAwB,CAAC;AAE/F,eAAe,sBAAsB,CAAC"}

package/dist/ignore-B1KXtl12.js

@@ -0,0 +1,80 @@
+const d = [
+  "/health",
+  "/api/health",
+  "/metrics",
+  "/readyz",
+  "/livez",
+  "/favicon.ico",
+  "/robots.txt",
+  "/sitemap.xml",
+  "/_next",
+  "/__nextjs_",
+  "/.well-known"
+], m = [
+  ".css",
+  ".js",
+  ".mjs",
+  ".cjs",
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".svg",
+  ".ico",
+  ".webp",
+  ".avif",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".map",
+  ".txt",
+  ".xml"
+], i = {
+  paths: d,
+  extensions: m,
+  methods: ["HEAD", "OPTIONS"]
+}, f = (e) => e.map((s) => {
+  const t = s.trim().toLowerCase();
+  return t && (t.startsWith(".") ? t : `.${t}`);
+}), w = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), C = (e, s) => {
+  if (e instanceof RegExp)
+    return e.test(s);
+  const t = e.trim();
+  if (!t) return !1;
+  if (t.includes("*")) {
+    const a = `^${w(t).replace(/\\\*\\\*/g, ".*").replace(/\\\*/g, "[^/]*")}$`;
+    return new RegExp(a).test(s);
+  }
+  return s === t ? !0 : t.endsWith("/") ? s.startsWith(t) : s.startsWith(`${t}/`) || s.startsWith(t);
+}, E = (e, s) => {
+  const t = s.toLowerCase();
+  return e.some((o) => o && t.endsWith(o));
+}, j = (e) => {
+  var a;
+  if (!e) return "default";
+  if ((a = e.paths) == null ? void 0 : a.some((n) => n instanceof RegExp)) return null;
+  const t = (e.paths ?? []).map(String).sort().join(","), o = (e.extensions ?? []).map((n) => n.toLowerCase()).sort().join(","), h = (e.methods ?? []).map((n) => n.toUpperCase()).sort().join(",");
+  return `p:${t}|e:${o}|m:${h}`;
+}, c = /* @__PURE__ */ new Map(), $ = 16, I = (e) => {
+  var n, l, p;
+  const s = j(e);
+  if (s) {
+    const r = c.get(s);
+    if (r) return r;
+  }
+  const t = (n = e == null ? void 0 : e.paths) != null && n.length ? e.paths : i.paths, o = (l = e == null ? void 0 : e.extensions) != null && l.length ? f(e.extensions) : i.extensions, h = (p = e == null ? void 0 : e.methods) != null && p.length ? e.methods.map((r) => r.toUpperCase()) : i.methods, a = (r, u) => u && h.includes(u.toUpperCase()) ? !0 : r ? E(o, r) ? !0 : t.some((x) => C(x, r)) : !1;
+  if (s) {
+    if (c.size >= $) {
+      const r = c.keys().next().value;
+      r && c.delete(r);
+    }
+    c.set(s, a);
+  }
+  return a;
+};
+export {
+  I as c,
+  i as d,
+  C as m
+};

package/dist/ignore.d.ts

@@ -0,0 +1,7 @@
+import { IgnoreConfig, PathPattern } from './types';
+export declare const defaultIgnoreConfig: Required<IgnoreConfig>;
+/** 判断路径是否匹配规则 */
+export declare const matchesPathPattern: (pattern: PathPattern, pathname: string) => boolean;
+/** 创建忽略规则匹配器（相同配置复用，减少重复创建） */
+export declare const createIgnoreMatcher: (config?: IgnoreConfig) => (pathname: string, method?: string) => boolean;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../src/ignore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAsCzD,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,YAAY,CAItD,CAAC;AAcF,iBAAiB;AACjB,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,EAAE,UAAU,MAAM,YAmBxE,CAAC;AAsBF,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,GAAI,SAAS,YAAY,gBAJT,MAAM,WAAW,MAAM,KAAK,OAsC3E,CAAC"}

package/dist/index

@@ -0,0 +1,355 @@
+import { NodeSDK as b } from "@opentelemetry/sdk-node";
+import { OTLPTraceExporter as v } from "@opentelemetry/exporter-trace-otlp-http";
+import { resourceFromAttributes as Y } from "@opentelemetry/resources";
+import { ATTR_SERVICE_VERSION as F, ATTR_SERVICE_NAME as q } from "@opentelemetry/semantic-conventions";
+import { SamplingDecision as d, TraceIdRatioBasedSampler as N, AlwaysOnSampler as U, BatchSpanProcessor as z } from "@opentelemetry/sdk-trace-base";
+import { trace as B, TraceFlags as M, propagation as I, context as V, SpanStatusCode as G } from "@opentelemetry/api";
+import { readFile as k } from "node:fs/promises";
+import { HttpInstrumentation as j } from "@opentelemetry/instrumentation-http";
+import { UndiciInstrumentation as Q } from "@opentelemetry/instrumentation-undici";
+import { c as X, m as W, d as J } from "./ignore-B1KXtl12.js";
+const K = "deployment.environment.name", f = (t, e) => {
+  if (!t) return;
+  const r = t[e.toLowerCase()];
+  if (Array.isArray(r)) {
+    const n = r[0];
+    return typeof n == "string" ? n : void 0;
+  }
+  return typeof r == "string" ? r : void 0;
+}, T = (t) => {
+  if (!t) return "";
+  try {
+    return t.startsWith("http://") || t.startsWith("https://") ? new URL(t).pathname : new URL(t, "http://localhost").pathname;
+  } catch {
+    return t.split("?")[0] || t;
+  }
+}, w = /* @__PURE__ */ new WeakMap();
+function $(t) {
+  const e = X(t.ignore), r = (t.inspectionHeader ?? "x-inspection").toLowerCase(), n = (t.userTypeHeader ?? "x-telemetry-user-type").toLowerCase(), o = (t.requestStartHeader ?? "x-telemetry-start").toLowerCase();
+  return [
+    new j({
+      startIncomingSpanHook: (s) => {
+        const i = "headers" in s ? s.headers : void 0, a = f(i, r), c = f(i, n), u = f(i, o), l = "method" in s ? s.method : void 0, C = T("url" in s ? s.url : void 0), L = Number(u || Date.now()), m = {
+          "telemetry.request.start_time_ms": Number.isFinite(L) ? L : Date.now()
+        };
+        return C && (m["url.path"] = C), l && (m["http.request.method"] = l), a && (m["telemetry.request.inspection"] = !0, m["http.request.header.x-inspection"] = a), c && (m["enduser.type"] = c, m["telemetry.request.user_type"] = c), m;
+      },
+      requestHook: (s, i) => {
+        const a = "headers" in i ? i.headers : void 0, c = f(a, o), u = Number(c || Date.now());
+        w.set(s, Number.isFinite(u) ? u : Date.now());
+      },
+      responseHook: (s, i) => {
+        const a = "statusCode" in i ? i.statusCode : void 0;
+        typeof a == "number" && (s.setAttribute("http.response.status_code", a), s.setAttribute("telemetry.response.status_code", a), a >= 500 && s.setAttribute("telemetry.request.error", !0));
+        const c = w.get(s);
+        typeof c == "number" && s.setAttribute("telemetry.request.duration_ms", Date.now() - c);
+      },
+      ignoreIncomingRequestHook: (s) => {
+        const i = "url" in s ? s.url : void 0, a = T(i), c = "method" in s ? s.method : void 0;
+        return e(a, c);
+      },
+      ignoreOutgoingRequestHook: (s) => {
+        const i = typeof s == "string" ? s : s.path || "";
+        return e(T(i));
+      }
+    }),
+    new Q()
+  ];
+}
+const R = (t) => {
+  if (typeof t == "string") return t;
+  if (Array.isArray(t)) {
+    const e = t[0];
+    return typeof e == "string" ? e : void 0;
+  }
+}, x = (t) => {
+  if (typeof t == "number") return t;
+  if (typeof t == "string") {
+    const e = Number(t);
+    return Number.isFinite(e) ? e : void 0;
+  }
+  if (Array.isArray(t)) {
+    const e = t[0];
+    return x(e);
+  }
+}, E = (t, e) => {
+  for (const r of e)
+    if (r in t)
+      return t[r];
+}, Z = (t) => {
+  const e = E(t, ["url.path", "http.target", "http.route"]), r = E(t, ["http.request.method", "http.method"]), n = E(t, ["enduser.type", "telemetry.request.user_type"]), o = E(t, [
+    "http.response.status_code",
+    "http.status_code",
+    "telemetry.response.status_code"
+  ]), s = E(t, [
+    "telemetry.request.inspection",
+    "http.request.header.x-inspection",
+    "x-inspection"
+  ]), i = s === !0 || s === "true" || s === "1" || s === 1;
+  return {
+    path: R(e),
+    method: R(r),
+    userType: R(n),
+    statusCode: x(o),
+    inspection: i
+  };
+}, O = (t, e) => !t || !(e != null && e.length) ? !1 : e.some((r) => r.toLowerCase() === t.toLowerCase()), tt = (t, e) => !t || !(e != null && e.length) ? !1 : e.some((r) => W(r, t)), et = (t, e) => {
+  const r = t.when;
+  if (!r) return !0;
+  if (r.inspection !== void 0 && r.inspection !== e.inspection || r.path && !tt(e.path, r.path) || r.method && !O(e.method, r.method) || r.userType && !O(e.userType, r.userType))
+    return !1;
+  if (r.statusCode && typeof e.statusCode == "number") {
+    if (!r.statusCode.includes(e.statusCode))
+      return !1;
+  } else if (r.statusCode && r.statusCode.length)
+    return !1;
+  return !(typeof r.minStatusCode == "number" && (typeof e.statusCode != "number" || e.statusCode < r.minStatusCode) || typeof r.maxStatusCode == "number" && (typeof e.statusCode != "number" || e.statusCode > r.maxStatusCode));
+}, _ = (t) => Math.max(0, Math.min(1, t)), rt = (t, e, r) => {
+  if (!(t != null && t.length)) return _(r);
+  for (const n of t)
+    if (et(n, e))
+      return _(n.ratio);
+  return _(r);
+}, A = /* @__PURE__ */ new Map(), nt = (t) => {
+  if (t <= 0)
+    return new N(0);
+  if (t >= 1)
+    return new U();
+  const e = Number(t.toFixed(6)), r = A.get(e);
+  if (r) return r;
+  const n = new N(e);
+  return A.set(e, n), n;
+}, st = (t) => ({
+  shouldSample(e, r, n, o, s, i) {
+    const a = B.getSpanContext(e);
+    if (a)
+      return (a.traceFlags & M.SAMPLED) === M.SAMPLED ? { decision: d.RECORD_AND_SAMPLED } : { decision: d.NOT_RECORD };
+    const c = t.getConfig(), u = Z(s);
+    if (u.inspection)
+      return { decision: d.RECORD_AND_SAMPLED };
+    const l = rt(
+      c.samplingRules,
+      u,
+      c.defaultSamplingRatio ?? 0.01
+    );
+    return nt(l).shouldSample(e, r, n, o, s, i);
+  },
+  toString: () => "RuleBasedSampler"
+}), ot = (t) => t;
+let h, p;
+const g = (t) => Array.from(new Set(t)), S = (t) => (t == null ? void 0 : t.split(",").map((e) => e.trim()).filter(Boolean)) ?? [], it = (t) => {
+  if (!t) return;
+  const e = {};
+  for (const r of t.split(",")) {
+    const [n, ...o] = r.split("="), s = n == null ? void 0 : n.trim();
+    s && (e[s] = o.join("=").trim());
+  }
+  return e;
+}, y = (t) => {
+  if (t)
+    try {
+      return JSON.parse(t);
+    } catch {
+      return;
+    }
+}, at = async (t) => {
+  if (t)
+    try {
+      const e = await k(t, "utf8");
+      return y(e);
+    } catch {
+      return;
+    }
+}, H = (t, e) => {
+  const r = g([...(t == null ? void 0 : t.paths) ?? [], ...(e == null ? void 0 : e.paths) ?? []]), n = g([
+    ...(t == null ? void 0 : t.extensions) ?? [],
+    ...(e == null ? void 0 : e.extensions) ?? []
+  ]), o = g([...(t == null ? void 0 : t.methods) ?? [], ...(e == null ? void 0 : e.methods) ?? []]);
+  return {
+    paths: r.length ? r : void 0,
+    extensions: n.length ? n : void 0,
+    methods: o.length ? o : void 0
+  };
+}, ct = (t) => {
+  if (t != null && t.length)
+    return t.map((e) => ({
+      ...e,
+      ratio: Number.isFinite(e.ratio) ? Math.max(0, Math.min(1, e.ratio)) : 0
+    })).filter((e) => e.ratio >= 0);
+}, ut = async (t = process.env) => {
+  const e = await at(t.TELEMETRY_CONFIG_FILE), r = S(t.TELEMETRY_IGNORE_PATHS), n = S(t.TELEMETRY_IGNORE_EXTENSIONS), o = S(t.TELEMETRY_IGNORE_METHODS), s = y(t.TELEMETRY_SAMPLING_RULES), i = typeof (e == null ? void 0 : e.samplingRules) == "string" ? y(e.samplingRules) : e == null ? void 0 : e.samplingRules, a = {
+    serviceName: t.OTEL_SERVICE_NAME || t.TELEMETRY_SERVICE_NAME,
+    serviceVersion: t.OTEL_SERVICE_VERSION || t.TELEMETRY_SERVICE_VERSION,
+    environment: t.OTEL_RESOURCE_ATTRIBUTES || t.TELEMETRY_ENVIRONMENT || (t.VERCEL ? t.VERCEL_ENV : void 0),
+    defaultSamplingRatio: t.TELEMETRY_SAMPLING_RATIO ? Number(t.TELEMETRY_SAMPLING_RATIO) : void 0,
+    url: t.OTEL_EXPORTER_OTLP_ENDPOINT || t.TELEMETRY_OTLP_ENDPOINT,
+    headers: it(t.OTEL_EXPORTER_OTLP_HEADERS || t.TELEMETRY_OTLP_HEADERS),
+    inspectionHeader: t.TELEMETRY_INSPECTION_HEADER,
+    userTypeHeader: t.TELEMETRY_USER_TYPE_HEADER,
+    requestStartHeader: t.TELEMETRY_REQUEST_START_HEADER,
+    samplingRules: s || i,
+    ignore: r.length || n.length || o.length ? {
+      paths: r.length ? r : void 0,
+      extensions: n.length ? n : void 0,
+      methods: o.length ? o : void 0
+    } : void 0
+  };
+  return e && typeof e == "object" ? { ...e, ...a } : a;
+}, mt = (t) => {
+  if (!t) return process.env.NODE_ENV || "development";
+  if (t.includes("deployment.environment")) {
+    const r = t.split(",").find((o) => o.includes("deployment.environment"));
+    if (!r) return t;
+    const [, n] = r.split("=");
+    return (n == null ? void 0 : n.trim()) || t;
+  }
+  return t;
+}, pt = (t, e) => {
+  var n, o;
+  const r = [
+    { name: "inspection", ratio: 1, when: { inspection: !0 } },
+    { name: "error", ratio: 1, when: { minStatusCode: 500 } }
+  ];
+  if ((n = t == null ? void 0 : t.criticalPaths) != null && n.length && r.push({
+    name: "critical-path",
+    ratio: 1,
+    when: { path: t.criticalPaths }
+  }), (o = t == null ? void 0 : t.criticalUserTypes) != null && o.length && r.push({
+    name: "critical-user",
+    ratio: 1,
+    when: { userType: t.criticalUserTypes }
+  }), t != null && t.pathSampling)
+    for (const [s, i] of Object.entries(t.pathSampling))
+      r.push({
+        name: `path:${s}`,
+        ratio: i,
+        when: { path: [s] }
+      });
+  if (t != null && t.userTypeSampling)
+    for (const [s, i] of Object.entries(t.userTypeSampling))
+      r.push({
+        name: `user:${s}`,
+        ratio: i,
+        when: { userType: [s] }
+      });
+  return r.push({ name: "default", ratio: e }), r;
+}, D = (t) => {
+  const e = mt(t.environment), r = H(J, t.ignore), n = typeof t.defaultSamplingRatio == "number" ? Math.max(0, Math.min(1, t.defaultSamplingRatio)) : 0.01, o = ct(t.samplingRules) ?? pt(t.layeredSampling, n);
+  return {
+    ...t,
+    serviceName: t.serviceName || "unknown-service",
+    serviceVersion: t.serviceVersion,
+    environment: e,
+    defaultSamplingRatio: n,
+    ignore: r,
+    samplingRules: o,
+    inspectionHeader: t.inspectionHeader ?? "x-inspection",
+    userTypeHeader: t.userTypeHeader ?? "x-telemetry-user-type",
+    requestStartHeader: t.requestStartHeader ?? "x-telemetry-start",
+    scheduledDelayMillis: t.scheduledDelayMillis ?? 1e3,
+    maxQueueSize: t.maxQueueSize ?? 2048,
+    maxExportBatchSize: t.maxExportBatchSize ?? 512,
+    exporterTimeoutMillis: t.exporterTimeoutMillis ?? 3e4
+  };
+}, P = async (t = {}, e = process.env) => {
+  const r = await ut(e);
+  return D({ ...r, ...t });
+}, Et = async (t) => {
+  let e = await P(t);
+  return {
+    getConfig: () => e,
+    updateConfig: (r) => {
+      e = D({
+        ...e,
+        ...r,
+        ignore: H(e.ignore, r.ignore)
+      });
+    }
+  };
+}, lt = (t) => t[0] * 1e3 + t[1] / 1e6, ft = (t, e) => {
+  for (const r of e) {
+    const n = t.attributes[r];
+    if (typeof n == "number") return n;
+  }
+}, ht = (t) => {
+  const e = t.events.find((n) => n.name === "exception");
+  if (!(e != null && e.attributes)) return;
+  const r = e.attributes["exception.message"];
+  return typeof r == "string" ? r : void 0;
+}, dt = () => ({
+  onStart: () => {
+  },
+  onEnd: (t) => {
+    const e = lt(t.duration);
+    t.attributes["telemetry.request.duration_ms"] = Math.round(e), typeof t.attributes["telemetry.request.start_time_ms"] != "number" && (t.attributes["telemetry.request.start_time_ms"] = Date.now() - Math.round(e));
+    const r = ft(t, [
+      "http.response.status_code",
+      "http.status_code",
+      "telemetry.response.status_code"
+    ]);
+    if (typeof r == "number" && (t.attributes["telemetry.response.status_code"] = r), t.status.code === G.ERROR || typeof r == "number" && r >= 500) {
+      t.attributes["telemetry.request.error"] = !0;
+      const o = t.status.message || ht(t);
+      o && (t.attributes["telemetry.request.error_message"] = o);
+    }
+  },
+  shutdown: () => Promise.resolve(),
+  forceFlush: () => Promise.resolve()
+}), wt = async (t) => {
+  const e = await P(t);
+  p = await Et(e);
+  const r = process.env, n = {
+    [q]: e.serviceName,
+    [F]: e.serviceVersion || "1.0.0",
+    [K]: e.environment || r.VERCEL_ENV || r.NODE_ENV || "development"
+  };
+  r.VERCEL && (r.VERCEL_REGION && (n["vercel.region"] = r.VERCEL_REGION), r.NEXT_RUNTIME && (n["vercel.runtime"] = r.NEXT_RUNTIME), r.VERCEL_GIT_COMMIT_SHA && (n["vercel.sha"] = r.VERCEL_GIT_COMMIT_SHA), r.VERCEL_URL && (n["vercel.host"] = r.VERCEL_URL), r.VERCEL_BRANCH_URL && (n["vercel.branch_host"] = r.VERCEL_BRANCH_URL), r.VERCEL_DEPLOYMENT_ID && (n["vercel.deployment_id"] = r.VERCEL_DEPLOYMENT_ID));
+  const o = Y(n), s = new v(e), i = ot(s), a = [
+    dt(),
+    new z(i, {
+      scheduledDelayMillis: e.scheduledDelayMillis,
+      maxQueueSize: e.maxQueueSize,
+      maxExportBatchSize: e.maxExportBatchSize,
+      exportTimeoutMillis: e.exporterTimeoutMillis
+    })
+  ];
+  h = new b({
+    serviceName: e.serviceName,
+    resource: o,
+    spanProcessors: a,
+    sampler: st(p),
+    instrumentations: $(e)
+  });
+  try {
+    await h.start();
+  } catch (c) {
+    console.warn("Telemetry start failed:", c);
+  }
+  return p;
+}, Ot = (t) => {
+  p == null || p.updateConfig(t);
+}, At = (t) => (I.inject(V.active(), t), t), It = (t = fetch) => async (e, r) => {
+  const n = (r == null ? void 0 : r.headers) ?? (e instanceof Request ? e.headers : void 0), o = new Headers(n);
+  return I.inject(V.active(), o, {
+    set: (s, i, a) => {
+      s.set(i, a);
+    }
+  }), t(e, { ...r, headers: o });
+}, Vt = async () => {
+  h && await h.shutdown();
+};
+export {
+  Z as buildSamplingContextFromAttributes,
+  X as createIgnoreMatcher,
+  It as createPropagatingFetch,
+  Et as createTelemetryRuntime,
+  J as defaultIgnoreConfig,
+  At as injectTraceHeaders,
+  ut as loadTelemetryConfigFromEnv,
+  et as matchSamplingRule,
+  rt as resolveSamplingRatio,
+  P as resolveTelemetryConfig,
+  Vt as shutdownTelemetry,
+  wt as startTelemetry,
+  Ot as updateTelemetryConfig
+};

package/dist/index.d.ts

@@ -1,12 +1,22 @@
-import { OTLPExporterNodeConfigBase } from '@opentelemetry/otlp-exporter-base';
-interface TelemetryOptions extends OTLPExporterNodeConfigBase {
-    serviceName: string;
-    serviceVersion?: string;
-    environment: string;
-    ignorePaths?: string[];
-    inspectionRatio?: number;
-}
-export declare function startTelemetry(otlpOptions: TelemetryOptions): void;
-export declare function shutdownTelemetry(): void;
-export {};
+import { buildSamplingContextFromAttributes, matchSamplingRule, resolveSamplingRatio } from './Sampler';
+import { createIgnoreMatcher, defaultIgnoreConfig } from './ignore';
+import { TelemetryConfig, TelemetryRuntime } from './types';
+export * from './types';
+export { buildSamplingContextFromAttributes, matchSamplingRule, resolveSamplingRatio, createIgnoreMatcher, defaultIgnoreConfig, };
+/** 从环境变量加载 Telemetry 配置（异步读取配置文件，不阻塞主线程） */
+export declare const loadTelemetryConfigFromEnv: (env?: NodeJS.ProcessEnv) => Promise<Partial<TelemetryConfig>>;
+/** 合并环境变量与显式配置得到最终配置 */
+export declare const resolveTelemetryConfig: (options?: Partial<TelemetryConfig>, env?: NodeJS.ProcessEnv) => Promise<TelemetryConfig>;
+/** 创建可运行时更新的配置容器 */
+export declare const createTelemetryRuntime: (initialConfig: Partial<TelemetryConfig>) => Promise<TelemetryRuntime>;
+/** 启动 OpenTelemetry SDK */
+export declare const startTelemetry: (options: Partial<TelemetryConfig> | TelemetryConfig) => Promise<TelemetryRuntime>;
+/** 运行时更新 Telemetry 配置 */
+export declare const updateTelemetryConfig: (partial: Partial<TelemetryConfig>) => void;
+/** 注入 traceparent 等传播头 */
+export declare const injectTraceHeaders: (headers: Record<string, string>) => Record<string, string>;
+/** 创建带 traceparent 注入的 fetch */
+export declare const createPropagatingFetch: (fetchImpl?: typeof fetch) => (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** 停止并释放 Telemetry SDK */
+export declare const shutdownTelemetry: () => Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAY/E,UAAU,gBAAiB,SAAQ,0BAA0B;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,cAAc,CAAC,WAAW,EAAE,gBAAgB,QAiC3D;AAED,wBAAgB,iBAAiB,SAIhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,kCAAkC,EAGlC,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAIV,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,CAAC;AA4EF,4CAA4C;AAC5C,eAAO,MAAM,0BAA0B,GACrC,MAAK,MAAM,CAAC,UAAwB,KACnC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAuClC,CAAC;AAiGF,wBAAwB;AACxB,eAAO,MAAM,sBAAsB,GACjC,UAAS,OAAO,CAAC,eAAe,CAAM,EACtC,MAAK,MAAM,CAAC,UAAwB,KACnC,OAAO,CAAC,eAAe,CAGzB,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,sBAAsB,GACjC,eAAe,OAAO,CAAC,eAAe,CAAC,KACtC,OAAO,CAAC,gBAAgB,CAY1B,CAAC;AAwDF,2BAA2B;AAC3B,eAAO,MAAM,cAAc,GAAU,SAAS,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,8BA+CvF,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,qBAAqB,GAAI,SAAS,OAAO,CAAC,eAAe,CAAC,SAEtE,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,2BAGjE,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,GAAI,YAAW,OAAO,KAAa,MACtD,OAAO,WAAW,GAAG,GAAG,EAAE,OAAO,WAAW,sBAY3D,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,iBAAiB,qBAI7B,CAAC"}

package/dist/instrumentation

@@ -0,0 +1,8 @@
+import { startTelemetry as a } from "./index";
+const o = async (t) => {
+  const e = typeof t == "function" ? await t() : t;
+  await a(e ?? {});
+};
+export {
+  o as registerTelemetry
+};

package/dist/instrumentation.d.ts

@@ -0,0 +1,4 @@
+import { TelemetryConfig } from './types';
+/** 在 Next.js instrumentation.ts 中注册追踪 */
+export declare const registerTelemetry: (configOrProvider?: TelemetryConfig | (() => TelemetryConfig | Promise<TelemetryConfig>)) => Promise<void>;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,GAC5B,mBAAmB,eAAe,GAAG,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,kBAKxF,CAAC"}

package/dist/middleware

@@ -0,0 +1,29 @@
+import { NextRequest as w, NextResponse as i } from "next/server";
+import { c as g } from "./ignore-B1KXtl12.js";
+const h = {
+  matcher: [
+    "/((?!_next/static|_next/image|favicon.ico|robots.txt|sitemap.xml|.*\\.(?:css|js|mjs|cjs|png|jpg|jpeg|gif|svg|ico|webp|avif|woff|woff2|ttf|eot|map|txt|xml)).*)"
+  ]
+}, l = (r, s = {}) => {
+  const p = g(s.ignore), d = (s.requestStartHeader ?? "x-telemetry-start").toLowerCase(), n = (s.userTypeHeader ?? "x-telemetry-user-type").toLowerCase(), a = s.resolveUserType;
+  return async (e, o) => {
+    const f = e.nextUrl.pathname;
+    if (p(f, e.method))
+      return r(e, o);
+    const t = new Headers(e.headers), c = (a == null ? void 0 : a(e)) || t.get(n);
+    c && t.set(n, c), t.set(d, String(Date.now()));
+    const x = new w(e, {
+      headers: t
+    }), m = await r(x, o);
+    return m || i.next({
+      request: {
+        headers: t
+      }
+    });
+  };
+}, T = (r = {}) => l(() => i.next(), r);
+export {
+  T as createTelemetryMiddleware,
+  h as defaultTelemetryMiddlewareConfig,
+  l as withTelemetryMiddleware
+};

package/dist/middleware.d.ts

@@ -0,0 +1,24 @@
+import { NextResponse, NextRequest, NextFetchEvent } from 'next/server';
+import { TelemetryMiddlewareOptions } from './types';
+export declare const defaultTelemetryMiddlewareConfig: {
+    matcher: string[];
+};
+export type NextMiddlewareResult = NextResponse | Response | null | undefined | void;
+export type NextMiddleware = (request: NextRequest, event: NextFetchEvent) => NextMiddlewareResult | Promise<NextMiddlewareResult>;
+/**
+ * Higher-order function to wrap existing middleware with telemetry support.
+ * This is less invasive than creating a separate middleware factory.
+ *
+ * Usage:
+ * export const middleware = withTelemetryMiddleware(async (req) => {
+ *   // your existing middleware logic
+ *   return NextResponse.next();
+ * });
+ */
+export declare const withTelemetryMiddleware: (middleware: NextMiddleware, options?: TelemetryMiddlewareOptions) => NextMiddleware;
+/**
+ * Simplified Telemetry Middleware Creator (Factory Pattern)
+ * For users who don't have existing middleware or prefer this style.
+ */
+export declare const createTelemetryMiddleware: (options?: TelemetryMiddlewareOptions) => NextMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,gCAAgC;;CAI5C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAErF,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,cAAc,KAClB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,cAAc,EAC1B,UAAS,0BAA+B,KACvC,cAqCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAS,0BAA+B,mBAGjF,CAAC"}

package/dist/next

@@ -0,0 +1,29 @@
+import { NextRequest as w, NextResponse as i } from "next/server";
+import { c as g } from "./ignore-B1KXtl12.js";
+const h = {
+  matcher: [
+    "/((?!_next/static|_next/image|favicon.ico|robots.txt|sitemap.xml|.*\\.(?:css|js|mjs|cjs|png|jpg|jpeg|gif|svg|ico|webp|avif|woff|woff2|ttf|eot|map|txt|xml)).*)"
+  ]
+}, l = (r, s = {}) => {
+  const p = g(s.ignore), d = (s.requestStartHeader ?? "x-telemetry-start").toLowerCase(), n = (s.userTypeHeader ?? "x-telemetry-user-type").toLowerCase(), a = s.resolveUserType;
+  return async (e, o) => {
+    const f = e.nextUrl.pathname;
+    if (p(f, e.method))
+      return r(e, o);
+    const t = new Headers(e.headers), c = (a == null ? void 0 : a(e)) || t.get(n);
+    c && t.set(n, c), t.set(d, String(Date.now()));
+    const x = new w(e, {
+      headers: t
+    }), m = await r(x, o);
+    return m || i.next({
+      request: {
+        headers: t
+      }
+    });
+  };
+}, T = (r = {}) => l(() => i.next(), r);
+export {
+  T as createTelemetryMiddleware,
+  h as defaultTelemetryMiddlewareConfig,
+  l as withTelemetryMiddleware
+};

package/dist/next.d.ts

@@ -0,0 +1,24 @@
+import { NextResponse, NextRequest, NextFetchEvent } from 'next/server';
+import { TelemetryMiddlewareOptions } from './types';
+export declare const defaultTelemetryMiddlewareConfig: {
+    matcher: string[];
+};
+export type NextMiddlewareResult = NextResponse | Response | null | undefined | void;
+export type NextMiddleware = (request: NextRequest, event: NextFetchEvent) => NextMiddlewareResult | Promise<NextMiddlewareResult>;
+/**
+ * Higher-order function to wrap existing middleware with telemetry support.
+ * This is less invasive than creating a separate middleware factory.
+ *
+ * Usage:
+ * export const middleware = withTelemetryMiddleware(async (req) => {
+ *   // your existing middleware logic
+ *   return NextResponse.next();
+ * });
+ */
+export declare const withTelemetryMiddleware: (middleware: NextMiddleware, options?: TelemetryMiddlewareOptions) => NextMiddleware;
+/**
+ * Simplified Telemetry Middleware Creator (Factory Pattern)
+ * For users who don't have existing middleware or prefer this style.
+ */
+export declare const createTelemetryMiddleware: (options?: TelemetryMiddlewareOptions) => NextMiddleware;
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,gCAAgC;;CAI5C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAErF,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,cAAc,KAClB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,cAAc,EAC1B,UAAS,0BAA+B,KACvC,cAqCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAS,0BAA+B,mBAGjF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+import { OTLPExporterNodeConfigBase } from '@opentelemetry/otlp-exporter-base';
+export type PathPattern = string | RegExp;
+export interface IgnoreConfig {
+    paths?: PathPattern[];
+    extensions?: string[];
+    methods?: string[];
+}
+export interface SamplingRuleCondition {
+    path?: PathPattern[];
+    method?: string[];
+    userType?: string[];
+    statusCode?: number[];
+    minStatusCode?: number;
+    maxStatusCode?: number;
+    inspection?: boolean;
+}
+export interface SamplingRule {
+    name?: string;
+    ratio: number;
+    when?: SamplingRuleCondition;
+}
+export interface LayeredSamplingConfig {
+    criticalPaths?: PathPattern[];
+    criticalUserTypes?: string[];
+    pathSampling?: Record<string, number>;
+    userTypeSampling?: Record<string, number>;
+}
+export interface TelemetryConfig extends OTLPExporterNodeConfigBase {
+    serviceName: string;
+    serviceVersion?: string;
+    environment?: string;
+    defaultSamplingRatio?: number;
+    samplingRules?: SamplingRule[];
+    layeredSampling?: LayeredSamplingConfig;
+    ignore?: IgnoreConfig;
+    inspectionHeader?: string;
+    userTypeHeader?: string;
+    requestStartHeader?: string;
+    exporterTimeoutMillis?: number;
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduledDelayMillis?: number;
+}
+export interface TelemetryRuntime {
+    getConfig: () => TelemetryConfig;
+    updateConfig: (partial: Partial<TelemetryConfig>) => void;
+}
+export interface TelemetryMiddlewareOptions {
+    ignore?: IgnoreConfig;
+    inspectionHeader?: string;
+    requestStartHeader?: string;
+    userTypeHeader?: string;
+    resolveUserType?: (request: import('next/server').NextRequest) => string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,eAAgB,SAAQ,0BAA0B;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,eAAe,CAAC;IACjC,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,aAAa,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAC;CACtF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xchain/telemetry",
-  "version": "1.0.0",
+  "version": "1.1.0-beta.10",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,6 +11,24 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js",
+      "require": "./dist/middleware.js",
+      "default": "./dist/middleware.js"
+    },
+    "./instrumentation": {
+      "types": "./dist/instrumentation.d.ts",
+      "import": "./dist/instrumentation.js",
+      "require": "./dist/instrumentation.js",
+      "default": "./dist/instrumentation.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.js",
+      "require": "./dist/next.js",
+      "default": "./dist/next.js"
     }
   },
   "files": [
@@ -19,14 +37,15 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "0.62.0",
-    "@opentelemetry/exporter-trace-otlp-http": "0.203.0",
-    "@opentelemetry/instrumentation-undici": "0.14.0",
-    "@opentelemetry/otlp-exporter-base": "0.203.0",
-    "@opentelemetry/resources": "2.0.1",
-    "@opentelemetry/sdk-node": "0.203.0",
-    "@opentelemetry/sdk-trace-base": "2.0.1",
-    "@opentelemetry/semantic-conventions": "1.36.0"
+    "@opentelemetry/instrumentation-http": "0.211.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.211.0",
+    "@opentelemetry/instrumentation-undici": "0.21.0",
+    "@opentelemetry/otlp-exporter-base": "0.211.0",
+    "@opentelemetry/resources": "2.5.0",
+    "@opentelemetry/sdk-node": "0.211.0",
+    "@opentelemetry/sdk-trace-base": "2.5.0",
+    "@opentelemetry/semantic-conventions": "1.39.0",
+    "next": "16.1.6"
   },
   "publishConfig": {
     "access": "public"

package/dist/index.js

@@ -1,98 +0,0 @@
-var S = Object.defineProperty;
-var f = (n, e, t) => e in n ? S(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var m = (n, e, t) => f(n, typeof e != "symbol" ? e + "" : e, t);
-import { NodeSDK as g } from "@opentelemetry/sdk-node";
-import { OTLPTraceExporter as E } from "@opentelemetry/exporter-trace-otlp-http";
-import { resourceFromAttributes as I } from "@opentelemetry/resources";
-import { ATTR_SERVICE_VERSION as T, ATTR_SERVICE_NAME as R } from "@opentelemetry/semantic-conventions";
-import { TraceIdRatioBasedSampler as _, AlwaysOnSampler as x, SamplingDecision as l, BatchSpanProcessor as w } from "@opentelemetry/sdk-trace-base";
-import { trace as A, TraceFlags as u } from "@opentelemetry/api";
-import { getNodeAutoInstrumentations as N } from "@opentelemetry/auto-instrumentations-node";
-import { UndiciInstrumentation as P } from "@opentelemetry/instrumentation-undici";
-const y = "deployment.environment.name";
-class D {
-  constructor(e) {
-    m(this, "defaultSampler");
-    m(this, "inspectionSampler");
-    this.defaultSampler = new _(e), this.inspectionSampler = new x();
-  }
-  shouldSample(e, t, r, s, o, i) {
-    if (o["http.request.header.x-inspection"] === "true" || o["x-inspection"] === "true")
-      return this.inspectionSampler.shouldSample(e, t, r, s, o, i);
-    const a = A.getSpanContext(e);
-    return a ? (a.traceFlags & u.SAMPLED) === u.SAMPLED ? { decision: l.RECORD_AND_SAMPLED } : { decision: l.NOT_RECORD } : this.defaultSampler.shouldSample(e, t, r, s, o, i);
-  }
-  toString() {
-    return "InspectionSampler";
-  }
-}
-const O = [
-  "/health",
-  "/metrics",
-  "/_next/static",
-  "/favicon.ico",
-  "/__nextjs_",
-  "/.well-known"
-], d = (n, e) => n.some((t) => e.includes(t));
-function M(n) {
-  const e = [...O, ...n];
-  return [
-    N({
-      // 禁用可能导致问题的检测器
-      "@opentelemetry/instrumentation-grpc": {
-        enabled: !1
-      },
-      "@opentelemetry/instrumentation-http": {
-        enabled: !0,
-        startIncomingSpanHook: (t) => "headers" in t && t.headers["x-inspection"] === "true" ? {
-          "http.request.header.x-inspection": "true",
-          "x-inspection": "true"
-        } : {},
-        ignoreIncomingRequestHook: (t) => {
-          const r = t.url || "";
-          return d(e, r);
-        },
-        ignoreOutgoingRequestHook: (t) => {
-          const r = typeof t == "string" ? t : t.path || "";
-          return d(e, r);
-        }
-      }
-    }),
-    new P()
-  ];
-}
-let c;
-function j(n) {
-  const {
-    serviceName: e,
-    serviceVersion: t,
-    environment: r,
-    ignorePaths: s = [],
-    inspectionRatio: o = 0.01,
-    ...i
-  } = n, p = I({
-    [R]: e || "ichaingo-seo",
-    [T]: t || "1.0.0",
-    [y]: r || "development"
-  }), a = new E(i), h = new w(a, {
-    scheduledDelayMillis: 1e3,
-    // 1秒延迟
-    maxQueueSize: 2048,
-    maxExportBatchSize: 512
-  });
-  c = new g({
-    serviceName: e,
-    resource: p,
-    spanProcessors: [h],
-    sampler: new D(o),
-    // traceExporter,
-    instrumentations: M(s)
-  }), c.start(), console.log("OpenTelemetry started:", JSON.stringify(n, null, 2));
-}
-function q() {
-  c && c.shutdown();
-}
-export {
-  q as shutdownTelemetry,
-  j as startTelemetry
-};