optictrace 1.0.1

package/README.md

@@ -0,0 +1,99 @@
+# OpticTrace SDK
+
+OpenTelemetry-based SDK for OpticTrace observability. This SDK provides automatic and manual instrumentation for Node.js applications, including HTTP, Express, PostgreSQL, and MongoDB.
+
+## Installation
+
+```bash
+npm install optictrace
+```
+
+## Features
+
+- **Automatic Instrumentation**: HTTP, Express, PG, and MongoDB.
+- **Environment Logging**: Tag logs and traces with `development`, `staging`, `production`, etc.
+- **Manual Logging**: Send logs directly to the OpticTrace Hub.
+- **API Discovery**: Automatically discover and sync your Express routes.
+- **OpenAPI Generation**: Generate OpenAPI 3.0 specs from your Express app.
+
+## Usage
+
+### Initialization
+
+```javascript
+import OT from 'optictrace';
+
+OT.init({
+    serviceName: 'my-service',
+    hubUrl: 'http://localhost:8080',
+    apiKey: 'your-api-key',
+    environment: 'production'
+});
+```
+
+### Express Integration & Route Discovery
+
+```javascript
+import express from 'express';
+import OT from 'optictrace';
+
+const app = express();
+
+// ... define your routes ...
+
+OT.discoverRoutes(app);
+```
+
+### Database Tracing
+
+#### PostgreSQL
+
+```javascript
+import { Pool } from 'pg';
+import OT from 'optictrace';
+
+const pool = OT.wrapPool(new Pool({
+    // ... config ...
+}));
+
+// All queries via this pool will now be traced automatically
+await pool.query('SELECT * FROM users');
+```
+
+#### MongoDB
+
+```javascript
+import { MongoClient } from 'mongodb';
+import OT from 'optictrace';
+
+const client = OT.wrapMongoClient(new MongoClient('mongodb://localhost:27017'));
+
+// All operations will be traced
+const db = client.db('test');
+await db.collection('users').find({}).toArray();
+```
+
+### Manual Logging
+
+```javascript
+import OT from 'optictrace';
+
+OT.log('INFO', 'User logged in', { userId: '123' });
+OT.log('ERROR', 'Database connection failed', { error: err.message });
+```
+
+### OpenAPI Specification Generation
+
+```javascript
+import OT from 'optictrace';
+
+// Save OpenAPI spec to a file
+OT.saveOpenApi(app, './openapi.yaml');
+
+// Or get the YAML string
+const yaml = OT.generateOpenApiSpec(app);
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import type { Pool } from 'pg';
+import type { MongoClient } from 'mongodb';
+import type { Application } from 'express';
+import type { OpticTraceConfig, LogLevel, LogAttributes } from './types';
+/**
+ * Initialize the OpticTrace SDK
+ */
+export declare function init(config: OpticTraceConfig): void;
+/**
+ * Discover and register API routes from Express app
+ */
+export declare function discoverRoutes(app: Application): void;
+/**
+ * Send a log message to OpticTrace
+ */
+export declare function log(level: LogLevel, message: string, attributes?: LogAttributes): void;
+/**
+ * Wrap a PostgreSQL connection pool for automatic query tracing
+ */
+export declare function wrapPool<T extends Pool>(pool: T): T;
+/**
+ * Wrap a MongoDB client for automatic query tracing
+ */
+export declare function wrapMongoClient<T extends MongoClient>(client: T): T;
+/**
+ * Generate OpenAPI 3.0 specification from Express app routes
+ */
+export declare function generateOpenApiSpec(app: Application): string;
+/**
+ * Save OpenAPI specification to a file
+ */
+export declare function saveOpenApi(app: Application, filePath: string): void;
+declare const _default: {
+    init: typeof init;
+    discoverRoutes: typeof discoverRoutes;
+    log: typeof log;
+    wrapPool: typeof wrapPool;
+    wrapMongoClient: typeof wrapMongoClient;
+    generateOpenApiSpec: typeof generateOpenApiSpec;
+    saveOpenApi: typeof saveOpenApi;
+};
+export default _default;
+//# 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":"AAYA,OAAO,KAAK,EAAE,IAAI,EAA+B,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAA4B,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAS,QAAQ,EAAE,aAAa,EAAmD,MAAM,SAAS,CAAC;AASjI;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAkEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA6CrD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,aAAkB,GAAG,IAAI,CA4B1F;AAsCD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAyCnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CA2EnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAqG5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQpE;;;;;;;;;;AAGD,wBAA0G"}

package/dist/index.js

@@ -0,0 +1,399 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import * as fs from 'fs';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { ExpressInstrumentation } from '@opentelemetry/instrumentation-express';
+import { PgInstrumentation } from '@opentelemetry/instrumentation-pg';
+import { MongoDBInstrumentation } from '@opentelemetry/instrumentation-mongodb';
+import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
+import { logs } from '@opentelemetry/api-logs';
+let sdk;
+let routeDiscoveryUrl;
+let serviceName;
+let logger;
+let apiKey;
+let currentEnvironment = 'development';
+/**
+ * Initialize the OpticTrace SDK
+ */
+export function init(config) {
+    const { serviceName: name = 'nodejs-service', hubUrl = 'http://localhost:8080', apiKey: key, environment = process.env.OPTICTRACE_ENV || process.env.NODE_ENV || 'development', // Default to development
+     } = config;
+    currentEnvironment = environment;
+    serviceName = name;
+    apiKey = key;
+    routeDiscoveryUrl = `${hubUrl}/v1/routes`;
+    const resource = new Resource({
+        [ATTR_SERVICE_NAME]: serviceName,
+        'deployment.environment': environment,
+    });
+    const traceExporter = new OTLPTraceExporter({
+        url: `${hubUrl}/v1/traces`,
+        headers: apiKey ? { 'X-API-Key': apiKey } : {},
+    });
+    const logExporter = new OTLPLogExporter({
+        url: `${hubUrl}/v1/logs`,
+        headers: apiKey ? { 'X-API-Key': apiKey } : {},
+    });
+    // Configure logging with immediate export
+    const loggerProvider = new LoggerProvider({ resource });
+    loggerProvider.addLogRecordProcessor(new BatchLogRecordProcessor(logExporter, {
+        maxQueueSize: 100,
+        maxExportBatchSize: 1, // Export immediately
+        scheduledDelayMillis: 500, // Export every 500ms
+    }));
+    logs.setGlobalLoggerProvider(loggerProvider);
+    logger = loggerProvider.getLogger(serviceName);
+    sdk = new NodeSDK({
+        resource,
+        traceExporter,
+        instrumentations: [
+            new HttpInstrumentation(),
+            new ExpressInstrumentation(),
+            new PgInstrumentation({
+                enhancedDatabaseReporting: true,
+            }),
+            new MongoDBInstrumentation({
+                enhancedDatabaseReporting: true,
+            }),
+        ],
+    });
+    sdk.start();
+    console.log(`[OpticTrace] SDK initialized for service: ${serviceName}`);
+    // Graceful shutdown
+    process.on('SIGTERM', () => {
+        sdk?.shutdown()
+            .then(() => console.log('[OpticTrace] SDK shut down successfully'))
+            .catch((error) => console.error('[OpticTrace] Error shutting down SDK', error))
+            .finally(() => process.exit(0));
+    });
+}
+/**
+ * Discover and register API routes from Express app
+ */
+export function discoverRoutes(app) {
+    const appWithRouter = app;
+    if (!app || !appWithRouter._router) {
+        console.error('[OpticTrace] Invalid Express app provided');
+        return;
+    }
+    const routes = [];
+    // Extract routes from Express app
+    const extractRoutes = (stack, basePath = '') => {
+        stack.forEach((layer) => {
+            if (layer.route) {
+                // Regular route
+                const path = basePath + layer.route.path;
+                const methods = Object.keys(layer.route.methods).map(m => m.toUpperCase());
+                methods.forEach(method => {
+                    routes.push({ method, path });
+                });
+            }
+            else if (layer.name === 'router' && layer.handle?.stack) {
+                // Nested router
+                const routerPath = layer.regexp?.source
+                    .replace('\\/?', '')
+                    .replace('(?=\\/|$)', '')
+                    .replace(/\\\//g, '/')
+                    .replace(/\^/g, '')
+                    .replace(/\$/g, '') || '';
+                extractRoutes(layer.handle.stack, basePath + routerPath);
+            }
+        });
+    };
+    extractRoutes(appWithRouter._router.stack);
+    fetch(routeDiscoveryUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify({ service: serviceName, routes }),
+    })
+        .then(() => console.log(`[OpticTrace] Discovered ${routes.length} routes`))
+        .catch((err) => console.error('[OpticTrace] Failed to send routes:', err));
+}
+/**
+ * Send a log message to OpticTrace
+ */
+export function log(level, message, attributes = {}) {
+    // Send log directly to Hub via HTTP
+    const logData = {
+        timestamp: new Date().toISOString(),
+        service: serviceName,
+        level: level,
+        message: message,
+        attributes: attributes,
+        trace_id: '',
+        span_id: '',
+        environment: currentEnvironment,
+    };
+    // Send to Hub backend
+    fetch(`${routeDiscoveryUrl.replace('/v1/routes', '/api/logs/ingest')}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify(logData),
+    }).catch(() => {
+        // Silently fail - don't want logging to break the app
+    });
+    // Also log to console for debugging
+    const consoleMethod = level === 'ERROR' ? 'error' : level === 'WARN' ? 'warn' : 'log';
+    console[consoleMethod](`[${level}] ${message}`);
+}
+/**
+ * Internal function to trace database queries
+ */
+function traceQuery(query, params, duration, dbSystem = 'postgresql', dbName = 'default', error = null) {
+    const traceData = {
+        timestamp: new Date().toISOString(),
+        service: serviceName,
+        query: query,
+        duration_ms: duration,
+        error: error ? error.message : null,
+        params: params ? JSON.stringify(params) : null,
+        db_system: dbSystem,
+        db_name: dbName,
+        environment: currentEnvironment,
+    };
+    // Send to Hub backend
+    fetch(`${routeDiscoveryUrl.replace('/v1/routes', '/api/traces/ingest')}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify(traceData),
+    }).catch(() => {
+        // Silently fail
+    });
+}
+/**
+ * Wrap a PostgreSQL connection pool for automatic query tracing
+ */
+export function wrapPool(pool) {
+    const originalQuery = pool.query.bind(pool);
+    // Override query method - use Function type to avoid complex overload issues
+    pool.query = function (...args) {
+        const startTime = Date.now();
+        let queryText = '';
+        let queryParams = null;
+        // Extract query and params from various call signatures
+        if (typeof args[0] === 'string') {
+            queryText = args[0];
+            queryParams = args[1] || null;
+        }
+        else if (args[0] && typeof args[0] === 'object' && 'text' in args[0]) {
+            const config = args[0];
+            queryText = config.text;
+            queryParams = config.values || null;
+        }
+        // Execute the original query
+        const result = originalQuery(...args);
+        // Handle promise-based queries
+        if (result && typeof result.then === 'function') {
+            return result
+                .then((res) => {
+                const duration = Date.now() - startTime;
+                traceQuery(queryText, queryParams, duration, 'postgresql', 'users_db');
+                return res;
+            })
+                .catch((err) => {
+                const duration = Date.now() - startTime;
+                traceQuery(queryText, queryParams, duration, 'postgresql', 'users_db', err);
+                throw err;
+            });
+        }
+        return result;
+    };
+    return pool;
+}
+/**
+ * Wrap a MongoDB client for automatic query tracing
+ */
+export function wrapMongoClient(client) {
+    const originalDb = client.db.bind(client);
+    // Override db method - use Function type to avoid complex type issues
+    client.db = function (dbName) {
+        const db = originalDb(dbName);
+        const originalCollection = db.collection.bind(db);
+        // Override collection method
+        db.collection = function (collectionName) {
+            const collection = originalCollection(collectionName);
+            // Methods to wrap
+            const methods = [
+                'find', 'findOne', 'insertOne', 'insertMany',
+                'updateOne', 'updateMany', 'deleteOne', 'deleteMany',
+                'countDocuments', 'aggregate'
+            ];
+            methods.forEach(method => {
+                const collectionWithMethod = collection;
+                if (typeof collectionWithMethod[method] === 'function') {
+                    const originalMethod = collectionWithMethod[method].bind(collection);
+                    collectionWithMethod[method] = function (...args) {
+                        const startTime = Date.now();
+                        const result = originalMethod(...args);
+                        const handleFinish = (err, res) => {
+                            const duration = Date.now() - startTime;
+                            const query = `${method}(${JSON.stringify(args[0] || {})})`;
+                            traceQuery(query, args.slice(1), duration, 'mongodb', dbName || 'default', err);
+                        };
+                        // Handle both promise-based and cursor-based return types
+                        if (result && typeof result.then === 'function') {
+                            return result
+                                .then((res) => {
+                                handleFinish(null, res);
+                                return res;
+                            })
+                                .catch((err) => {
+                                handleFinish(err);
+                                throw err;
+                            });
+                        }
+                        else if (result && typeof result.toArray === 'function') {
+                            // Specialized path for cursors
+                            const cursor = result;
+                            const originalToArray = cursor.toArray.bind(result);
+                            cursor.toArray = function (...taArgs) {
+                                return originalToArray(...taArgs)
+                                    .then((res) => {
+                                    handleFinish(null, res);
+                                    return res;
+                                })
+                                    .catch((err) => {
+                                    handleFinish(err);
+                                    throw err;
+                                });
+                            };
+                            return result;
+                        }
+                        return result;
+                    };
+                }
+            });
+            return collection;
+        };
+        return db;
+    };
+    return client;
+}
+/**
+ * Generate OpenAPI 3.0 specification from Express app routes
+ */
+export function generateOpenApiSpec(app) {
+    const appWithRouter = app;
+    if (!app || !appWithRouter._router) {
+        throw new Error('[OpticTrace] Invalid Express app provided');
+    }
+    const routes = [];
+    // Extract routes from Express app (reusing logic from discoverRoutes)
+    const extractRoutes = (stack, basePath = '') => {
+        stack.forEach((layer) => {
+            if (layer.route) {
+                const path = basePath + layer.route.path;
+                const methods = Object.keys(layer.route.methods).map(m => m.toUpperCase());
+                methods.forEach(method => {
+                    routes.push({ method, path });
+                });
+            }
+            else if (layer.name === 'router' && layer.handle?.stack) {
+                const routerPath = layer.regexp?.source
+                    .replace('\\/?', '')
+                    .replace('(?=\\/|$)', '')
+                    .replace(/\\\//g, '/')
+                    .replace(/\^/g, '')
+                    .replace(/\$/g, '') || '';
+                extractRoutes(layer.handle.stack, basePath + routerPath);
+            }
+        });
+    };
+    extractRoutes(appWithRouter._router.stack);
+    const spec = {
+        openapi: '3.0.0',
+        info: {
+            title: `${serviceName} API`,
+            version: '1.0.0',
+            description: `Auto-generated OpenAPI spec for ${serviceName}`,
+        },
+        paths: {},
+    };
+    routes.forEach((route) => {
+        // Convert Express path parameters (:id) to OpenAPI path parameters ({id})
+        const openApiPath = route.path.replace(/:(\w+)/g, '{$1}');
+        if (!spec.paths[openApiPath]) {
+            spec.paths[openApiPath] = {};
+        }
+        const method = route.method.toLowerCase();
+        spec.paths[openApiPath][method] = {
+            summary: `${route.method} ${route.path}`,
+            responses: {
+                200: {
+                    description: 'Successful response',
+                },
+            },
+        };
+        // Add parameters if any
+        const params = route.path.match(/:(\w+)/g);
+        if (params) {
+            spec.paths[openApiPath][method].parameters = params.map((p) => ({
+                name: p.substring(1),
+                in: 'path',
+                required: true,
+                schema: { type: 'string' },
+            }));
+        }
+    });
+    // Helper to convert object to simple YAML
+    const toYaml = (obj, indent = 0) => {
+        const spaces = ' '.repeat(indent);
+        let yaml = '';
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === null || value === undefined) {
+                yaml += `${spaces}${key}: null\n`;
+            }
+            else if (Array.isArray(value)) {
+                yaml += `${spaces}${key}:\n`;
+                value.forEach((item) => {
+                    if (typeof item === 'object') {
+                        yaml += `${spaces}  - ${toYaml(item, indent + 4).trimStart()}`;
+                    }
+                    else {
+                        yaml += `${spaces}  - ${item}\n`;
+                    }
+                });
+            }
+            else if (typeof value === 'object') {
+                yaml += `${spaces}${key}:\n${toYaml(value, indent + 2)}`;
+            }
+            else if (typeof value === 'string') {
+                yaml += `${spaces}${key}: "${value}"\n`;
+            }
+            else {
+                yaml += `${spaces}${key}: ${value}\n`;
+            }
+        }
+        return yaml;
+    };
+    return toYaml(spec);
+}
+/**
+ * Save OpenAPI specification to a file
+ */
+export function saveOpenApi(app, filePath) {
+    try {
+        const yamlSpec = generateOpenApiSpec(app);
+        fs.writeFileSync(filePath, yamlSpec, 'utf8');
+        console.log(`[OpticTrace] OpenAPI specification saved to ${filePath}`);
+    }
+    catch (error) {
+        console.error(`[OpticTrace] Failed to save OpenAPI specification: ${error}`);
+    }
+}
+// Default export
+export default { init, discoverRoutes, log, wrapPool, wrapMongoClient, generateOpenApiSpec, saveOpenApi };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAO/C,IAAI,GAAwB,CAAC;AAC7B,IAAI,iBAAyB,CAAC;AAC9B,IAAI,WAAmB,CAAC;AACxB,IAAI,MAA0B,CAAC;AAC/B,IAAI,MAA0B,CAAC;AAC/B,IAAI,kBAAkB,GAAW,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,MAAwB;IACzC,MAAM,EACF,WAAW,EAAE,IAAI,GAAG,gBAAgB,EACpC,MAAM,GAAG,uBAAuB,EAChC,MAAM,EAAE,GAAG,EACX,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,EAAE,yBAAyB;MAC/G,GAAG,MAAM,CAAC;IAEX,kBAAkB,GAAG,WAAW,CAAC;IAEjC,WAAW,GAAG,IAAI,CAAC;IACnB,MAAM,GAAG,GAAG,CAAC;IACb,iBAAiB,GAAG,GAAG,MAAM,YAAY,CAAC;IAE1C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;QAC1B,CAAC,iBAAiB,CAAC,EAAE,WAAW;QAChC,wBAAwB,EAAE,WAAW;KACxC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC;QACxC,GAAG,EAAE,GAAG,MAAM,YAAY;QAC1B,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;KACjD,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACpC,GAAG,EAAE,GAAG,MAAM,UAAU;QACxB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;KACjD,CAAC,CAAC;IAEH,0CAA0C;IAC1C,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,cAAc,CAAC,qBAAqB,CAChC,IAAI,uBAAuB,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,GAAG;QACjB,kBAAkB,EAAE,CAAC,EAAE,qBAAqB;QAC5C,oBAAoB,EAAE,GAAG,EAAE,qBAAqB;KACnD,CAAC,CACL,CAAC;IACF,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE/C,GAAG,GAAG,IAAI,OAAO,CAAC;QACd,QAAQ;QACR,aAAa;QACb,gBAAgB,EAAE;YACd,IAAI,mBAAmB,EAAE;YACzB,IAAI,sBAAsB,EAAE;YAC5B,IAAI,iBAAiB,CAAC;gBAClB,yBAAyB,EAAE,IAAI;aAClC,CAAC;YACF,IAAI,sBAAsB,CAAC;gBACvB,yBAAyB,EAAE,IAAI;aAClC,CAAC;SACL;KACJ,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,CAAC,GAAG,CAAC,6CAA6C,WAAW,EAAE,CAAC,CAAC;IAExE,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,GAAG,EAAE,QAAQ,EAAE;aACV,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;aAClE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;aAC9E,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC3C,MAAM,aAAa,GAAG,GAA2D,CAAC;IAElF,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,kCAAkC;IAClC,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAE,QAAQ,GAAG,EAAE,EAAQ,EAAE;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,gBAAgB;gBAChB,MAAM,IAAI,GAAG,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC3E,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;oBACrB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC,CAAC,CAAC;YACP,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACxD,gBAAgB;gBAChB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM;qBAClC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;qBACnB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;qBACxB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;qBACrB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;qBAClB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC9B,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3C,KAAK,CAAC,iBAAiB,EAAE;QACrB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;KACzD,CAAC;SACG,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;SAC1E,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,aAA4B,EAAE;IAChF,oCAAoC;IACpC,MAAM,OAAO,GAAG;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,kBAAkB;KAClC,CAAC;IAEF,sBAAsB;IACtB,KAAK,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,YAAY,EAAE,kBAAkB,CAAC,EAAE,EAAE;QACpE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACV,sDAAsD;IAC1D,CAAC,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,aAAa,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACtF,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CACf,KAAa,EACb,MAAmB,EACnB,QAAgB,EAChB,WAAqB,YAAY,EACjC,MAAM,GAAG,SAAS,EAClB,QAAsB,IAAI;IAE1B,MAAM,SAAS,GAAG;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,QAAQ;QACrB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACnC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9C,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,kBAAkB;KAClC,CAAC;IAEF,sBAAsB;IACtB,KAAK,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,YAAY,EAAE,oBAAoB,CAAC,EAAE,EAAE;QACtE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;KAClC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QACV,gBAAgB;IACpB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAiB,IAAO;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,6EAA6E;IAC5E,IAA4B,CAAC,KAAK,GAAG,UAAU,GAAG,IAAe;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,WAAW,GAAgB,IAAI,CAAC;QAEpC,wDAAwD;QACxD,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,WAAW,GAAI,IAAI,CAAC,CAAC,CAAiB,IAAI,IAAI,CAAC;QACnD,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAgB,CAAC;YACtC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;YACxB,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QACxC,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,GAAI,aAA0B,CAAC,GAAG,IAAI,CAAC,CAAC;QAEpD,+BAA+B;QAC/B,IAAI,MAAM,IAAI,OAAQ,MAA8B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACvE,OAAQ,MAA2B;iBAC9B,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;gBACV,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACxC,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;gBACvE,OAAO,GAAG,CAAC;YACf,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACxC,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;gBAC5E,MAAM,GAAG,CAAC;YACd,CAAC,CAAC,CAAC;QACX,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAwB,MAAS;IAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1C,sEAAsE;IACrE,MAA2B,CAAC,EAAE,GAAG,UAAU,MAAe;QACvD,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,kBAAkB,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAElD,6BAA6B;QAC5B,EAA+B,CAAC,UAAU,GAAG,UAAU,cAAsB;YAC1E,MAAM,UAAU,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;YAEtD,kBAAkB;YAClB,MAAM,OAAO,GAAG;gBACZ,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY;gBAC5C,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY;gBACpD,gBAAgB,EAAE,WAAW;aAChC,CAAC;YAEF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBACrB,MAAM,oBAAoB,GAAG,UAA6D,CAAC;gBAE3F,IAAI,OAAO,oBAAoB,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;oBACrD,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACrE,oBAAoB,CAAC,MAAM,CAAC,GAAG,UAAU,GAAG,IAAe;wBACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;wBAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;wBAEvC,MAAM,YAAY,GAAG,CAAC,GAAiB,EAAE,GAAa,EAAQ,EAAE;4BAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;4BACxC,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC;4BAC5D,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,IAAI,SAAS,EAAE,GAAG,CAAC,CAAC;wBACpF,CAAC,CAAC;wBAEF,0DAA0D;wBAC1D,IAAI,MAAM,IAAI,OAAQ,MAA8B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;4BACvE,OAAQ,MAA2B;iCAC9B,IAAI,CAAC,CAAC,GAAY,EAAE,EAAE;gCACnB,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gCACxB,OAAO,GAAG,CAAC;4BACf,CAAC,CAAC;iCACD,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;gCAClB,YAAY,CAAC,GAAG,CAAC,CAAC;gCAClB,MAAM,GAAG,CAAC;4BACd,CAAC,CAAC,CAAC;wBACX,CAAC;6BAAM,IAAI,MAAM,IAAI,OAAQ,MAAiC,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;4BACpF,+BAA+B;4BAC/B,MAAM,MAAM,GAAG,MAA+D,CAAC;4BAC/E,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;4BACpD,MAAM,CAAC,OAAO,GAAG,UAAU,GAAG,MAAiB;gCAC3C,OAAO,eAAe,CAAC,GAAG,MAAM,CAAC;qCAC5B,IAAI,CAAC,CAAC,GAAY,EAAE,EAAE;oCACnB,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oCACxB,OAAO,GAAG,CAAC;gCACf,CAAC,CAAC;qCACD,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;oCAClB,YAAY,CAAC,GAAG,CAAC,CAAC;oCAClB,MAAM,GAAG,CAAC;gCACd,CAAC,CAAC,CAAC;4BACX,CAAC,CAAC;4BACF,OAAO,MAAM,CAAC;wBAClB,CAAC;wBAED,OAAO,MAAM,CAAC;oBAClB,CAAC,CAAC;gBACN,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC;QACtB,CAAC,CAAC;QAEF,OAAO,EAAE,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAChD,MAAM,aAAa,GAAG,GAA2D,CAAC;IAElF,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,sEAAsE;IACtE,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAE,QAAQ,GAAG,EAAE,EAAQ,EAAE;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC3E,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;oBACrB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC,CAAC,CAAC;YACP,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;gBACxD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM;qBAClC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;qBACnB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;qBACxB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;qBACrB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;qBAClB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC9B,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG;QACT,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACF,KAAK,EAAE,GAAG,WAAW,MAAM;YAC3B,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,mCAAmC,WAAW,EAAE;SAChE;QACD,KAAK,EAAE,EAAyB;KACnC,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,0EAA0E;QAC1E,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG;YAC9B,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE;YACxC,SAAS,EAAE;gBACP,GAAG,EAAE;oBACD,WAAW,EAAE,qBAAqB;iBACrC;aACJ;SACJ,CAAC;QAEF,wBAAwB;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5D,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;gBACpB,EAAE,EAAE,MAAM;gBACV,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC7B,CAAC,CAAC,CAAC;QACR,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0CAA0C;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAQ,EAAE,MAAM,GAAG,CAAC,EAAU,EAAE;QAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG,UAAU,CAAC;YACtC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC3B,IAAI,IAAI,GAAG,MAAM,OAAO,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;oBACnE,CAAC;yBAAM,CAAC;wBACJ,IAAI,IAAI,GAAG,MAAM,OAAO,IAAI,IAAI,CAAC;oBACrC,CAAC;gBACL,CAAC,CAAC,CAAC;YACP,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnC,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7D,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnC,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG,MAAM,KAAK,KAAK,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACJ,IAAI,IAAI,GAAG,MAAM,GAAG,GAAG,KAAK,KAAK,IAAI,CAAC;YAC1C,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,QAAgB;IAC1D,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC1C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sDAAsD,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;AACL,CAAC;AAED,iBAAiB;AACjB,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * OpticTrace SDK Type Definitions
+ */
+import type { Pool } from 'pg';
+import type { MongoClient } from 'mongodb';
+import type { Application } from 'express';
+/**
+ * SDK Configuration
+ */
+export interface OpticTraceConfig {
+    /** Name of the service */
+    serviceName: string;
+    /** Hub backend URL */
+    hubUrl?: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Deployment environment (default: 'development') */
+    environment?: string;
+}
+/**
+ * Route definition for API discovery
+ */
+export interface Route {
+    method: string;
+    path: string;
+}
+/**
+ * Supported environments
+ */
+export type Environment = 'development' | 'staging' | 'uat' | 'production';
+/**
+ * Log severity levels
+ */
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * Database system types
+ */
+export type DBSystem = 'postgresql' | 'mongodb' | 'mysql' | 'sqlite';
+/**
+ * Log attributes (key-value pairs)
+ */
+export type LogAttributes = Record<string, string | number | boolean>;
+/**
+ * Express Router Layer (internal structure)
+ */
+export interface RouterLayer {
+    route?: {
+        path: string;
+        methods: Record<string, boolean>;
+    };
+    name?: string;
+    regexp?: RegExp & {
+        source: string;
+    };
+    handle?: {
+        stack: RouterLayer[];
+    };
+}
+/**
+ * PostgreSQL Query Config
+ */
+export interface QueryConfig {
+    text: string;
+    values?: unknown[];
+}
+/**
+ * Database query parameters (can be array or object)
+ */
+export type QueryParams = unknown[] | Record<string, unknown> | null;
+/**
+ * OpticTrace SDK Interface
+ */
+export interface OpticTraceSDK {
+    /**
+     * Initialize the SDK
+     */
+    init(config: OpticTraceConfig): void;
+    /**
+     * Discover and register API routes
+     */
+    discoverRoutes(app: Application): void;
+    /**
+     * Send a log message
+     */
+    log(level: LogLevel, message: string, attributes?: LogAttributes): void;
+    /**
+     * Wrap a PostgreSQL connection pool for automatic tracing
+     */
+    wrapPool<T extends Pool>(pool: T): T;
+    /**
+     * Wrap a MongoDB client for automatic tracing
+     */
+    wrapMongoClient<T extends MongoClient>(client: T): T;
+    /**
+     * Generate OpenAPI 3.0 specification from Express app routes
+     */
+    generateOpenApiSpec(app: Application): string;
+    /**
+     * Save OpenAPI specification to a file
+     */
+    saveOpenApi(app: Application, filePath: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA+B,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAExE;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IAErC;;OAEG;IACH,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAErD;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC;IAE9C;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * OpticTrace SDK Type Definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "optictrace",
+  "version": "1.0.1",
+  "description": "OpenTelemetry-based SDK for OpticTrace observability",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "observability",
+    "opentelemetry",
+    "tracing",
+    "logging",
+    "typescript"
+  ],
+  "author": "Rajat",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rajat/project-lens"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "^0.54.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.54.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.54.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.54.0",
+    "@opentelemetry/instrumentation-express": "^0.44.0",
+    "@opentelemetry/instrumentation-http": "^0.54.0",
+    "@opentelemetry/instrumentation-mongodb": "^0.48.0",
+    "@opentelemetry/instrumentation-pg": "^0.48.0",
+    "@opentelemetry/resources": "^1.29.0",
+    "@opentelemetry/sdk-logs": "^0.54.0",
+    "@opentelemetry/sdk-node": "^0.54.0",
+    "@opentelemetry/semantic-conventions": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/mongodb": "^4.0.6",
+    "@types/node": "^20.10.6",
+    "@types/pg": "^8.10.9",
+    "express": "^5.2.1",
+    "mongodb": "^7.1.0",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0",
+    "mongodb": "^6.3.0",
+    "pg": "^8.11.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,462 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import * as fs from 'fs';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { ExpressInstrumentation } from '@opentelemetry/instrumentation-express';
+import { PgInstrumentation } from '@opentelemetry/instrumentation-pg';
+import { MongoDBInstrumentation } from '@opentelemetry/instrumentation-mongodb';
+import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
+import { logs } from '@opentelemetry/api-logs';
+import type { Pool, QueryResult, QueryResultRow } from 'pg';
+import type { MongoClient, Db, Collection, Document } from 'mongodb';
+import type { Application } from 'express';
+import type { Logger } from '@opentelemetry/api-logs';
+import type { OpticTraceConfig, Route, LogLevel, LogAttributes, DBSystem, RouterLayer, QueryConfig, QueryParams } from './types';
+
+let sdk: NodeSDK | undefined;
+let routeDiscoveryUrl: string;
+let serviceName: string;
+let logger: Logger | undefined;
+let apiKey: string | undefined;
+let currentEnvironment: string = 'development';
+
+/**
+ * Initialize the OpticTrace SDK
+ */
+export function init(config: OpticTraceConfig): void {
+    const {
+        serviceName: name = 'nodejs-service',
+        hubUrl = 'http://localhost:8080',
+        apiKey: key,
+        environment = process.env.OPTICTRACE_ENV || process.env.NODE_ENV || 'development', // Default to development
+    } = config;
+
+    currentEnvironment = environment;
+
+    serviceName = name;
+    apiKey = key;
+    routeDiscoveryUrl = `${hubUrl}/v1/routes`;
+
+    const resource = new Resource({
+        [ATTR_SERVICE_NAME]: serviceName,
+        'deployment.environment': environment,
+    });
+
+    const traceExporter = new OTLPTraceExporter({
+        url: `${hubUrl}/v1/traces`,
+        headers: apiKey ? { 'X-API-Key': apiKey } : {},
+    });
+
+    const logExporter = new OTLPLogExporter({
+        url: `${hubUrl}/v1/logs`,
+        headers: apiKey ? { 'X-API-Key': apiKey } : {},
+    });
+
+    // Configure logging with immediate export
+    const loggerProvider = new LoggerProvider({ resource });
+    loggerProvider.addLogRecordProcessor(
+        new BatchLogRecordProcessor(logExporter, {
+            maxQueueSize: 100,
+            maxExportBatchSize: 1, // Export immediately
+            scheduledDelayMillis: 500, // Export every 500ms
+        })
+    );
+    logs.setGlobalLoggerProvider(loggerProvider);
+    logger = loggerProvider.getLogger(serviceName);
+
+    sdk = new NodeSDK({
+        resource,
+        traceExporter,
+        instrumentations: [
+            new HttpInstrumentation(),
+            new ExpressInstrumentation(),
+            new PgInstrumentation({
+                enhancedDatabaseReporting: true,
+            }),
+            new MongoDBInstrumentation({
+                enhancedDatabaseReporting: true,
+            }),
+        ],
+    });
+
+    sdk.start();
+    console.log(`[OpticTrace] SDK initialized for service: ${serviceName}`);
+
+    // Graceful shutdown
+    process.on('SIGTERM', () => {
+        sdk?.shutdown()
+            .then(() => console.log('[OpticTrace] SDK shut down successfully'))
+            .catch((error) => console.error('[OpticTrace] Error shutting down SDK', error))
+            .finally(() => process.exit(0));
+    });
+}
+
+/**
+ * Discover and register API routes from Express app
+ */
+export function discoverRoutes(app: Application): void {
+    const appWithRouter = app as Application & { _router?: { stack: RouterLayer[] } };
+
+    if (!app || !appWithRouter._router) {
+        console.error('[OpticTrace] Invalid Express app provided');
+        return;
+    }
+
+    const routes: Route[] = [];
+
+    // Extract routes from Express app
+    const extractRoutes = (stack: RouterLayer[], basePath = ''): void => {
+        stack.forEach((layer) => {
+            if (layer.route) {
+                // Regular route
+                const path = basePath + layer.route.path;
+                const methods = Object.keys(layer.route.methods).map(m => m.toUpperCase());
+                methods.forEach(method => {
+                    routes.push({ method, path });
+                });
+            } else if (layer.name === 'router' && layer.handle?.stack) {
+                // Nested router
+                const routerPath = layer.regexp?.source
+                    .replace('\\/?', '')
+                    .replace('(?=\\/|$)', '')
+                    .replace(/\\\//g, '/')
+                    .replace(/\^/g, '')
+                    .replace(/\$/g, '') || '';
+                extractRoutes(layer.handle.stack, basePath + routerPath);
+            }
+        });
+    };
+
+    extractRoutes(appWithRouter._router.stack);
+
+    fetch(routeDiscoveryUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify({ service: serviceName, routes }),
+    })
+        .then(() => console.log(`[OpticTrace] Discovered ${routes.length} routes`))
+        .catch((err) => console.error('[OpticTrace] Failed to send routes:', err));
+}
+
+/**
+ * Send a log message to OpticTrace
+ */
+export function log(level: LogLevel, message: string, attributes: LogAttributes = {}): void {
+    // Send log directly to Hub via HTTP
+    const logData = {
+        timestamp: new Date().toISOString(),
+        service: serviceName,
+        level: level,
+        message: message,
+        attributes: attributes,
+        trace_id: '',
+        span_id: '',
+        environment: currentEnvironment,
+    };
+
+    // Send to Hub backend
+    fetch(`${routeDiscoveryUrl.replace('/v1/routes', '/api/logs/ingest')}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify(logData),
+    }).catch(() => {
+        // Silently fail - don't want logging to break the app
+    });
+
+    // Also log to console for debugging
+    const consoleMethod = level === 'ERROR' ? 'error' : level === 'WARN' ? 'warn' : 'log';
+    console[consoleMethod](`[${level}] ${message}`);
+}
+
+/**
+ * Internal function to trace database queries
+ */
+function traceQuery(
+    query: string,
+    params: QueryParams,
+    duration: number,
+    dbSystem: DBSystem = 'postgresql',
+    dbName = 'default',
+    error: Error | null = null
+): void {
+    const traceData = {
+        timestamp: new Date().toISOString(),
+        service: serviceName,
+        query: query,
+        duration_ms: duration,
+        error: error ? error.message : null,
+        params: params ? JSON.stringify(params) : null,
+        db_system: dbSystem,
+        db_name: dbName,
+        environment: currentEnvironment,
+    };
+
+    // Send to Hub backend
+    fetch(`${routeDiscoveryUrl.replace('/v1/routes', '/api/traces/ingest')}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(apiKey ? { 'X-API-Key': apiKey } : {})
+        },
+        body: JSON.stringify(traceData),
+    }).catch(() => {
+        // Silently fail
+    });
+}
+
+/**
+ * Wrap a PostgreSQL connection pool for automatic query tracing
+ */
+export function wrapPool<T extends Pool>(pool: T): T {
+    const originalQuery = pool.query.bind(pool);
+
+    // Override query method - use Function type to avoid complex overload issues
+    (pool as { query: Function }).query = function (...args: unknown[]): unknown {
+        const startTime = Date.now();
+        let queryText = '';
+        let queryParams: QueryParams = null;
+
+        // Extract query and params from various call signatures
+        if (typeof args[0] === 'string') {
+            queryText = args[0];
+            queryParams = (args[1] as QueryParams) || null;
+        } else if (args[0] && typeof args[0] === 'object' && 'text' in args[0]) {
+            const config = args[0] as QueryConfig;
+            queryText = config.text;
+            queryParams = config.values || null;
+        }
+
+        // Execute the original query
+        const result = (originalQuery as Function)(...args);
+
+        // Handle promise-based queries
+        if (result && typeof (result as { then?: Function }).then === 'function') {
+            return (result as Promise<unknown>)
+                .then((res) => {
+                    const duration = Date.now() - startTime;
+                    traceQuery(queryText, queryParams, duration, 'postgresql', 'users_db');
+                    return res;
+                })
+                .catch((err) => {
+                    const duration = Date.now() - startTime;
+                    traceQuery(queryText, queryParams, duration, 'postgresql', 'users_db', err);
+                    throw err;
+                });
+        }
+
+        return result;
+    };
+
+    return pool;
+}
+
+/**
+ * Wrap a MongoDB client for automatic query tracing
+ */
+export function wrapMongoClient<T extends MongoClient>(client: T): T {
+    const originalDb = client.db.bind(client);
+
+    // Override db method - use Function type to avoid complex type issues
+    (client as { db: Function }).db = function (dbName?: string): Db {
+        const db = originalDb(dbName);
+        const originalCollection = db.collection.bind(db);
+
+        // Override collection method
+        (db as { collection: Function }).collection = function (collectionName: string): Collection<Document> {
+            const collection = originalCollection(collectionName);
+
+            // Methods to wrap
+            const methods = [
+                'find', 'findOne', 'insertOne', 'insertMany',
+                'updateOne', 'updateMany', 'deleteOne', 'deleteMany',
+                'countDocuments', 'aggregate'
+            ];
+
+            methods.forEach(method => {
+                const collectionWithMethod = collection as Collection<Document> & Record<string, Function>;
+
+                if (typeof collectionWithMethod[method] === 'function') {
+                    const originalMethod = collectionWithMethod[method].bind(collection);
+                    collectionWithMethod[method] = function (...args: unknown[]): unknown {
+                        const startTime = Date.now();
+                        const result = originalMethod(...args);
+
+                        const handleFinish = (err: Error | null, res?: unknown): void => {
+                            const duration = Date.now() - startTime;
+                            const query = `${method}(${JSON.stringify(args[0] || {})})`;
+                            traceQuery(query, args.slice(1), duration, 'mongodb', dbName || 'default', err);
+                        };
+
+                        // Handle both promise-based and cursor-based return types
+                        if (result && typeof (result as { then?: Function }).then === 'function') {
+                            return (result as Promise<unknown>)
+                                .then((res: unknown) => {
+                                    handleFinish(null, res);
+                                    return res;
+                                })
+                                .catch((err: Error) => {
+                                    handleFinish(err);
+                                    throw err;
+                                });
+                        } else if (result && typeof (result as { toArray?: Function }).toArray === 'function') {
+                            // Specialized path for cursors
+                            const cursor = result as { toArray: (...args: unknown[]) => Promise<unknown> };
+                            const originalToArray = cursor.toArray.bind(result);
+                            cursor.toArray = function (...taArgs: unknown[]): Promise<unknown> {
+                                return originalToArray(...taArgs)
+                                    .then((res: unknown) => {
+                                        handleFinish(null, res);
+                                        return res;
+                                    })
+                                    .catch((err: Error) => {
+                                        handleFinish(err);
+                                        throw err;
+                                    });
+                            };
+                            return result;
+                        }
+
+                        return result;
+                    };
+                }
+            });
+
+            return collection;
+        };
+
+        return db;
+    };
+
+    return client;
+}
+
+/**
+ * Generate OpenAPI 3.0 specification from Express app routes
+ */
+export function generateOpenApiSpec(app: Application): string {
+    const appWithRouter = app as Application & { _router?: { stack: RouterLayer[] } };
+
+    if (!app || !appWithRouter._router) {
+        throw new Error('[OpticTrace] Invalid Express app provided');
+    }
+
+    const routes: Route[] = [];
+
+    // Extract routes from Express app (reusing logic from discoverRoutes)
+    const extractRoutes = (stack: RouterLayer[], basePath = ''): void => {
+        stack.forEach((layer) => {
+            if (layer.route) {
+                const path = basePath + layer.route.path;
+                const methods = Object.keys(layer.route.methods).map(m => m.toUpperCase());
+                methods.forEach(method => {
+                    routes.push({ method, path });
+                });
+            } else if (layer.name === 'router' && layer.handle?.stack) {
+                const routerPath = layer.regexp?.source
+                    .replace('\\/?', '')
+                    .replace('(?=\\/|$)', '')
+                    .replace(/\\\//g, '/')
+                    .replace(/\^/g, '')
+                    .replace(/\$/g, '') || '';
+                extractRoutes(layer.handle.stack, basePath + routerPath);
+            }
+        });
+    };
+
+    extractRoutes(appWithRouter._router.stack);
+
+    const spec = {
+        openapi: '3.0.0',
+        info: {
+            title: `${serviceName} API`,
+            version: '1.0.0',
+            description: `Auto-generated OpenAPI spec for ${serviceName}`,
+        },
+        paths: {} as Record<string, any>,
+    };
+
+    routes.forEach((route) => {
+        // Convert Express path parameters (:id) to OpenAPI path parameters ({id})
+        const openApiPath = route.path.replace(/:(\w+)/g, '{$1}');
+
+        if (!spec.paths[openApiPath]) {
+            spec.paths[openApiPath] = {};
+        }
+
+        const method = route.method.toLowerCase();
+        spec.paths[openApiPath][method] = {
+            summary: `${route.method} ${route.path}`,
+            responses: {
+                200: {
+                    description: 'Successful response',
+                },
+            },
+        };
+
+        // Add parameters if any
+        const params = route.path.match(/:(\w+)/g);
+        if (params) {
+            spec.paths[openApiPath][method].parameters = params.map((p) => ({
+                name: p.substring(1),
+                in: 'path',
+                required: true,
+                schema: { type: 'string' },
+            }));
+        }
+    });
+
+    // Helper to convert object to simple YAML
+    const toYaml = (obj: any, indent = 0): string => {
+        const spaces = ' '.repeat(indent);
+        let yaml = '';
+
+        for (const [key, value] of Object.entries(obj)) {
+            if (value === null || value === undefined) {
+                yaml += `${spaces}${key}: null\n`;
+            } else if (Array.isArray(value)) {
+                yaml += `${spaces}${key}:\n`;
+                value.forEach((item) => {
+                    if (typeof item === 'object') {
+                        yaml += `${spaces}  - ${toYaml(item, indent + 4).trimStart()}`;
+                    } else {
+                        yaml += `${spaces}  - ${item}\n`;
+                    }
+                });
+            } else if (typeof value === 'object') {
+                yaml += `${spaces}${key}:\n${toYaml(value, indent + 2)}`;
+            } else if (typeof value === 'string') {
+                yaml += `${spaces}${key}: "${value}"\n`;
+            } else {
+                yaml += `${spaces}${key}: ${value}\n`;
+            }
+        }
+        return yaml;
+    };
+
+    return toYaml(spec);
+}
+
+/**
+ * Save OpenAPI specification to a file
+ */
+export function saveOpenApi(app: Application, filePath: string): void {
+    try {
+        const yamlSpec = generateOpenApiSpec(app);
+        fs.writeFileSync(filePath, yamlSpec, 'utf8');
+        console.log(`[OpticTrace] OpenAPI specification saved to ${filePath}`);
+    } catch (error) {
+        console.error(`[OpticTrace] Failed to save OpenAPI specification: ${error}`);
+    }
+}
+
+// Default export
+export default { init, discoverRoutes, log, wrapPool, wrapMongoClient, generateOpenApiSpec, saveOpenApi };

package/src/types.ts

@@ -0,0 +1,118 @@
+/**
+ * OpticTrace SDK Type Definitions
+ */
+
+import type { Pool, QueryResult, QueryResultRow } from 'pg';
+import type { MongoClient } from 'mongodb';
+import type { Application } from 'express';
+import type { Logger } from '@opentelemetry/api-logs';
+
+/**
+ * SDK Configuration
+ */
+export interface OpticTraceConfig {
+    /** Name of the service */
+    serviceName: string;
+    /** Hub backend URL */
+    hubUrl?: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Deployment environment (default: 'development') */
+    environment?: string;
+}
+
+/**
+ * Route definition for API discovery
+ */
+export interface Route {
+    method: string;
+    path: string;
+}
+
+/**
+ * Supported environments
+ */
+export type Environment = 'development' | 'staging' | 'uat' | 'production';
+
+/**
+ * Log severity levels
+ */
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+
+/**
+ * Database system types
+ */
+export type DBSystem = 'postgresql' | 'mongodb' | 'mysql' | 'sqlite';
+
+/**
+ * Log attributes (key-value pairs)
+ */
+export type LogAttributes = Record<string, string | number | boolean>;
+
+/**
+ * Express Router Layer (internal structure)
+ */
+export interface RouterLayer {
+    route?: {
+        path: string;
+        methods: Record<string, boolean>;
+    };
+    name?: string;
+    regexp?: RegExp & { source: string };
+    handle?: {
+        stack: RouterLayer[];
+    };
+}
+
+/**
+ * PostgreSQL Query Config
+ */
+export interface QueryConfig {
+    text: string;
+    values?: unknown[];
+}
+
+/**
+ * Database query parameters (can be array or object)
+ */
+export type QueryParams = unknown[] | Record<string, unknown> | null;
+
+/**
+ * OpticTrace SDK Interface
+ */
+export interface OpticTraceSDK {
+    /**
+     * Initialize the SDK
+     */
+    init(config: OpticTraceConfig): void;
+
+    /**
+     * Discover and register API routes
+     */
+    discoverRoutes(app: Application): void;
+
+    /**
+     * Send a log message
+     */
+    log(level: LogLevel, message: string, attributes?: LogAttributes): void;
+
+    /**
+     * Wrap a PostgreSQL connection pool for automatic tracing
+     */
+    wrapPool<T extends Pool>(pool: T): T;
+
+    /**
+     * Wrap a MongoDB client for automatic tracing
+     */
+    wrapMongoClient<T extends MongoClient>(client: T): T;
+
+    /**
+     * Generate OpenAPI 3.0 specification from Express app routes
+     */
+    generateOpenApiSpec(app: Application): string;
+
+    /**
+     * Save OpenAPI specification to a file
+     */
+    saveOpenApi(app: Application, filePath: string): void;
+}