otel-express-collector 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# OpenTelemetry Express Collector
+
+A comprehensive OpenTelemetry instrumentation package for Node.js Express microservices.
+
+## Features
+
+- **Automatic Instrumentation**: HTTP requests, database queries, and more
+- **Structured Logging**: Winston integration with OpenTelemetry export
+- **Metrics Collection**: HTTP, database, business, and system metrics
+- **Distributed Tracing**: End-to-end trace correlation
+- **Health Checks**: Built-in health, readiness, and liveness endpoints
+- **Decorators**: Easy method-level tracing with decorators
+- **TypeScript Support**: Full type definitions
+
+## Installation
+
+```bash
+npm install otel-express-collector
+# or
+yarn add otel-express-collector

package/dist/collector.d.ts

@@ -0,0 +1,35 @@
+import { LoggerProvider } from '@opentelemetry/sdk-logs';
+import { CollectorConfig } from './types';
+interface ResolvedCollectorConfig {
+    serviceName: string;
+    serviceVersion: string;
+    otlpEndpoint: string;
+    tracesEndpoint: string;
+    metricsEndpoint: string;
+    logsEndpoint: string;
+    enableTracing: boolean;
+    enableMetrics: boolean;
+    enableLogging: boolean;
+    enableConsoleExport: boolean;
+    metricExportInterval: number;
+    logBatchSize: number;
+    resourceAttributes: Record<string, string | number | boolean>;
+    instrumentations: string[];
+}
+export declare class OpenTelemetryCollector {
+    private sdk;
+    private loggerProvider;
+    private isInitialized;
+    private isStarted;
+    private config;
+    constructor(config: CollectorConfig);
+    private initialize;
+    private getInstrumentations;
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+    isRunning(): boolean;
+    getLoggerProvider(): LoggerProvider | null;
+    getConfig(): Readonly<ResolvedCollectorConfig>;
+}
+export {};
+//# sourceMappingURL=collector.d.ts.map

package/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,cAAc,EAIf,MAAM,yBAAyB,CAAC;AASjC,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK1C,UAAU,uBAAuB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IAEvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IAErB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAE7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IAErB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC9D,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,cAAc,CAA+B;IAErD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,eAAe;YAuCrB,UAAU;IA0ExB,OAAO,CAAC,mBAAmB;IAgBd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B,SAAS,IAAI,OAAO;IAIpB,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAK1C,SAAS,IAAI,QAAQ,CAAC,uBAAuB,CAAC;CAGtD"}

package/dist/collector.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryCollector = void 0;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const exporter_trace_otlp_grpc_1 = require("@opentelemetry/exporter-trace-otlp-grpc");
+const exporter_metrics_otlp_grpc_1 = require("@opentelemetry/exporter-metrics-otlp-grpc");
+const exporter_logs_otlp_grpc_1 = require("@opentelemetry/exporter-logs-otlp-grpc");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const sdk_logs_1 = require("@opentelemetry/sdk-logs");
+const api_logs_1 = require("@opentelemetry/api-logs");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const resources_1 = require("@opentelemetry/resources");
+const api_1 = require("@opentelemetry/api");
+class OpenTelemetryCollector {
+    constructor(config) {
+        this.sdk = null;
+        this.loggerProvider = null;
+        this.isInitialized = false;
+        this.isStarted = false;
+        if (!config.serviceName)
+            throw new Error('serviceName is required');
+        if (!config.serviceVersion)
+            throw new Error('serviceVersion is required');
+        const otlpEndpoint = config.otlpEndpoint ?? 'http://localhost:4317';
+        this.config = {
+            serviceName: config.serviceName,
+            serviceVersion: config.serviceVersion,
+            otlpEndpoint,
+            tracesEndpoint: config.tracesEndpoint ?? otlpEndpoint,
+            metricsEndpoint: config.metricsEndpoint ?? otlpEndpoint,
+            logsEndpoint: config.logsEndpoint ?? otlpEndpoint,
+            enableTracing: config.enableTracing ?? true,
+            enableMetrics: config.enableMetrics ?? true,
+            enableLogging: config.enableLogging ?? true,
+            enableConsoleExport: config.enableConsoleExport ?? false,
+            metricExportInterval: config.metricExportInterval ?? 60000,
+            logBatchSize: config.logBatchSize ?? 512,
+            resourceAttributes: config.resourceAttributes ?? {},
+            instrumentations: config.instrumentations ?? [],
+        };
+        if (process.env.NODE_ENV === 'development' ||
+            this.config.enableConsoleExport) {
+            api_1.diag.setLogger(new api_1.DiagConsoleLogger(), api_1.DiagLogLevel.DEBUG);
+        }
+    }
+    /* =========================
+       INITIALIZATION
+    ========================= */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        // ✅ DOC-ALIGNED RESOURCE ATTRIBUTES (PLAIN STRINGS)
+        const resource = (0, resources_1.resourceFromAttributes)({
+            'service.name': this.config.serviceName,
+            'service.version': this.config.serviceVersion,
+            'deployment.environment': process.env.NODE_ENV ?? 'development',
+            'process.runtime.name': 'nodejs',
+            'process.runtime.version': process.version,
+            ...this.config.resourceAttributes,
+        });
+        /* -------- Traces & Metrics -------- */
+        this.sdk = new sdk_node_1.NodeSDK({
+            resource,
+            traceExporter: this.config.enableTracing
+                ? this.config.enableConsoleExport
+                    ? new sdk_trace_base_1.ConsoleSpanExporter()
+                    : new exporter_trace_otlp_grpc_1.OTLPTraceExporter({ url: this.config.tracesEndpoint })
+                : undefined,
+            metricReader: this.config.enableMetrics
+                ? new sdk_metrics_1.PeriodicExportingMetricReader({
+                    exporter: this.config.enableConsoleExport
+                        ? new sdk_metrics_1.ConsoleMetricExporter()
+                        : new exporter_metrics_otlp_grpc_1.OTLPMetricExporter({ url: this.config.metricsEndpoint }),
+                    exportIntervalMillis: this.config.metricExportInterval,
+                })
+                : undefined,
+            instrumentations: this.getInstrumentations(),
+        });
+        /* -------- Logs (SDK-LOGS DOC-ALIGNED) -------- */
+        if (this.config.enableLogging) {
+            const logExporter = this.config.enableConsoleExport
+                ? new sdk_logs_1.ConsoleLogRecordExporter()
+                : new exporter_logs_otlp_grpc_1.OTLPLogExporter({ url: this.config.logsEndpoint });
+            this.loggerProvider = new sdk_logs_1.LoggerProvider({
+                resource,
+                loggerConfigurator: (0, sdk_logs_1.createLoggerConfigurator)([
+                    {
+                        pattern: '*',
+                        config: {
+                            minimumSeverity: api_logs_1.SeverityNumber.INFO,
+                            traceBased: false,
+                        },
+                    },
+                ]),
+                processors: [
+                    new sdk_logs_1.BatchLogRecordProcessor(logExporter, {
+                        maxExportBatchSize: this.config.logBatchSize,
+                    }),
+                ],
+            });
+            // REQUIRED by @opentelemetry/sdk-logs docs
+            api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
+        }
+        await this.sdk.start();
+        this.isInitialized = true;
+        this.isStarted = true;
+        console.log(`[otel] Started for ${this.config.serviceName}`);
+    }
+    /* =========================
+       INSTRUMENTATIONS
+    ========================= */
+    getInstrumentations() {
+        return [
+            (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+                '@opentelemetry/instrumentation-http': { enabled: true },
+                '@opentelemetry/instrumentation-express': {
+                    enabled: true,
+                    ignoreLayers: ['/health', '/metrics'],
+                },
+            }),
+        ];
+    }
+    /* =========================
+       LIFECYCLE
+    ========================= */
+    async start() {
+        if (!this.isStarted) {
+            await this.initialize();
+        }
+    }
+    async shutdown() {
+        if (!this.isStarted)
+            return;
+        await this.sdk?.shutdown();
+        await this.loggerProvider?.shutdown();
+        this.sdk = null;
+        this.loggerProvider = null;
+        this.isStarted = false;
+        this.isInitialized = false;
+        console.log('[otel] Shutdown complete');
+    }
+    /* =========================
+       HELPERS (TEST + API SAFE)
+    ========================= */
+    isRunning() {
+        return this.isStarted;
+    }
+    getLoggerProvider() {
+        return this.loggerProvider;
+    }
+    // ✅ ADDED BACK — fixes your test failure
+    getConfig() {
+        return this.config;
+    }
+}
+exports.OpenTelemetryCollector = OpenTelemetryCollector;
+//# sourceMappingURL=collector.js.map

package/dist/collector.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,16 @@
+import { Logger } from './logger';
+export interface TraceOptions {
+    /** Custom span name */
+    name?: string;
+    /** Span attributes */
+    attributes?: Record<string, any>;
+    /** Logger instance for logging */
+    logger?: Logger;
+    /** Log method arguments (default: false) */
+    logArguments?: boolean;
+    /** Log return value (default: false) */
+    logReturnValue?: boolean;
+}
+export declare function Trace(options?: TraceOptions): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function TraceAsync(options?: TraceOptions): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,IAE5C,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAoEjC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,IAEjD,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,wBAyCjC"}

package/dist/decorators.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Trace = Trace;
+exports.TraceAsync = TraceAsync;
+const api_1 = require("@opentelemetry/api");
+function Trace(options = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const className = target.constructor.name;
+        const spanName = options.name || `${className}.${propertyKey}`;
+        const logger = options.logger;
+        descriptor.value = async function (...args) {
+            const tracer = api_1.trace.getTracer(className);
+            return tracer.startActiveSpan(spanName, async (span) => {
+                try {
+                    // Add custom attributes
+                    if (options.attributes) {
+                        span.setAttributes(options.attributes);
+                    }
+                    // Add class and method names as attributes
+                    span.setAttribute('class.name', className);
+                    span.setAttribute('method.name', propertyKey);
+                    // Log method arguments if enabled
+                    if (options.logArguments && logger) {
+                        logger.debug(`Method ${spanName} called with arguments`, {
+                            arguments: args,
+                            traceId: span.spanContext().traceId,
+                        });
+                    }
+                    // Execute the original method
+                    const result = await originalMethod.apply(this, args);
+                    // Log return value if enabled
+                    if (options.logReturnValue && logger) {
+                        logger.debug(`Method ${spanName} returned`, {
+                            result,
+                            traceId: span.spanContext().traceId,
+                        });
+                    }
+                    span.setStatus({ code: api_1.SpanStatusCode.OK });
+                    span.end();
+                    return result;
+                }
+                catch (error) {
+                    // Record exception in span
+                    span.recordException(error);
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: error.message,
+                    });
+                    // Log error if logger is available
+                    if (logger) {
+                        logger.error(`Method ${spanName} failed`, {
+                            error: error.message,
+                            stack: error.stack,
+                            traceId: span.spanContext().traceId,
+                        });
+                    }
+                    span.end();
+                    throw error;
+                }
+            });
+        };
+        return descriptor;
+    };
+}
+function TraceAsync(options = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const className = target.constructor.name;
+        const spanName = options.name || `${className}.${propertyKey}`;
+        descriptor.value = function (...args) {
+            const tracer = api_1.trace.getTracer(className);
+            const promise = originalMethod.apply(this, args);
+            if (!(promise instanceof Promise)) {
+                return promise;
+            }
+            const span = tracer.startSpan(spanName, {
+                attributes: {
+                    'class.name': className,
+                    'method.name': propertyKey,
+                    ...options.attributes,
+                },
+            });
+            return promise
+                .then((result) => {
+                span.setStatus({ code: api_1.SpanStatusCode.OK });
+                span.end();
+                return result;
+            })
+                .catch((error) => {
+                span.recordException(error);
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: error.message,
+                });
+                span.end();
+                throw error;
+            });
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

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

package/dist/express.d.ts

@@ -0,0 +1,23 @@
+import { Request, Response, NextFunction, Application, Router } from 'express';
+import { Logger } from './logger';
+import { Metrics } from './metrics';
+export interface ExpressMiddlewareConfig {
+    /** Service name for logging */
+    serviceName: string;
+    /** Logger instance */
+    logger?: Logger;
+    /** Metrics instance */
+    metrics?: Metrics;
+    /** Paths to exclude from tracing */
+    excludePaths?: string[];
+    /** Enable request/response body logging (default: false) */
+    logBody?: boolean;
+    /** Maximum body size to log in bytes (default: 1024) */
+    maxBodyLogSize?: number;
+    /** Custom span name formatter */
+    spanNameFormatter?: (req: Request) => string;
+}
+export declare function createOpenTelemetryMiddleware(config: ExpressMiddlewareConfig): (req: Request, res: Response, next: NextFunction) => void;
+export declare function createErrorMiddleware(logger?: Logger): (error: Error, req: Request, res: Response, next: NextFunction) => void;
+export declare function configureExpressApp(app: Application | Router, config: ExpressMiddlewareConfig): void;
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE/E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9C;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,uBAAuB,IAWnE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UAsIxD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,IAC3C,OAAO,KAAK,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA6BtE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,GAAG,MAAM,EACzB,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAMN"}

package/dist/express.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenTelemetryMiddleware = createOpenTelemetryMiddleware;
+exports.createErrorMiddleware = createErrorMiddleware;
+exports.configureExpressApp = configureExpressApp;
+const api_1 = require("@opentelemetry/api");
+function createOpenTelemetryMiddleware(config) {
+    const { serviceName, logger, metrics, excludePaths = ['/health', '/metrics', '/favicon.ico'], logBody = false, maxBodyLogSize = 1024, spanNameFormatter = (req) => `${req.method} ${req.route?.path || req.path}` } = config;
+    return (req, res, next) => {
+        // Skip excluded paths
+        if (excludePaths.some(path => req.path.startsWith(path))) {
+            return next();
+        }
+        const startTime = Date.now();
+        const tracer = api_1.trace.getTracer(serviceName);
+        const spanName = spanNameFormatter(req);
+        // Create span for this request
+        const span = tracer.startSpan(spanName, {
+            attributes: {
+                'http.method': req.method,
+                'http.url': req.url,
+                'http.route': req.route?.path || req.path,
+                'http.host': req.headers.host,
+                'http.user_agent': req.headers['user-agent'],
+                'net.peer.ip': req.ip || req.socket.remoteAddress,
+            },
+        });
+        // Store trace context in request
+        req.traceId = span.spanContext().traceId;
+        req.spanId = span.spanContext().spanId;
+        req.startTime = startTime;
+        // Log request start
+        logger?.info('Incoming HTTP request', {
+            method: req.method,
+            url: req.url,
+            path: req.path,
+            query: req.query,
+            traceId: req.traceId,
+            ...(logBody && req.body && {
+                body: truncateBody(req.body, maxBodyLogSize)
+            }),
+        });
+        // Increment active requests counter
+        metrics?.incrementActiveRequests();
+        // Capture response
+        const originalSend = res.send;
+        let responseBody;
+        res.send = function (body) {
+            responseBody = body;
+            return originalSend.call(this, body);
+        };
+        res.on('finish', () => {
+            const duration = Date.now() - startTime;
+            const route = req.route?.path || req.path;
+            // Decrement active requests counter
+            metrics?.decrementActiveRequests();
+            // Update span with response information
+            span.setAttributes({
+                'http.status_code': res.statusCode,
+                'http.response_content_length': res.get('Content-Length') || '0',
+                'http.flavor': req.httpVersion,
+                'http.response.duration_ms': duration,
+            });
+            // Record metrics
+            metrics?.recordHttpRequest({
+                method: req.method,
+                route,
+                statusCode: res.statusCode,
+                duration,
+            });
+            // Record response size if available
+            const contentLength = res.get('Content-Length');
+            if (contentLength) {
+                metrics?.recordHttpResponseSize(parseInt(contentLength), req.method, route, res.statusCode);
+            }
+            // Log response
+            const logLevel = res.statusCode >= 400 ? 'warn' : 'info';
+            logger?.[logLevel]('HTTP request completed', {
+                method: req.method,
+                url: req.url,
+                statusCode: res.statusCode,
+                duration,
+                traceId: req.traceId,
+                ...(logBody && responseBody && {
+                    response: truncateBody(responseBody, maxBodyLogSize)
+                }),
+            });
+            // Set span status based on HTTP status code
+            if (res.statusCode >= 400) {
+                span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: `HTTP ${res.statusCode}`,
+                });
+            }
+            else {
+                span.setStatus({ code: api_1.SpanStatusCode.OK });
+            }
+            span.end();
+        });
+        // Handle errors
+        res.on('error', (error) => {
+            logger?.error('HTTP response error', {
+                error: error.message,
+                stack: error.stack,
+                method: req.method,
+                url: req.url,
+                traceId: req.traceId,
+            });
+            span.recordException(error);
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error.message,
+            });
+            span.end();
+        });
+        // Continue processing
+        api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), () => {
+            next();
+        });
+    };
+}
+function createErrorMiddleware(logger) {
+    return (error, req, res, next) => {
+        const span = api_1.trace.getActiveSpan();
+        logger?.error('Unhandled error in Express middleware', {
+            error: error.message,
+            stack: error.stack,
+            method: req.method,
+            url: req.url,
+            traceId: req.traceId,
+            spanId: req.spanId,
+        });
+        if (span) {
+            span.recordException(error);
+            span.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: error.message,
+            });
+        }
+        // Send error response
+        res.status(500).json({
+            error: 'Internal Server Error',
+            message: process.env.NODE_ENV === 'production'
+                ? 'An unexpected error occurred'
+                : error.message,
+            traceId: req.traceId,
+        });
+    };
+}
+function configureExpressApp(app, config) {
+    // Add OpenTelemetry middleware
+    app.use(createOpenTelemetryMiddleware(config));
+    // Add error handling middleware (should be last)
+    app.use(createErrorMiddleware(config.logger));
+}
+function truncateBody(body, maxSize) {
+    if (typeof body === 'string') {
+        return body.length > maxSize ? body.substring(0, maxSize) + '...' : body;
+    }
+    if (typeof body === 'object') {
+        const str = JSON.stringify(body);
+        return str.length > maxSize ? str.substring(0, maxSize) + '...' : body;
+    }
+    return body;
+}
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,28 @@
+import { Application, Router } from 'express';
+import { OpenTelemetryCollector } from './collector';
+import { Logger } from './logger';
+import { HealthStatus } from './types';
+export interface HealthCheckOptions {
+    /** Collector instance for checking OpenTelemetry health */
+    collector?: OpenTelemetryCollector;
+    /** Logger instance */
+    logger?: Logger;
+    /** Custom health checks */
+    checks?: Record<string, () => Promise<boolean>>;
+    /** Service name */
+    serviceName?: string;
+    /** Service version */
+    serviceVersion?: string;
+}
+export declare class HealthController {
+    private collector?;
+    private logger?;
+    private checks;
+    private serviceName;
+    private serviceVersion;
+    constructor(options?: HealthCheckOptions);
+    getHealthStatus(): Promise<HealthStatus>;
+    createHealthRouter(): Router;
+    registerHealthRoutes(app: Application | Router): void;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,sBAAsB,CAAC;IAEnC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhD,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAyB;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,GAAE,kBAAuB;IAQ/B,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAoC9C,kBAAkB,IAAI,MAAM;IA+E5B,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;CAI7D"}