@west10tech/constructionwire-mcp 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+export interface ServerConfig {
+    logShipping: {
+        enabled: boolean;
+        endpoint: string;
+        apiKey?: string;
+        requireApiKey?: boolean;
+        batchSize: number;
+        flushInterval: number;
+        maxRetries: number;
+        logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'FATAL';
+    };
+    constructionwire: {
+        cONSTRUCTIONWIREUSERNAME: string;
+        cONSTRUCTIONWIREPASSWORD: string;
+        api_base_url: any;
+    };
+}
+export declare function loadConfig(): ServerConfig;
+export declare function validateConfig(config: ServerConfig): {
+    isValid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAE3B,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;KACzD,CAAC;IAEF,gBAAgB,EAAE;QAChB,wBAAwB,EAAE,MAAM,CAAC;QACjC,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,EAAE,GAAG,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,UAAU,IAAI,YAAY,CAoBzC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA+C3F"}

package/dist/config.js

@@ -0,0 +1,63 @@
+export function loadConfig() {
+    return {
+        // Log shipping configuration
+        logShipping: {
+            enabled: process.env.LOG_SHIPPING_ENABLED === 'true',
+            endpoint: process.env.LOG_INGESTION_URL || '',
+            ...(process.env.LOG_INGESTION_API_KEY && { apiKey: process.env.LOG_INGESTION_API_KEY }),
+            requireApiKey: process.env.LOG_SHIPPING_REQUIRE_API_KEY === 'true',
+            batchSize: parseInt(process.env.LOG_SHIPPING_BATCH_SIZE || '500', 10),
+            flushInterval: parseInt(process.env.LOG_SHIPPING_INTERVAL || '5000', 10),
+            maxRetries: parseInt(process.env.LOG_SHIPPING_MAX_RETRIES || '3', 10),
+            logLevel: (process.env.LOG_LEVEL || 'ERROR')
+        },
+        constructionwire: {
+            cONSTRUCTIONWIREUSERNAME: process.env.CONSTRUCTIONWIRE_USERNAME || '',
+            cONSTRUCTIONWIREPASSWORD: process.env.CONSTRUCTIONWIRE_PASSWORD || '',
+            api_base_url: "https://api.constructionwire.com/v1",
+        },
+    };
+}
+export function validateConfig(config) {
+    const errors = [];
+    // Validate log shipping configuration
+    if (config.logShipping.enabled) {
+        if (!config.logShipping.endpoint) {
+            errors.push('LOG_INGESTION_URL environment variable is required when log shipping is enabled');
+        }
+        // API key validation based on requireApiKey flag
+        if (config.logShipping.requireApiKey && !config.logShipping.apiKey) {
+            errors.push('LOG_INGESTION_API_KEY environment variable is required when LOG_SHIPPING_REQUIRE_API_KEY is true');
+        }
+        // Warning for missing API key (not an error during transition)
+        if (!config.logShipping.apiKey && !config.logShipping.requireApiKey) {
+            console.warn('[CONFIG WARNING] LOG_INGESTION_API_KEY not set. Log shipping will work now but will require an API key in the future.');
+            console.warn('[CONFIG WARNING] Set LOG_INGESTION_API_KEY to prepare for future requirements.');
+        }
+        if (config.logShipping.endpoint && !config.logShipping.endpoint.startsWith('https://')) {
+            errors.push('LOG_INGESTION_URL must use HTTPS protocol');
+        }
+        if (config.logShipping.batchSize < 1 || config.logShipping.batchSize > 1000) {
+            errors.push('LOG_SHIPPING_BATCH_SIZE must be between 1 and 1000');
+        }
+        if (config.logShipping.flushInterval < 1000) {
+            errors.push('LOG_SHIPPING_INTERVAL must be at least 1000ms');
+        }
+        if (!['DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'].includes(config.logShipping.logLevel)) {
+            errors.push('LOG_LEVEL must be one of: DEBUG, INFO, WARN, ERROR, FATAL');
+        }
+    }
+    // Validate constructionwire configuration
+    // ConstructionWire specific validation
+    if (!process.env.CONSTRUCTIONWIRE_EMAIL) {
+        errors.push('CONSTRUCTIONWIRE_EMAIL environment variable is required for ConstructionWire basic+bearer authentication');
+    }
+    if (!process.env.CONSTRUCTIONWIRE_PASSWORD) {
+        errors.push('CONSTRUCTIONWIRE_PASSWORD environment variable is required for ConstructionWire basic+bearer authentication');
+    }
+    return {
+        isValid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, CancelledNotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { config } from 'dotenv';
+import { loadConfig, validateConfig } from './config.js';
+import { LogShipper } from './services/log-shipper.js';
+import { Logger } from './services/logger.js';
+import { RequestTracker } from './services/request-tracker.js';
+import { ProgressReporter } from './services/progress-reporter.js';
+// Load environment variables
+config();
+// Import tools from each template
+import { ConstructionwireTools } from './tools/constructionwire-tools.js';
+import { ConstructionwireClient } from './clients/constructionwire-client.js';
+// Import OAuth clients only if OAuth is enabled globally
+// Import unified OAuth clients for special cases
+class ConstructionwireMcpServer {
+    // OAuth clients
+    constructor() {
+        // Initialize logging first
+        this.initializeLogging();
+        this.server = new Server({
+            name: 'constructionwire-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Initialize OAuth clients first
+        // Initialize template clients and tools
+        // Regular client - pass configuration object
+        this.constructionwireClient = new ConstructionwireClient({
+            authToken: process.env.CONSTRUCTIONWIRE_USERNAME,
+            cONSTRUCTIONWIREUSERNAME: process.env.CONSTRUCTIONWIRE_USERNAME,
+            cONSTRUCTIONWIREPASSWORD: process.env.CONSTRUCTIONWIRE_PASSWORD,
+            api_base_url: "https://api.constructionwire.com/v1",
+            logger: this.logger
+        });
+        this.constructionwireTools = new ConstructionwireTools(this.constructionwireClient);
+        this.setupHandlers();
+        this.setupNotificationHandlers();
+    }
+    initializeLogging() {
+        const config = loadConfig();
+        const validation = validateConfig(config);
+        if (!validation.isValid) {
+            console.error('Configuration validation failed:', validation.errors);
+            process.exit(1);
+        }
+        this.logShipper = new LogShipper(config.logShipping);
+        this.logger = new Logger({
+            logLevel: config.logShipping.logLevel,
+            component: 'server',
+            enableConsole: true,
+            enableShipping: config.logShipping.enabled,
+            serverName: 'constructionwire-mcp',
+            logShipper: this.logShipper
+        });
+        this.logger.info('SERVER_INIT', 'MCP server initializing', {
+            serverName: 'constructionwire-mcp',
+            logShippingEnabled: config.logShipping.enabled,
+            logLevel: config.logShipping.logLevel
+        });
+        // Initialize request tracking and progress reporting
+        this.requestTracker = new RequestTracker(this.logger);
+        this.progressReporter = new ProgressReporter(this.server, this.logger, this.requestTracker);
+        // Set up periodic cleanup
+        setInterval(() => {
+            this.requestTracker.cleanupStaleRequests();
+            this.progressReporter.cleanupCompletedRequests();
+        }, 60000);
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = [];
+            // Add constructionwire tools
+            tools.push(...this.constructionwireTools.getToolDefinitions());
+            return { tools };
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const requestId = request.id;
+            const progressToken = request.params._meta?.progressToken;
+            // Register request for tracking
+            const context = this.requestTracker.registerRequest(requestId, progressToken, name);
+            try {
+                // Handle constructionwire tools
+                if (this.constructionwireTools.canHandle(name)) {
+                    return await this.constructionwireTools.executeTool(name, args, context, this.progressReporter);
+                }
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+            catch (error) {
+                // Check if error is due to cancellation
+                if (context.abortController.signal.aborted) {
+                    this.logger.info('REQUEST_ABORTED', 'Request was cancelled', {
+                        requestId,
+                        toolName: name,
+                        reason: context.abortController.signal.reason
+                    });
+                    throw new McpError(ErrorCode.InternalError, 'Request was cancelled');
+                }
+                if (error instanceof McpError) {
+                    throw error;
+                }
+                throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            finally {
+                // Clean up request tracking
+                this.requestTracker.cleanup(requestId);
+            }
+        });
+    }
+    setupNotificationHandlers() {
+        // Handle cancellation notifications
+        this.server.setNotificationHandler(CancelledNotificationSchema, async (notification) => {
+            const { requestId, reason } = notification.params;
+            this.logger.info('CANCELLATION_RECEIVED', 'Received cancellation notification', {
+                requestId,
+                reason
+            });
+            // Cancel the request
+            const cancelled = this.requestTracker.cancelRequest(requestId, reason);
+            if (!cancelled) {
+                this.logger.debug('CANCELLATION_IGNORED', 'Cancellation ignored - request not found or already completed', {
+                    requestId
+                });
+            }
+        });
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        this.logger.info('SERVER_START', 'MCP server started successfully', {
+            serverName: 'constructionwire-mcp',
+            transport: 'stdio'
+        });
+        console.error('constructionwire-mcp MCP server running on stdio');
+        // Handle graceful shutdown for log shipping
+        const shutdown = async () => {
+            this.logger.info('SERVER_SHUTDOWN', 'MCP server shutting down', {
+                serverName: 'constructionwire-mcp'
+            });
+            // Shutdown request tracking and progress reporting
+            if (this.requestTracker) {
+                this.requestTracker.shutdown();
+            }
+            if (this.progressReporter) {
+                this.progressReporter.shutdown();
+            }
+            // Shutdown logging
+            if (this.logShipper) {
+                await this.logShipper.shutdown();
+            }
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    }
+}
+const server = new ConstructionwireMcpServer();
+server.run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/services/log-batcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * LogBatcher - Implements the exact batching logic as specified in requirements
+ * Batches logs and sends them to the centralized logging endpoint
+ */
+import { LogShipper, LogEntry } from './log-shipper.js';
+export declare class LogBatcher {
+    private logs;
+    private maxBatchSize;
+    private flushInterval;
+    private sessionId;
+    private logShipper;
+    private flushTimer;
+    constructor(logShipper: LogShipper, maxBatchSize?: number, flushInterval?: number);
+    /**
+     * Add a structured log entry to the batch
+     */
+    addStructuredLog(logEntry: LogEntry): void;
+    /**
+     * Flush all batched logs
+     */
+    flush(): Promise<void>;
+    /**
+     * Get the session ID for this batcher instance
+     */
+    getSessionId(): string;
+    /**
+     * Generate a unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Get current batch status
+     */
+    getBatchStatus(): {
+        queueSize: number;
+        maxBatchSize: number;
+        flushInterval: number;
+        sessionId: string;
+    };
+    /**
+     * Shutdown the batcher and flush remaining logs
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=log-batcher.d.ts.map

package/dist/services/log-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-batcher.d.ts","sourceRoot":"","sources":["../../src/services/log-batcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExD,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAA+B;gBAErC,UAAU,EAAE,UAAU,EAAE,YAAY,GAAE,MAAY,EAAE,aAAa,GAAE,MAAa;IAU5F;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAS1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,cAAc,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IASvG;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/services/log-batcher.js

@@ -0,0 +1,81 @@
+/**
+ * LogBatcher - Implements the exact batching logic as specified in requirements
+ * Batches logs and sends them to the centralized logging endpoint
+ */
+export class LogBatcher {
+    constructor(logShipper, maxBatchSize = 500, flushInterval = 5000) {
+        this.logs = [];
+        this.flushTimer = null;
+        this.logShipper = logShipper;
+        this.maxBatchSize = maxBatchSize;
+        this.flushInterval = flushInterval;
+        this.sessionId = this.generateSessionId();
+        // Start the flush timer
+        this.flushTimer = setInterval(() => this.flush(), this.flushInterval);
+    }
+    /**
+     * Add a structured log entry to the batch
+     */
+    addStructuredLog(logEntry) {
+        this.logs.push(logEntry);
+        // Flush immediately if batch size reached
+        if (this.logs.length >= this.maxBatchSize) {
+            this.flush();
+        }
+    }
+    /**
+     * Flush all batched logs
+     */
+    async flush() {
+        if (this.logs.length === 0)
+            return;
+        const batch = this.logs.splice(0, this.maxBatchSize);
+        try {
+            // Send each structured log through the LogShipper
+            for (const logEntry of batch) {
+                this.logShipper.addLog(logEntry);
+            }
+            // Trigger immediate flush in LogShipper
+            await this.logShipper.flush();
+        }
+        catch (error) {
+            console.error('Failed to send logs:', error);
+            // Could implement retry logic here
+        }
+    }
+    /**
+     * Get the session ID for this batcher instance
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Generate a unique session ID
+     */
+    generateSessionId() {
+        return `constructionwire-mcp-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    }
+    /**
+     * Get current batch status
+     */
+    getBatchStatus() {
+        return {
+            queueSize: this.logs.length,
+            maxBatchSize: this.maxBatchSize,
+            flushInterval: this.flushInterval,
+            sessionId: this.sessionId
+        };
+    }
+    /**
+     * Shutdown the batcher and flush remaining logs
+     */
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Flush any remaining logs
+        await this.flush();
+    }
+}
+//# sourceMappingURL=log-batcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log-batcher.js","sourceRoot":"","sources":["../../src/services/log-batcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,UAAU;IAQrB,YAAY,UAAsB,EAAE,eAAuB,GAAG,EAAE,gBAAwB,IAAI;QAPpF,SAAI,GAAe,EAAE,CAAC;QAKtB,eAAU,GAA0B,IAAI,CAAC;QAG/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE1C,wBAAwB;QACxB,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAkB;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzB,0CAA0C;QAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,kDAAkD;YAClD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC;YAED,wCAAwC;YACxC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC7C,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,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;IACH,cAAc;QACZ,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,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,2BAA2B;QAC3B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/services/log-shipper.d.ts

@@ -0,0 +1,104 @@
+/**
+ * LogShipper - Centralized log shipping service for constructionwire-mcp
+ * Sends logs to the centralized logging API endpoint with batching and retry logic
+ */
+export interface LogEntry {
+    timestamp: string;
+    level: string;
+    sessionId: string;
+    user: string;
+    integration: string;
+    component: string;
+    action: string;
+    message: string;
+    serverName: string;
+    projectId?: string;
+    organizationId?: string;
+    metadata?: {
+        toolParams?: any;
+        responseData?: any;
+        errorDetails?: any;
+        duration_ms?: number;
+        httpStatus?: number;
+        responseSize?: number;
+        requestId?: string;
+        executionId?: string;
+        [key: string]: any;
+    };
+}
+export interface LogBatch {
+    logs: LogEntry[];
+}
+export interface LogShipperConfig {
+    endpoint: string;
+    apiKey?: string;
+    requireApiKey?: boolean;
+    batchSize: number;
+    flushInterval: number;
+    maxRetries: number;
+    enabled: boolean;
+}
+export declare class LogShipper {
+    private config;
+    private logQueue;
+    private flushTimer;
+    private isShuttingDown;
+    private lastSuccessfulFlush;
+    constructor(config: LogShipperConfig);
+    private validateConfig;
+    private startFlushTimer;
+    /**
+     * Add a log entry to the queue
+     */
+    addLog(logEntry: LogEntry): void;
+    /**
+     * Flush all queued logs to the endpoint
+     */
+    flush(): Promise<void>;
+    /**
+     * Send logs with retry logic
+     */
+    private sendLogsWithRetry;
+    /**
+     * Map component values to API-accepted enum values
+     */
+    private mapComponentToValidEnum;
+    /**
+     * Map log level to API-accepted enum values (lowercase)
+     */
+    private mapLogLevelToValidEnum;
+    /**
+     * Validate and clean log entries to ensure API compatibility
+     */
+    private validateAndCleanLogs;
+    /**
+     * Clean metadata object to ensure JSON serialization compatibility
+     */
+    private cleanMetadata;
+    /**
+     * Send logs to the API endpoint
+     */
+    private sendLogs;
+    /**
+     * Generate a unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Log locally to stderr (for debugging the log shipper itself)
+     */
+    private logLocally;
+    /**
+     * Get health status of the log shipper
+     */
+    getHealthStatus(): {
+        healthy: boolean;
+        lastFlush?: string;
+        queueSize: number;
+        config: Partial<LogShipperConfig>;
+    };
+    /**
+     * Graceful shutdown - flush remaining logs
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=log-shipper.d.ts.map

package/dist/services/log-shipper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-shipper.d.ts","sourceRoot":"","sources":["../../src/services/log-shipper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE;QAET,UAAU,CAAC,EAAE,GAAG,CAAC;QACjB,YAAY,CAAC,EAAE,GAAG,CAAC;QACnB,YAAY,CAAC,EAAE,GAAG,CAAC;QAEnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,EAAE,gBAAgB;IAmBpC,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAkBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;OAEG;YACW,iBAAiB;IA6C/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,aAAa;IA6CrB;;OAEG;YACW,QAAQ;IA6EtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,eAAe,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAkBjH;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBhC"}