@reveldigital/mcp-graphql-proxy 1.0.0

package/dist/types/mcp.js

@@ -0,0 +1,126 @@
+/**
+ * MCP Protocol Types
+ *
+ * Extended MCP types with proxy metadata for request/response handling.
+ */
+/**
+ * Get category for an MCP method
+ */
+export function getMCPMethodCategory(method) {
+    if (method === 'initialize' || method === 'initialized') {
+        return 'initialization';
+    }
+    if (method.startsWith('tools/')) {
+        return 'tools';
+    }
+    if (method.startsWith('resources/')) {
+        return 'resources';
+    }
+    if (method.startsWith('prompts/')) {
+        return 'prompts';
+    }
+    if (method.startsWith('logging/')) {
+        return 'logging';
+    }
+    if (method.startsWith('completion/')) {
+        return 'completion';
+    }
+    if (method.startsWith('notifications/')) {
+        return 'notification';
+    }
+    return 'unknown';
+}
+/**
+ * Check if an MCP method has side effects (should not be cached)
+ */
+export function hasSideEffects(method) {
+    const sideEffectMethods = [
+        'tools/call',
+        'resources/subscribe',
+        'resources/unsubscribe',
+    ];
+    return sideEffectMethods.includes(method);
+}
+/**
+ * Check if an MCP method is a notification (no response expected)
+ */
+export function isNotification(method) {
+    return method.startsWith('notifications/') || method === 'initialized';
+}
+/**
+ * MCP error codes
+ */
+export const MCP_ERROR_CODES = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    // Custom proxy error codes
+    RATE_LIMITED: -32001,
+    AUTHENTICATION_FAILED: -32002,
+    UPSTREAM_ERROR: -32003,
+    TIMEOUT: -32004,
+    CACHE_ERROR: -32005,
+};
+/**
+ * Create a JSON-RPC error response
+ */
+export function createErrorResponse(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+            code,
+            message,
+            data,
+        },
+    };
+}
+/**
+ * Create a JSON-RPC success response
+ */
+export function createSuccessResponse(id, result) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        result,
+    };
+}
+/**
+ * Extract method from JSON-RPC message
+ */
+export function extractMethod(message) {
+    if ('method' in message) {
+        return message.method;
+    }
+    return undefined;
+}
+/**
+ * Extract ID from JSON-RPC message
+ */
+export function extractId(message) {
+    if ('id' in message) {
+        return message.id ?? null;
+    }
+    return null;
+}
+/**
+ * Check if message is a request (has method and id)
+ */
+export function isRequest(message) {
+    return 'method' in message && 'id' in message;
+}
+/**
+ * Check if message is a response (has result or error)
+ */
+export function isResponse(message) {
+    return 'result' in message || 'error' in message;
+}
+/**
+ * Check if message is an error response
+ */
+export function isErrorResponse(message) {
+    return 'error' in message;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/types/mcp.js.map

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

package/dist/types/metrics.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Metrics Types
+ *
+ * Metrics collection, aggregation, and export interfaces.
+ */
+/**
+ * Metrics configuration
+ */
+export interface MetricsConfig {
+    /** Enable metrics collection */
+    enabled: boolean;
+    /** Metrics export targets */
+    exporters: MetricsExporter[];
+    /** Collection interval in seconds */
+    collectionIntervalSeconds: number;
+    /** Histogram buckets for latency (in milliseconds) */
+    latencyBuckets: number[];
+    /** Enable per-operation metrics */
+    perOperationMetrics: boolean;
+    /** Enable per-tenant metrics */
+    perTenantMetrics: boolean;
+    /** Enable cache metrics */
+    cacheMetrics: boolean;
+    /** Enable rate limit metrics */
+    rateLimitMetrics: boolean;
+    /** Metric name prefix */
+    prefix: string;
+}
+/**
+ * Metrics exporter configuration
+ */
+export interface MetricsExporter {
+    /** Exporter type */
+    type: 'prometheus' | 'statsd' | 'console' | 'http' | 'opentelemetry';
+    /** Exporter-specific options */
+    options: MetricsExporterOptions;
+    /** Export interval in seconds */
+    intervalSeconds?: number;
+}
+/**
+ * Exporter-specific options
+ */
+export interface MetricsExporterOptions {
+    /** HTTP endpoint for http/prometheus exporters */
+    endpoint?: string;
+    /** Port for prometheus scrape endpoint */
+    port?: number;
+    /** StatsD host */
+    host?: string;
+    /** StatsD port */
+    statsdPort?: number;
+    /** Push gateway URL for prometheus */
+    pushGateway?: string;
+    /** Labels to add to all metrics */
+    labels?: Record<string, string>;
+}
+/**
+ * Request metrics aggregation
+ */
+export interface RequestMetrics {
+    /** Total request count */
+    totalRequests: number;
+    /** Successful request count */
+    successfulRequests: number;
+    /** Failed request count */
+    failedRequests: number;
+    /** Rate limited request count */
+    rateLimitedRequests: number;
+    /** Latency histogram */
+    latencyHistogram: HistogramData;
+    /** Requests per second (current rate) */
+    requestsPerSecond: number;
+    /** Error rate percentage */
+    errorRate: number;
+    /** Average request duration in ms */
+    avgDurationMs: number;
+}
+/**
+ * Histogram data structure
+ */
+export interface HistogramData {
+    /** Bucket counts (bucket upper bound -> count) */
+    buckets: Map<number, number>;
+    /** Sum of all values */
+    sum: number;
+    /** Count of observations */
+    count: number;
+    /** Minimum value */
+    min: number;
+    /** Maximum value */
+    max: number;
+    /** P50 (median) latency */
+    p50: number;
+    /** P90 latency */
+    p90: number;
+    /** P95 latency */
+    p95: number;
+    /** P99 latency */
+    p99: number;
+}
+/**
+ * Operation-level metrics
+ */
+export interface OperationMetrics {
+    /** Operation name (MCP method) */
+    operation: string;
+    /** Request metrics for this operation */
+    requests: RequestMetrics;
+    /** Cache hit rate for this operation */
+    cacheHitRate: number;
+    /** Average payload size in bytes */
+    avgPayloadSize: number;
+    /** Last request timestamp */
+    lastRequestAt?: Date;
+}
+/**
+ * Tenant-level metrics
+ */
+export interface TenantMetrics {
+    /** Tenant ID */
+    tenantId: string;
+    /** Request metrics for this tenant */
+    requests: RequestMetrics;
+    /** Rate limit hit count */
+    rateLimitHits: number;
+    /** Quota usage percentage */
+    quotaUsagePercent: number;
+    /** Active sessions */
+    activeSessions: number;
+}
+/**
+ * System metrics
+ */
+export interface SystemMetrics {
+    /** Process uptime in seconds */
+    uptimeSeconds: number;
+    /** Memory usage */
+    memory: MemoryMetrics;
+    /** CPU usage */
+    cpu: CpuMetrics;
+    /** Active connections */
+    activeConnections: number;
+    /** Upstream server health */
+    upstreamHealth: HealthStatus;
+    /** Pending requests */
+    pendingRequests: number;
+}
+/**
+ * Memory metrics
+ */
+export interface MemoryMetrics {
+    /** Heap used in bytes */
+    heapUsed: number;
+    /** Heap total in bytes */
+    heapTotal: number;
+    /** External memory in bytes */
+    external: number;
+    /** Array buffers in bytes */
+    arrayBuffers: number;
+    /** RSS in bytes */
+    rss: number;
+    /** Heap usage percentage */
+    heapUsagePercent: number;
+}
+/**
+ * CPU metrics
+ */
+export interface CpuMetrics {
+    /** CPU usage percentage */
+    usagePercent: number;
+    /** User CPU time in ms */
+    userTimeMs: number;
+    /** System CPU time in ms */
+    systemTimeMs: number;
+}
+/**
+ * Health status values
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+/**
+ * Aggregated metrics snapshot
+ */
+export interface MetricsSnapshot {
+    /** Snapshot timestamp */
+    timestamp: Date;
+    /** Snapshot duration in seconds */
+    durationSeconds: number;
+    /** System metrics */
+    system: SystemMetrics;
+    /** Request metrics */
+    requests: RequestMetrics;
+    /** Cache metrics */
+    cache: CacheMetricsSnapshot;
+    /** Rate limit metrics */
+    rateLimit: RateLimitMetricsSnapshot;
+    /** Per-operation metrics (if enabled) */
+    operations?: Map<string, OperationMetrics>;
+    /** Per-tenant metrics (if enabled) */
+    tenants?: Map<string, TenantMetrics>;
+}
+/**
+ * Cache metrics snapshot
+ */
+export interface CacheMetricsSnapshot {
+    /** Total hits */
+    hits: number;
+    /** Total misses */
+    misses: number;
+    /** Hit rate percentage */
+    hitRate: number;
+    /** Current size in bytes */
+    sizeBytes: number;
+    /** Entry count */
+    entryCount: number;
+    /** Evictions */
+    evictions: number;
+}
+/**
+ * Rate limit metrics snapshot
+ */
+export interface RateLimitMetricsSnapshot {
+    /** Total rate limit checks */
+    totalChecks: number;
+    /** Rate limited requests */
+    limitedRequests: number;
+    /** Limit rate percentage */
+    limitRate: number;
+    /** By operation */
+    byOperation?: Map<string, number>;
+    /** By tenant */
+    byTenant?: Map<string, number>;
+}
+/**
+ * Default metrics configuration
+ */
+export declare const DEFAULT_METRICS_CONFIG: MetricsConfig;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/types/metrics.d.ts.map

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

package/dist/types/metrics.js

@@ -0,0 +1,26 @@
+/**
+ * Metrics Types
+ *
+ * Metrics collection, aggregation, and export interfaces.
+ */
+/**
+ * Default metrics configuration
+ */
+export const DEFAULT_METRICS_CONFIG = {
+    enabled: true,
+    exporters: [
+        {
+            type: 'console',
+            options: {},
+            intervalSeconds: 60,
+        },
+    ],
+    collectionIntervalSeconds: 10,
+    latencyBuckets: [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000],
+    perOperationMetrics: true,
+    perTenantMetrics: true,
+    cacheMetrics: true,
+    rateLimitMetrics: true,
+    prefix: 'reveldigital_mcp_proxy_',
+};
+//# sourceMappingURL=metrics.js.map

package/dist/types/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/types/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqTH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,IAAI;IACb,SAAS,EAAE;QACT;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE;YACX,eAAe,EAAE,EAAE;SACpB;KACF;IACD,yBAAyB,EAAE,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IACvE,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,IAAI;IACtB,MAAM,EAAE,yBAAyB;CAClC,CAAC"}

package/dist/types/rate-limit.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Rate Limiting Types
+ *
+ * Rate limiting configuration and state interfaces.
+ */
+/**
+ * Rate limiting configuration
+ */
+export interface RateLimitConfig {
+    /** Enable rate limiting */
+    enabled: boolean;
+    /** Rate limiting algorithm */
+    algorithm: RateLimitAlgorithm;
+    /** Global rate limits */
+    global: RateLimitRule;
+    /** Per-operation rate limits */
+    operations: Record<string, RateLimitRule>;
+    /** Per-tenant rate limits */
+    tenants: Record<string, TenantRateLimitConfig>;
+    /** Response when rate limited */
+    response: RateLimitResponse;
+    /** Storage backend for distributed rate limiting */
+    storage: RateLimitStorage;
+}
+/**
+ * Rate limiting algorithms
+ */
+export type RateLimitAlgorithm = 'sliding-window' | 'token-bucket' | 'fixed-window' | 'leaky-bucket';
+/**
+ * Rate limit rule definition
+ */
+export interface RateLimitRule {
+    /** Maximum requests allowed */
+    maxRequests: number;
+    /** Time window in seconds */
+    windowSeconds: number;
+    /** Burst allowance (for token bucket) */
+    burstSize?: number;
+    /** Token refill rate per second (for token bucket) */
+    refillRate?: number;
+    /** Penalty duration in seconds when limit exceeded */
+    penaltySeconds?: number;
+}
+/**
+ * Tenant-specific rate limit configuration
+ */
+export interface TenantRateLimitConfig {
+    /** Override global limits */
+    global?: RateLimitRule;
+    /** Override per-operation limits */
+    operations?: Record<string, RateLimitRule>;
+    /** Priority tier (higher = more lenient) */
+    tier: RateLimitTier;
+}
+/**
+ * Rate limiting tiers for multi-tenant environments
+ */
+export type RateLimitTier = 'free' | 'standard' | 'premium' | 'enterprise' | 'unlimited';
+/**
+ * Rate limit tier multipliers
+ */
+export declare const RATE_LIMIT_TIER_MULTIPLIERS: Record<RateLimitTier, number>;
+/**
+ * Response when rate limited
+ */
+export interface RateLimitResponse {
+    /** HTTP status code */
+    statusCode: number;
+    /** Error message template */
+    message: string;
+    /** Include Retry-After header */
+    includeRetryAfter: boolean;
+    /** Include rate limit headers (X-RateLimit-*) */
+    includeRateLimitHeaders: boolean;
+}
+/**
+ * Rate limit storage backend
+ */
+export interface RateLimitStorage {
+    /** Storage type */
+    type: 'memory' | 'redis';
+    /** Redis options if type is 'redis' */
+    redisOptions?: {
+        host: string;
+        port: number;
+        password?: string;
+        db?: number;
+        keyPrefix?: string;
+    };
+}
+/**
+ * Rate limit state for a specific key
+ */
+export interface RateLimitState {
+    /** Rate limit key (e.g., "tenant:method" or "global") */
+    key: string;
+    /** Number of requests in current window */
+    requestCount: number;
+    /** Window start timestamp */
+    windowStart: Date;
+    /** Remaining requests */
+    remaining: number;
+    /** Time until reset in milliseconds */
+    resetAtMs: number;
+    /** Is currently rate limited */
+    isLimited: boolean;
+    /** Limit applied */
+    limit: number;
+    /** Window size in seconds */
+    windowSeconds: number;
+    /** Penalty end time if in penalty period */
+    penaltyEndAt?: Date;
+}
+/**
+ * Rate limit check result
+ */
+export interface RateLimitResult {
+    /** Is the request allowed? */
+    allowed: boolean;
+    /** Current rate limit state */
+    state: RateLimitState;
+    /** Headers to include in response */
+    headers: RateLimitHeaders;
+    /** Retry after in seconds (if not allowed) */
+    retryAfterSeconds?: number;
+}
+/**
+ * Rate limit response headers
+ */
+export interface RateLimitHeaders {
+    /** Total limit */
+    'X-RateLimit-Limit': string;
+    /** Remaining requests */
+    'X-RateLimit-Remaining': string;
+    /** Reset timestamp (Unix epoch seconds) */
+    'X-RateLimit-Reset': string;
+    /** Retry-After in seconds (when limited) */
+    'Retry-After'?: string;
+}
+/**
+ * Default rate limit configuration
+ */
+export declare const DEFAULT_RATE_LIMIT_CONFIG: RateLimitConfig;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/types/rate-limit.d.ts.map

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

package/dist/types/rate-limit.js

@@ -0,0 +1,43 @@
+/**
+ * Rate Limiting Types
+ *
+ * Rate limiting configuration and state interfaces.
+ */
+/**
+ * Rate limit tier multipliers
+ */
+export const RATE_LIMIT_TIER_MULTIPLIERS = {
+    free: 1,
+    standard: 2,
+    premium: 5,
+    enterprise: 10,
+    unlimited: Infinity,
+};
+/**
+ * Default rate limit configuration
+ */
+export const DEFAULT_RATE_LIMIT_CONFIG = {
+    enabled: true,
+    algorithm: 'sliding-window',
+    global: {
+        maxRequests: 1000,
+        windowSeconds: 60,
+    },
+    operations: {
+        'tools/call': {
+            maxRequests: 100,
+            windowSeconds: 60,
+        },
+    },
+    tenants: {},
+    response: {
+        statusCode: 429,
+        message: 'Rate limit exceeded. Please retry after {retryAfter} seconds.',
+        includeRetryAfter: true,
+        includeRateLimitHeaders: true,
+    },
+    storage: {
+        type: 'memory',
+    },
+};
+//# sourceMappingURL=rate-limit.js.map

package/dist/types/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/types/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAkC;IACxE,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,QAAQ;CACpB,CAAC;AAsGF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE;QACN,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,EAAE;KAClB;IACD,UAAU,EAAE;QACV,YAAY,EAAE;YACZ,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,EAAE;SAClB;KACF;IACD,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE;QACR,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,+DAA+D;QACxE,iBAAiB,EAAE,IAAI;QACvB,uBAAuB,EAAE,IAAI;KAC9B;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;KACf;CACF,CAAC"}