@0xchain/telemetry 1.1.0-beta.2 → 1.1.0-beta.20

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/instrumentation.js

@@ -0,0 +1,8 @@
+import { startTelemetry } from "./index.js";
+const registerTelemetry = async (configOrProvider) => {
+  const resolvedConfig = typeof configOrProvider === "function" ? await configOrProvider() : configOrProvider;
+  await startTelemetry(resolvedConfig ?? {});
+};
+export {
+  registerTelemetry
+};

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/middleware.js

@@ -0,0 +1,43 @@
+import { NextRequest, NextResponse } from "next/server";
+import { c as createIgnoreMatcher } from "./ignore-BvHZTNsF.js";
+const defaultTelemetryMiddlewareConfig = {
+  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)).*)"
+  ]
+};
+const withTelemetryMiddleware = (middleware, options = {}) => {
+  const shouldIgnore = createIgnoreMatcher(options.ignore);
+  const requestStartHeader = (options.requestStartHeader ?? "x-telemetry-start").toLowerCase();
+  const userTypeHeader = (options.userTypeHeader ?? "x-telemetry-user-type").toLowerCase();
+  const resolveUserType = options.resolveUserType;
+  return async (request, event) => {
+    const pathname = request.nextUrl.pathname;
+    if (shouldIgnore(pathname, request.method)) {
+      return middleware(request, event);
+    }
+    const headers = new Headers(request.headers);
+    const userType = resolveUserType?.(request) || headers.get(userTypeHeader);
+    if (userType) headers.set(userTypeHeader, userType);
+    headers.set(requestStartHeader, String(Date.now()));
+    const wrappedRequest = new NextRequest(request, {
+      headers
+    });
+    const response = await middleware(wrappedRequest, event);
+    if (!response) {
+      return NextResponse.next({
+        request: {
+          headers
+        }
+      });
+    }
+    return response;
+  };
+};
+const createTelemetryMiddleware = (options = {}) => {
+  return withTelemetryMiddleware(() => NextResponse.next(), options);
+};
+export {
+  createTelemetryMiddleware,
+  defaultTelemetryMiddlewareConfig,
+  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/next.js

@@ -0,0 +1,43 @@
+import { NextRequest, NextResponse } from "next/server";
+import { c as createIgnoreMatcher } from "./ignore-BvHZTNsF.js";
+const defaultTelemetryMiddlewareConfig = {
+  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)).*)"
+  ]
+};
+const withTelemetryMiddleware = (middleware, options = {}) => {
+  const shouldIgnore = createIgnoreMatcher(options.ignore);
+  const requestStartHeader = (options.requestStartHeader ?? "x-telemetry-start").toLowerCase();
+  const userTypeHeader = (options.userTypeHeader ?? "x-telemetry-user-type").toLowerCase();
+  const resolveUserType = options.resolveUserType;
+  return async (request, event) => {
+    const pathname = request.nextUrl.pathname;
+    if (shouldIgnore(pathname, request.method)) {
+      return middleware(request, event);
+    }
+    const headers = new Headers(request.headers);
+    const userType = resolveUserType?.(request) || headers.get(userTypeHeader);
+    if (userType) headers.set(userTypeHeader, userType);
+    headers.set(requestStartHeader, String(Date.now()));
+    const wrappedRequest = new NextRequest(request, {
+      headers
+    });
+    const response = await middleware(wrappedRequest, event);
+    if (!response) {
+      return NextResponse.next({
+        request: {
+          headers
+        }
+      });
+    }
+    return response;
+  };
+};
+const createTelemetryMiddleware = (options = {}) => {
+  return withTelemetryMiddleware(() => NextResponse.next(), options);
+};
+export {
+  createTelemetryMiddleware,
+  defaultTelemetryMiddlewareConfig,
+  withTelemetryMiddleware
+};

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+import { OTLPExporterNodeConfigBase } from '@opentelemetry/otlp-exporter-base';
+export type PathPattern = string | RegExp;
+export interface IgnoreConfig {
+    paths?: PathPattern[];
+    extensions?: string[];
+    methods?: string[];
+    /** 需要忽略的 span 名称模式（用于过滤 Next.js 内部 span 等非 HTTP 请求） */
+    spanNames?: PathPattern[];
+}
+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;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;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.1.0-beta.2",
+  "version": "1.1.0-beta.20",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,22 +11,58 @@
       "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": [
     "dist",
     "!**/*.tsbuildinfo"
   ],
-  "dependencies": {
+  "peerDependencies": {
     "@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/exporter-trace-otlp-http": "0.212.0",
+    "@opentelemetry/instrumentation-http": "0.212.0",
+    "@opentelemetry/instrumentation-undici": "0.22.0",
+    "@opentelemetry/otlp-exporter-base": "0.212.0",
+    "@opentelemetry/resources": "2.5.1",
+    "@opentelemetry/sdk-node": "0.212.0",
+    "@opentelemetry/sdk-trace-base": "2.5.1",
+    "@opentelemetry/semantic-conventions": "1.40.0",
+    "next": "16.1.6"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.212.0",
+    "@opentelemetry/instrumentation-http": "0.212.0",
+    "@opentelemetry/instrumentation-undici": "0.22.0",
+    "@opentelemetry/otlp-exporter-base": "0.212.0",
+    "@opentelemetry/resources": "2.5.1",
+    "@opentelemetry/sdk-node": "0.212.0",
+    "@opentelemetry/sdk-trace-base": "2.5.1",
+    "@opentelemetry/semantic-conventions": "1.40.0",
+    "next": "16.1.6"
+  },
+  "nx": {
+    "tags": [
+      "type:util"
+    ]
   },
   "publishConfig": {
     "access": "public"