@devskin/agent 1.0.0

package/README.md

@@ -0,0 +1,156 @@
+# @devskin/agent
+
+DevSkin APM Agent for Node.js - Automatic instrumentation for application performance monitoring.
+
+## Installation
+
+```bash
+npm install @devskin/agent
+```
+
+## Quick Start
+
+### 1. Initialize the Agent
+
+```javascript
+const { init, startAgent } = require('@devskin/agent');
+
+const agent = init({
+  serverUrl: 'https://api-monitoring.devskin.com',
+  apiKey: 'your-api-key-here',
+  serviceName: 'my-api-service',
+  serviceVersion: '1.0.0',
+  environment: 'production',
+  sampleRate: 1.0,
+});
+
+startAgent();
+```
+
+### 2. With Express
+
+```javascript
+const express = require('express');
+const { init, startAgent, expressMiddleware, expressErrorHandler } = require('@devskin/agent');
+
+const agent = init({
+  serverUrl: 'https://api-monitoring.devskin.com',
+  apiKey: 'your-api-key',
+  serviceName: 'my-express-app',
+});
+
+await startAgent();
+
+const app = express();
+
+// Add middleware BEFORE your routes
+app.use(expressMiddleware(agent));
+
+// Your routes
+app.get('/api/users', async (req, res) => {
+  // Automatically traced!
+  const users = await getUsers();
+  res.json(users);
+});
+
+// Add error handler AFTER your routes
+app.use(expressErrorHandler(agent));
+
+app.listen(3000);
+```
+
+### 3. Manual Span Creation
+
+```javascript
+const { SpanBuilder, SpanKind, getAgent } = require('@devskin/agent');
+
+const agent = getAgent();
+
+async function processOrder(orderId) {
+  const span = new SpanBuilder(
+    'processOrder',
+    SpanKind.INTERNAL,
+    agent.getConfig().serviceName,
+    agent.getConfig().serviceVersion,
+    agent.getConfig().environment,
+    agent
+  );
+
+  span.setAttribute('order.id', orderId);
+
+  try {
+    // Your business logic
+    const order = await fetchOrder(orderId);
+    span.setAttribute('order.amount', order.amount);
+
+    return order;
+  } catch (error) {
+    span.recordError(error);
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `serverUrl` | string | *required* | DevSkin backend URL |
+| `apiKey` | string | *required* | API key for authentication |
+| `serviceName` | string | *required* | Name of your service |
+| `serviceVersion` | string | undefined | Version of your service |
+| `environment` | string | undefined | Environment (production, staging, etc) |
+| `enabled` | boolean | true | Enable/disable agent |
+| `sampleRate` | number | 1.0 | Sample rate (0.0 to 1.0) |
+| `instrumentHttp` | boolean | true | Auto-instrument HTTP |
+| `instrumentExpress` | boolean | true | Auto-instrument Express |
+| `batchSize` | number | 100 | Batch size before flushing |
+| `flushInterval` | number | 10000 | Flush interval in ms |
+| `debug` | boolean | false | Enable debug logging |
+
+## Features
+
+- ✅ Automatic HTTP request/response tracing
+- ✅ Express middleware for automatic route tracing
+- ✅ Manual span creation
+- ✅ Distributed tracing with trace ID propagation
+- ✅ Error tracking and reporting
+- ✅ Sampling support
+- ✅ Async context propagation
+- ✅ Service discovery
+
+## Best Practices
+
+1. **Initialize early**: Call `init()` and `startAgent()` as early as possible in your application
+2. **Use Express middleware**: For Express apps, use the provided middleware for automatic instrumentation
+3. **Sample in production**: Set `sampleRate` to a value < 1.0 in high-traffic production environments
+4. **Add context**: Use `span.setAttribute()` to add business context to your traces
+5. **Graceful shutdown**: Call `stopAgent()` before your application exits
+
+## Environment Variables
+
+You can also configure the agent using environment variables:
+
+```bash
+DEVSKIN_SERVER_URL=https://api-monitoring.devskin.com
+DEVSKIN_API_KEY=your-api-key
+DEVSKIN_SERVICE_NAME=my-service
+DEVSKIN_ENVIRONMENT=production
+DEVSKIN_SAMPLE_RATE=1.0
+```
+
+```javascript
+const agent = init({
+  serverUrl: process.env.DEVSKIN_SERVER_URL,
+  apiKey: process.env.DEVSKIN_API_KEY,
+  serviceName: process.env.DEVSKIN_SERVICE_NAME,
+  environment: process.env.DEVSKIN_ENVIRONMENT,
+  sampleRate: parseFloat(process.env.DEVSKIN_SAMPLE_RATE || '1.0'),
+});
+```
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,28 @@
+import { AgentConfig, Span, Transaction, LogEntry, ErrorData } from './types';
+export declare class Agent {
+    private config;
+    private apiClient;
+    private spanBuffer;
+    private transactionBuffer;
+    private logBuffer;
+    private errorBuffer;
+    private flushTimer?;
+    private initialized;
+    constructor(config: AgentConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private initHttpInstrumentation;
+    private sendServiceMetadata;
+    reportSpan(span: Span): void;
+    reportTransaction(transaction: Transaction): void;
+    reportLog(log: LogEntry): void;
+    reportError(error: ErrorData): void;
+    flush(): Promise<void>;
+    getConfig(): AgentConfig;
+    shouldSample(): boolean;
+}
+export declare function init(config: AgentConfig): Agent;
+export declare function getAgent(): Agent | null;
+export declare function startAgent(): Promise<void>;
+export declare function stopAgent(): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQ9E,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,WAAW;IAgCzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAuBb,uBAAuB;YAYvB,mBAAmB;IAuBjC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAa5B,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAajD,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAa9B,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAa7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B,SAAS,IAAI,WAAW;IAOxB,YAAY,IAAI,OAAO;CAGxB;AAUD,wBAAgB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAQ/C;AAKD,wBAAgB,QAAQ,IAAI,KAAK,GAAG,IAAI,CAEvC;AAKD,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAKD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAI/C"}

package/dist/agent.js

@@ -0,0 +1,221 @@
+"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.Agent = void 0;
+exports.init = init;
+exports.getAgent = getAgent;
+exports.startAgent = startAgent;
+exports.stopAgent = stopAgent;
+const api_client_1 = require("./api-client");
+const id_generator_1 = require("./utils/id-generator");
+class Agent {
+    constructor(config) {
+        this.spanBuffer = [];
+        this.transactionBuffer = [];
+        this.logBuffer = [];
+        this.errorBuffer = [];
+        this.initialized = false;
+        this.config = {
+            enabled: true,
+            sampleRate: 1.0,
+            instrumentHttp: true,
+            instrumentExpress: true,
+            batchSize: 100,
+            flushInterval: 10000,
+            debug: false,
+            ...config,
+        };
+        if (!this.config.enabled) {
+            console.log('[DevSkin Agent] Agent is disabled');
+            return;
+        }
+        if (!this.config.serverUrl || !this.config.apiKey || !this.config.serviceName) {
+            throw new Error('[DevSkin Agent] serverUrl, apiKey, and serviceName are required');
+        }
+        this.apiClient = new api_client_1.ApiClient(this.config.serverUrl, this.config.apiKey, this.config.serviceName, this.config.debug);
+    }
+    async start() {
+        if (!this.config.enabled)
+            return;
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        if (this.config.debug) {
+            console.log('[DevSkin Agent] Starting agent for service:', this.config.serviceName);
+        }
+        this.flushTimer = setInterval(() => {
+            this.flush();
+        }, this.config.flushInterval);
+        await this.sendServiceMetadata();
+        if (this.config.instrumentHttp) {
+            await this.initHttpInstrumentation();
+        }
+        if (this.config.debug) {
+            console.log('[DevSkin Agent] Agent started successfully');
+        }
+    }
+    async stop() {
+        if (!this.config.enabled)
+            return;
+        if (this.config.debug) {
+            console.log('[DevSkin Agent] Stopping agent...');
+        }
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        await this.flush();
+        this.initialized = false;
+        if (this.config.debug) {
+            console.log('[DevSkin Agent] Agent stopped');
+        }
+    }
+    async initHttpInstrumentation() {
+        try {
+            const { instrumentHttp } = await Promise.resolve().then(() => __importStar(require('./instrumentation/http')));
+            instrumentHttp(this);
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to initialize HTTP instrumentation:', error.message);
+        }
+    }
+    async sendServiceMetadata() {
+        try {
+            await this.apiClient.sendServiceMetadata({
+                service_version: this.config.serviceVersion,
+                environment: this.config.environment,
+                language: 'node.js',
+                language_version: process.version,
+                metadata: {
+                    platform: process.platform,
+                    arch: process.arch,
+                    node_version: process.version,
+                },
+            });
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error('[DevSkin Agent] Failed to send service metadata:', error.message);
+            }
+        }
+    }
+    reportSpan(span) {
+        if (!this.config.enabled)
+            return;
+        this.spanBuffer.push(span);
+        if (this.spanBuffer.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    reportTransaction(transaction) {
+        if (!this.config.enabled)
+            return;
+        this.transactionBuffer.push(transaction);
+        if (this.transactionBuffer.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    reportLog(log) {
+        if (!this.config.enabled)
+            return;
+        this.logBuffer.push(log);
+        if (this.logBuffer.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    reportError(error) {
+        if (!this.config.enabled)
+            return;
+        this.errorBuffer.push(error);
+        if (this.errorBuffer.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    async flush() {
+        if (!this.config.enabled)
+            return;
+        const spans = [...this.spanBuffer];
+        const transactions = [...this.transactionBuffer];
+        const logs = [...this.logBuffer];
+        const errors = [...this.errorBuffer];
+        this.spanBuffer = [];
+        this.transactionBuffer = [];
+        this.logBuffer = [];
+        this.errorBuffer = [];
+        try {
+            await Promise.all([
+                this.apiClient.sendSpans(spans),
+                this.apiClient.sendTransactions(transactions),
+                this.apiClient.sendLogs(logs),
+                this.apiClient.sendErrors(errors),
+            ]);
+        }
+        catch (error) {
+            if (this.config.debug) {
+                console.error('[DevSkin Agent] Failed to flush data:', error.message);
+            }
+        }
+    }
+    getConfig() {
+        return this.config;
+    }
+    shouldSample() {
+        return (0, id_generator_1.shouldSample)(this.config.sampleRate || 1.0);
+    }
+}
+exports.Agent = Agent;
+let globalAgent = null;
+function init(config) {
+    if (globalAgent) {
+        console.warn('[DevSkin Agent] Agent already initialized');
+        return globalAgent;
+    }
+    globalAgent = new Agent(config);
+    return globalAgent;
+}
+function getAgent() {
+    return globalAgent;
+}
+async function startAgent() {
+    if (!globalAgent) {
+        throw new Error('[DevSkin Agent] Agent not initialized. Call init() first.');
+    }
+    await globalAgent.start();
+}
+async function stopAgent() {
+    if (globalAgent) {
+        await globalAgent.stop();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/api-client.d.ts

@@ -0,0 +1,14 @@
+import { Span, Transaction, LogEntry, ErrorData } from './types';
+export declare class ApiClient {
+    private client;
+    private apiKey;
+    private serviceName;
+    private debug;
+    constructor(serverUrl: string, apiKey: string, serviceName: string, debug?: boolean);
+    sendSpans(spans: Span[]): Promise<void>;
+    sendTransactions(transactions: Transaction[]): Promise<void>;
+    sendLogs(logs: LogEntry[]): Promise<void>;
+    sendErrors(errors: ErrorData[]): Promise<void>;
+    sendServiceMetadata(metadata: Record<string, any>): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKjE,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAU;gBAEX,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,UAAQ;IAkB3E,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvC,gBAAgB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAcxE"}

package/dist/api-client.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+class ApiClient {
+    constructor(serverUrl, apiKey, serviceName, debug = false) {
+        this.apiKey = apiKey;
+        this.serviceName = serviceName;
+        this.debug = debug;
+        this.client = axios_1.default.create({
+            baseURL: serverUrl,
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-DevSkin-API-Key': apiKey,
+            },
+        });
+    }
+    async sendSpans(spans) {
+        if (spans.length === 0)
+            return;
+        try {
+            if (this.debug) {
+                console.log(`[DevSkin Agent] Sending ${spans.length} spans`);
+            }
+            await this.client.post('/api/v1/apm/spans', {
+                service_name: this.serviceName,
+                spans,
+            });
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to send spans:', error.message);
+        }
+    }
+    async sendTransactions(transactions) {
+        if (transactions.length === 0)
+            return;
+        try {
+            if (this.debug) {
+                console.log(`[DevSkin Agent] Sending ${transactions.length} transactions`);
+            }
+            await this.client.post('/api/v1/apm/transactions', {
+                service_name: this.serviceName,
+                transactions,
+            });
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to send transactions:', error.message);
+        }
+    }
+    async sendLogs(logs) {
+        if (logs.length === 0)
+            return;
+        try {
+            if (this.debug) {
+                console.log(`[DevSkin Agent] Sending ${logs.length} logs`);
+            }
+            await this.client.post('/api/v1/logs/batch', {
+                service_name: this.serviceName,
+                logs,
+            });
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to send logs:', error.message);
+        }
+    }
+    async sendErrors(errors) {
+        if (errors.length === 0)
+            return;
+        try {
+            if (this.debug) {
+                console.log(`[DevSkin Agent] Sending ${errors.length} errors`);
+            }
+            await this.client.post('/api/v1/apm/errors', {
+                service_name: this.serviceName,
+                errors,
+            });
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to send errors:', error.message);
+        }
+    }
+    async sendServiceMetadata(metadata) {
+        try {
+            if (this.debug) {
+                console.log('[DevSkin Agent] Sending service metadata');
+            }
+            await this.client.post('/api/v1/apm/services', {
+                service_name: this.serviceName,
+                ...metadata,
+            });
+        }
+        catch (error) {
+            console.error('[DevSkin Agent] Failed to send service metadata:', error.message);
+        }
+    }
+}
+exports.ApiClient = ApiClient;
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export * from './agent';
+export * from './span';
+export * from './api-client';
+export * from './utils/context';
+export * from './utils/id-generator';
+export { expressMiddleware, expressErrorHandler } from './instrumentation/express';
+export { init, getAgent, startAgent, stopAgent } from './agent';
+export { SpanBuilder, TransactionBuilder } from './span';
+export { Context } from './utils/context';
+//# 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":"AAoBA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGnF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = exports.TransactionBuilder = exports.SpanBuilder = exports.stopAgent = exports.startAgent = exports.getAgent = exports.init = exports.expressErrorHandler = exports.expressMiddleware = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./span"), exports);
+__exportStar(require("./api-client"), exports);
+__exportStar(require("./utils/context"), exports);
+__exportStar(require("./utils/id-generator"), exports);
+var express_1 = require("./instrumentation/express");
+Object.defineProperty(exports, "expressMiddleware", { enumerable: true, get: function () { return express_1.expressMiddleware; } });
+Object.defineProperty(exports, "expressErrorHandler", { enumerable: true, get: function () { return express_1.expressErrorHandler; } });
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return agent_1.init; } });
+Object.defineProperty(exports, "getAgent", { enumerable: true, get: function () { return agent_1.getAgent; } });
+Object.defineProperty(exports, "startAgent", { enumerable: true, get: function () { return agent_1.startAgent; } });
+Object.defineProperty(exports, "stopAgent", { enumerable: true, get: function () { return agent_1.stopAgent; } });
+var span_1 = require("./span");
+Object.defineProperty(exports, "SpanBuilder", { enumerable: true, get: function () { return span_1.SpanBuilder; } });
+Object.defineProperty(exports, "TransactionBuilder", { enumerable: true, get: function () { return span_1.TransactionBuilder; } });
+var context_1 = require("./utils/context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAoBA,0CAAwB;AACxB,0CAAwB;AACxB,yCAAuB;AACvB,+CAA6B;AAC7B,kDAAgC;AAChC,uDAAqC;AACrC,qDAAmF;AAA1E,4GAAA,iBAAiB,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAG/C,iCAAgE;AAAvD,6FAAA,IAAI,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,kGAAA,SAAS,OAAA;AAC9C,+BAAyD;AAAhD,mGAAA,WAAW,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AACxC,2CAA0C;AAAjC,kGAAA,OAAO,OAAA"}

package/dist/instrumentation/express.d.ts

@@ -0,0 +1,5 @@
+import { Request, Response, NextFunction } from 'express';
+import { Agent } from '../agent';
+export declare function expressMiddleware(agent: Agent): (req: Request, res: Response, next: NextFunction) => void;
+export declare function expressErrorHandler(agent: Agent): (err: Error, req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=express.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/instrumentation/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAOjC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,IAGpC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UAgGxD;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,IACtC,KAAK,KAAK,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,UA6BpE"}