@vtvlive/interactive-apm 0.0.2 → 0.0.3

package/README.md

@@ -8,7 +8,10 @@
 - **NestJS Integration**: Ready-to-use module with dependency injection
 - **Standalone Usage**: Works without NestJS for vanilla TypeScript/JavaScript projects
 - **Flexible Configuration**: Configure via environment variables or programmatic options
+- **Debug Mode**: Comprehensive logging for troubleshooting connection issues
+- **OTLP Transport Options**: Support for HTTP, gRPC, and PROTO (protobuf over HTTP) transports
 - **TypeScript Support**: Fully typed with TypeScript
+- **Auto Transaction Naming**: HTTP requests automatically named as "METHOD /route/path"
 
 ## Installation
 
@@ -18,6 +21,11 @@
 npm install @vtvlive/interactive-apm @opentelemetry/api @opentelemetry/exporter-trace-otlp-http @opentelemetry/instrumentation-http @opentelemetry/sdk-node @opentelemetry/resources
 ```
 
+For gRPC or PROTO transport support:
+```bash
+npm install @opentelemetry/exporter-trace-otlp-grpc @opentelemetry/exporter-trace-otlp-proto
+```
+
 ### For Elastic APM
 
 ```bash
@@ -34,37 +42,91 @@ npm install @nestjs/common @nestjs/config
 
 ## Environment Variables
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `APM_PROVIDER` | Provider selection: `elastic-apm` or `opentelemetry` | `opentelemetry` |
-| `ELASTIC_APM_SERVICE_NAME` | Service name for APM | Required |
-| `ELASTIC_APM_SERVER_URL` | Elastic APM server URL | `http://localhost:8200` |
-| `ELASTIC_APM_SECRET_TOKEN` | Secret token for authentication | Optional |
-| `ELASTIC_APM_ENVIRONMENT` | Deployment environment | `development` |
-| `ELASTIC_OTLP_ENDPOINT` | OTLP endpoint (OpenTelemetry only) | `http://localhost:8200/v1/traces` |
-| `ELASTIC_OTLP_AUTH_TOKEN` | OTLP-specific auth token (takes precedence over `ELASTIC_APM_SECRET_TOKEN`) | Optional |
-| `ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER` | Enable console exporter for debugging (default: `false`) | `false` |
+| Variable                               | Description                                                                 | Default                           |
+| -------------------------------------- | --------------------------------------------------------------------------- | --------------------------------- |
+| `APM_PROVIDER`                         | Provider selection: `elastic-apm` or `opentelemetry`                        | `opentelemetry`                   |
+| `APM_DEBUG`                            | Enable debug mode with detailed logging (default: `false`)                  | `false`                           |
+| `ELASTIC_APM_SERVICE_NAME`             | Service name for APM                                                        | Required                          |
+| `ELASTIC_APM_SERVER_URL`               | Elastic APM server URL                                                      | `http://localhost:8200`           |
+| `ELASTIC_APM_SECRET_TOKEN`             | Secret token for authentication                                             | Optional                          |
+| `ELASTIC_APM_ENVIRONMENT`              | Deployment environment                                                      | `development`                     |
+| `ELASTIC_OTLP_ENDPOINT`                | OTLP endpoint (OpenTelemetry only)                                          | `http://localhost:8200/v1/traces` |
+| `ELASTIC_OTLP_TRANSPORT`               | OTLP transport: `http`, `grpc`, or `proto`                                  | `http`                            |
+| `ELASTIC_OTLP_AUTH_TOKEN`              | OTLP-specific auth token (takes precedence over `ELASTIC_APM_SECRET_TOKEN`) | Optional                          |
+| `ELASTIC_OTLP_HEADERS`                 | Additional OTLP headers as JSON string                                      | Optional                          |
+| `ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER` | Enable console exporter for debugging                                       | `false`                           |
+
+## Debug Mode
+
+Enable debug mode to see detailed logs about APM initialization, span creation, and export status:
+
+```bash
+# Enable debug mode
+APM_DEBUG=true
+
+# Or in .env file
+APM_DEBUG=true
+```
+
+Debug mode provides:
+- Initialization details (service name, endpoint, transport type)
+- Span creation and lifecycle events
+- Export success/failure status
+- HTTP request/response details for troubleshooting
 
 ## Usage
 
 ### NestJS Integration
 
-#### Basic Usage (reads from environment)
+#### Complete Example with ConfigService
 
 ```typescript
 // app.module.ts
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
 import { TracingModule } from '@vtvlive/interactive-apm';
 
 @Module({
   imports: [
-    TracingModule.registerAsync(),
-    // ... other modules
+    ConfigModule.forRoot({
+      isGlobal: true,
+      envFilePath: ['.env.local', '.env'],
+    }),
+
+    TracingModule.registerAsync({
+      imports: [ConfigModule],
+      useFactory: async (configService: ConfigService) => {
+        return {
+          // Provider selection
+          provider: configService.get<string>('APM_PROVIDER', 'opentelemetry'),
+
+          // Common configuration
+          serviceName: configService.get<string>('ELASTIC_APM_SERVICE_NAME', 'my-service'),
+          environment: configService.get<string>('ELASTIC_APM_ENVIRONMENT', 'development'),
+
+          // OpenTelemetry configuration
+          otlpEndpoint: configService.get<string>('ELASTIC_OTLP_ENDPOINT', 'http://localhost:8200/v1/traces'),
+          otlpTransport: configService.get<string>('ELASTIC_OTLP_TRANSPORT', 'http'), // 'http' | 'grpc' | 'proto'
+          otlpAuthToken: configService.get<string>('ELASTIC_OTLP_AUTH_TOKEN'),
+          otlpHeaders: configService.get('ELASTIC_OTLP_HEADERS'),
+          enableConsoleExporter: configService.get<string>('ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER', 'false') === 'true',
+
+          // Elastic APM configuration
+          serverUrl: configService.get<string>('ELASTIC_APM_SERVER_URL', 'http://localhost:8200'),
+          secretToken: configService.get<string>('ELASTIC_APM_SECRET_TOKEN'),
+
+          // Debug mode - parse boolean from string env var
+          debug: ['1', 'true', 'yes'].includes(configService.get<string>('APM_DEBUG', 'false').toLowerCase()),
+        };
+      },
+      inject: [ConfigService],
+    }),
   ],
 })
 export class AppModule {}
 ```
 
-#### With Explicit Options
+#### Basic Usage (reads from environment)
 
 ```typescript
 // app.module.ts
@@ -72,44 +134,38 @@ import { TracingModule } from '@vtvlive/interactive-apm';
 
 @Module({
   imports: [
-    TracingModule.register({
-      provider: 'opentelemetry',
-      serviceName: 'my-service',
-      otlpEndpoint: 'http://localhost:8200/v1/traces',
-      environment: 'production',
-      autoInit: true,
-    }),
+    TracingModule.registerAsync(),
     // ... other modules
   ],
 })
 export class AppModule {}
 ```
 
-#### Using ConfigService
+#### In Controllers
 
 ```typescript
-// app.module.ts
-import { TracingModule } from '@vtvlive/interactive-apm';
-import { ConfigModule, ConfigService } from '@nestjs/config';
+import { Controller, Get } from '@nestjs/common';
+import { TracingService } from '@vtvlive/interactive-apm';
 
-@Module({
-  imports: [
-    TracingModule.registerAsync({
-      imports: [ConfigModule],
-      useFactory: (configService: ConfigService) => ({
-        provider: configService.get('APM_PROVIDER'),
-        serviceName: configService.get('ELASTIC_APM_SERVICE_NAME'),
-        environment: configService.get('ELASTIC_APM_ENVIRONMENT'),
-      }),
-      inject: [ConfigService],
-    }),
-    // ... other modules
-  ],
-})
-export class AppModule {}
+@Controller('healthcheck')
+export class HealthController {
+  constructor(private readonly tracingService: TracingService) {}
+
+  @Get('ping')
+  ping() {
+    return this.tracingService.startSpanWithParent(
+      'healthcheck.ping',
+      async (span) => {
+        span.setAttribute('healthcheck.type', 'liveness');
+        return { message: 'pong' };
+      },
+      { 'http.method': 'GET', 'http.route': '/healthcheck/ping' }
+    );
+  }
+}
 ```
 
-#### In Controllers/Services
+#### In Services
 
 ```typescript
 import { Injectable } from '@nestjs/common';
@@ -117,20 +173,27 @@ import { TracingService } from '@vtvlive/interactive-apm';
 
 @Injectable()
 export class UserService {
-  constructor(private readonly tracingService: TracingService) {}
+  constructor(
+    private readonly tracingService: TracingService,
+    private readonly userRepository: UserRepository
+  ) {}
 
   async findById(id: string) {
-    const span = this.tracingService.startSpan('user.findById', { userId: id }, 'SERVER');
-
-    try {
-      const user = await this.userRepository.findById(id);
-      return user;
-    } catch (error) {
-      this.tracingService.captureError(error);
-      throw error;
-    } finally {
-      span.end();
-    }
+    return this.tracingService.startSpanWithParent(
+      'user.findById',
+      async (span) => {
+        span.setAttribute('userId', id);
+
+        const user = await this.userRepository.findById(id);
+        if (!user) {
+          throw new NotFoundException(`User ${id} not found`);
+        }
+
+        span.setAttribute('user.exists', 'true');
+        return user;
+      },
+      { 'operation.type': 'read' }
+    );
   }
 
   async create(data: CreateUserDto) {
@@ -138,10 +201,23 @@ export class UserService {
       'user.create',
       async (span) => {
         span.setAttribute('user.email', data.email);
-        const user = await this.userRepository.create(data);
+
+        // This nested call creates a child span
+        const hashedPassword = await this.tracingService.startSpanWithParent(
+          'user.hashPassword',
+          async () => await bcrypt.hash(data.password, 10),
+          { 'operation.type': 'crypto' }
+        );
+
+        const user = await this.userRepository.create({
+          ...data,
+          password: hashedPassword,
+        });
+
+        span.setAttribute('user.created', 'true');
         return user;
       },
-      { userType: 'premium' }
+      { 'operation.type': 'write' }
     );
   }
 }
@@ -152,54 +228,36 @@ export class UserService {
 #### OpenTelemetry
 
 ```typescript
-import { initOpenTelemetry, TracingHelper } from '@vtvlive/interactive-apm';
-import { SpanKind } from '@opentelemetry/api';
+import { initOpenTelemetry } from '@vtvlive/interactive-apm';
 
-// Initialize at the top of your application
+// Initialize at the top of your application (before any imports)
 await initOpenTelemetry({
   serviceName: 'my-service',
   otlpEndpoint: 'http://localhost:8200/v1/traces',
   environment: 'production',
+  otlpTransport: 'proto', // 'http' | 'grpc' | 'proto'
+  enableConsoleExporter: false,
 });
 
-// Use TracingHelper for manual tracing
-const span = TracingHelper.startSpan('operation', { key: 'value' }, SpanKind.SERVER);
-try {
-  // Your code here
-  TracingHelper.setAttribute('result', 'success');
-} catch (error) {
-  TracingHelper.captureError(error);
-  throw error;
-} finally {
-  TracingHelper.endSpan(span);
-}
+// Your application code
+import express from 'express';
+const app = express();
 ```
 
 #### Elastic APM
 
 ```typescript
-import { initElasticApm, createTracingProvider, TracingService } from '@vtvlive/interactive-apm';
+import { initElasticApm } from '@vtvlive/interactive-apm';
 
 // Initialize at the top of your application
 initElasticApm({
   serviceName: 'my-service',
   serverUrl: 'http://localhost:8200',
   environment: 'production',
+  secretToken: 'your-secret-token',
 });
 
-// Use TracingService
-const provider = createTracingProvider({ provider: 'elastic-apm' });
-const tracingService = new TracingService(provider);
-
-const span = tracingService.startSpan('operation', { key: 'value' });
-try {
-  // Your code here
-} catch (error) {
-  tracingService.captureError(error);
-  throw error;
-} finally {
-  span.end();
-}
+// Your application code
 ```
 
 ## API Reference
@@ -208,41 +266,27 @@ try {
 
 NestJS module for APM integration.
 
-| Method | Description |
-|--------|-------------|
-| `register(options)` | Register module with synchronous options |
-| `registerAsync(options)` | Register module with asynchronous options |
+| Method                   | Description                                                    |
+| ------------------------ | -------------------------------------------------------------- |
+| `register(options)`      | Register module with synchronous options                       |
+| `registerAsync(options)` | Register module with asynchronous options (with ConfigService) |
 
 ### TracingService
 
 Service for tracing operations.
 
-| Method | Description |
-|--------|-------------|
-| `startSpan(name, attributes?, spanKind?)` | Start a new span |
-| `startSpanWithParent(name, fn, attributes?)` | Execute function with tracing context |
-| `captureError(error)` | Capture error to active span |
-| `setAttribute(key, value)` | Set attribute on active span |
-| `endSpan(span?)` | End a span |
-| `shutdown()` | Flush and shutdown provider |
-
-### TracingHelper
-
-Static utility class for OpenTelemetry.
-
-| Method | Description |
-|--------|-------------|
-| `startSpan(name, attributes?, spanKind?)` | Start a new span |
-| `startSpanWithParent(name, fn, attributes?)` | Execute function with tracing context |
-| `captureError(error)` | Capture error to active span |
-| `setAttribute(key, value)` | Set attribute on active span |
-| `endSpan(span?)` | End a span |
-| `getActiveSpan()` | Get the active span |
-| `getTraceId()` | Get the current trace ID |
+| Method                                       | Description                                           |
+| -------------------------------------------- | ----------------------------------------------------- |
+| `startSpan(name, attributes?, spanKind?)`    | Start a new span (must call `span.end()` manually)    |
+| `startSpanWithParent(name, fn, attributes?)` | Execute function with automatic tracing (recommended) |
+| `captureError(error)`                        | Capture error to active span                          |
+| `setAttribute(key, value)`                   | Set attribute on active span                          |
+| `endSpan(span?)`                             | End a span manually                                   |
+| `shutdown()`                                 | Flush and shutdown provider                           |
 
 ### SpanKind
 
-Types of spans:
+Types of spans (used with `startSpan`):
 
 - `INTERNAL`: Internal operation
 - `SERVER`: Server-side request handler (API endpoints)
@@ -250,24 +294,58 @@ Types of spans:
 - `PRODUCER`: Message producer
 - `CONSUMER`: Message consumer
 
-## Provider Selection
+### OtlpTransport
 
-The package supports two APM providers:
+Transport options for OpenTelemetry OTLP exporter:
 
-### OpenTelemetry (default)
+- `HTTP`: JSON over HTTP (default)
+- `GRPC`: gRPC with protobuf
+- `PROTO`: Protobuf over HTTP (most efficient)
 
-Uses OpenTelemetry SDK with OTLP exporter to send traces to Elastic APM.
+## Transaction Naming
 
-```bash
-APM_PROVIDER=opentelemetry
-```
+HTTP transactions are automatically named in the format `METHOD /route/path`:
+
+- Request to `GET /api/healthcheck/ping` → Transaction: `GET /api/healthcheck/ping`
+- Request to `POST /api/users` → Transaction: `POST /api/users`
+
+This applies to both OpenTelemetry and Elastic APM providers.
+
+## Provider Comparison
 
-### Elastic APM
+| Feature              | OpenTelemetry                | Elastic APM      |
+| -------------------- | ---------------------------- | ---------------- |
+| Transport Options    | HTTP, gRPC, PROTO            | HTTP/HTTPS       |
+| Auto Instrumentation | HTTP, Express (configurable) | Built-in         |
+| Debug Logging        | Comprehensive                | Comprehensive    |
+| Transaction Naming   | Auto + Custom                | Auto + Custom    |
+| Standard             | W3C Trace Context            | Elastic APM spec |
 
-Uses the native Elastic APM Node.js agent.
+## Troubleshooting
+
+### No traces appearing in APM
+
+1. Check if `APM_DEBUG=true` is set to see detailed logs
+2. Verify endpoint URL is correct
+3. Check network connectivity to APM server
+4. Verify authentication token
+
+### Using npm link for local development
 
 ```bash
-APM_PROVIDER=elastic-apm
+# In the package directory
+cd /path/to/interactive-apm
+npm link
+
+# In your project directory
+cd /path/to/your-project
+npm link @vtvlive/interactive-apm
+```
+
+Note: After making changes to the package, rebuild it:
+```bash
+cd /path/to/interactive-apm
+npm run build
 ```
 
 ## Testing
@@ -305,8 +383,6 @@ npm test
 npm run clean
 ```
 
-**For detailed deployment instructions (build, publish, install from private registry), see [DEPLOYMENT.md](DEPLOYMENT.md)**
-
 ## License
 
 MIT
@@ -317,4 +393,6 @@ VTVLive
 
 ---
 
-For more information, visit the [Elastic APM documentation](https://www.elastic.co/guide/en/apm/get-started/current/index.html) or [OpenTelemetry documentation](https://opentelemetry.io/docs/instrumentation/js/).
+For more information:
+- [Elastic APM documentation](https://www.elastic.co/guide/en/apm/get-started/current/index.html)
+- [OpenTelemetry documentation](https://opentelemetry.io/docs/instrumentation/js/)

package/dist/factories/tracing-provider.factory.d.ts

@@ -1,5 +1,6 @@
 import { ITracingProvider } from '../interfaces/tracing-provider.interface';
 import { ApmProvider } from '../types/apm-provider.type';
+import { OtlpTransport } from '../types/otlp-transport.type';
 /**
  * Configuration options for creating a tracing provider
  */
@@ -20,6 +21,8 @@ export interface TracingProviderConfig {
     otlpAuthToken?: string;
     /** OTLP headers as a record (key-value pairs). If provided, merges with Authorization header when token is set. */
     otlpHeaders?: Record<string, string>;
+    /** OTLP transport type: 'http' or 'grpc' (default: 'http') */
+    otlpTransport?: OtlpTransport | string;
     /** Enable console exporter for debugging (default: false) */
     enableConsoleExporter?: boolean;
     /** Service version */

package/dist/factories/tracing-provider.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracing-provider.factory.d.ts","sourceRoot":"","sources":["../../src/factories/tracing-provider.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,qBAA0B,GAAG,gBAAgB,CAQ1F;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,sBAAsB;;iCAEJ,GAAG;;CAgCjC,CAAC"}
+{"version":3,"file":"tracing-provider.factory.d.ts","sourceRoot":"","sources":["../../src/factories/tracing-provider.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACvC,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,qBAA0B,GAAG,gBAAgB,CAQ1F;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,sBAAsB;;iCAEJ,GAAG;;CAiCjC,CAAC"}

package/dist/factories/tracing-provider.factory.js

@@ -86,6 +86,7 @@ exports.TracingProviderFactory = {
             otlpEndpoint: get('ELASTIC_OTLP_ENDPOINT', 'http://localhost:8200/v1/traces'),
             otlpAuthToken,
             otlpHeaders: Object.keys(headers).length > 0 ? headers : undefined,
+            otlpTransport: get('ELASTIC_OTLP_TRANSPORT', 'http'),
             enableConsoleExporter: get('ELASTIC_OTLP_ENABLE_CONSOLE_EXPORTER', 'false') === 'true',
         });
     },

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { TracingService } from './services/tracing.service';
 export { TracingHelper } from './utils/tracing.helper';
 export { ITracingProvider } from './interfaces/tracing-provider.interface';
 export { ApmProvider, SpanKind } from './types/apm-provider.type';
+export { OtlpTransport } from './types/otlp-transport.type';
 export { ElasticApmTracingProvider } from './providers/elastic-apm.tracing-provider';
 export { OpenTelemetryTracingProvider } from './providers/opentelemetry.tracing-provider';
 export { createTracingProvider, TracingProviderFactory, TRACING_PROVIDER_TOKEN, TracingProviderConfig } from './factories/tracing-provider.factory';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAG1G,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAG1F,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGpJ,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAG1G,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAG1F,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGpJ,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldUseOpenTelemetry = exports.initOpenTelemetry = exports.shouldUseElasticApm = exports.getElasticApmAgent = exports.isElasticApmStarted = exports.initElasticApm = exports.TRACING_PROVIDER_TOKEN = exports.TracingProviderFactory = exports.createTracingProvider = exports.OpenTelemetryTracingProvider = exports.ElasticApmTracingProvider = exports.SpanKind = exports.ApmProvider = exports.TracingHelper = exports.TracingService = exports.TracingModule = void 0;
+exports.shouldUseOpenTelemetry = exports.initOpenTelemetry = exports.shouldUseElasticApm = exports.getElasticApmAgent = exports.isElasticApmStarted = exports.initElasticApm = exports.TRACING_PROVIDER_TOKEN = exports.TracingProviderFactory = exports.createTracingProvider = exports.OpenTelemetryTracingProvider = exports.ElasticApmTracingProvider = exports.OtlpTransport = exports.SpanKind = exports.ApmProvider = exports.TracingHelper = exports.TracingService = exports.TracingModule = void 0;
 // Core exports - NestJS integration
 var tracing_module_1 = require("./modules/tracing.module");
 Object.defineProperty(exports, "TracingModule", { enumerable: true, get: function () { return tracing_module_1.TracingModule; } });
@@ -14,6 +14,8 @@ Object.defineProperty(exports, "TracingHelper", { enumerable: true, get: functio
 var apm_provider_type_1 = require("./types/apm-provider.type");
 Object.defineProperty(exports, "ApmProvider", { enumerable: true, get: function () { return apm_provider_type_1.ApmProvider; } });
 Object.defineProperty(exports, "SpanKind", { enumerable: true, get: function () { return apm_provider_type_1.SpanKind; } });
+var otlp_transport_type_1 = require("./types/otlp-transport.type");
+Object.defineProperty(exports, "OtlpTransport", { enumerable: true, get: function () { return otlp_transport_type_1.OtlpTransport; } });
 // Providers - for direct usage
 var elastic_apm_tracing_provider_1 = require("./providers/elastic-apm.tracing-provider");
 Object.defineProperty(exports, "ElasticApmTracingProvider", { enumerable: true, get: function () { return elastic_apm_tracing_provider_1.ElasticApmTracingProvider; } });

package/dist/init/elastic-apm-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elastic-apm-init.d.ts","sourceRoot":"","sources":["../../src/init/elastic-apm-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,GAAG,CAuBvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAWxC"}
+{"version":3,"file":"elastic-apm-init.d.ts","sourceRoot":"","sources":["../../src/init/elastic-apm-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,GAAG,CAyCvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAWxC"}

package/dist/init/elastic-apm-init.js

@@ -21,6 +21,7 @@ exports.initElasticApm = initElasticApm;
 exports.isElasticApmStarted = isElasticApmStarted;
 exports.getElasticApmAgent = getElasticApmAgent;
 const apm_provider_type_1 = require("../types/apm-provider.type");
+const debug_logger_1 = require("../utils/debug-logger");
 /**
  * Check if APM should use Elastic APM provider based on configuration
  * @returns true if Elastic APM should be used
@@ -42,17 +43,33 @@ function initElasticApm(options = {}) {
     if (apm.isStarted()) {
         return apm;
     }
+    const serviceName = options.serviceName || process.env.ELASTIC_APM_SERVICE_NAME || 'interactive-backend';
+    const serverUrl = options.serverUrl || process.env.ELASTIC_APM_SERVER_URL || 'http://localhost:8200';
+    const secretToken = options.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN;
+    const serviceVersion = options.serviceVersion || process.env.npm_package_version || '1.0.0';
+    const environment = options.environment || process.env.ELASTIC_APM_ENVIRONMENT || 'development';
+    // Log initialization details when debug mode is on
+    (0, debug_logger_1.logInitialization)('ElasticAPM', {
+        serviceName,
+        serverUrl,
+        hasSecretToken: !!secretToken,
+        serviceVersion,
+        environment,
+        logLevel: options.logLevel || 'error',
+    });
     // Start the agent
     const agent = apm.start({
-        serviceName: options.serviceName || process.env.ELASTIC_APM_SERVICE_NAME || 'interactive-backend',
-        serverUrl: options.serverUrl || process.env.ELASTIC_APM_SERVER_URL || 'http://localhost:8200',
-        secretToken: options.secretToken || process.env.ELASTIC_APM_SECRET_TOKEN,
-        serviceVersion: options.serviceVersion || process.env.npm_package_version || '1.0.0',
-        environment: options.environment || process.env.ELASTIC_APM_ENVIRONMENT || 'development',
+        serviceName,
+        serverUrl,
+        secretToken,
+        serviceVersion,
+        environment,
         logLevel: options.logLevel || 'error',
     });
-    console.log(`[ElasticAPM] Service: ${agent.getServiceName()}, Environment: ${agent.conf.environment}`);
-    console.log('[ElasticAPM] Initialized');
+    if ((0, debug_logger_1.isDebugEnabled)()) {
+        (0, debug_logger_1.infoLog)(`[ElasticAPM] Service: ${agent.getServiceName()}, Environment: ${agent.conf.environment}`);
+        (0, debug_logger_1.infoLog)('[ElasticAPM] Initialized');
+    }
     return agent;
 }
 /**

package/dist/init/opentelemetry-init.d.ts

@@ -14,6 +14,7 @@
  *   environment: 'production',
  * });
  */
+import { OtlpTransport } from '../types/otlp-transport.type';
 export interface OpenTelemetryInitOptions {
     /** Service name for APM */
     serviceName?: string;
@@ -35,6 +36,8 @@ export interface OpenTelemetryInitOptions {
     enableHttpInstrumentation?: boolean;
     /** Enable Express instrumentation */
     enableExpressInstrumentation?: boolean;
+    /** OTLP transport type: 'http' or 'grpc' (default: 'http') */
+    otlpTransport?: OtlpTransport | string;
 }
 /**
  * Check if APM should use OpenTelemetry provider based on configuration

package/dist/init/opentelemetry-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opentelemetry-init.d.ts","sourceRoot":"","sources":["../../src/init/opentelemetry-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kCAAkC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,qCAAqC;IACrC,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,GAAG,CAAC,CAyG5F"}
+{"version":3,"file":"opentelemetry-init.d.ts","sourceRoot":"","sources":["../../src/init/opentelemetry-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AA0C7D,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kCAAkC;IAClC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,qCAAqC;IACrC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAwCD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,GAAG,CAAC,CA2I5F"}