@asenajs/asena-otel 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AsenaJs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,331 @@
+# @asenajs/asena-otel
+
+OpenTelemetry integration for AsenaJS — automatic HTTP tracing, method-level auto-tracing, metrics, and distributed tracing support.
+
+A single request automatically produces a full waterfall trace:
+
+```
+GET /api/users (SERVER)
+  └─ UserController.list (INTERNAL)
+       └─ UserService.getAll (INTERNAL)
+```
+
+## Installation
+
+```bash
+bun add @asenajs/asena-otel @opentelemetry/api @opentelemetry/resources @opentelemetry/sdk-trace-base @opentelemetry/sdk-metrics @opentelemetry/semantic-conventions @opentelemetry/context-async-hooks
+```
+
+## Quick Start
+
+### Step 1: Create an @Otel class
+
+Create a class that extends `OtelTracingPostProcessor` and apply the `@Otel` decorator with your configuration. Asena automatically discovers and initializes it during bootstrap.
+
+```typescript
+// src/otel/AppOtel.ts
+import { Otel, OtelTracingPostProcessor } from '@asenajs/asena-otel';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
+
+@Otel({
+  serviceName: 'my-app',
+  serviceVersion: '1.0.0',
+  traceExporter: new OTLPTraceExporter({
+    url: 'http://localhost:4318/v1/traces',
+  }),
+  metricReader: new PeriodicExportingMetricReader({
+    exporter: new OTLPMetricExporter({
+      url: 'http://localhost:4318/v1/metrics',
+    }),
+  }),
+  autoTrace: {
+    services: true,     // auto-trace @Service methods
+    controllers: true,  // auto-trace @Controller methods
+  },
+})
+export class AppOtel extends OtelTracingPostProcessor {}
+```
+
+### Step 2: Register OtelTracingMiddleware in your Config
+
+Add `OtelTracingMiddleware` to your config's `globalMiddlewares()`. This is required so that all HTTP requests are traced automatically.
+
+```typescript
+import { Config } from '@asenajs/asena/decorators';
+import { ConfigService, type Context, HttpException } from '@asenajs/ergenecore';
+import { OtelTracingMiddleware } from '@asenajs/asena-otel';
+import { AppCorsMiddleware } from '../middlewares/AppCorsMiddleware';
+
+@Config()
+export class AppConfig extends ConfigService {
+
+  public globalMiddlewares() {
+    return [
+      OtelTracingMiddleware,  // traces all HTTP requests automatically
+      AppCorsMiddleware,
+    ];
+  }
+
+  public onError(error: Error, context: Context) {
+    if (error instanceof HttpException) {
+      return context.send(error.body, error.status);
+    }
+    return context.send({ error: 'Internal Server Error' }, 500);
+  }
+
+}
+```
+
+That's it. Asena's IoC container automatically discovers `AppOtel`, `OtelService`, and `OtelTracingMiddleware`. All HTTP requests are traced, service methods are auto-traced, and metrics are collected — without changing any business logic.
+
+## Components
+
+### @Otel Decorator
+
+Configures an `OtelTracingPostProcessor` subclass with OpenTelemetry options. Apply it to a class extending `OtelTracingPostProcessor`:
+
+```typescript
+import { Otel, OtelTracingPostProcessor } from '@asenajs/asena-otel';
+
+@Otel({
+  serviceName: 'my-app',
+  traceExporter: exporter,
+  autoTrace: { services: true, controllers: true },
+})
+export class AppOtel extends OtelTracingPostProcessor {}
+```
+
+The decorator stores the options as metadata and applies `@PostProcessor()` automatically. During bootstrap, `@PostConstruct()` in `OtelTracingPostProcessor` reads the metadata and initializes the OpenTelemetry SDK — tracer provider, meter provider, context manager, and shutdown hooks.
+
+### OtelService
+
+Injectable `@Service` that provides access to OpenTelemetry tracer and meter. Use it for custom spans and distributed tracing. Asena automatically discovers and registers it.
+
+```typescript
+import { Inject } from '@asenajs/asena/decorators/ioc';
+import type { OtelService } from '@asenajs/asena-otel';
+
+@Service()
+export class OrderService {
+
+  @Inject('OtelService')
+  private otelService: OtelService;
+
+  async processOrder(orderId: string) {
+    return this.otelService.withSpan('process-order', async (span) => {
+      span.setAttribute('order.id', orderId);
+      // ... business logic
+      return { success: true };
+    });
+    // span automatically ends, errors are recorded
+  }
+
+}
+```
+
+**API:**
+- `tracer` — OpenTelemetry `Tracer` instance
+- `meter` — OpenTelemetry `Meter` instance
+- `withSpan(name, fn)` — creates a span, sets OK/ERROR status, records exceptions, ends span automatically
+- `getActiveSpan()` — returns current active span (or undefined)
+- `injectTraceContext(headers?)` — injects W3C `traceparent` header into a headers object for distributed tracing (see [Outgoing Request Context Propagation](#outgoing-request-context-propagation))
+
+**Expression injection** (for direct tracer/meter access):
+```typescript
+@Inject('OtelService', (s) => s.tracer)
+private tracer: Tracer;
+
+@Inject('OtelService', (s) => s.meter)
+private meter: Meter;
+```
+
+### OtelTracingMiddleware
+
+`@Middleware` that automatically traces all HTTP requests. Register in your Config's `globalMiddlewares()` to enable request tracing.
+
+**Creates for each request:**
+- A `SERVER` span named `"{METHOD} {PATH}"` (e.g., `GET /api/users`)
+- Attributes: `http.request.method`, `url.path`, `http.route` (after route matching), `http.response.status_code`
+- Metrics: `http.server.request.count` (Counter), `http.server.request.duration` (Histogram)
+- Extracts W3C `traceparent` header from incoming requests for distributed tracing
+
+### OtelTracingPostProcessor
+
+`@PostProcessor` that wraps Service and Controller methods with tracing spans via JavaScript Proxy.
+
+- Creates `INTERNAL` spans named `"{ClassName}.{methodName}"` (e.g., `UserService.getAll`)
+- Spans are automatically children of the HTTP span (proper waterfall hierarchy)
+- Controlled via `autoTrace` config in the `@Otel` decorator options
+- Skips private methods (`_` prefix), constructors, and Symbol properties
+
+## Configuration
+
+### AsenaOtelOptions
+
+```typescript
+interface AsenaOtelOptions {
+  serviceName: string;           // Required: identifies your service
+  serviceVersion?: string;       // Optional: defaults to '0.0.0'
+  traceExporter: SpanExporter;   // Required: where to send spans
+  metricReader?: MetricReader;   // Optional: enables metrics collection
+  autoTrace?: AutoTraceConfig;   // Optional: auto-trace settings
+  sampler?: Sampler;             // Optional: custom sampling strategy
+  ignoreRoutes?: string[];       // Optional: routes to exclude from tracing
+}
+
+interface AutoTraceConfig {
+  services?: boolean;     // auto-trace @Service methods (default: false)
+  controllers?: boolean;  // auto-trace @Controller methods (default: false)
+}
+```
+
+## Sampling
+
+Use `ratioBasedSampler()` for production environments to control trace volume:
+
+```typescript
+import { Otel, OtelTracingPostProcessor, ratioBasedSampler } from '@asenajs/asena-otel';
+
+@Otel({
+  serviceName: 'my-app',
+  traceExporter: exporter,
+  sampler: ratioBasedSampler(0.1),  // sample 10% of traces
+  autoTrace: { services: true, controllers: true },
+})
+export class AppOtel extends OtelTracingPostProcessor {}
+```
+
+`ratioBasedSampler(ratio)` creates a `ParentBasedSampler` wrapping `TraceIdRatioBasedSampler`. Root spans are sampled at the given ratio (0.0–1.0); child spans respect the parent's decision.
+
+## Route Exclusion
+
+Use `ignoreRoutes` to skip tracing on specific paths (e.g., health checks, metrics endpoints):
+
+```typescript
+@Otel({
+  serviceName: 'my-app',
+  traceExporter: exporter,
+  ignoreRoutes: ['/health', '/metrics', '/admin/*'],
+})
+export class AppOtel extends OtelTracingPostProcessor {}
+```
+
+- **Exact match:** `/health` matches only `/health`
+- **Wildcard suffix:** `/admin/*` matches `/admin/` and all sub-paths
+
+Ignored routes produce no spans and no metrics.
+
+## Outgoing Request Context Propagation
+
+`@asenajs/asena-otel` automatically traces **incoming** HTTP requests via `OtelTracingMiddleware` (extracts W3C `traceparent` header). However, **outgoing** HTTP calls (e.g., `fetch` to another service) are **not** automatically instrumented.
+
+Use `OtelService.injectTraceContext()` to manually propagate trace context to downstream services:
+
+```typescript
+@Service()
+export class PaymentClient {
+
+  @Inject('OtelService')
+  private otelService: OtelService;
+
+  async charge(payload: ChargeRequest) {
+    // injectTraceContext() adds the W3C traceparent header
+    const headers = this.otelService.injectTraceContext({
+      'Content-Type': 'application/json',
+    });
+
+    const res = await fetch('http://payment-service/api/charge', {
+      method: 'POST',
+      headers,
+      body: JSON.stringify(payload),
+    });
+
+    return res.json();
+  }
+
+}
+```
+
+For full visibility, combine with `withSpan()` to create a dedicated span for the outgoing call:
+
+```typescript
+async charge(payload: ChargeRequest) {
+  return this.otelService.withSpan('call-payment-service', async (span) => {
+    span.setAttribute('service.target', 'payment-service');
+
+    const headers = this.otelService.injectTraceContext();
+    const res = await fetch('http://payment-service/api/charge', {
+      method: 'POST',
+      headers: { ...headers, 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    });
+
+    return res.json();
+  });
+}
+```
+
+This writes a `traceparent` header in the format `00-{traceId}-{spanId}-{traceFlags}`. The downstream service extracts this header to continue the same trace, enabling end-to-end distributed tracing across microservices.
+
+## Testing
+
+Use `InMemorySpanExporter` and `InMemoryMetricExporter` for testing:
+
+```typescript
+import { Otel, OtelTracingPostProcessor } from '@asenajs/asena-otel';
+import { InMemorySpanExporter } from '@opentelemetry/sdk-trace-base';
+import { InMemoryMetricExporter, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+
+const spanExporter = new InMemorySpanExporter();
+const metricExporter = new InMemoryMetricExporter();
+const metricReader = new PeriodicExportingMetricReader({
+  exporter: metricExporter,
+  exportIntervalMillis: 100,
+});
+
+@Otel({
+  serviceName: 'test-service',
+  traceExporter: spanExporter,
+  metricReader,
+  autoTrace: { services: true, controllers: true },
+})
+export class TestOtel extends OtelTracingPostProcessor {}
+```
+
+After making requests, flush spans (`BatchSpanProcessor` is lazy):
+
+```typescript
+import { trace } from '@opentelemetry/api';
+
+const provider = trace.getTracerProvider() as any;
+await provider.forceFlush?.();
+const spans = spanExporter.getFinishedSpans();
+```
+
+For metrics, wait for periodic export then read from exporter:
+
+```typescript
+await metricReader.forceFlush();
+const metrics = metricExporter.getMetrics();
+```
+
+### Verifying parent-child hierarchy
+
+In OpenTelemetry SDK v2, use `parentSpanContext` (not `parentSpanId`):
+
+```typescript
+const httpSpan = spans.find(s => s.kind === SpanKind.SERVER);
+const serviceSpan = spans.find(s => s.name.includes('UserService'));
+
+// Same trace
+expect(serviceSpan.spanContext().traceId).toBe(httpSpan.spanContext().traceId);
+
+// Parent-child link (SDK v2)
+expect(serviceSpan.parentSpanContext?.spanId).toBe(httpSpan.spanContext().spanId);
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Otel } from './lib/decorators';
+export { OtelConstants } from './lib/constants/OtelConstants';
+export { OtelTracingPostProcessor } from './lib/postprocessor/OtelTracingPostProcessor';
+export { OtelService } from './lib/services/OtelService';
+export { OtelTracingMiddleware } from './lib/middleware/OtelTracingMiddleware';
+export { ratioBasedSampler } from './lib/samplers';
+export { isRouteIgnored } from './lib/shared/OtelRuntimeConfig';
+export type { AsenaOtelOptions, AutoTraceConfig } from './lib/types';
+export type { Sampler } from '@opentelemetry/sdk-trace-base';

package/dist/index.js

@@ -0,0 +1,15 @@
+// Decorator
+export { Otel } from './lib/decorators';
+// Constants
+export { OtelConstants } from './lib/constants/OtelConstants';
+// PostProcessor
+export { OtelTracingPostProcessor } from './lib/postprocessor/OtelTracingPostProcessor';
+// Service
+export { OtelService } from './lib/services/OtelService';
+// Middleware
+export { OtelTracingMiddleware } from './lib/middleware/OtelTracingMiddleware';
+// Samplers
+export { ratioBasedSampler } from './lib/samplers';
+// Runtime config utilities
+export { isRouteIgnored } from './lib/shared/OtelRuntimeConfig';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,gBAAgB;AAChB,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAExF,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,aAAa;AACb,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,2BAA2B;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/lib/OtelConfig.d.ts

@@ -0,0 +1,15 @@
+import type { Sampler, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import type { MetricReader } from '@opentelemetry/sdk-metrics';
+export interface AutoTraceConfig {
+    services?: boolean;
+    controllers?: boolean;
+}
+export interface AsenaOtelOptions {
+    serviceName: string;
+    serviceVersion?: string;
+    traceExporter: SpanExporter;
+    metricReader?: MetricReader;
+    autoTrace?: AutoTraceConfig;
+    sampler?: Sampler;
+    ignoreRoutes?: string[];
+}

package/dist/lib/OtelConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OtelConfig.js.map

package/dist/lib/OtelConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelConfig.js","sourceRoot":"","sources":["../../lib/OtelConfig.ts"],"names":[],"mappings":""}

package/dist/lib/constants/OtelConstants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Metadata constants for OTel decorators.
+ * Uses Symbols to prevent naming collisions.
+ */
+export declare class OtelConstants {
+    /**
+     * @Otel() decorator metadata key.
+     * Stores AsenaOtelOptions on the PostProcessor subclass.
+     */
+    static readonly OptionsKey: unique symbol;
+}

package/dist/lib/constants/OtelConstants.js

@@ -0,0 +1,12 @@
+/**
+ * Metadata constants for OTel decorators.
+ * Uses Symbols to prevent naming collisions.
+ */
+export class OtelConstants {
+    /**
+     * @Otel() decorator metadata key.
+     * Stores AsenaOtelOptions on the PostProcessor subclass.
+     */
+    static OptionsKey = Symbol('otel:options');
+}
+//# sourceMappingURL=OtelConstants.js.map

package/dist/lib/constants/OtelConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelConstants.js","sourceRoot":"","sources":["../../../lib/constants/OtelConstants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,aAAa;IAExB;;;OAGG;IACI,MAAM,CAAU,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/dist/lib/decorators/Otel.d.ts

@@ -0,0 +1,20 @@
+import type { AsenaOtelOptions } from '../OtelConfig';
+/**
+ * Decorator that configures an OTel Tracing PostProcessor.
+ *
+ * Apply to a class extending `OtelTracingPostProcessor` to automatically:
+ * 1. Initialize the OpenTelemetry SDK (tracer + meter providers)
+ * 2. Auto-trace Service and Controller methods via Proxy
+ * 3. Register shutdown hooks for graceful cleanup
+ *
+ * @example
+ * ```typescript
+ * @Otel({
+ *   serviceName: 'my-app',
+ *   traceExporter: new OTLPTraceExporter({ url: 'http://jaeger:4318/v1/traces' }),
+ *   autoTrace: { services: true, controllers: true },
+ * })
+ * export class AppOtel extends OtelTracingPostProcessor {}
+ * ```
+ */
+export declare function Otel(options: AsenaOtelOptions): <T extends new (...args: any[]) => any>(target: T) => T;

package/dist/lib/decorators/Otel.js

@@ -0,0 +1,28 @@
+import { PostProcessor } from '@asenajs/asena/decorators';
+import { defineTypedMetadata } from '@asenajs/asena/utils';
+import { OtelConstants } from '../constants/OtelConstants';
+/**
+ * Decorator that configures an OTel Tracing PostProcessor.
+ *
+ * Apply to a class extending `OtelTracingPostProcessor` to automatically:
+ * 1. Initialize the OpenTelemetry SDK (tracer + meter providers)
+ * 2. Auto-trace Service and Controller methods via Proxy
+ * 3. Register shutdown hooks for graceful cleanup
+ *
+ * @example
+ * ```typescript
+ * @Otel({
+ *   serviceName: 'my-app',
+ *   traceExporter: new OTLPTraceExporter({ url: 'http://jaeger:4318/v1/traces' }),
+ *   autoTrace: { services: true, controllers: true },
+ * })
+ * export class AppOtel extends OtelTracingPostProcessor {}
+ * ```
+ */
+export function Otel(options) {
+    return function (target) {
+        defineTypedMetadata(OtelConstants.OptionsKey, options, target);
+        return PostProcessor()(target);
+    };
+}
+//# sourceMappingURL=Otel.js.map

package/dist/lib/decorators/Otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Otel.js","sourceRoot":"","sources":["../../../lib/decorators/Otel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAC,OAAyB;IAC5C,OAAO,UAAiD,MAAS;QAC/D,mBAAmB,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/D,OAAO,aAAa,EAAE,CAAC,MAAM,CAAM,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/decorators/index.d.ts

@@ -0,0 +1 @@
+export { Otel } from './Otel';

package/dist/lib/decorators/index.js

@@ -0,0 +1,2 @@
+export { Otel } from './Otel';
+//# sourceMappingURL=index.js.map

package/dist/lib/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}

package/dist/lib/middleware/OtelTracingMiddleware.d.ts

@@ -0,0 +1,10 @@
+import { AsenaMiddlewareService } from '@asenajs/asena/middleware';
+import type { AsenaContext } from '@asenajs/asena/adapter';
+export declare class OtelTracingMiddleware extends AsenaMiddlewareService {
+    private tracer;
+    private meter;
+    private requestCounter;
+    private requestDuration;
+    onInit(): void;
+    handle(ctx: AsenaContext<any, any>, next: () => Promise<void>): Promise<void>;
+}

package/dist/lib/middleware/OtelTracingMiddleware.js

@@ -0,0 +1,94 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { trace, metrics } from '@opentelemetry/api';
+import { context as otelContext, propagation, SpanKind, SpanStatusCode, } from '@opentelemetry/api';
+import { ATTR_HTTP_REQUEST_METHOD, ATTR_HTTP_RESPONSE_STATUS_CODE, ATTR_HTTP_ROUTE, ATTR_URL_PATH, } from '@opentelemetry/semantic-conventions';
+import { AsenaMiddlewareService } from '@asenajs/asena/middleware';
+import { Middleware } from '@asenajs/asena/decorators';
+import { PostConstruct } from '@asenajs/asena/decorators/ioc';
+import { isRouteIgnored } from '../shared/OtelRuntimeConfig';
+const LIBRARY_NAME = '@asenajs/asena-otel';
+let OtelTracingMiddleware = class OtelTracingMiddleware extends AsenaMiddlewareService {
+    tracer;
+    meter;
+    requestCounter;
+    requestDuration;
+    onInit() {
+        this.tracer = trace.getTracer(LIBRARY_NAME);
+        this.meter = metrics.getMeter(LIBRARY_NAME);
+        this.requestCounter = this.meter.createCounter('http.server.request.count', {
+            description: 'Total number of HTTP requests',
+        });
+        this.requestDuration = this.meter.createHistogram('http.server.request.duration', {
+            description: 'HTTP request duration in milliseconds',
+            unit: 'ms',
+        });
+    }
+    async handle(ctx, next) {
+        const startTime = performance.now();
+        const method = ctx.req?.method ?? 'UNKNOWN';
+        const url = ctx.req?.url ? new URL(ctx.req.url).pathname : '/';
+        // Check ignoreRoutes against static URL path (before route matching)
+        if (isRouteIgnored(url)) {
+            await next();
+            return;
+        }
+        // Extract W3C traceparent from incoming request headers
+        const parentContext = propagation.extract(otelContext.active(), ctx.headers);
+        await this.tracer.startActiveSpan(`${method} ${url}`, { kind: SpanKind.SERVER }, parentContext, async (span) => {
+            span.setAttribute(ATTR_HTTP_REQUEST_METHOD, method);
+            span.setAttribute(ATTR_URL_PATH, url);
+            try {
+                await next();
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            catch (error) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                span.recordException(error);
+                throw error;
+            }
+            finally {
+                const duration = performance.now() - startTime;
+                // Read routePattern AFTER next() — in Hono, route matching happens during next()
+                const raw = ctx.routePattern;
+                const trimmed = raw && raw.length > 1 && raw.endsWith('/') ? raw.slice(0, -1) : raw;
+                const routePattern = trimmed && trimmed !== '/*' ? trimmed : undefined;
+                if (routePattern) {
+                    span.updateName(`${method} ${routePattern}`);
+                    span.setAttribute(ATTR_HTTP_ROUTE, routePattern);
+                }
+                const metricRoute = routePattern || url;
+                const attributes = {
+                    [ATTR_HTTP_REQUEST_METHOD]: method,
+                    [ATTR_URL_PATH]: metricRoute,
+                };
+                const statusCode = ctx.res?.status;
+                if (statusCode !== undefined) {
+                    span.setAttribute(ATTR_HTTP_RESPONSE_STATUS_CODE, statusCode);
+                    attributes[ATTR_HTTP_RESPONSE_STATUS_CODE] = statusCode;
+                }
+                this.requestCounter.add(1, attributes);
+                this.requestDuration.record(duration, attributes);
+                span.end();
+            }
+        });
+    }
+};
+__decorate([
+    PostConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], OtelTracingMiddleware.prototype, "onInit", null);
+OtelTracingMiddleware = __decorate([
+    Middleware()
+], OtelTracingMiddleware);
+export { OtelTracingMiddleware };
+//# sourceMappingURL=OtelTracingMiddleware.js.map

package/dist/lib/middleware/OtelTracingMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelTracingMiddleware.js","sourceRoot":"","sources":["../../../lib/middleware/OtelTracingMiddleware.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAc,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,OAAO,IAAI,WAAW,EAGtB,WAAW,EACX,QAAQ,EACR,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,eAAe,EACf,aAAa,GACd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAGpC,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,sBAAsB;IAEvD,MAAM,CAAU;IAEhB,KAAK,CAAS;IAEd,cAAc,CAAW;IAEzB,eAAe,CAAa;IAG7B,MAAM;QACX,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAE5C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,2BAA2B,EAAE;YAC1E,WAAW,EAAE,+BAA+B;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,8BAA8B,EAAE;YAChF,WAAW,EAAE,uCAAuC;YACpD,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAA2B,EAAE,IAAyB;QACxE,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC;QAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/D,qEAAqE;QACrE,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,EAAE,CAAC;YAEb,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7E,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC7G,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAEtC,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAC;gBAEb,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClF,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;gBAErC,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAE/C,iFAAiF;gBACjF,MAAM,GAAG,GAAI,GAAW,CAAC,YAAkC,CAAC;gBAC5D,MAAM,OAAO,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBACpF,MAAM,YAAY,GAAG,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEvE,IAAI,YAAY,EAAE,CAAC;oBACjB,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC,CAAC;oBAC7C,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;gBACnD,CAAC;gBAED,MAAM,WAAW,GAAG,YAAY,IAAI,GAAG,CAAC;gBAExC,MAAM,UAAU,GAAoC;oBAClD,CAAC,wBAAwB,CAAC,EAAE,MAAM;oBAClC,CAAC,aAAa,CAAC,EAAE,WAAW;iBAC7B,CAAC;gBAEF,MAAM,UAAU,GAAI,GAAG,CAAC,GAAW,EAAE,MAA4B,CAAC;gBAElE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;oBAC7B,IAAI,CAAC,YAAY,CAAC,8BAA8B,EAAE,UAAU,CAAC,CAAC;oBAC9D,UAAU,CAAC,8BAA8B,CAAC,GAAG,UAAU,CAAC;gBAC1D,CAAC;gBAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBACvC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAElD,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CAEF,CAAA;AA9EQ;IADN,aAAa,EAAE;;;;mDAaf;AAvBU,qBAAqB;IADjC,UAAU,EAAE;GACA,qBAAqB,CAyFjC"}

package/dist/lib/postprocessor/OtelTracingPostProcessor.d.ts

@@ -0,0 +1,19 @@
+import { BasicTracerProvider } from '@opentelemetry/sdk-trace-base';
+import { MeterProvider } from '@opentelemetry/sdk-metrics';
+import type { ComponentPostProcessor } from '@asenajs/asena/ioc/types';
+export declare class OtelTracingPostProcessor implements ComponentPostProcessor {
+    protected tracerProvider: BasicTracerProvider | null;
+    protected meterProvider: MeterProvider | null;
+    private tracer;
+    private autoTraceConfig;
+    onInit(): void;
+    postProcess<T>(instance: T, Class: any): T;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private getOptions;
+    private setupContextManager;
+    private setupTracing;
+    private setupMetrics;
+    private registerShutdownHook;
+    private getComponentType;
+}

package/dist/lib/postprocessor/OtelTracingPostProcessor.js

@@ -0,0 +1,164 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { trace, metrics, context, propagation, SpanKind, SpanStatusCode } from '@opentelemetry/api';
+import { AsyncLocalStorageContextManager } from '@opentelemetry/context-async-hooks';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';
+import { BasicTracerProvider, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { MeterProvider } from '@opentelemetry/sdk-metrics';
+import { getMetadata } from 'reflect-metadata/no-conflict';
+import { PostConstruct } from '@asenajs/asena/decorators/ioc';
+import { getOwnTypedMetadata } from '@asenajs/asena/utils';
+import { OtelConstants } from '../constants/OtelConstants';
+import { otelRuntimeConfig } from '../shared/OtelRuntimeConfig';
+const COMPONENT_TYPE_SERVICE = 'SERVICE';
+const COMPONENT_TYPE_CONTROLLER = 'CONTROLLER';
+const LIBRARY_NAME = '@asenajs/asena-otel';
+export class OtelTracingPostProcessor {
+    tracerProvider = null;
+    meterProvider = null;
+    tracer;
+    autoTraceConfig = {};
+    onInit() {
+        const options = this.getOptions();
+        if (!options)
+            return;
+        const resource = resourceFromAttributes({
+            [ATTR_SERVICE_NAME]: options.serviceName,
+            [ATTR_SERVICE_VERSION]: options.serviceVersion ?? '0.0.0',
+        });
+        this.setupContextManager();
+        this.setupTracing(resource, options.traceExporter, options.sampler);
+        if (options.metricReader) {
+            this.setupMetrics(resource, options.metricReader);
+        }
+        this.autoTraceConfig = options.autoTrace ?? {};
+        otelRuntimeConfig.ignoreRoutes = options.ignoreRoutes ?? [];
+        this.tracer = trace.getTracer(LIBRARY_NAME);
+        this.registerShutdownHook();
+    }
+    postProcess(instance, Class) {
+        const config = this.autoTraceConfig;
+        const componentType = this.getComponentType(Class);
+        if (!componentType)
+            return instance;
+        if (componentType === COMPONENT_TYPE_SERVICE && !config.services)
+            return instance;
+        if (componentType === COMPONENT_TYPE_CONTROLLER && !config.controllers)
+            return instance;
+        const className = Class.name;
+        const tracer = this.tracer;
+        return new Proxy(instance, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value !== 'function')
+                    return value;
+                if (prop === 'constructor' || typeof prop === 'symbol')
+                    return value;
+                if (String(prop).startsWith('_'))
+                    return value;
+                const spanName = `${className}.${String(prop)}`;
+                return function (...args) {
+                    const span = tracer.startSpan(spanName, { kind: SpanKind.INTERNAL });
+                    const spanContext = trace.setSpan(context.active(), span);
+                    let result;
+                    try {
+                        result = context.with(spanContext, () => value.apply(target, args));
+                    }
+                    catch (error) {
+                        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                        span.recordException(error);
+                        span.end();
+                        throw error;
+                    }
+                    if (result instanceof Promise) {
+                        return result
+                            .then((resolved) => {
+                            span.setStatus({ code: SpanStatusCode.OK });
+                            span.end();
+                            return resolved;
+                        })
+                            .catch((error) => {
+                            span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                            span.recordException(error);
+                            span.end();
+                            throw error;
+                        });
+                    }
+                    span.setStatus({ code: SpanStatusCode.OK });
+                    span.end();
+                    return result;
+                };
+            },
+        });
+    }
+    async forceFlush() {
+        if (this.tracerProvider) {
+            await this.tracerProvider.forceFlush();
+        }
+        if (this.meterProvider) {
+            await this.meterProvider.forceFlush();
+        }
+    }
+    async shutdown() {
+        if (this.tracerProvider) {
+            await this.tracerProvider.shutdown();
+            this.tracerProvider = null;
+        }
+        if (this.meterProvider) {
+            await this.meterProvider.shutdown();
+            this.meterProvider = null;
+        }
+        context.disable();
+    }
+    getOptions() {
+        return getOwnTypedMetadata(OtelConstants.OptionsKey, this.constructor);
+    }
+    setupContextManager() {
+        const contextManager = new AsyncLocalStorageContextManager();
+        contextManager.enable();
+        context.setGlobalContextManager(contextManager);
+        propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    }
+    setupTracing(resource, exporter, sampler) {
+        this.tracerProvider = new BasicTracerProvider({
+            resource,
+            spanProcessors: [new BatchSpanProcessor(exporter)],
+            sampler,
+        });
+        trace.setGlobalTracerProvider(this.tracerProvider);
+    }
+    setupMetrics(resource, reader) {
+        this.meterProvider = new MeterProvider({ resource, readers: [reader] });
+        metrics.setGlobalMeterProvider(this.meterProvider);
+    }
+    registerShutdownHook() {
+        const shutdown = async () => {
+            await this.shutdown();
+        };
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
+    }
+    getComponentType(Class) {
+        if (getMetadata(COMPONENT_TYPE_SERVICE, Class))
+            return COMPONENT_TYPE_SERVICE;
+        if (getMetadata(COMPONENT_TYPE_CONTROLLER, Class))
+            return COMPONENT_TYPE_CONTROLLER;
+        return null;
+    }
+}
+__decorate([
+    PostConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], OtelTracingPostProcessor.prototype, "onInit", null);
+//# sourceMappingURL=OtelTracingPostProcessor.js.map

package/dist/lib/postprocessor/OtelTracingPostProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelTracingPostProcessor.js","sourceRoot":"","sources":["../../../lib/postprocessor/OtelTracingPostProcessor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAe,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAiB,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAmC,MAAM,+BAA+B,CAAC;AACzH,OAAO,EAAE,aAAa,EAAqB,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,sBAAsB,GAAG,SAAS,CAAC;AACzC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAC/C,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,MAAM,OAAO,wBAAwB;IAEzB,cAAc,GAA+B,IAAI,CAAC;IAElD,aAAa,GAAyB,IAAI,CAAC;IAE7C,MAAM,CAAU;IAEhB,eAAe,GAAoB,EAAE,CAAC;IAGvC,MAAM;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAElC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,QAAQ,GAAG,sBAAsB,CAAC;YACtC,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,WAAW;YACxC,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO;SAC1D,CAAC,CAAC;QAEH,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QAC/C,iBAAiB,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAE5C,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAEM,WAAW,CAAI,QAAW,EAAE,KAAU;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;QACpC,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAEnD,IAAI,CAAC,aAAa;YAAE,OAAO,QAAQ,CAAC;QAEpC,IAAI,aAAa,KAAK,sBAAsB,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAElF,IAAI,aAAa,KAAK,yBAAyB,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,QAAQ,CAAC;QAExF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,OAAO,IAAI,KAAK,CAAC,QAAkB,EAAE;YACnC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;gBACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAElD,IAAI,OAAO,KAAK,KAAK,UAAU;oBAAE,OAAO,KAAK,CAAC;gBAE9C,IAAI,IAAI,KAAK,aAAa,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAErE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAE/C,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAEhD,OAAO,UAAqB,GAAG,IAAW;oBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACrE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;oBAE1D,IAAI,MAAW,CAAC;oBAEhB,IAAI,CAAC;wBACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;oBACtE,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;wBAClF,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;wBACrC,IAAI,CAAC,GAAG,EAAE,CAAC;wBAEX,MAAM,KAAK,CAAC;oBACd,CAAC;oBAED,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;wBAC9B,OAAO,MAAM;6BACV,IAAI,CAAC,CAAC,QAAa,EAAE,EAAE;4BACtB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;4BAEX,OAAO,QAAQ,CAAC;wBAClB,CAAC,CAAC;6BACD,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;4BACtB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;4BACvE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;4BAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;4BAEX,MAAM,KAAK,CAAC;wBACd,CAAC,CAAC,CAAC;oBACP,CAAC;oBAED,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;oBAEX,OAAO,MAAM,CAAC;gBAChB,CAAC,CAAC;YACJ,CAAC;SACF,CAAM,CAAC;IACV,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QACzC,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;IAEO,UAAU;QAChB,OAAO,mBAAmB,CAAmB,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3F,CAAC;IAEO,mBAAmB;QACzB,MAAM,cAAc,GAAG,IAAI,+BAA+B,EAAE,CAAC;QAE7D,cAAc,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QAChD,WAAW,CAAC,mBAAmB,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,YAAY,CAAC,QAAkB,EAAE,QAAsB,EAAE,OAAiB;QAChF,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAmB,CAAC;YAC5C,QAAQ;YACR,cAAc,EAAE,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO;SACR,CAAC,CAAC;QAEH,KAAK,CAAC,uBAAuB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IAEO,YAAY,CAAC,QAAkB,EAAE,MAAoB;QAC3D,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAEO,oBAAoB;QAC1B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAEO,gBAAgB,CAAC,KAAU;QACjC,IAAI,WAAW,CAAC,sBAAsB,EAAE,KAAK,CAAC;YAAE,OAAO,sBAAsB,CAAC;QAE9E,IAAI,WAAW,CAAC,yBAAyB,EAAE,KAAK,CAAC;YAAE,OAAO,yBAAyB,CAAC;QAEpF,OAAO,IAAI,CAAC;IACd,CAAC;CAEF;AA/JQ;IADN,aAAa,EAAE;;;;sDAuBf"}

package/dist/lib/samplers/index.d.ts

@@ -0,0 +1,8 @@
+import { type Sampler } from '@opentelemetry/sdk-trace-base';
+/**
+ * Creates a production-ready ratio-based sampler.
+ * Root spans are sampled at the given ratio; child spans respect the parent's decision.
+ *
+ * @param ratio - Fraction of traces to sample (0.0 to 1.0). Default 0.1 (10%).
+ */
+export declare function ratioBasedSampler(ratio?: number): Sampler;

package/dist/lib/samplers/index.js

@@ -0,0 +1,13 @@
+import { ParentBasedSampler, TraceIdRatioBasedSampler } from '@opentelemetry/sdk-trace-base';
+/**
+ * Creates a production-ready ratio-based sampler.
+ * Root spans are sampled at the given ratio; child spans respect the parent's decision.
+ *
+ * @param ratio - Fraction of traces to sample (0.0 to 1.0). Default 0.1 (10%).
+ */
+export function ratioBasedSampler(ratio = 0.1) {
+    return new ParentBasedSampler({
+        root: new TraceIdRatioBasedSampler(ratio),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/samplers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/samplers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAgB,MAAM,+BAA+B,CAAC;AAE3G;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAG,GAAG;IAC3C,OAAO,IAAI,kBAAkB,CAAC;QAC5B,IAAI,EAAE,IAAI,wBAAwB,CAAC,KAAK,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/services/OtelService.d.ts

@@ -0,0 +1,11 @@
+import { type Tracer, type Meter, type Span } from '@opentelemetry/api';
+export declare class OtelService {
+    private _tracer;
+    private _meter;
+    onInit(): void;
+    get tracer(): Tracer;
+    get meter(): Meter;
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+    getActiveSpan(): Span | undefined;
+    injectTraceContext(headers?: Record<string, string>): Record<string, string>;
+}

package/dist/lib/services/OtelService.js

@@ -0,0 +1,62 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { trace, metrics, context, propagation } from '@opentelemetry/api';
+import { Service } from '@asenajs/asena/decorators';
+import { PostConstruct } from '@asenajs/asena/decorators/ioc';
+const LIBRARY_NAME = '@asenajs/asena-otel';
+let OtelService = class OtelService {
+    _tracer;
+    _meter;
+    onInit() {
+        this._tracer = trace.getTracer(LIBRARY_NAME);
+        this._meter = metrics.getMeter(LIBRARY_NAME);
+    }
+    get tracer() {
+        return this._tracer;
+    }
+    get meter() {
+        return this._meter;
+    }
+    async withSpan(name, fn) {
+        return this._tracer.startActiveSpan(name, async (span) => {
+            try {
+                const result = await fn(span);
+                span.setStatus({ code: 1 }); // SpanStatusCode.OK
+                return result;
+            }
+            catch (error) {
+                span.setStatus({ code: 2 }); // SpanStatusCode.ERROR
+                span.recordException(error);
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    getActiveSpan() {
+        return trace.getSpan(context.active());
+    }
+    injectTraceContext(headers = {}) {
+        propagation.inject(context.active(), headers);
+        return headers;
+    }
+};
+__decorate([
+    PostConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], OtelService.prototype, "onInit", null);
+OtelService = __decorate([
+    Service('OtelService')
+], OtelService);
+export { OtelService };
+//# sourceMappingURL=OtelService.js.map

package/dist/lib/services/OtelService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelService.js","sourceRoot":"","sources":["../../../lib/services/OtelService.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAsC,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAGpC,IAAM,WAAW,GAAjB,MAAM,WAAW;IAEd,OAAO,CAAU;IAEjB,MAAM,CAAS;IAGhB,MAAM;QACX,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAI,IAAY,EAAE,EAA8B;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;gBAE9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB;gBAEjD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB;gBACpD,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;gBAErC,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,aAAa;QAClB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAEM,kBAAkB,CAAC,UAAkC,EAAE;QAC5D,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAE9C,OAAO,OAAO,CAAC;IACjB,CAAC;CAEF,CAAA;AA1CQ;IADN,aAAa,EAAE;;;;yCAIf;AAVU,WAAW;IADvB,OAAO,CAAC,aAAa,CAAC;GACV,WAAW,CAiDvB"}

package/dist/lib/shared/OtelRuntimeConfig.d.ts

@@ -0,0 +1,8 @@
+export declare const otelRuntimeConfig: {
+    ignoreRoutes: string[];
+};
+/**
+ * Check if a route path should be excluded from tracing.
+ * Supports exact match and wildcard suffix (e.g., `/admin/*`).
+ */
+export declare function isRouteIgnored(path: string): boolean;

package/dist/lib/shared/OtelRuntimeConfig.js

@@ -0,0 +1,21 @@
+export const otelRuntimeConfig = {
+    ignoreRoutes: [],
+};
+/**
+ * Check if a route path should be excluded from tracing.
+ * Supports exact match and wildcard suffix (e.g., `/admin/*`).
+ */
+export function isRouteIgnored(path) {
+    for (const route of otelRuntimeConfig.ignoreRoutes) {
+        if (route.endsWith('*')) {
+            if (path.startsWith(route.slice(0, -1)))
+                return true;
+        }
+        else {
+            if (path === route)
+                return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=OtelRuntimeConfig.js.map

package/dist/lib/shared/OtelRuntimeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelRuntimeConfig.js","sourceRoot":"","sources":["../../../lib/shared/OtelRuntimeConfig.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,EAAc;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,KAAK,MAAM,KAAK,IAAI,iBAAiB,CAAC,YAAY,EAAE,CAAC;QACnD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/types/index.d.ts

@@ -0,0 +1 @@
+export type { AsenaOtelOptions, AutoTraceConfig } from '../OtelConfig';

package/dist/lib/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@asenajs/asena-otel",
+  "version": "1.0.0",
+  "author": "LibirSoft",
+  "description": "OpenTelemetry integration for AsenaJS - auto-tracing, HTTP metrics, distributed tracing",
+  "main": "dist/index.js",
+  "module": "index.ts",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AsenaJs/asena-otel.git"
+  },
+  "scripts": {
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "build": "bun run clean && tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "bun run build && changeset publish"
+  },
+  "devDependencies": {
+    "@asenajs/asena": "^0.7.1",
+    "@changesets/cli": "^2.30.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/resources": "^2.6.1",
+    "@opentelemetry/sdk-metrics": "^2.6.1",
+    "@opentelemetry/sdk-trace-base": "^2.6.1",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@types/bun": "latest",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "eslint": "^8.57.1",
+    "eslint-config-alloy": "^5.1.2",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-alloy": "^1.2.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^16.6.2",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-promise": "^6.6.0",
+    "prettier": "^3.8.2",
+    "reflect-metadata": "^0.2.2"
+  },
+  "peerDependencies": {
+    "@asenajs/asena": "^0.7.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/resources": "^2.6.0",
+    "@opentelemetry/sdk-metrics": "^2.6.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@opentelemetry/context-async-hooks": "^2.6.0",
+    "reflect-metadata": "^0.2.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@opentelemetry/context-async-hooks": "^2.6.1"
+  }
+}