@reveldigital/mcp-graphql-proxy 1.0.0

package/dist/bin/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point for Revel Digital MCP GraphQL Proxy
+ */
+import '../index.js';
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAGH,OAAO,aAAa,CAAC"}

package/dist/bin/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point for Revel Digital MCP GraphQL Proxy
+ */
+// Re-export the main server
+import '../index.js';
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,4BAA4B;AAC5B,OAAO,aAAa,CAAC"}

package/dist/core/cache.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Simple in-memory cache for GraphQL responses
+ * Optimized for reducing API calls and improving response times
+ */
+import type { GraphQLCacheStats } from '../types/graphql-proxy.js';
+export declare class ResponseCache {
+    private cache;
+    private stats;
+    private defaultTtl;
+    private maxEntries;
+    constructor(defaultTtl?: number, maxEntries?: number);
+    /**
+     * Generate a hash key for the query
+     */
+    private generateKey;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Get cached response
+     */
+    get<T = unknown>(query: string, variables?: Record<string, unknown>): T | null;
+    /**
+     * Store response in cache
+     */
+    set<T = unknown>(query: string, variables: Record<string, unknown> | undefined, data: T, ttl?: number): void;
+    /**
+     * Invalidate specific cache entry
+     */
+    invalidate(query: string, variables?: Record<string, unknown>): boolean;
+    /**
+     * Invalidate all entries matching a pattern
+     */
+    invalidatePattern(pattern: RegExp): number;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Evict oldest entries
+     */
+    private evictOldest;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Update stats
+     */
+    private updateStats;
+    /**
+     * Get cache statistics
+     */
+    getStats(): GraphQLCacheStats;
+    /**
+     * Get cache hit rate
+     */
+    getHitRate(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEtF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAAkE;IAC/E,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAY,EAAE,UAAU,GAAE,MAAa;IAK/D;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI;IAoB9E;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC9C,IAAI,EAAE,CAAC,EACP,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;IAkBP;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAOvE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAc1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,IAAI,MAAM;IAYjB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,QAAQ,IAAI,iBAAiB;IAI7B;;OAEG;IACH,UAAU,IAAI,MAAM;CAIrB"}

package/dist/core/cache.js

@@ -0,0 +1,147 @@
+/**
+ * Simple in-memory cache for GraphQL responses
+ * Optimized for reducing API calls and improving response times
+ */
+import crypto from 'crypto';
+export class ResponseCache {
+    cache = new Map();
+    stats = { hits: 0, misses: 0, size: 0, entries: 0 };
+    defaultTtl;
+    maxEntries;
+    constructor(defaultTtl = 300, maxEntries = 1000) {
+        this.defaultTtl = defaultTtl;
+        this.maxEntries = maxEntries;
+    }
+    /**
+     * Generate a hash key for the query
+     */
+    generateKey(query, variables) {
+        const content = JSON.stringify({ query, variables });
+        return crypto.createHash('sha256').update(content).digest('hex').substring(0, 16);
+    }
+    /**
+     * Check if entry is expired
+     */
+    isExpired(entry) {
+        return Date.now() > entry.timestamp + entry.ttl * 1000;
+    }
+    /**
+     * Get cached response
+     */
+    get(query, variables) {
+        const key = this.generateKey(query, variables);
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.stats.misses++;
+            return null;
+        }
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.stats.misses++;
+            this.updateStats();
+            return null;
+        }
+        this.stats.hits++;
+        return entry.data;
+    }
+    /**
+     * Store response in cache
+     */
+    set(query, variables, data, ttl) {
+        // Evict oldest entries if at capacity
+        if (this.cache.size >= this.maxEntries) {
+            this.evictOldest();
+        }
+        const key = this.generateKey(query, variables);
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            ttl: ttl ?? this.defaultTtl,
+            queryHash: key,
+        };
+        this.cache.set(key, entry);
+        this.updateStats();
+    }
+    /**
+     * Invalidate specific cache entry
+     */
+    invalidate(query, variables) {
+        const key = this.generateKey(query, variables);
+        const deleted = this.cache.delete(key);
+        this.updateStats();
+        return deleted;
+    }
+    /**
+     * Invalidate all entries matching a pattern
+     */
+    invalidatePattern(pattern) {
+        let count = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            // Check if the original query matches pattern (we'd need to store query)
+            // For now, just invalidate by key
+            if (pattern.test(key)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        this.updateStats();
+        return count;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+        this.stats = { hits: 0, misses: 0, size: 0, entries: 0 };
+    }
+    /**
+     * Evict oldest entries
+     */
+    evictOldest(count = 100) {
+        const entries = Array.from(this.cache.entries())
+            .sort((a, b) => a[1].timestamp - b[1].timestamp)
+            .slice(0, count);
+        for (const [key] of entries) {
+            this.cache.delete(key);
+        }
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        let removed = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (this.isExpired(entry)) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        this.updateStats();
+        return removed;
+    }
+    /**
+     * Update stats
+     */
+    updateStats() {
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += JSON.stringify(entry.data).length;
+        }
+        this.stats.size = totalSize;
+        this.stats.entries = this.cache.size;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get cache hit rate
+     */
+    getHitRate() {
+        const total = this.stats.hits + this.stats.misses;
+        return total > 0 ? this.stats.hits / total : 0;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

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

package/dist/core/graphql-client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GraphQL Client for Revel Digital API
+ * Handles authentication, request execution, and response processing
+ */
+import type { GraphQLRequest, GraphQLResponse, GraphQLProxyConfig } from '../types/graphql-proxy.js';
+export declare class GraphQLClient {
+    private config;
+    private authHeaders;
+    constructor(config: GraphQLProxyConfig);
+    /**
+     * Set Bearer token for authentication (Authorization: Bearer header)
+     * This is the only authentication method supported by the Revel Digital GraphQL API
+     */
+    setBearerToken(token: string): void;
+    /**
+     * Set custom headers (proxied from client)
+     */
+    setCustomHeaders(headers: Record<string, string>): void;
+    /**
+     * Clear all authentication headers
+     */
+    clearAuth(): void;
+    /**
+     * Execute a GraphQL query
+     */
+    execute<T = unknown>(request: GraphQLRequest): Promise<GraphQLResponse<T>>;
+    /**
+     * Execute a raw query string with optional variables
+     */
+    query<T = unknown>(query: string, variables?: Record<string, unknown>, operationName?: string): Promise<GraphQLResponse<T>>;
+    /**
+     * Fetch the GraphQL schema (introspection)
+     */
+    introspect(): Promise<GraphQLResponse>;
+    /**
+     * Fetch type information for a specific type
+     */
+    introspectType(typeName: string): Promise<GraphQLResponse>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): GraphQLProxyConfig;
+    /**
+     * Check if authenticated
+     */
+    isAuthenticated(): boolean;
+}
+//# sourceMappingURL=graphql-client.d.ts.map

package/dist/core/graphql-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-client.d.ts","sourceRoot":"","sources":["../../src/core/graphql-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAErG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAA8B;gBAErC,MAAM,EAAE,kBAAkB;IAQtC;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IA0ChF;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAI9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAmE5C;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDhE;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACH,eAAe,IAAI,OAAO;CAG3B"}

package/dist/core/graphql-client.js

@@ -0,0 +1,210 @@
+/**
+ * GraphQL Client for Revel Digital API
+ * Handles authentication, request execution, and response processing
+ */
+export class GraphQLClient {
+    config;
+    authHeaders = {};
+    constructor(config) {
+        this.config = config;
+        // Set auth token if provided (Authorization: Bearer header)
+        if (config.authToken) {
+            this.setBearerToken(config.authToken);
+        }
+    }
+    /**
+     * Set Bearer token for authentication (Authorization: Bearer header)
+     * This is the only authentication method supported by the Revel Digital GraphQL API
+     */
+    setBearerToken(token) {
+        this.authHeaders['Authorization'] = `Bearer ${token}`;
+    }
+    /**
+     * Set custom headers (proxied from client)
+     */
+    setCustomHeaders(headers) {
+        Object.assign(this.authHeaders, headers);
+    }
+    /**
+     * Clear all authentication headers
+     */
+    clearAuth() {
+        this.authHeaders = {};
+    }
+    /**
+     * Execute a GraphQL query
+     */
+    async execute(request) {
+        const startTime = Date.now();
+        try {
+            const response = await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json',
+                    ...this.authHeaders,
+                },
+                body: JSON.stringify({
+                    query: request.query,
+                    variables: request.variables,
+                    operationName: request.operationName,
+                }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`GraphQL request failed: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const result = await response.json();
+            if (this.config.debug) {
+                console.error(`[GraphQL] Query executed in ${Date.now() - startTime}ms`);
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === 'TimeoutError') {
+                    throw new Error(`GraphQL request timed out after ${this.config.timeout}ms`);
+                }
+                throw error;
+            }
+            throw new Error('Unknown error during GraphQL request');
+        }
+    }
+    /**
+     * Execute a raw query string with optional variables
+     */
+    async query(query, variables, operationName) {
+        return this.execute({ query, variables, operationName });
+    }
+    /**
+     * Fetch the GraphQL schema (introspection)
+     */
+    async introspect() {
+        const introspectionQuery = `
+      query IntrospectionQuery {
+        __schema {
+          queryType { name }
+          types {
+            kind
+            name
+            description
+            fields(includeDeprecated: true) {
+              name
+              description
+              isDeprecated
+              deprecationReason
+              args {
+                name
+                description
+                type {
+                  kind
+                  name
+                  ofType {
+                    kind
+                    name
+                  }
+                }
+                defaultValue
+              }
+              type {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                  ofType {
+                    kind
+                    name
+                  }
+                }
+              }
+            }
+            inputFields {
+              name
+              description
+              type {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                }
+              }
+              defaultValue
+            }
+            enumValues(includeDeprecated: true) {
+              name
+              description
+              isDeprecated
+              deprecationReason
+            }
+          }
+        }
+      }
+    `;
+        return this.execute({ query: introspectionQuery });
+    }
+    /**
+     * Fetch type information for a specific type
+     */
+    async introspectType(typeName) {
+        const typeQuery = `
+      query TypeQuery($name: String!) {
+        __type(name: $name) {
+          kind
+          name
+          description
+          fields(includeDeprecated: true) {
+            name
+            description
+            isDeprecated
+            deprecationReason
+            args {
+              name
+              description
+              type {
+                kind
+                name
+                ofType { kind name ofType { kind name } }
+              }
+              defaultValue
+            }
+            type {
+              kind
+              name
+              ofType { kind name ofType { kind name ofType { kind name } } }
+            }
+          }
+          inputFields {
+            name
+            description
+            type {
+              kind
+              name
+              ofType { kind name }
+            }
+          }
+          enumValues(includeDeprecated: true) {
+            name
+            description
+          }
+        }
+      }
+    `;
+        return this.execute({ query: typeQuery, variables: { name: typeName } });
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Check if authenticated
+     */
+    isAuthenticated() {
+        return Object.keys(this.authHeaders).length > 0;
+    }
+}
+//# sourceMappingURL=graphql-client.js.map

package/dist/core/graphql-client.js.map

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

package/dist/core/query-builder.d.ts

@@ -0,0 +1,90 @@
+/**
+ * GraphQL Query Builder for Revel Digital API
+ * Helps agents construct optimized queries with proper field selection and filtering
+ */
+declare const QUERY_OPERATIONS: Record<string, {
+    returnType: string;
+    supportsFilter: boolean;
+    requiresDateRange: boolean;
+}>;
+export interface QueryBuilderOptions {
+    operation: string;
+    fields: string[];
+    arguments?: Record<string, unknown>;
+    filter?: Record<string, unknown>;
+    orderBy?: {
+        field: string;
+        direction: 'ASC' | 'DESC';
+    };
+    limit?: number;
+    preset?: string;
+}
+export declare class QueryBuilder {
+    /**
+     * Build a GraphQL query from options
+     */
+    static build(options: QueryBuilderOptions): {
+        query: string;
+        variables: Record<string, unknown>;
+    };
+    /**
+     * Build field selection string, handling nested fields
+     */
+    private static buildFieldSelection;
+    /**
+     * Build filter input from simple object
+     */
+    private static buildFilterInput;
+    /**
+     * Infer GraphQL type from variable name and value
+     */
+    private static inferGraphQLType;
+    /**
+     * Capitalize first letter
+     */
+    private static capitalizeFirst;
+    /**
+     * Get available operations
+     */
+    static getOperations(): string[];
+    /**
+     * Get operation info
+     */
+    static getOperationInfo(operation: string): typeof QUERY_OPERATIONS[string] | null;
+    /**
+     * Get field presets for an operation
+     */
+    static getFieldPresets(operation: string): Record<string, string[]> | null;
+    /**
+     * Build a quick query for common use cases
+     */
+    static quick: {
+        /** Get all devices with status */
+        devicesStatus: () => {
+            query: string;
+            variables: Record<string, unknown>;
+        };
+        /** Get online devices only */
+        onlineDevices: () => {
+            query: string;
+            variables: Record<string, unknown>;
+        };
+        /** Get recent media */
+        recentMedia: (limit?: number) => {
+            query: string;
+            variables: Record<string, unknown>;
+        };
+        /** Get active schedules */
+        activeSchedules: () => {
+            query: string;
+            variables: Record<string, unknown>;
+        };
+        /** Get play logs for date range */
+        playLogs: (startDate: string, endDate: string, deviceId?: string[]) => {
+            query: string;
+            variables: Record<string, unknown>;
+        };
+    };
+}
+export {};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/core/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/core/query-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CAsBjH,CAAC;AAiCF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IA0EjG;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2BlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAqB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI;IAIlF;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAI1E;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,kCAAkC;;mBAnLiB,MAAM;uBAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;QAyL7F,8BAA8B;;mBAzLqB,MAAM;uBAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;QAgM7F,uBAAuB;;mBAhM4B,MAAM;uBAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;QAwM7F,2BAA2B;;mBAxMwB,MAAM;uBAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;QA+M7F,mCAAmC;8BACb,MAAM,WAAW,MAAM,aAAa,MAAM,EAAE;mBAhNf,MAAM;uBAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;MAqN7F;CACH"}