attio-mcp 0.1.2 → 1.1.0

package/dist/middleware/performance.js

@@ -0,0 +1,298 @@
+/**
+ * Performance Tracking Middleware
+ *
+ * Provides performance monitoring and timing for all MCP tool operations.
+ * Tracks execution time, API latency, and performance bottlenecks.
+ */
+import { performance } from 'perf_hooks';
+/**
+ * Performance tracking service
+ */
+export class PerformanceTracker {
+    static metrics = [];
+    static thresholds = new Map();
+    static enabled = process.env.PERFORMANCE_TRACKING !== 'false';
+    static maxMetrics = parseInt(process.env.PERF_MAX_METRICS || '1000', 10);
+    static metricsIndex = 0;
+    static isBufferFull = false;
+    /**
+     * Set performance thresholds for a tool
+     */
+    static setThresholds(toolName, thresholds) {
+        this.thresholds.set(toolName, thresholds);
+    }
+    /**
+     * Get default thresholds
+     */
+    static getDefaultThresholds() {
+        return {
+            warning: 1000, // 1 second
+            critical: 5000, // 5 seconds
+        };
+    }
+    /**
+     * Start tracking an operation
+     */
+    static startOperation(toolName, metadata) {
+        if (!this.enabled)
+            return 0;
+        const startTime = performance.now();
+        // Log slow operations in development
+        if (process.env.NODE_ENV === 'development') {
+            const thresholds = this.thresholds.get(toolName) || this.getDefaultThresholds();
+            const metadataHint = metadata && Object.keys(metadata).length > 0
+                ? ` metadata=${JSON.stringify(metadata)}`
+                : '';
+            // Set a timeout to warn about slow operations
+            setTimeout(() => {
+                const duration = performance.now() - startTime;
+                if (duration > thresholds.critical) {
+                    console.warn(`⚠️ Critical: ${toolName} is taking too long (${duration.toFixed(2)}ms)${metadataHint}`);
+                }
+                else if (duration > thresholds.warning) {
+                    console.warn(`⚠️ Warning: ${toolName} is slow (${duration.toFixed(2)}ms)${metadataHint}`);
+                }
+            }, thresholds.warning);
+        }
+        return startTime;
+    }
+    /**
+     * End tracking an operation
+     */
+    static endOperation(toolName, startTime, success = true, error, metadata) {
+        if (!this.enabled) {
+            return {
+                toolName,
+                startTime: 0,
+                endTime: 0,
+                duration: 0,
+                success,
+            };
+        }
+        const endTime = performance.now();
+        const duration = endTime - startTime;
+        const metrics = {
+            toolName,
+            startTime,
+            endTime,
+            duration,
+            success,
+            error,
+            metadata,
+        };
+        // Use circular buffer for efficient memory management
+        if (this.isBufferFull) {
+            // Overwrite oldest entry
+            this.metrics[this.metricsIndex] = metrics;
+        }
+        else {
+            // Still filling the buffer
+            this.metrics.push(metrics);
+            if (this.metrics.length >= this.maxMetrics) {
+                this.isBufferFull = true;
+            }
+        }
+        // Update circular buffer index
+        this.metricsIndex = (this.metricsIndex + 1) % this.maxMetrics;
+        // Log performance in development
+        if (process.env.NODE_ENV === 'development') {
+            const thresholds = this.thresholds.get(toolName) || this.getDefaultThresholds();
+            const statusIcon = success ? '✅' : '❌';
+            const timeColor = duration > thresholds.critical
+                ? '🔴'
+                : duration > thresholds.warning
+                    ? '🟡'
+                    : '🟢';
+            console.error(`${statusIcon} ${toolName}: ${timeColor} ${duration.toFixed(2)}ms` +
+                (error ? ` (Error: ${error})` : ''));
+        }
+        return metrics;
+    }
+    /**
+     * Get performance summary for a tool
+     */
+    static getSummary(toolName) {
+        const relevantMetrics = toolName
+            ? this.metrics.filter((m) => m.toolName === toolName)
+            : this.metrics;
+        if (relevantMetrics.length === 0) {
+            return {
+                totalOperations: 0,
+                successfulOperations: 0,
+                failedOperations: 0,
+                averageDuration: 0,
+                minDuration: 0,
+                maxDuration: 0,
+                p50Duration: 0,
+                p95Duration: 0,
+                p99Duration: 0,
+            };
+        }
+        const durations = relevantMetrics
+            .map((m) => m.duration)
+            .sort((a, b) => a - b);
+        const successCount = relevantMetrics.filter((m) => m.success).length;
+        const failureCount = relevantMetrics.length - successCount;
+        return {
+            totalOperations: relevantMetrics.length,
+            successfulOperations: successCount,
+            failedOperations: failureCount,
+            averageDuration: durations.length > 0
+                ? durations.reduce((a, b) => a + b, 0) / durations.length
+                : 0,
+            minDuration: durations.length > 0 ? durations[0] : 0,
+            maxDuration: durations.length > 0 ? durations[durations.length - 1] : 0,
+            p50Duration: durations.length > 0 ? this.getPercentile(durations, 50) : 0,
+            p95Duration: durations.length > 0 ? this.getPercentile(durations, 95) : 0,
+            p99Duration: durations.length > 0 ? this.getPercentile(durations, 99) : 0,
+        };
+    }
+    /**
+     * Get percentile value from sorted array
+     */
+    static getPercentile(sortedArray, percentile) {
+        if (sortedArray.length === 0)
+            return 0;
+        const index = Math.ceil((percentile / 100) * sortedArray.length) - 1;
+        return sortedArray[Math.max(0, index)];
+    }
+    /**
+     * Clear all metrics
+     */
+    static clear() {
+        this.metrics = [];
+        this.metricsIndex = 0;
+        this.isBufferFull = false;
+    }
+    /**
+     * Get all metrics
+     */
+    static getMetrics() {
+        return [...this.metrics];
+    }
+    /**
+     * Export metrics as JSON
+     */
+    static exportMetrics() {
+        return JSON.stringify({
+            timestamp: new Date().toISOString(),
+            enabled: this.enabled,
+            metrics: this.metrics,
+            summary: this.getSummary(),
+        }, null, 2);
+    }
+    /**
+     * Enable or disable tracking
+     */
+    static setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Check if tracking is enabled
+     */
+    static isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Measure async function performance
+     */
+    static async measureAsync(toolName, fn, metadata) {
+        const startTime = this.startOperation(toolName, metadata);
+        try {
+            const result = await fn();
+            this.endOperation(toolName, startTime, true, undefined, metadata);
+            return result;
+        }
+        catch (error) {
+            this.endOperation(toolName, startTime, false, error instanceof Error ? error.message : String(error), metadata);
+            throw error;
+        }
+    }
+    /**
+     * Measure sync function performance
+     */
+    static measure(toolName, fn, metadata) {
+        const startTime = this.startOperation(toolName, metadata);
+        try {
+            const result = fn();
+            this.endOperation(toolName, startTime, true, undefined, metadata);
+            return result;
+        }
+        catch (error) {
+            this.endOperation(toolName, startTime, false, error instanceof Error ? error.message : String(error), metadata);
+            throw error;
+        }
+    }
+    /**
+     * Get slow operations above threshold
+     */
+    static getSlowOperations(threshold) {
+        const limit = threshold || 1000; // Default 1 second
+        return this.metrics.filter((m) => m.duration > limit);
+    }
+    /**
+     * Get failed operations
+     */
+    static getFailedOperations() {
+        return this.metrics.filter((m) => !m.success);
+    }
+    /**
+     * Generate performance report
+     */
+    static generateReport() {
+        const summary = this.getSummary();
+        const slowOps = this.getSlowOperations();
+        const failedOps = this.getFailedOperations();
+        return `
+Performance Report
+==================
+Total Operations: ${summary.totalOperations}
+Successful: ${summary.successfulOperations} (${((summary.successfulOperations / summary.totalOperations) *
+            100).toFixed(1)}%)
+Failed: ${summary.failedOperations} (${((summary.failedOperations / summary.totalOperations) *
+            100).toFixed(1)}%)
+
+Timing Statistics
+-----------------
+Average: ${summary.averageDuration.toFixed(2)}ms
+Min: ${summary.minDuration.toFixed(2)}ms
+Max: ${summary.maxDuration.toFixed(2)}ms
+P50: ${summary.p50Duration.toFixed(2)}ms
+P95: ${summary.p95Duration.toFixed(2)}ms
+P99: ${summary.p99Duration.toFixed(2)}ms
+
+Slow Operations: ${slowOps.length}
+Failed Operations: ${failedOps.length}
+    `.trim();
+    }
+}
+/**
+ * Performance monitoring decorator
+ */
+export function trackPerformance(toolName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const name = toolName ||
+            `${target.constructor.name}.${propertyKey}`;
+        descriptor.value = async function (...args) {
+            const startTime = PerformanceTracker.startOperation(name);
+            try {
+                const result = await originalMethod.apply(this, args);
+                PerformanceTracker.endOperation(name, startTime, true);
+                return result;
+            }
+            catch (error) {
+                PerformanceTracker.endOperation(name, startTime, false, error instanceof Error ? error.message : String(error));
+                throw error;
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Export a singleton instance for convenience
+ */
+export const performanceTracker = PerformanceTracker;
+// Re-export compatibility layer for instance-based usage
+export { PerformanceMonitor, performanceMonitor, } from './performance-compat.js';
+//# sourceMappingURL=performance.js.map

package/dist/middleware/performance.js.map

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

package/dist/middleware/validation.d.ts

@@ -0,0 +1,88 @@
+/**
+ * JSON Schema Validation Middleware
+ *
+ * Provides strict JSON-schema validation for all MCP tools
+ * to prevent runtime type errors from reaching business logic.
+ *
+ * This middleware validates all tool parameters against their schemas
+ * and returns proper 4xx ValidationError for schema violations.
+ */
+import { UniversalValidationError, SanitizedObject } from '../handlers/tool-configs/universal/schemas.js';
+/**
+ * Schema validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    sanitizedParams?: SanitizedObject;
+    errors?: ValidationError[];
+}
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    value?: unknown;
+    expected?: string;
+    suggestion?: string;
+}
+/**
+ * Schema definition for validation
+ */
+export interface SchemaDefinition {
+    type: string;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+    enum?: string[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    default?: unknown;
+}
+/**
+ * Validates a value against a JSON schema
+ */
+export declare class JsonSchemaValidator {
+    /**
+     * Validate parameters against a JSON schema
+     */
+    static validate(params: unknown, schema: SchemaDefinition): ValidationResult;
+    /**
+     * Validate an object against a schema
+     */
+    private static validateObject;
+    /**
+     * Validate a single value against a schema
+     */
+    private static validateValue;
+}
+/**
+ * Parameter validation middleware
+ */
+export declare class ParameterValidationMiddleware {
+    /**
+     * Validate parameters for universal tools
+     */
+    static validateUniversalParams(toolName: string, params: unknown, schema: SchemaDefinition): SanitizedObject;
+    /**
+     * Validate pagination parameters (limit, offset)
+     */
+    private static validatePaginationParams;
+    /**
+     * Validate ID format for record_id and similar fields
+     */
+    private static validateIdFormat;
+}
+/**
+ * Create a validation error response
+ */
+export declare function createValidationErrorResponse(error: UniversalValidationError): Record<string, unknown>;
+/**
+ * Wrap a handler with validation middleware
+ */
+export declare function withValidation<T extends (...args: unknown[]) => unknown>(handler: T, schema: SchemaDefinition, toolName: string): T;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/middleware/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EAKxB,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAwC5E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAqD7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAwI7B;AAED;;GAEG;AACH,qBAAa,6BAA6B;IACxC;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,gBAAgB,GACvB,eAAe;IA6BlB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAqFvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAiDhC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,wBAAwB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACtE,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,GACf,CAAC,CAoCH"}