@west10tech/constructionwire-mcp 1.0.0

package/dist/services/log-shipper.js

@@ -0,0 +1,384 @@
+/**
+ * LogShipper - Centralized log shipping service for constructionwire-mcp
+ * Sends logs to the centralized logging API endpoint with batching and retry logic
+ */
+export class LogShipper {
+    constructor(config) {
+        this.logQueue = [];
+        this.flushTimer = null;
+        this.isShuttingDown = false;
+        this.lastSuccessfulFlush = 0;
+        this.config = config;
+        if (!this.config.enabled) {
+            return;
+        }
+        this.validateConfig();
+        this.startFlushTimer();
+        // Log initialization
+        this.logLocally('INFO', 'LogShipper initialized', {
+            endpoint: this.config.endpoint,
+            batchSize: this.config.batchSize,
+            flushInterval: this.config.flushInterval,
+            maxRetries: this.config.maxRetries
+        });
+    }
+    validateConfig() {
+        if (!this.config.endpoint) {
+            throw new Error('LogShipper: endpoint is required');
+        }
+        // API key validation based on requireApiKey flag
+        if (this.config.requireApiKey && !this.config.apiKey) {
+            throw new Error('LogShipper: apiKey is required when requireApiKey is true');
+        }
+        // Warning for missing API key during transition period
+        if (!this.config.apiKey && !this.config.requireApiKey) {
+            this.logLocally('WARN', 'API key not configured. Log shipping will work now but will require an API key in the future.', {
+                help: 'Set LOG_INGESTION_API_KEY environment variable to prepare for future requirements'
+            });
+        }
+        if (!this.config.endpoint.startsWith('https://')) {
+            throw new Error('LogShipper: endpoint must use HTTPS');
+        }
+    }
+    startFlushTimer() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        this.flushTimer = setInterval(() => {
+            this.flush().catch(error => {
+                this.logLocally('ERROR', 'Scheduled flush failed', {
+                    error: error.message,
+                    queueSize: this.logQueue.length
+                });
+            });
+        }, this.config.flushInterval);
+    }
+    /**
+     * Add a log entry to the queue
+     */
+    addLog(logEntry) {
+        if (!this.config.enabled || this.isShuttingDown) {
+            return;
+        }
+        this.logQueue.push(logEntry);
+        // Trigger immediate flush if batch size reached
+        if (this.logQueue.length >= this.config.batchSize) {
+            this.flush().catch(error => {
+                this.logLocally('ERROR', 'Immediate flush failed', {
+                    error: error.message,
+                    queueSize: this.logQueue.length
+                });
+            });
+        }
+    }
+    /**
+     * Flush all queued logs to the endpoint
+     */
+    async flush() {
+        if (!this.config.enabled || this.logQueue.length === 0) {
+            return;
+        }
+        const batch = this.logQueue.splice(0, this.config.batchSize);
+        try {
+            await this.sendLogsWithRetry(batch);
+            this.lastSuccessfulFlush = Date.now();
+            this.logLocally('DEBUG', 'Logs shipped successfully', {
+                batchSize: batch.length,
+                queueRemaining: this.logQueue.length,
+                lastFlush: new Date(this.lastSuccessfulFlush).toISOString()
+            });
+        }
+        catch (error) {
+            // Return logs to queue on failure
+            this.logQueue.unshift(...batch);
+            this.logLocally('ERROR', 'Failed to ship logs after retries', {
+                error: error instanceof Error ? error.message : String(error),
+                batchSize: batch.length,
+                queueSize: this.logQueue.length
+            });
+            throw error;
+        }
+    }
+    /**
+     * Send logs with retry logic
+     */
+    async sendLogsWithRetry(logs) {
+        for (let attempt = 1; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                await this.sendLogs(logs);
+                return; // Success
+            }
+            catch (error) {
+                const status = error.status || error.response?.status;
+                // Don't retry on client errors (4xx except 429)
+                if (status >= 400 && status < 500 && status !== 429) {
+                    this.logLocally('ERROR', 'Client error - not retrying', {
+                        status,
+                        error: error.message,
+                        attempt
+                    });
+                    throw error;
+                }
+                // On last attempt, throw the error
+                if (attempt === this.config.maxRetries) {
+                    this.logLocally('ERROR', 'Max retries exceeded', {
+                        status,
+                        error: error.message,
+                        attempts: attempt
+                    });
+                    throw error;
+                }
+                // Calculate delay with exponential backoff
+                const baseDelay = status === 429 ? 1000 : 500; // Longer delay for rate limits
+                const delay = baseDelay * Math.pow(2, attempt - 1);
+                this.logLocally('WARN', 'Retrying log shipment', {
+                    status,
+                    error: error.message,
+                    attempt,
+                    nextAttemptIn: delay,
+                    maxRetries: this.config.maxRetries
+                });
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+    }
+    /**
+     * Map component values to API-accepted enum values
+     */
+    mapComponentToValidEnum(component) {
+        const validComponents = ['client', 'tools', 'oauth-client'];
+        const componentMap = {
+            'server': 'client',
+            'client': 'client',
+            'tools': 'tools',
+            'oauth-client': 'oauth-client'
+        };
+        const componentStr = String(component || 'client');
+        const mapped = componentMap[componentStr.toLowerCase()];
+        return mapped || 'client'; // Default to 'client' for any unmapped components
+    }
+    /**
+     * Map log level to API-accepted enum values (lowercase)
+     */
+    mapLogLevelToValidEnum(level) {
+        const validLevels = ['info', 'error', 'warn', 'debug'];
+        const levelMap = {
+            'info': 'info',
+            'error': 'error',
+            'warn': 'warn',
+            'warning': 'warn',
+            'debug': 'debug',
+            'fatal': 'error' // Map fatal to error as API doesn't support fatal
+        };
+        const levelStr = String(level || 'info');
+        const mapped = levelMap[levelStr.toLowerCase()];
+        return mapped || 'info'; // Default to 'info' for any unmapped levels
+    }
+    /**
+     * Validate and clean log entries to ensure API compatibility
+     */
+    validateAndCleanLogs(logs) {
+        return logs.map(log => {
+            // Ensure all required fields are present and valid
+            const cleanedLog = {
+                timestamp: log.timestamp || new Date().toISOString(),
+                level: this.mapLogLevelToValidEnum(log.level || 'info'),
+                sessionId: log.sessionId || this.generateSessionId(),
+                user: log.user || process.env.CORETEXT_USER || 'unknown',
+                integration: log.integration || 'unknown',
+                component: this.mapComponentToValidEnum(log.component || 'client'),
+                action: log.action || 'unknown',
+                message: String(log.message || 'No message'),
+                serverName: log.serverName || 'constructionwire-mcp',
+                projectId: log.projectId || process.env.PROJECT_ID || '',
+                organizationId: log.organizationId || process.env.ORGANIZATION_ID || ''
+            };
+            // Clean and validate metadata
+            if (log.metadata && typeof log.metadata === 'object') {
+                cleanedLog.metadata = this.cleanMetadata(log.metadata);
+            }
+            return cleanedLog;
+        }).filter(log => {
+            // Filter out any logs that still have invalid data
+            return log.timestamp && log.level && log.user && log.message;
+        });
+    }
+    /**
+     * Clean metadata object to ensure JSON serialization compatibility
+     */
+    cleanMetadata(metadata) {
+        if (!metadata || typeof metadata !== 'object') {
+            return {};
+        }
+        const cleaned = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            try {
+                // Skip undefined values
+                if (value === undefined) {
+                    continue;
+                }
+                // Convert functions to string representation
+                if (typeof value === 'function') {
+                    cleaned[key] = '[Function]';
+                    continue;
+                }
+                // Handle circular references and complex objects
+                if (typeof value === 'object' && value !== null) {
+                    try {
+                        // Test if the object can be serialized
+                        JSON.stringify(value);
+                        cleaned[key] = value;
+                    }
+                    catch (e) {
+                        // If serialization fails, convert to string
+                        cleaned[key] = String(value);
+                    }
+                }
+                else {
+                    cleaned[key] = value;
+                }
+            }
+            catch (error) {
+                // If any error occurs with this field, skip it
+                this.logLocally('WARN', 'Skipping problematic metadata field', {
+                    field: key,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Send logs to the API endpoint
+     */
+    async sendLogs(logs) {
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        // Only include API key header if provided
+        if (this.config.apiKey) {
+            headers['X-API-Key'] = this.config.apiKey;
+        }
+        // Validate and clean logs before sending
+        const cleanedLogs = this.validateAndCleanLogs(logs);
+        const payload = { logs: cleanedLogs };
+        // Debug logging - log the exact payload being sent
+        this.logLocally('DEBUG', 'Sending log payload', {
+            payloadSize: JSON.stringify(payload).length,
+            logCount: cleanedLogs.length,
+            endpoint: this.config.endpoint,
+            hasApiKey: !!this.config.apiKey,
+            payload: JSON.stringify(payload, null, 2)
+        });
+        const response = await fetch(this.config.endpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            // Get response body for debugging
+            let responseBody = '';
+            try {
+                responseBody = await response.text();
+            }
+            catch (e) {
+                responseBody = 'Unable to read response body';
+            }
+            // Log detailed error information
+            this.logLocally('ERROR', 'HTTP error response from log ingestion API', {
+                status: response.status,
+                statusText: response.statusText,
+                responseBody,
+                requestPayloadSize: JSON.stringify({ logs: cleanedLogs }).length,
+                endpoint: this.config.endpoint,
+                headers: Object.keys(headers)
+            });
+            // Provide helpful message for authentication errors
+            if ((response.status === 401 || response.status === 403) && !this.config.apiKey) {
+                const error = new Error(`Authentication required (${response.status}). The log ingestion API now requires an API key. ` +
+                    'Please set LOG_INGESTION_API_KEY environment variable and restart the server.');
+                error.status = response.status;
+                throw error;
+            }
+            // Provide specific error message for 400 Bad Request
+            if (response.status === 400) {
+                const error = new Error(`Bad Request (400): The log payload format is invalid. ` +
+                    `Response: ${responseBody}. ` +
+                    'Check the payload structure and field formats.');
+                error.status = response.status;
+                throw error;
+            }
+            const error = new Error(`HTTP ${response.status}: ${response.statusText}. Response: ${responseBody}`);
+            error.status = response.status;
+            throw error;
+        }
+        return response.json();
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId() {
+        return `constructionwire-mcp-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    }
+    /**
+     * Log locally to stderr (for debugging the log shipper itself)
+     */
+    logLocally(level, message, metadata) {
+        const timestamp = new Date().toISOString();
+        const user = process.env.CORETEXT_USER || 'unknown';
+        const logEntry = {
+            timestamp,
+            user,
+            component: 'log-shipper',
+            level,
+            message,
+            ...(metadata && { metadata })
+        };
+        console.error(`[CONSTRUCTIONWIRE-MCP-LOG-SHIPPER] ${JSON.stringify(logEntry)}`);
+    }
+    /**
+     * Get health status of the log shipper
+     */
+    getHealthStatus() {
+        const now = Date.now();
+        const timeSinceLastFlush = now - this.lastSuccessfulFlush;
+        const isHealthy = this.config.enabled && (this.lastSuccessfulFlush === 0 || timeSinceLastFlush < this.config.flushInterval * 3);
+        return {
+            healthy: isHealthy,
+            lastFlush: this.lastSuccessfulFlush > 0 ? new Date(this.lastSuccessfulFlush).toISOString() : undefined,
+            queueSize: this.logQueue.length,
+            config: {
+                enabled: this.config.enabled,
+                endpoint: this.config.endpoint,
+                batchSize: this.config.batchSize,
+                flushInterval: this.config.flushInterval
+            }
+        };
+    }
+    /**
+     * Graceful shutdown - flush remaining logs
+     */
+    async shutdown() {
+        this.isShuttingDown = true;
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.logLocally('INFO', 'LogShipper shutting down', {
+            queueSize: this.logQueue.length
+        });
+        if (this.logQueue.length > 0) {
+            try {
+                await this.flush();
+                this.logLocally('INFO', 'Final flush completed successfully');
+            }
+            catch (error) {
+                this.logLocally('ERROR', 'Final flush failed', {
+                    error: error instanceof Error ? error.message : String(error),
+                    lostLogs: this.logQueue.length
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=log-shipper.js.map

package/dist/services/log-shipper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-shipper.js","sourceRoot":"","sources":["../../src/services/log-shipper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH,MAAM,OAAO,UAAU;IAOrB,YAAY,MAAwB;QAL5B,aAAQ,GAAe,EAAE,CAAC;QAC1B,eAAU,GAA0B,IAAI,CAAC;QACzC,mBAAc,GAAG,KAAK,CAAC;QACvB,wBAAmB,GAAG,CAAC,CAAC;QAG9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,qBAAqB;QACrB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,wBAAwB,EAAE;YAChD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YACxC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACnC,CAAC,CAAC;IACL,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,iDAAiD;QACjD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QAED,uDAAuD;QACvD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YACtD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,+FAA+F,EAAE;gBACvH,IAAI,EAAE,mFAAmF;aAC1F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBACzB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,wBAAwB,EAAE;oBACjD,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;iBAChC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAkB;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7B,gDAAgD;QAChD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBACzB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,wBAAwB,EAAE;oBACjD,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;iBAChC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAEtC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,2BAA2B,EAAE;gBACpD,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;gBACpC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kCAAkC;YAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;YAEhC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,mCAAmC,EAAE;gBAC5D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;aAChC,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,IAAgB;QAC9C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO,CAAC,UAAU;YACpB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEtD,gDAAgD;gBAChD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBACpD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,6BAA6B,EAAE;wBACtD,MAAM;wBACN,KAAK,EAAE,KAAK,CAAC,OAAO;wBACpB,OAAO;qBACR,CAAC,CAAC;oBACH,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,mCAAmC;gBACnC,IAAI,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;oBACvC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,sBAAsB,EAAE;wBAC/C,MAAM;wBACN,KAAK,EAAE,KAAK,CAAC,OAAO;wBACpB,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAC;oBACH,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,2CAA2C;gBAC3C,MAAM,SAAS,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,+BAA+B;gBAC9E,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBAEnD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,uBAAuB,EAAE;oBAC/C,MAAM;oBACN,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,OAAO;oBACP,aAAa,EAAE,KAAK;oBACpB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;iBACnC,CAAC,CAAC;gBAEH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,SAAiB;QAC/C,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAC5D,MAAM,YAAY,GAA2B;YAC3C,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,OAAO;YAChB,cAAc,EAAE,cAAc;SAC/B,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,OAAO,MAAM,IAAI,QAAQ,CAAC,CAAC,kDAAkD;IAC/E,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,KAAa;QAC1C,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,QAAQ,GAA2B;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,OAAO,CAAC,kDAAkD;SACpE,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,IAAI,MAAM,CAAC,CAAC,4CAA4C;IACvE,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAgB;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACpB,mDAAmD;YACnD,MAAM,UAAU,GAAa;gBAC3B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpD,KAAK,EAAE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC;gBACvD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,iBAAiB,EAAE;gBACpD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS;gBACxD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;gBACzC,SAAS,EAAE,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC;gBAClE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,SAAS;gBAC/B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,YAAY,CAAC;gBAC5C,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,sBAAsB;gBACpD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE;gBACxD,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;aACxE,CAAC;YAEF,8BAA8B;YAC9B,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACrD,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;YACd,mDAAmD;YACnD,OAAO,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,QAAa;QACjC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAQ,EAAE,CAAC;QAExB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,wBAAwB;gBACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,SAAS;gBACX,CAAC;gBAED,6CAA6C;gBAC7C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;oBAC5B,SAAS;gBACX,CAAC;gBAED,iDAAiD;gBACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAChD,IAAI,CAAC;wBACH,uCAAuC;wBACvC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;wBACtB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACvB,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,4CAA4C;wBAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,+CAA+C;gBAC/C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,qCAAqC,EAAE;oBAC7D,KAAK,EAAE,GAAG;oBACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ,CAAC,IAAgB;QACrC,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,0CAA0C;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC5C,CAAC;QAED,yCAAyC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAEtC,mDAAmD;QACnD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,qBAAqB,EAAE;YAC9C,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM;YAC3C,QAAQ,EAAE,WAAW,CAAC,MAAM;YAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAC/B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,kCAAkC;YAClC,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,YAAY,GAAG,8BAA8B,CAAC;YAChD,CAAC;YAED,iCAAiC;YACjC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,4CAA4C,EAAE;gBACrE,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,YAAY;gBACZ,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM;gBAChE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YAEH,oDAAoD;YACpD,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChF,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,4BAA4B,QAAQ,CAAC,MAAM,oDAAoD;oBAC/F,+EAA+E,CAChF,CAAC;gBACD,KAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,qDAAqD;YACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,wDAAwD;oBACxD,aAAa,YAAY,IAAI;oBAC7B,gDAAgD,CACjD,CAAC;gBACD,KAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,eAAe,YAAY,EAAE,CAAC,CAAC;YACrG,KAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,OAAO,wBAAwB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5F,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,KAAa,EAAE,OAAe,EAAE,QAAc;QAC/D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS,CAAC;QAEpD,MAAM,QAAQ,GAAG;YACf,SAAS;YACT,IAAI;YACJ,SAAS,EAAE,aAAa;YACxB,KAAK;YACL,OAAO;YACP,GAAG,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;SAC9B,CAAC;QAEF,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,eAAe;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QAEhI,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;YACtG,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC/B,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;gBAC5B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAChC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;aACzC;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,0BAA0B,EAAE;YAClD,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;SAChC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;YAChE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,oBAAoB,EAAE;oBAC7C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC7D,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/services/logger.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Logger - Centralized logging service for constructionwire-mcp
+ * Provides structured logging with centralized log shipping capability
+ */
+import { LogShipper } from './log-shipper.js';
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';
+export interface LoggerConfig {
+    logLevel: LogLevel;
+    component: string;
+    enableConsole: boolean;
+    enableShipping: boolean;
+    serverName: string;
+    logShipper?: LogShipper;
+}
+export declare class Logger {
+    private config;
+    private batcher;
+    private logLevelPriority;
+    constructor(config: LoggerConfig);
+    /**
+     * Log a debug message
+     */
+    debug(action: string, message: string, metadata?: any): void;
+    /**
+     * Log an info message
+     */
+    info(action: string, message: string, metadata?: any): void;
+    /**
+     * Log a warning message
+     */
+    warn(action: string, message: string, metadata?: any): void;
+    /**
+     * Log an error message
+     */
+    error(action: string, message: string, metadata?: any): void;
+    /**
+     * Log a fatal error message
+     */
+    fatal(action: string, message: string, metadata?: any): void;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Log HTTP request start
+     */
+    logRequestStart(method: string, url: string, metadata?: any): void;
+    /**
+     * Log HTTP request success
+     */
+    logRequestSuccess(method: string, url: string, status: number, duration: number, metadata?: any): void;
+    /**
+     * Log HTTP request error
+     */
+    logRequestError(method: string, url: string, error: any, duration: number, metadata?: any): void;
+    /**
+     * Log tool execution start
+     */
+    logToolStart(toolName: string, params: any): void;
+    /**
+     * Log tool execution success
+     */
+    logToolSuccess(toolName: string, duration: number, responseData?: any, httpStatus?: number): void;
+    /**
+     * Log tool execution error
+     */
+    logToolError(toolName: string, error: any, duration: number, params?: any): void;
+    /**
+     * Log authentication events
+     */
+    logAuthEvent(event: string, success: boolean, metadata?: any): void;
+    /**
+     * Log rate limiting events
+     */
+    logRateLimit(action: string, delayMs: number, metadata?: any): void;
+    /**
+     * Truncate large data objects to prevent oversized log entries
+     */
+    private truncateIfNeeded;
+    /**
+     * Get logger status
+     */
+    getStatus(): {
+        config: LoggerConfig;
+        batcherStatus?: any;
+    };
+    /**
+     * Shutdown logger and flush remaining logs
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/services/logger.d.ts.map

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