@tracekit/node-apm 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TraceKit
+
+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,373 @@
+# TraceKit APM for Node.js
+
+Zero-config distributed tracing and performance monitoring for Express and NestJS applications.
+
+[![npm version](https://img.shields.io/npm/v/@tracekit/node-apm.svg)](https://www.npmjs.com/package/@tracekit/node-apm)
+[![Downloads](https://img.shields.io/npm/dm/@tracekit/node-apm.svg)](https://www.npmjs.com/package/@tracekit/node-apm)
+[![License](https://img.shields.io/npm/l/@tracekit/node-apm.svg)](https://www.npmjs.com/package/@tracekit/node-apm)
+
+## Features
+
+- **Zero Configuration** - Works out of the box with sensible defaults
+- **Automatic Instrumentation** - No code changes needed
+- **Express Support** - Simple middleware integration
+- **NestJS Support** - Module and interceptor-based tracing
+- **TypeScript First** - Full type definitions included
+- **HTTP Request Tracing** - Track every request, route, and handler
+- **Error Tracking** - Capture exceptions with full context
+- **Low Overhead** - < 5% performance impact
+
+## Installation
+
+```bash
+npm install @tracekit/node-apm
+```
+
+## Quick Start
+
+### Express
+
+```javascript
+const express = require('express');
+const tracekit = require('@tracekit/node-apm');
+
+const app = express();
+
+// Initialize TraceKit
+tracekit.init({
+  apiKey: process.env.TRACEKIT_API_KEY,
+  serviceName: 'my-express-app',
+});
+
+// Add middleware (must be before routes)
+app.use(tracekit.middleware());
+
+// Your routes
+app.get('/', (req, res) => {
+  res.send('Hello World!');
+});
+
+app.listen(3000);
+```
+
+### Express (TypeScript)
+
+```typescript
+import express from 'express';
+import * as tracekit from '@tracekit/node-apm';
+
+const app = express();
+
+// Initialize TraceKit
+tracekit.init({
+  apiKey: process.env.TRACEKIT_API_KEY!,
+  serviceName: 'my-express-app',
+});
+
+// Add middleware
+app.use(tracekit.middleware());
+
+// Your routes
+app.get('/', (req, res) => {
+  res.send('Hello World!');
+});
+
+app.listen(3000);
+```
+
+### NestJS
+
+```typescript
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { TracekitModule } from '@tracekit/node-apm/nestjs';
+
+@Module({
+  imports: [
+    TracekitModule.forRoot({
+      apiKey: process.env.TRACEKIT_API_KEY!,
+      serviceName: 'my-nestjs-app',
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+That's it! Your app is now automatically traced.
+
+Get your API key at [https://app.tracekit.dev](https://app.tracekit.dev)
+
+## Configuration
+
+### Basic Configuration
+
+```typescript
+import * as tracekit from '@tracekit/node-apm';
+
+tracekit.init({
+  // Required: Your TraceKit API key
+  apiKey: process.env.TRACEKIT_API_KEY,
+
+  // Optional: Service name (default: 'node-app')
+  serviceName: 'my-service',
+
+  // Optional: TraceKit endpoint (default: 'https://app.tracekit.dev/v1/traces')
+  endpoint: 'https://app.tracekit.dev/v1/traces',
+
+  // Optional: Enable/disable tracing (default: true)
+  enabled: process.env.NODE_ENV !== 'development',
+
+  // Optional: Sample rate 0.0-1.0 (default: 1.0 = 100%)
+  sampleRate: 0.5, // Trace 50% of requests
+});
+```
+
+### NestJS Async Configuration
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { TracekitModule } from '@tracekit/node-apm/nestjs';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot(),
+    TracekitModule.forRootAsync({
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) => ({
+        apiKey: config.get('TRACEKIT_API_KEY')!,
+        serviceName: config.get('APP_NAME', 'my-app'),
+        enabled: config.get('NODE_ENV') !== 'development',
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## What Gets Traced?
+
+### HTTP Requests
+
+Every HTTP request is automatically traced with:
+
+- Route path and HTTP method
+- Request URL and query parameters
+- HTTP status code
+- Request duration
+- User agent and client IP
+- Controller and handler names (NestJS)
+
+### Errors and Exceptions
+
+All exceptions are automatically captured with:
+
+- Exception type and message
+- Full stack trace
+- Request context
+- Handler information
+
+## Advanced Usage
+
+### Manual Tracing (Express)
+
+```typescript
+import { getClient } from '@tracekit/node-apm';
+
+app.get('/custom', async (req, res) => {
+  const client = getClient();
+
+  const span = client.startSpan('my-operation', null, {
+    'user.id': req.user?.id,
+    'custom.attribute': 'value',
+  });
+
+  try {
+    const result = await doSomething();
+
+    client.endSpan(span, {
+      'result.count': result.length,
+    });
+
+    res.json(result);
+  } catch (error) {
+    client.recordException(span, error as Error);
+    client.endSpan(span, {}, 'ERROR');
+    throw error;
+  }
+});
+```
+
+### Manual Tracing (NestJS)
+
+```typescript
+import { Injectable, Inject } from '@nestjs/common';
+import { TracekitClient } from '@tracekit/node-apm/nestjs';
+
+@Injectable()
+export class MyService {
+  constructor(
+    @Inject('TRACEKIT_CLIENT') private tracekit: TracekitClient
+  ) {}
+
+  async doSomething() {
+    const span = this.tracekit.startSpan('custom-operation', null, {
+      'operation.type': 'database',
+    });
+
+    try {
+      const result = await this.database.query();
+
+      this.tracekit.endSpan(span, {
+        'rows.count': result.length,
+      });
+
+      return result;
+    } catch (error) {
+      this.tracekit.recordException(span, error as Error);
+      this.tracekit.endSpan(span, {}, 'ERROR');
+      throw error;
+    }
+  }
+}
+```
+
+## Environment-Based Configuration
+
+### Disable tracing in development
+
+```typescript
+tracekit.init({
+  apiKey: process.env.TRACEKIT_API_KEY!,
+  enabled: process.env.NODE_ENV === 'production',
+});
+```
+
+### Sample only 10% of requests
+
+```typescript
+tracekit.init({
+  apiKey: process.env.TRACEKIT_API_KEY!,
+  sampleRate: 0.1, // Trace 10% of requests
+});
+```
+
+## Performance
+
+TraceKit APM is designed to have minimal performance impact:
+
+- **< 5% overhead** on average request time
+- Asynchronous trace sending (doesn't block responses)
+- Automatic batching and compression
+- Configurable sampling for high-traffic apps
+
+## TypeScript Support
+
+Full TypeScript support with type definitions included:
+
+```typescript
+import { TracekitClient, TracekitConfig, Span } from '@tracekit/node-apm';
+
+const config: TracekitConfig = {
+  apiKey: 'your-key',
+  serviceName: 'my-app',
+};
+
+const attributes: Record<string, any> = {
+  'user.id': 123,
+  'request.path': '/api/users',
+};
+
+// Using the client
+const client = new TracekitClient(config);
+const span: Span = client.startSpan('my-operation', null, attributes);
+```
+
+## Requirements
+
+- Node.js 16.x or higher
+- Express 4.x or 5.x (for Express support)
+- NestJS 10.x (for NestJS support)
+
+## Examples
+
+### Express Example
+
+```javascript
+const express = require('express');
+const tracekit = require('@tracekit/node-apm');
+
+const app = express();
+
+tracekit.init({
+  apiKey: process.env.TRACEKIT_API_KEY,
+  serviceName: 'express-example',
+});
+
+app.use(tracekit.middleware());
+
+app.get('/users', async (req, res) => {
+  const users = await db.getUsers();
+  res.json(users);
+});
+
+app.listen(3000);
+```
+
+### NestJS Example
+
+```typescript
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(3000);
+}
+bootstrap();
+
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { TracekitModule } from '@tracekit/node-apm/nestjs';
+import { UsersModule } from './users/users.module';
+
+@Module({
+  imports: [
+    TracekitModule.forRoot({
+      apiKey: process.env.TRACEKIT_API_KEY!,
+      serviceName: 'nestjs-example',
+    }),
+    UsersModule,
+  ],
+})
+export class AppModule {}
+
+// users.controller.ts
+import { Controller, Get } from '@nestjs/common';
+import { UsersService } from './users.service';
+
+@Controller('users')
+export class UsersController {
+  constructor(private usersService: UsersService) {}
+
+  @Get()
+  findAll() {
+    return this.usersService.findAll();
+  }
+}
+```
+
+## Support
+
+- Documentation: [https://app.tracekit.dev/docs](https://app.tracekit.dev/docs)
+- Issues: [https://github.com/Tracekit-Dev/node-apm/issues](https://github.com/Tracekit-Dev/node-apm/issues)
+- Email: support@tracekit.dev
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Credits
+
+Built with ❤️ by the TraceKit team.

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+import * as api from '@opentelemetry/api';
+export interface TracekitConfig {
+    apiKey: string;
+    endpoint?: string;
+    serviceName?: string;
+    enabled?: boolean;
+    sampleRate?: number;
+}
+export declare class TracekitClient {
+    private provider;
+    private tracer;
+    private config;
+    constructor(config: TracekitConfig);
+    startTrace(operationName: string, attributes?: Record<string, any>): api.Span;
+    startSpan(operationName: string, parentSpan?: api.Span | null, attributes?: Record<string, any>): api.Span;
+    endSpan(span: api.Span, finalAttributes?: Record<string, any>, status?: string): void;
+    addEvent(span: api.Span, name: string, attributes?: Record<string, any>): void;
+    recordException(span: api.Span, error: Error): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    isEnabled(): boolean;
+    shouldSample(): boolean;
+    getTracer(): api.Tracer;
+    private normalizeAttributes;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,cAAc;IAsClC,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,GAAG,CAAC,IAAI;IAOjF,SAAS,CACP,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,EAC5B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACnC,GAAG,CAAC,IAAI;IAcX,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBzF,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAIlF,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAQ7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,SAAS,IAAI,OAAO;IAIpB,YAAY,IAAI,OAAO;IAIvB,SAAS,IAAI,GAAG,CAAC,MAAM;IAIvB,OAAO,CAAC,mBAAmB;CAiB5B"}

package/dist/client.js

@@ -0,0 +1,143 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracekitClient = void 0;
+const sdk_trace_node_1 = require("@opentelemetry/sdk-trace-node");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const sdk_trace_node_2 = require("@opentelemetry/sdk-trace-node");
+const api = __importStar(require("@opentelemetry/api"));
+class TracekitClient {
+    constructor(config) {
+        this.config = {
+            endpoint: config.endpoint || 'https://app.tracekit.dev/v1/traces',
+            serviceName: config.serviceName || 'node-app',
+            enabled: config.enabled ?? true,
+            sampleRate: config.sampleRate ?? 1.0,
+            apiKey: config.apiKey,
+        };
+        const resource = new resources_1.Resource({
+            [semantic_conventions_1.SemanticResourceAttributes.SERVICE_NAME]: this.config.serviceName,
+        });
+        this.provider = new sdk_trace_node_1.NodeTracerProvider({
+            resource,
+        });
+        if (this.config.enabled) {
+            const exporter = new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                url: this.config.endpoint,
+                headers: {
+                    'X-API-Key': this.config.apiKey,
+                },
+            });
+            this.provider.addSpanProcessor(new sdk_trace_node_2.BatchSpanProcessor(exporter));
+            this.provider.register();
+        }
+        this.tracer = api.trace.getTracer('@tracekit/node-apm', '1.0.0');
+    }
+    startTrace(operationName, attributes = {}) {
+        return this.tracer.startSpan(operationName, {
+            kind: api.SpanKind.SERVER,
+            attributes: this.normalizeAttributes(attributes),
+        });
+    }
+    startSpan(operationName, parentSpan, attributes = {}) {
+        const options = {
+            kind: api.SpanKind.INTERNAL,
+            attributes: this.normalizeAttributes(attributes),
+        };
+        if (parentSpan) {
+            const ctx = api.trace.setSpan(api.context.active(), parentSpan);
+            return this.tracer.startSpan(operationName, options, ctx);
+        }
+        return this.tracer.startSpan(operationName, options);
+    }
+    endSpan(span, finalAttributes = {}, status) {
+        if (Object.keys(finalAttributes).length > 0) {
+            span.setAttributes(this.normalizeAttributes(finalAttributes));
+        }
+        if (status === 'ERROR') {
+            span.setStatus({ code: api.SpanStatusCode.ERROR });
+        }
+        else if (status === 'OK') {
+            span.setStatus({ code: api.SpanStatusCode.OK });
+        }
+        span.end();
+    }
+    addEvent(span, name, attributes = {}) {
+        span.addEvent(name, this.normalizeAttributes(attributes));
+    }
+    recordException(span, error) {
+        span.recordException(error);
+        span.setStatus({
+            code: api.SpanStatusCode.ERROR,
+            message: error.message,
+        });
+    }
+    async flush() {
+        await this.provider.forceFlush();
+    }
+    async shutdown() {
+        await this.provider.shutdown();
+    }
+    isEnabled() {
+        return this.config.enabled && !!this.config.apiKey;
+    }
+    shouldSample() {
+        return Math.random() < this.config.sampleRate;
+    }
+    getTracer() {
+        return this.tracer;
+    }
+    normalizeAttributes(attributes) {
+        const normalized = {};
+        for (const [key, value] of Object.entries(attributes)) {
+            if (typeof value === 'string' ||
+                typeof value === 'number' ||
+                typeof value === 'boolean') {
+                normalized[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                normalized[key] = value.map(String);
+            }
+            else {
+                normalized[key] = String(value);
+            }
+        }
+        return normalized;
+    }
+}
+exports.TracekitClient = TracekitClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { TracekitClient, TracekitConfig } from './client';
+export declare function init(config: TracekitConfig): TracekitClient;
+export declare function middleware(): (req: import("express").Request, res: import("express").Response, next: import("express").NextFunction) => Promise<void>;
+export declare function getClient(): TracekitClient;
+export { TracekitClient, TracekitConfig } from './client';
+export { createExpressMiddleware, getCurrentSpan } from './middleware/express';
+export { Span, Context } from '@opentelemetry/api';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ1D,wBAAgB,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAG3D;AAKD,wBAAgB,UAAU,6HAOzB;AAKD,wBAAgB,SAAS,IAAI,cAAc,CAO1C;AAGD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentSpan = exports.createExpressMiddleware = exports.TracekitClient = void 0;
+exports.init = init;
+exports.middleware = middleware;
+exports.getClient = getClient;
+const client_1 = require("./client");
+const express_1 = require("./middleware/express");
+let globalClient = null;
+function init(config) {
+    globalClient = new client_1.TracekitClient(config);
+    return globalClient;
+}
+function middleware() {
+    if (!globalClient) {
+        throw new Error('TraceKit not initialized. Call tracekit.init() first.');
+    }
+    return (0, express_1.createExpressMiddleware)(globalClient);
+}
+function getClient() {
+    if (!globalClient) {
+        throw new Error('TraceKit not initialized. Call tracekit.init() first.');
+    }
+    return globalClient;
+}
+var client_2 = require("./client");
+Object.defineProperty(exports, "TracekitClient", { enumerable: true, get: function () { return client_2.TracekitClient; } });
+var express_2 = require("./middleware/express");
+Object.defineProperty(exports, "createExpressMiddleware", { enumerable: true, get: function () { return express_2.createExpressMiddleware; } });
+Object.defineProperty(exports, "getCurrentSpan", { enumerable: true, get: function () { return express_2.getCurrentSpan; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAQA,oBAGC;AAKD,gCAOC;AAKD,8BAOC;AAnCD,qCAA0D;AAC1D,kDAA+D;AAE/D,IAAI,YAAY,GAA0B,IAAI,CAAC;AAK/C,SAAgB,IAAI,CAAC,MAAsB;IACzC,YAAY,GAAG,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,YAAY,CAAC;AACtB,CAAC;AAKD,SAAgB,UAAU;IACxB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,iCAAuB,EAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAKD,SAAgB,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAGD,mCAA0D;AAAjD,wGAAA,cAAc,OAAA;AACvB,gDAA+E;AAAtE,kHAAA,uBAAuB,OAAA;AAAE,yGAAA,cAAc,OAAA"}

package/dist/middleware/express.d.ts

@@ -0,0 +1,6 @@
+import { Request, Response, NextFunction } from 'express';
+import { TracekitClient } from '../client';
+import * as api from '@opentelemetry/api';
+export declare function createExpressMiddleware(client: TracekitClient): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+export declare function getCurrentSpan(req: Request): api.Span | null;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAE1C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,IAC9C,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAwD9D;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAE5D"}

package/dist/middleware/express.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressMiddleware = createExpressMiddleware;
+exports.getCurrentSpan = getCurrentSpan;
+function createExpressMiddleware(client) {
+    return async (req, res, next) => {
+        if (!client.isEnabled() || !client.shouldSample()) {
+            return next();
+        }
+        const startTime = Date.now();
+        const operationName = getOperationName(req);
+        const span = client.startTrace(operationName, {
+            'http.method': req.method,
+            'http.url': req.originalUrl || req.url,
+            'http.route': req.route?.path || req.path,
+            'http.user_agent': req.get('user-agent') || '',
+            'http.client_ip': getClientIp(req),
+        });
+        req.__tracekitSpan = span;
+        const originalSend = res.send;
+        let responseSent = false;
+        res.send = function (body) {
+            if (!responseSent) {
+                responseSent = true;
+                const durationMs = Date.now() - startTime;
+                client.endSpan(span, {
+                    'http.status_code': res.statusCode,
+                    'http.duration_ms': durationMs,
+                }, res.statusCode >= 400 ? 'ERROR' : 'OK');
+            }
+            return originalSend.call(this, body);
+        };
+        try {
+            next();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                client.recordException(span, error);
+                client.endSpan(span, {}, 'ERROR');
+            }
+            throw error;
+        }
+    };
+}
+function getCurrentSpan(req) {
+    return req.__tracekitSpan || null;
+}
+function getOperationName(req) {
+    if (req.route?.path) {
+        return `${req.method} ${req.route.path}`;
+    }
+    return `${req.method} ${req.path}`;
+}
+function getClientIp(req) {
+    return (req.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
+        req.headers['x-real-ip'] ||
+        req.socket.remoteAddress ||
+        '');
+}
+//# sourceMappingURL=express.js.map

package/dist/middleware/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":";;AAIA,0DAyDC;AAGD,wCAEC;AA9DD,SAAgB,uBAAuB,CAAC,MAAsB;IAC5D,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAE/D,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;YAClD,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAG7B,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAG5C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE;YAC5C,aAAa,EAAE,GAAG,CAAC,MAAM;YACzB,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG;YACtC,YAAY,EAAG,GAAG,CAAC,KAAK,EAAE,IAAe,IAAI,GAAG,CAAC,IAAI;YACrD,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE;YAC9C,gBAAgB,EAAE,WAAW,CAAC,GAAG,CAAC;SACnC,CAAC,CAAC;QAGF,GAAW,CAAC,cAAc,GAAG,IAAI,CAAC;QAGnC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC;QAC9B,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,GAAG,CAAC,IAAI,GAAG,UAAU,IAAS;YAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAE1C,MAAM,CAAC,OAAO,CACZ,IAAI,EACJ;oBACE,kBAAkB,EAAE,GAAG,CAAC,UAAU;oBAClC,kBAAkB,EAAE,UAAU;iBAC/B,EACD,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACvC,CAAC;YACJ,CAAC;YAED,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC;QAGF,IAAI,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACpC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAGD,SAAgB,cAAc,CAAC,GAAY;IACzC,OAAQ,GAAW,CAAC,cAAc,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IAEpC,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACpB,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAGD,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,CACJ,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,CAAY;QACpC,GAAG,CAAC,MAAM,CAAC,aAAa;QACxB,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/nestjs/index.d.ts

@@ -0,0 +1,5 @@
+export { TracekitModule } from './tracekit.module';
+export { TracekitInterceptor } from './tracekit.interceptor';
+export { TracekitClient, TracekitConfig } from '../client';
+export { Span } from '@opentelemetry/api';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/nestjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracekitClient = exports.TracekitInterceptor = exports.TracekitModule = void 0;
+var tracekit_module_1 = require("./tracekit.module");
+Object.defineProperty(exports, "TracekitModule", { enumerable: true, get: function () { return tracekit_module_1.TracekitModule; } });
+var tracekit_interceptor_1 = require("./tracekit.interceptor");
+Object.defineProperty(exports, "TracekitInterceptor", { enumerable: true, get: function () { return tracekit_interceptor_1.TracekitInterceptor; } });
+var client_1 = require("../client");
+Object.defineProperty(exports, "TracekitClient", { enumerable: true, get: function () { return client_1.TracekitClient; } });
+//# sourceMappingURL=index.js.map

package/dist/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nestjs/index.ts"],"names":[],"mappings":";;;AAAA,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,+DAA6D;AAApD,2HAAA,mBAAmB,OAAA;AAC5B,oCAA2D;AAAlD,wGAAA,cAAc,OAAA"}

package/dist/nestjs/tracekit.interceptor.d.ts

@@ -0,0 +1,10 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { TracekitClient } from '../client';
+export declare class TracekitInterceptor implements NestInterceptor {
+    private readonly client;
+    constructor(client: TracekitClient);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    private getClientIp;
+}
+//# sourceMappingURL=tracekit.interceptor.d.ts.map

package/dist/nestjs/tracekit.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracekit.interceptor.d.ts","sourceRoot":"","sources":["../../src/nestjs/tracekit.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,qBACa,mBAAoB,YAAW,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAGpE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;IAyExE,OAAO,CAAC,WAAW;CAQpB"}

package/dist/nestjs/tracekit.interceptor.js

@@ -0,0 +1,80 @@
+"use strict";
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracekitInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const client_1 = require("../client");
+let TracekitInterceptor = class TracekitInterceptor {
+    constructor(client) {
+        this.client = client;
+    }
+    intercept(context, next) {
+        if (context.getType() !== 'http') {
+            return next.handle();
+        }
+        if (!this.client.isEnabled() || !this.client.shouldSample()) {
+            return next.handle();
+        }
+        const request = context.switchToHttp().getRequest();
+        const response = context.switchToHttp().getResponse();
+        const startTime = process.hrtime();
+        const handler = context.getHandler().name;
+        const controller = context.getClass().name;
+        const operationName = `${controller}.${handler}`;
+        const spanId = this.client.startTrace(operationName, {
+            'http.method': request.method,
+            'http.url': request.url,
+            'http.route': request.route?.path || request.url,
+            'http.user_agent': request.get('user-agent') || '',
+            'http.client_ip': this.getClientIp(request),
+            'nestjs.controller': controller,
+            'nestjs.handler': handler,
+        });
+        return next.handle().pipe((0, operators_1.tap)(() => {
+            const [seconds, nanos] = process.hrtime(startTime);
+            const durationMs = seconds * 1000 + nanos / 1000000;
+            this.client.endSpan(spanId, {
+                'http.status_code': response.statusCode,
+                'http.duration_ms': Math.round(durationMs),
+            }, response.statusCode >= 400 ? 'ERROR' : 'OK');
+            this.client.flush().catch((err) => {
+                console.warn('TraceKit: Failed to flush traces', err);
+            });
+        }), (0, operators_1.catchError)((error) => {
+            const [seconds, nanos] = process.hrtime(startTime);
+            const durationMs = seconds * 1000 + nanos / 1000000;
+            this.client.recordException(spanId, error);
+            this.client.endSpan(spanId, {
+                'http.duration_ms': Math.round(durationMs),
+            }, 'ERROR');
+            this.client.flush().catch(() => { });
+            return (0, rxjs_1.throwError)(() => error);
+        }));
+    }
+    getClientIp(request) {
+        return (request.headers['x-forwarded-for']?.split(',')[0]?.trim() ||
+            request.headers['x-real-ip'] ||
+            request.socket.remoteAddress ||
+            '');
+    }
+};
+exports.TracekitInterceptor = TracekitInterceptor;
+exports.TracekitInterceptor = TracekitInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('TRACEKIT_CLIENT')),
+    __metadata("design:paramtypes", [client_1.TracekitClient])
+], TracekitInterceptor);
+//# sourceMappingURL=tracekit.interceptor.js.map

package/dist/nestjs/tracekit.interceptor.js.map

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

package/dist/nestjs/tracekit.module.d.ts

@@ -0,0 +1,10 @@
+import { DynamicModule } from '@nestjs/common';
+import { TracekitConfig } from '../client';
+export declare class TracekitModule {
+    static forRoot(config: TracekitConfig): DynamicModule;
+    static forRootAsync(options: {
+        useFactory: (...args: any[]) => Promise<TracekitConfig> | TracekitConfig;
+        inject?: any[];
+    }): DynamicModule;
+}
+//# sourceMappingURL=tracekit.module.d.ts.map

package/dist/nestjs/tracekit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracekit.module.d.ts","sourceRoot":"","sources":["../../src/nestjs/tracekit.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAkB,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3D,qBAEa,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa;IAoBrD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;QACzE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,aAAa;CAqBlB"}

package/dist/nestjs/tracekit.module.js

@@ -0,0 +1,58 @@
+"use strict";
+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 TracekitModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracekitModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const client_1 = require("../client");
+const tracekit_interceptor_1 = require("./tracekit.interceptor");
+let TracekitModule = TracekitModule_1 = class TracekitModule {
+    static forRoot(config) {
+        const clientProvider = {
+            provide: 'TRACEKIT_CLIENT',
+            useFactory: () => {
+                return new client_1.TracekitClient(config);
+            },
+        };
+        const interceptorProvider = {
+            provide: core_1.APP_INTERCEPTOR,
+            useClass: tracekit_interceptor_1.TracekitInterceptor,
+        };
+        return {
+            module: TracekitModule_1,
+            providers: [clientProvider, interceptorProvider, tracekit_interceptor_1.TracekitInterceptor],
+            exports: ['TRACEKIT_CLIENT'],
+        };
+    }
+    static forRootAsync(options) {
+        const clientProvider = {
+            provide: 'TRACEKIT_CLIENT',
+            useFactory: async (...args) => {
+                const config = await options.useFactory(...args);
+                return new client_1.TracekitClient(config);
+            },
+            inject: options.inject || [],
+        };
+        const interceptorProvider = {
+            provide: core_1.APP_INTERCEPTOR,
+            useClass: tracekit_interceptor_1.TracekitInterceptor,
+        };
+        return {
+            module: TracekitModule_1,
+            providers: [clientProvider, interceptorProvider, tracekit_interceptor_1.TracekitInterceptor],
+            exports: ['TRACEKIT_CLIENT'],
+        };
+    }
+};
+exports.TracekitModule = TracekitModule;
+exports.TracekitModule = TracekitModule = TracekitModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], TracekitModule);
+//# sourceMappingURL=tracekit.module.js.map

package/dist/nestjs/tracekit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracekit.module.js","sourceRoot":"","sources":["../../src/nestjs/tracekit.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAC/D,uCAA+C;AAC/C,sCAA2D;AAC3D,iEAA6D;AAItD,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,MAAsB;QACnC,MAAM,cAAc,GAAG;YACrB,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,GAAG,EAAE;gBACf,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;SACF,CAAC;QAEF,MAAM,mBAAmB,GAAG;YAC1B,OAAO,EAAE,sBAAe;YACxB,QAAQ,EAAE,0CAAmB;SAC9B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE,CAAC,cAAc,EAAE,mBAAmB,EAAE,0CAAmB,CAAC;YACrE,OAAO,EAAE,CAAC,iBAAiB,CAAC;SAC7B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAGnB;QACC,MAAM,cAAc,GAAG;YACrB,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;gBACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;gBACjD,OAAO,IAAI,uBAAc,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,MAAM,mBAAmB,GAAG;YAC1B,OAAO,EAAE,sBAAe;YACxB,QAAQ,EAAE,0CAAmB;SAC9B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE,CAAC,cAAc,EAAE,mBAAmB,EAAE,0CAAmB,CAAC;YACrE,OAAO,EAAE,CAAC,iBAAiB,CAAC;SAC7B,CAAC;IACJ,CAAC;CACF,CAAA;AA7CY,wCAAc;yBAAd,cAAc;IAF1B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,cAAc,CA6C1B"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@tracekit/node-apm",
+  "version": "1.0.0",
+  "description": "TraceKit APM for Node.js - Zero-config distributed tracing for Express and NestJS",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "tracekit",
+    "apm",
+    "tracing",
+    "monitoring",
+    "opentelemetry",
+    "express",
+    "nestjs",
+    "performance",
+    "observability"
+  ],
+  "author": "TraceKit <support@tracekit.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Tracekit-Dev/node-apm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Tracekit-Dev/node-apm/issues"
+  },
+  "homepage": "https://tracekit.dev",
+  "dependencies": {
+    "@opentelemetry/api": "^1.7.0",
+    "@opentelemetry/sdk-trace-node": "^1.19.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.46.0",
+    "@opentelemetry/resources": "^1.19.0",
+    "@opentelemetry/semantic-conventions": "^1.19.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0",
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "typescript": "^5.3.0",
+    "express": "^4.18.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}