mcp-quickbase 2.0.1

package/dist/utils/cache.js

@@ -0,0 +1,211 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheService = void 0;
+const node_cache_1 = __importDefault(require("node-cache"));
+const logger_1 = require("./logger");
+const logger = (0, logger_1.createLogger)('cache');
+/**
+ * Cache service for API responses
+ */
+class CacheService {
+    /**
+     * Creates a new cache service
+     * @param ttl Default TTL in seconds (default: 3600)
+     * @param enabled Whether caching is enabled (default: true)
+     */
+    constructor(ttl = 3600, enabled = true) {
+        this.operationLock = Promise.resolve();
+        this.cache = new node_cache_1.default({ stdTTL: ttl, checkperiod: ttl * 0.2 });
+        this.enabled = enabled;
+        // Register this instance for cleanup
+        CacheService.instances.add(this);
+        // Install cleanup handlers once
+        if (!CacheService.cleanupHandlerInstalled) {
+            CacheService.installCleanupHandlers();
+            CacheService.cleanupHandlerInstalled = true;
+        }
+        logger.info(`Cache initialized with TTL of ${ttl} seconds, enabled: ${enabled}`);
+    }
+    /**
+     * Gets a value from the cache
+     * @param key Cache key
+     * @returns The cached value or undefined if not found
+     */
+    get(key) {
+        if (!this.enabled) {
+            return undefined;
+        }
+        const value = this.cache.get(key);
+        if (value) {
+            logger.debug(`Cache hit for key: ${key}`);
+        }
+        else {
+            logger.debug(`Cache miss for key: ${key}`);
+        }
+        return value;
+    }
+    /**
+     * Sets a value in the cache
+     * @param key Cache key
+     * @param value Value to cache
+     * @param ttl TTL in seconds (optional, uses default if not specified)
+     */
+    set(key, value, ttl) {
+        if (!this.enabled) {
+            return;
+        }
+        if (typeof ttl === 'number') {
+            this.cache.set(key, value, ttl);
+        }
+        else {
+            this.cache.set(key, value);
+        }
+        logger.debug(`Cache set for key: ${key}`);
+    }
+    /**
+     * Removes a value from the cache
+     * @param key Cache key
+     */
+    del(key) {
+        this.cache.del(key);
+        logger.debug(`Cache entry deleted for key: ${key}`);
+    }
+    /**
+     * Clears all cache entries
+     */
+    clear() {
+        this.cache.flushAll();
+        logger.info('Cache cleared');
+    }
+    /**
+     * Enables or disables the cache
+     * @param enabled Whether the cache should be enabled
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+        logger.info(`Cache ${enabled ? 'enabled' : 'disabled'}`);
+        if (!enabled) {
+            this.clear();
+        }
+    }
+    /**
+     * Returns whether the cache is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Checks if a key exists in the cache
+     * @param key Cache key
+     * @returns True if the key exists, false otherwise
+     */
+    has(key) {
+        if (!this.enabled) {
+            return false;
+        }
+        return this.cache.has(key);
+    }
+    /**
+     * Removes a value from the cache (alias for del)
+     * @param key Cache key
+     */
+    delete(key) {
+        this.del(key);
+    }
+    /**
+     * Gets cache statistics
+     * @returns Cache statistics
+     */
+    getStats() {
+        const stats = this.cache.getStats();
+        return {
+            hits: stats.hits,
+            misses: stats.misses,
+            keys: this.cache.keys().length
+        };
+    }
+    /**
+     * Sets a new default TTL
+     * @param ttl New TTL in seconds
+     */
+    setTtl(ttl) {
+        // Serialize TTL changes to prevent corruption
+        this.operationLock = this.operationLock.then(async () => {
+            await this.safeTtlUpdate(ttl);
+        });
+    }
+    async safeTtlUpdate(ttl) {
+        // Wait a brief moment to allow in-flight operations to complete
+        await new Promise(resolve => setTimeout(resolve, 100));
+        const oldCache = this.cache;
+        // Create new cache with updated TTL
+        const newCache = new node_cache_1.default({ stdTTL: ttl, checkperiod: ttl * 0.2 });
+        // Migrate existing data to new cache (if any)
+        try {
+            const keys = oldCache.keys();
+            for (const key of keys) {
+                const value = oldCache.get(key);
+                if (value !== undefined) {
+                    newCache.set(key, value);
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('Error migrating cache data during TTL update', { error });
+        }
+        // Replace the cache atomically
+        this.cache = newCache;
+        // Clean up old cache
+        try {
+            oldCache.flushAll();
+            oldCache.close();
+        }
+        catch (error) {
+            logger.warn('Error closing old cache instance', { error });
+        }
+        logger.info(`Cache TTL updated to ${ttl} seconds`);
+    }
+    /**
+     * Cleanup this cache instance
+     */
+    cleanup() {
+        try {
+            this.cache.flushAll();
+            this.cache.close();
+            logger.debug('Cache instance cleaned up');
+        }
+        catch (error) {
+            logger.error('Error cleaning up cache', { error });
+        }
+    }
+    /**
+     * Install process cleanup handlers (called once)
+     */
+    static installCleanupHandlers() {
+        const cleanup = () => {
+            logger.info('Cleaning up all cache instances');
+            for (const instance of CacheService.instances) {
+                instance.cleanup();
+            }
+            CacheService.instances.clear();
+        };
+        process.on('exit', cleanup);
+        process.on('SIGTERM', cleanup);
+        process.on('SIGINT', cleanup);
+        process.on('uncaughtException', cleanup);
+        process.on('unhandledRejection', cleanup);
+    }
+    /**
+     * Get cleanup statistics
+     */
+    static getStats() {
+        return { instances: CacheService.instances.size };
+    }
+}
+exports.CacheService = CacheService;
+CacheService.instances = new Set();
+CacheService.cleanupHandlerInstalled = false;
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/file.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Utility functions for file operations
+ */
+/**
+ * Check if a file exists
+ * @param filePath File path to check
+ * @returns True if the file exists
+ */
+export declare function fileExists(filePath: string): boolean;
+/**
+ * Ensure a directory exists, creating it if necessary
+ * @param dirPath Directory path to ensure
+ * @returns True if the directory exists or was created
+ */
+export declare function ensureDirectoryExists(dirPath: string): boolean;
+/**
+ * Get information about a file
+ * @param filePath File path
+ * @returns File information or null if the file doesn't exist
+ */
+export declare function getFileInfo(filePath: string): {
+    name: string;
+    size: number;
+    extension: string;
+    mimeType: string;
+    lastModified: Date;
+} | null;
+/**
+ * Read a file as a Buffer
+ * @param filePath File path
+ * @returns File contents as Buffer or null if an error occurs
+ */
+export declare function readFileAsBuffer(filePath: string): Buffer | null;
+/**
+ * Write data to a file
+ * @param filePath File path to write to
+ * @param data Data to write
+ * @returns True if the file was written successfully
+ */
+export declare function writeFile(filePath: string, data: Buffer | string): boolean;

package/dist/utils/file.js

@@ -0,0 +1,167 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileExists = fileExists;
+exports.ensureDirectoryExists = ensureDirectoryExists;
+exports.getFileInfo = getFileInfo;
+exports.readFileAsBuffer = readFileAsBuffer;
+exports.writeFile = writeFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const logger = (0, logger_1.createLogger)('FileUtil');
+/**
+ * Utility functions for file operations
+ */
+/**
+ * Check if a file exists
+ * @param filePath File path to check
+ * @returns True if the file exists
+ */
+function fileExists(filePath) {
+    try {
+        return fs.existsSync(filePath) && fs.statSync(filePath).isFile();
+    }
+    catch (error) {
+        logger.error('Error checking if file exists', { filePath, error });
+        return false;
+    }
+}
+/**
+ * Ensure a directory exists, creating it if necessary
+ * @param dirPath Directory path to ensure
+ * @returns True if the directory exists or was created
+ */
+function ensureDirectoryExists(dirPath) {
+    try {
+        if (fs.existsSync(dirPath)) {
+            return fs.statSync(dirPath).isDirectory();
+        }
+        // Create the directory
+        fs.mkdirSync(dirPath, { recursive: true });
+        return true;
+    }
+    catch (error) {
+        logger.error('Error ensuring directory exists', { dirPath, error });
+        return false;
+    }
+}
+/**
+ * Get information about a file
+ * @param filePath File path
+ * @returns File information or null if the file doesn't exist
+ */
+function getFileInfo(filePath) {
+    try {
+        if (!fileExists(filePath)) {
+            return null;
+        }
+        const stats = fs.statSync(filePath);
+        const ext = path.extname(filePath).toLowerCase();
+        // Simple mime type mapping
+        const mimeTypes = {
+            '.txt': 'text/plain',
+            '.html': 'text/html',
+            '.css': 'text/css',
+            '.js': 'application/javascript',
+            '.json': 'application/json',
+            '.xml': 'application/xml',
+            '.pdf': 'application/pdf',
+            '.zip': 'application/zip',
+            '.png': 'image/png',
+            '.jpg': 'image/jpeg',
+            '.jpeg': 'image/jpeg',
+            '.gif': 'image/gif',
+            '.svg': 'image/svg+xml',
+            '.doc': 'application/msword',
+            '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            '.xls': 'application/vnd.ms-excel',
+            '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            '.ppt': 'application/vnd.ms-powerpoint',
+            '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation'
+        };
+        return {
+            name: path.basename(filePath),
+            size: stats.size,
+            extension: ext,
+            mimeType: mimeTypes[ext] || 'application/octet-stream',
+            lastModified: stats.mtime
+        };
+    }
+    catch (error) {
+        logger.error('Error getting file info', { filePath, error });
+        return null;
+    }
+}
+/**
+ * Read a file as a Buffer
+ * @param filePath File path
+ * @returns File contents as Buffer or null if an error occurs
+ */
+function readFileAsBuffer(filePath) {
+    try {
+        if (!fileExists(filePath)) {
+            logger.error('File does not exist', { filePath });
+            return null;
+        }
+        return fs.readFileSync(filePath);
+    }
+    catch (error) {
+        logger.error('Error reading file', { filePath, error });
+        return null;
+    }
+}
+/**
+ * Write data to a file
+ * @param filePath File path to write to
+ * @param data Data to write
+ * @returns True if the file was written successfully
+ */
+function writeFile(filePath, data) {
+    try {
+        const dirPath = path.dirname(filePath);
+        if (!ensureDirectoryExists(dirPath)) {
+            logger.error('Could not create directory for file', { dirPath });
+            return false;
+        }
+        fs.writeFileSync(filePath, data);
+        return true;
+    }
+    catch (error) {
+        logger.error('Error writing file', { filePath, error });
+        return false;
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Logger utility for the Quickbase connector
+ */
+/**
+ * Log levels
+ */
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    error(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    debug(message: string, data?: unknown): void;
+}
+/**
+ * Set the global log level
+ * @param level New log level
+ */
+export declare function setLogLevel(level: LogLevel | string): void;
+/**
+ * Get the current global log level
+ * @returns Current log level
+ */
+export declare function getLogLevel(): string;
+/**
+ * Creates a logger with the specified name
+ * @param name Logger name
+ * @returns Logger instance
+ */
+export declare function createLogger(name: string): Logger;

package/dist/utils/logger.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Logger utility for the Quickbase connector
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
+exports.createLogger = createLogger;
+/**
+ * Log levels
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+// Global log level (can be set via environment variable)
+let globalLogLevel = process.env.LOG_LEVEL
+    ? (LogLevel[process.env.LOG_LEVEL.toUpperCase()] || LogLevel.INFO)
+    : LogLevel.INFO;
+/**
+ * Set the global log level
+ * @param level New log level
+ */
+function setLogLevel(level) {
+    if (typeof level === 'string') {
+        globalLogLevel = LogLevel[level.toUpperCase()] || LogLevel.INFO;
+    }
+    else {
+        globalLogLevel = level;
+    }
+}
+/**
+ * Get the current global log level
+ * @returns Current log level
+ */
+function getLogLevel() {
+    return LogLevel[globalLogLevel] || 'INFO';
+}
+/**
+ * Creates a logger with the specified name
+ * @param name Logger name
+ * @returns Logger instance
+ */
+function createLogger(name) {
+    const formatData = (data) => {
+        if (data === undefined)
+            return '';
+        try {
+            return JSON.stringify(redactSensitiveData(data));
+        }
+        catch (error) {
+            // Safe error message formatting to prevent nested serialization issues
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return `[Unserializable data: ${errorMessage}]`;
+        }
+    };
+    return {
+        error(message, data) {
+            if (globalLogLevel >= LogLevel.ERROR) {
+                // Use stderr to avoid interfering with JSON responses on stdout
+                process.stderr.write(`[ERROR] ${name}: ${message} ${data ? formatData(data) : ''}\n`);
+            }
+        },
+        warn(message, data) {
+            if (globalLogLevel >= LogLevel.WARN) {
+                // Use stderr to avoid interfering with JSON responses on stdout
+                process.stderr.write(`[WARN] ${name}: ${message} ${data ? formatData(data) : ''}\n`);
+            }
+        },
+        info(message, data) {
+            if (globalLogLevel >= LogLevel.INFO) {
+                // Use stderr to avoid interfering with JSON responses on stdout
+                process.stderr.write(`[INFO] ${name}: ${message} ${data ? formatData(data) : ''}\n`);
+            }
+        },
+        debug(message, data) {
+            if (globalLogLevel >= LogLevel.DEBUG) {
+                // Use stderr to avoid interfering with JSON responses on stdout
+                process.stderr.write(`[DEBUG] ${name}: ${message} ${data ? formatData(data) : ''}\n`);
+            }
+        }
+    };
+}
+/**
+ * Sensitive keys that should be redacted
+ */
+const SENSITIVE_KEYS = [
+    'token',
+    'password',
+    'secret',
+    'auth',
+    'key',
+    'credential',
+    'Authorization',
+    'QB-USER-TOKEN',
+    'userToken',
+    'QUICKBASE_USER_TOKEN'
+];
+/**
+ * Redacts sensitive data in objects with circular reference protection
+ * @param data Object to redact
+ * @returns Redacted object
+ */
+function redactSensitiveData(data) {
+    const visited = new WeakSet();
+    function redactRecursive(obj) {
+        if (!obj || typeof obj !== 'object') {
+            return obj;
+        }
+        // Circular reference protection
+        if (visited.has(obj)) {
+            return '[Circular Reference]';
+        }
+        visited.add(obj);
+        if (Array.isArray(obj)) {
+            return obj.map(item => redactRecursive(item));
+        }
+        const result = {};
+        try {
+            for (const [key, value] of Object.entries(obj)) {
+                if (typeof value === 'object' && value !== null) {
+                    result[key] = redactRecursive(value);
+                }
+                else if (typeof value === 'string' &&
+                    SENSITIVE_KEYS.some(k => key.toLowerCase().includes(k.toLowerCase()))) {
+                    result[key] = '***REDACTED***';
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+        catch (error) {
+            return '[Unserializable Object]';
+        }
+        return result;
+    }
+    return redactRecursive(data);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Options for configuring retry behavior
+ */
+export interface RetryOptions {
+    /**
+     * Maximum number of retry attempts
+     */
+    maxRetries: number;
+    /**
+     * Base delay in milliseconds between retries
+     */
+    baseDelay: number;
+    /**
+     * Maximum delay in milliseconds between retries
+     */
+    maxDelay?: number;
+    /**
+     * Factor to multiply delay by after each retry attempt
+     */
+    backoffFactor?: number;
+    /**
+     * Function that determines if an error is retryable
+     */
+    isRetryable?: (error: unknown) => boolean;
+}
+/**
+ * Calculates the delay time for a retry attempt with exponential backoff
+ * @param attempt Retry attempt number (0-based)
+ * @param options Retry options
+ * @returns Delay time in milliseconds
+ */
+export declare function calculateBackoff(attempt: number, options: RetryOptions): number;
+/**
+ * Wrapper function that adds retry logic to any async function
+ * @param fn Function to add retry logic to
+ * @param options Retry options
+ * @returns Function with retry logic
+ */
+export declare function withRetry<T, Args extends unknown[]>(fn: (...args: Args) => Promise<T>, options?: Partial<RetryOptions>): (...args: Args) => Promise<T>;