@vestig/next 0.16.0 → 0.18.0

package/dist/instrumentation/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Next.js Instrumentation for vestig
+ *
+ * @example
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *     },
+ *     autoInstrument: {
+ *       fetch: true,
+ *     },
+ *   })
+ * }
+ * ```
+ */
+export { registerVestig } from './register';
+export type { RegisterVestigOptions, RegisterVestigResult, OTLPConfig, AutoInstrumentConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/instrumentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,YAAY,EACX,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACV,oBAAoB,GACpB,MAAM,SAAS,CAAA"}

package/dist/instrumentation/index.js

@@ -0,0 +1,23 @@
+/**
+ * Next.js Instrumentation for vestig
+ *
+ * @example
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *     },
+ *     autoInstrument: {
+ *       fetch: true,
+ *     },
+ *   })
+ * }
+ * ```
+ */
+export { registerVestig } from './register';
+//# sourceMappingURL=index.js.map

package/dist/instrumentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/instrumentation/register.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Unified vestig setup for Next.js instrumentation
+ *
+ * Call in your instrumentation.ts file for complete auto-instrumentation.
+ */
+import type { RegisterVestigOptions, RegisterVestigResult } from './types';
+/**
+ * Register vestig for Next.js instrumentation
+ *
+ * Call this in your `instrumentation.ts` file to enable:
+ * - OTLP trace export (Vercel, Honeycomb, Jaeger, etc.)
+ * - Automatic fetch() instrumentation
+ * - Console error capture (optional)
+ *
+ * @example Basic usage
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *   })
+ * }
+ * ```
+ *
+ * @example With OTLP export
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *       headers: {
+ *         'Authorization': `Bearer ${process.env.OTEL_AUTH_TOKEN}`,
+ *       },
+ *     },
+ *   })
+ * }
+ * ```
+ *
+ * @example Full configuration
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *       serviceVersion: '1.0.0',
+ *       environment: process.env.VERCEL_ENV,
+ *     },
+ *     autoInstrument: {
+ *       fetch: {
+ *         captureHeaders: ['content-type', 'x-request-id'],
+ *         ignoreUrls: ['/health', /^\/_next/],
+ *       },
+ *       console: true,
+ *     },
+ *     debug: process.env.NODE_ENV === 'development',
+ *   })
+ * }
+ * ```
+ *
+ * @example Environment variables
+ * ```bash
+ * # These are automatically read if not specified in config:
+ * OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.vercel.com/v1/traces
+ * OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer token
+ * VERCEL_ENV=production
+ * ```
+ */
+export declare function registerVestig(options: RegisterVestigOptions): RegisterVestigResult;
+//# sourceMappingURL=register.d.ts.map

package/dist/instrumentation/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/instrumentation/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAGX,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,SAAS,CAAA;AAsKhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CA4CnF"}

package/dist/instrumentation/register.js

@@ -0,0 +1,251 @@
+/**
+ * Unified vestig setup for Next.js instrumentation
+ *
+ * Call in your instrumentation.ts file for complete auto-instrumentation.
+ */
+import { instrumentFetch, registerSpanProcessor, shutdownSpanProcessors, } from 'vestig';
+import { OTLPExporter } from 'vestig/otlp';
+/**
+ * Parse OTEL headers from environment variable
+ * Format: key1=value1,key2=value2
+ */
+function parseOTLPHeaders(headersStr) {
+    if (!headersStr)
+        return {};
+    const headers = {};
+    const pairs = headersStr.split(',');
+    for (const pair of pairs) {
+        const [key, ...valueParts] = pair.split('=');
+        if (key && valueParts.length > 0) {
+            headers[key.trim()] = valueParts.join('=').trim();
+        }
+    }
+    return headers;
+}
+/**
+ * Get environment from various sources
+ */
+function getEnvironment(config) {
+    return config?.environment ?? process.env.VERCEL_ENV ?? process.env.NODE_ENV ?? 'development';
+}
+/**
+ * Setup OTLP export if configured
+ */
+function setupOTLP(serviceName, config, debug) {
+    // Get endpoint from config or environment
+    const endpoint = config?.endpoint ?? process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint) {
+        if (debug) {
+            console.log('[vestig] OTLP not configured: no endpoint provided');
+        }
+        return false;
+    }
+    // Ensure endpoint has /v1/traces suffix
+    const tracesEndpoint = endpoint.endsWith('/v1/traces')
+        ? endpoint
+        : `${endpoint.replace(/\/$/, '')}/v1/traces`;
+    // Get headers from config or environment
+    const headers = {
+        ...parseOTLPHeaders(process.env.OTEL_EXPORTER_OTLP_HEADERS),
+        ...config?.headers,
+    };
+    // Create and register exporter
+    const exporter = new OTLPExporter({
+        endpoint: tracesEndpoint,
+        serviceName,
+        serviceVersion: config?.serviceVersion,
+        environment: getEnvironment(config),
+        headers: Object.keys(headers).length > 0 ? headers : undefined,
+        resourceAttributes: config?.resourceAttributes,
+        batchSize: config?.batchSize,
+        flushInterval: config?.flushInterval,
+    });
+    registerSpanProcessor(exporter);
+    if (debug) {
+        console.log(`[vestig] OTLP enabled: ${tracesEndpoint}`);
+    }
+    return true;
+}
+/**
+ * Setup fetch instrumentation if configured
+ */
+function setupFetch(config, debug) {
+    // Default to enabled unless explicitly disabled
+    const fetchConfig = config?.fetch;
+    if (fetchConfig === false) {
+        if (debug) {
+            console.log('[vestig] Fetch instrumentation disabled');
+        }
+        return false;
+    }
+    // Determine options
+    const options = typeof fetchConfig === 'object'
+        ? fetchConfig
+        : {
+            // Default options for Next.js
+            ignoreUrls: [
+                // Next.js internal routes
+                /^\/_next/,
+                // Health checks
+                '/health',
+                '/healthz',
+                '/ready',
+                // Metrics
+                '/metrics',
+                // Favicon
+                '/favicon.ico',
+            ],
+        };
+    instrumentFetch(options);
+    if (debug) {
+        console.log('[vestig] Fetch instrumentation enabled');
+    }
+    return true;
+}
+/**
+ * Setup console capture if configured
+ */
+function setupConsole(config, debug) {
+    if (!config?.console) {
+        return null;
+    }
+    // Store original console.error
+    const originalError = console.error;
+    // Wrap console.error to create spans
+    console.error = (...args) => {
+        // Call original first
+        originalError.apply(console, args);
+        // Create span for the error (non-blocking)
+        // This is a fire-and-forget operation
+        try {
+            const message = args
+                .map((arg) => (typeof arg === 'string' ? arg : JSON.stringify(arg)))
+                .join(' ');
+            // Import dynamically to avoid circular deps
+            import('vestig').then(({ spanSync }) => {
+                spanSync('console.error', (s) => {
+                    s.setAttribute('message', message.slice(0, 1000));
+                    s.setStatus('error', 'console.error');
+                });
+            });
+        }
+        catch {
+            // Ignore errors in instrumentation
+        }
+    };
+    if (debug) {
+        console.log('[vestig] Console capture enabled');
+    }
+    // Return restore function
+    return () => {
+        console.error = originalError;
+    };
+}
+/**
+ * Register vestig for Next.js instrumentation
+ *
+ * Call this in your `instrumentation.ts` file to enable:
+ * - OTLP trace export (Vercel, Honeycomb, Jaeger, etc.)
+ * - Automatic fetch() instrumentation
+ * - Console error capture (optional)
+ *
+ * @example Basic usage
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *   })
+ * }
+ * ```
+ *
+ * @example With OTLP export
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *       headers: {
+ *         'Authorization': `Bearer ${process.env.OTEL_AUTH_TOKEN}`,
+ *       },
+ *     },
+ *   })
+ * }
+ * ```
+ *
+ * @example Full configuration
+ * ```typescript
+ * // instrumentation.ts
+ * import { registerVestig } from '@vestig/next/instrumentation'
+ *
+ * export function register() {
+ *   registerVestig({
+ *     serviceName: 'my-app',
+ *     otlp: {
+ *       endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+ *       serviceVersion: '1.0.0',
+ *       environment: process.env.VERCEL_ENV,
+ *     },
+ *     autoInstrument: {
+ *       fetch: {
+ *         captureHeaders: ['content-type', 'x-request-id'],
+ *         ignoreUrls: ['/health', /^\/_next/],
+ *       },
+ *       console: true,
+ *     },
+ *     debug: process.env.NODE_ENV === 'development',
+ *   })
+ * }
+ * ```
+ *
+ * @example Environment variables
+ * ```bash
+ * # These are automatically read if not specified in config:
+ * OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.vercel.com/v1/traces
+ * OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer token
+ * VERCEL_ENV=production
+ * ```
+ */
+export function registerVestig(options) {
+    const { serviceName, otlp, autoInstrument, debug = false } = options;
+    if (debug) {
+        console.log(`[vestig] Initializing for ${serviceName}...`);
+    }
+    // Track what was enabled
+    let otlpEnabled = false;
+    let fetchInstrumented = false;
+    let consoleRestore = null;
+    // Setup OTLP export
+    otlpEnabled = setupOTLP(serviceName, otlp, debug);
+    // Setup fetch instrumentation
+    fetchInstrumented = setupFetch(autoInstrument, debug);
+    // Setup console capture
+    consoleRestore = setupConsole(autoInstrument, debug);
+    if (debug) {
+        console.log('[vestig] Initialization complete');
+    }
+    // Return result with shutdown function
+    return {
+        otlpEnabled,
+        fetchInstrumented,
+        consoleInstrumented: consoleRestore !== null,
+        shutdown: async () => {
+            // Restore console
+            if (consoleRestore) {
+                consoleRestore();
+            }
+            // Shutdown span processors (flushes pending spans)
+            await shutdownSpanProcessors();
+            if (debug) {
+                console.log('[vestig] Shutdown complete');
+            }
+        },
+    };
+}
+//# sourceMappingURL=register.js.map

package/dist/instrumentation/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/instrumentation/register.ts"],"names":[],"mappings":"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"}

package/dist/instrumentation/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Types for registerVestig
+ */
+import type { InstrumentFetchOptions, TailSamplingConfig } from 'vestig';
+/**
+ * OTLP configuration options
+ */
+export interface OTLPConfig {
+    /**
+     * OTLP endpoint URL for traces
+     * Falls back to OTEL_EXPORTER_OTLP_ENDPOINT env var
+     * @example 'https://otel.vercel.com/v1/traces'
+     */
+    endpoint?: string;
+    /**
+     * Custom headers for authentication
+     * Falls back to OTEL_EXPORTER_OTLP_HEADERS env var (comma-separated key=value pairs)
+     * @example { 'Authorization': 'Bearer token' }
+     */
+    headers?: Record<string, string>;
+    /**
+     * Service version (optional)
+     * @example '1.0.0'
+     */
+    serviceVersion?: string;
+    /**
+     * Deployment environment
+     * Falls back to VERCEL_ENV, NODE_ENV
+     * @example 'production', 'development'
+     */
+    environment?: string;
+    /**
+     * Additional resource attributes
+     * @example { 'cloud.region': 'us-east-1' }
+     */
+    resourceAttributes?: Record<string, unknown>;
+    /**
+     * Batch size for span export
+     * @default 100
+     */
+    batchSize?: number;
+    /**
+     * Flush interval in ms
+     * @default 5000
+     */
+    flushInterval?: number;
+}
+/**
+ * Auto-instrumentation options
+ */
+export interface AutoInstrumentConfig {
+    /**
+     * Auto-instrument all fetch() calls
+     * @default true
+     */
+    fetch?: boolean | InstrumentFetchOptions;
+    /**
+     * Capture console.error as spans
+     * @default false
+     */
+    console?: boolean;
+}
+/**
+ * Options for registerVestig
+ */
+export interface RegisterVestigOptions {
+    /**
+     * Service name (required)
+     * Used in OTLP resource attributes
+     */
+    serviceName: string;
+    /**
+     * OTLP configuration
+     * If provided, enables automatic span export
+     */
+    otlp?: OTLPConfig;
+    /**
+     * Auto-instrumentation options
+     */
+    autoInstrument?: AutoInstrumentConfig;
+    /**
+     * Tail sampling configuration for wide events
+     */
+    tailSampling?: TailSamplingConfig;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Result of registerVestig
+ */
+export interface RegisterVestigResult {
+    /**
+     * Whether OTLP export was enabled
+     */
+    otlpEnabled: boolean;
+    /**
+     * Whether fetch was instrumented
+     */
+    fetchInstrumented: boolean;
+    /**
+     * Whether console capture was enabled
+     */
+    consoleInstrumented: boolean;
+    /**
+     * Shutdown function to cleanup resources
+     */
+    shutdown: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/instrumentation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/instrumentation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE5C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAExC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAA;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAA;IAE1B;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAA;IAE5B;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B"}

package/dist/instrumentation/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for registerVestig
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/instrumentation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/instrumentation/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vestig/next",
-	"version": "0.16.0",
+	"version": "0.18.0",
 	"description": "First-class Next.js 15+ integration for vestig logging library. Zero boilerplate, automatic request correlation, full type safety.",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -49,6 +49,10 @@
 		"./wide-events": {
 			"types": "./dist/wide-events/index.d.ts",
 			"import": "./dist/wide-events/index.js"
+		},
+		"./instrumentation": {
+			"types": "./dist/instrumentation/index.d.ts",
+			"import": "./dist/instrumentation/index.js"
 		}
 	},
 	"files": [
@@ -79,7 +83,10 @@
 		"observability",
 		"wide-events",
 		"canonical-log-lines",
-		"tail-sampling"
+		"tail-sampling",
+		"auto-instrumentation",
+		"otlp",
+		"opentelemetry"
 	],
 	"author": "Arakiss",
 	"license": "MIT",
@@ -99,7 +106,7 @@
 		"vestig": ">=0.2.0"
 	},
 	"dependencies": {
-		"vestig": "0.16.0",
+		"vestig": "0.18.0",
 		"web-vitals": "^4.2.4"
 	},
 	"devDependencies": {