mcp-quickbase 2.0.1

package/dist/tools/tables/update_table.d.ts

@@ -0,0 +1,91 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for update_table tool
+ */
+export interface UpdateTableParams {
+    /**
+     * The ID of the table to update
+     */
+    table_id: string;
+    /**
+     * New name for the table
+     */
+    name?: string;
+    /**
+     * New description for the table
+     */
+    description?: string;
+    /**
+     * Additional options for table update
+     */
+    options?: Record<string, any>;
+}
+/**
+ * Response from updating a table
+ */
+export interface UpdateTableResult {
+    /**
+     * The ID of the updated table
+     */
+    tableId: string;
+    /**
+     * The updated name of the table
+     */
+    name?: string;
+    /**
+     * The updated description of the table
+     */
+    description?: string;
+    /**
+     * The date the table was updated
+     */
+    updated?: string;
+    /**
+     * Additional details returned from the API
+     */
+    [key: string]: any;
+}
+/**
+ * Tool for updating an existing table in a Quickbase application
+ */
+export declare class UpdateTableTool extends BaseTool<UpdateTableParams, UpdateTableResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for update_table
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            options: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the update_table tool
+     * @param params Tool parameters
+     * @returns Updated table details
+     */
+    protected run(params: UpdateTableParams): Promise<UpdateTableResult>;
+}

package/dist/tools/tables/update_table.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateTableTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('UpdateTableTool');
+/**
+ * Tool for updating an existing table in a Quickbase application
+ */
+class UpdateTableTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'update_table';
+        this.description = 'Updates an existing Quickbase table';
+        /**
+         * Parameter schema for update_table
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the table'
+                },
+                name: {
+                    type: 'string',
+                    description: 'New name for the table'
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description for the table'
+                },
+                options: {
+                    type: 'object',
+                    description: 'Additional options for table update'
+                }
+            },
+            required: ['table_id']
+        };
+    }
+    /**
+     * Run the update_table tool
+     * @param params Tool parameters
+     * @returns Updated table details
+     */
+    async run(params) {
+        logger.info('Updating Quickbase table', {
+            tableId: params.table_id
+        });
+        const { table_id, name, description, options } = params;
+        // At least one update field is required
+        if (!name && !description && (!options || Object.keys(options).length === 0)) {
+            throw new Error('At least one update field (name, description, or options) is required');
+        }
+        // Prepare request body with only the fields that are provided
+        const body = {};
+        if (name !== undefined) {
+            body.name = name;
+        }
+        if (description !== undefined) {
+            body.description = description;
+        }
+        // Add any additional options
+        if (options) {
+            Object.assign(body, options);
+        }
+        // Update the table
+        const response = await this.client.request({
+            method: 'POST',
+            path: `/tables/${table_id}`,
+            body
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to update table', {
+                error: response.error,
+                tableId: table_id
+            });
+            throw new Error(response.error?.message || 'Failed to update table');
+        }
+        const table = response.data;
+        logger.info('Successfully updated table', {
+            tableId: table.id,
+            updates: Object.keys(body).join(', ')
+        });
+        return {
+            tableId: table.id,
+            name: table.name,
+            description: table.description,
+            updated: table.updated || new Date().toISOString(),
+            ...table
+        };
+    }
+}
+exports.UpdateTableTool = UpdateTableTool;
+//# sourceMappingURL=update_table.js.map

package/dist/tools/tables/update_table.js.map

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

package/dist/tools/test_connection.d.ts

@@ -0,0 +1,51 @@
+import { BaseTool } from './base';
+import { QuickbaseClient } from '../client/quickbase';
+/**
+ * Test connection parameters
+ */
+export interface TestConnectionParams {
+}
+/**
+ * Test connection result
+ */
+export interface TestConnectionResult {
+    connected: boolean;
+    userInfo?: {
+        id: string;
+        email: string;
+        name: string;
+        [key: string]: unknown;
+    };
+    realmInfo?: {
+        hostname: string;
+        id: string;
+        [key: string]: unknown;
+    };
+    errorMessage?: string;
+}
+/**
+ * Tool for testing the connection to Quickbase
+ */
+export declare class TestConnectionTool extends BaseTool<TestConnectionParams, TestConnectionResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for test_connection
+     */
+    paramSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the test_connection tool
+     * @param params Tool parameters (none required)
+     * @returns Test result
+     */
+    protected run(_params: TestConnectionParams): Promise<TestConnectionResult>;
+}

package/dist/tools/test_connection.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestConnectionTool = void 0;
+const base_1 = require("./base");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)('TestConnectionTool');
+/**
+ * Tool for testing the connection to Quickbase
+ */
+class TestConnectionTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'test_connection';
+        this.description = 'Tests the connection to Quickbase';
+        /**
+         * Parameter schema for test_connection
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {},
+            required: []
+        };
+    }
+    /**
+     * Run the test_connection tool
+     * @param params Tool parameters (none required)
+     * @returns Test result
+     */
+    async run(_params) {
+        logger.info('Testing connection to Quickbase');
+        try {
+            // Try to get apps list as a simple test
+            // This endpoint requires authentication and will validate our credentials
+            const config = this.client.getConfig();
+            // If we have an app ID, try to get that specific app
+            // Otherwise, just try to list apps (which should return at least one)
+            let response;
+            if (config.appId) {
+                response = await this.client.request({
+                    method: 'GET',
+                    path: `/apps/${config.appId}`
+                });
+            }
+            else {
+                response = await this.client.request({
+                    method: 'GET',
+                    path: '/apps'
+                });
+            }
+            if (!response.success) {
+                logger.error('Connection test failed', { error: response.error });
+                throw new Error(response.error?.message || 'Failed to connect to Quickbase');
+            }
+            logger.info('Connection test successful');
+            // Extract some basic info from the response
+            const data = response.data;
+            return {
+                connected: true,
+                userInfo: {
+                    id: 'authenticated',
+                    email: 'authenticated-user',
+                    name: 'Quickbase User',
+                },
+                realmInfo: {
+                    hostname: config.realmHost,
+                    id: config.appId || 'no-app-specified',
+                    appName: data?.name || 'Unknown App'
+                }
+            };
+        }
+        catch (error) {
+            logger.error('Connection test failed with error', { error });
+            // Provide more specific error messages
+            let errorMessage = 'Failed to connect to Quickbase';
+            if (error instanceof Error) {
+                if (error.message.includes('401')) {
+                    errorMessage = 'Authentication failed. Please check your user token.';
+                }
+                else if (error.message.includes('404')) {
+                    errorMessage = 'App not found. Please check your app ID.';
+                }
+                else if (error.message.includes('403')) {
+                    errorMessage = 'Access denied. Please check your permissions.';
+                }
+                else {
+                    errorMessage = error.message;
+                }
+            }
+            return {
+                connected: false,
+                errorMessage
+            };
+        }
+    }
+}
+exports.TestConnectionTool = TestConnectionTool;
+//# sourceMappingURL=test_connection.js.map

package/dist/tools/test_connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_connection.js","sourceRoot":"","sources":["../../src/tools/test_connection.ts"],"names":[],"mappings":";;;AAAA,iCAAkC;AAElC,4CAA+C;AAE/C,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,oBAAoB,CAAC,CAAC;AA4BlD;;GAEG;AACH,MAAa,kBAAmB,SAAQ,eAAoD;IAa1F;;;OAGG;IACH,YAAY,MAAuB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC;QAjBT,SAAI,GAAG,iBAAiB,CAAC;QACzB,gBAAW,GAAG,mCAAmC,CAAC;QAEzD;;WAEG;QACI,gBAAW,GAAG;YACnB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb,CAAC;IAQF,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,GAAG,CAAC,OAA6B;QAC/C,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,wCAAwC;YACxC,0EAA0E;YAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAEvC,qDAAqD;YACrD,sEAAsE;YACtE,IAAI,QAAQ,CAAC;YACb,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;oBACnC,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,SAAS,MAAM,CAAC,KAAK,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;oBACnC,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,OAAO;iBACd,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,gCAAgC,CAAC,CAAC;YAC/E,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAE1C,4CAA4C;YAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YAEtD,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE;oBACR,EAAE,EAAE,eAAe;oBACnB,KAAK,EAAE,oBAAoB;oBAC3B,IAAI,EAAE,gBAAgB;iBACvB;gBACD,SAAS,EAAE;oBACT,QAAQ,EAAE,MAAM,CAAC,SAAS;oBAC1B,EAAE,EAAE,MAAM,CAAC,KAAK,IAAI,kBAAkB;oBACtC,OAAO,EAAE,IAAI,EAAE,IAAc,IAAI,aAAa;iBAC/C;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAE7D,uCAAuC;YACvC,IAAI,YAAY,GAAG,gCAAgC,CAAC;YACpD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClC,YAAY,GAAG,sDAAsD,CAAC;gBACxE,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,YAAY,GAAG,0CAA0C,CAAC;gBAC5D,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzC,YAAY,GAAG,+CAA+C,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,YAAY;aACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA/FD,gDA+FC"}

package/dist/types/api.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Common API interfaces for Quickbase client
+ */
+/**
+ * Base API response
+ */
+export interface ApiResponse<T> {
+    /**
+     * Whether the request was successful
+     */
+    success: boolean;
+    /**
+     * Response data (present if success is true)
+     */
+    data?: T;
+    /**
+     * Error information (present if success is false)
+     */
+    error?: ApiError;
+}
+/**
+ * API error structure
+ */
+export interface ApiError {
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Error code
+     */
+    code?: number;
+    /**
+     * Error type
+     */
+    type?: string;
+    /**
+     * Additional error details
+     */
+    details?: Record<string, unknown>;
+}
+/**
+ * HTTP request options
+ */
+export interface RequestOptions {
+    /**
+     * HTTP method
+     */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /**
+     * Path to the API endpoint
+     */
+    path: string;
+    /**
+     * Request body
+     */
+    body?: Record<string, unknown>;
+    /**
+     * Query parameters
+     */
+    params?: Record<string, string>;
+    /**
+     * Additional headers
+     */
+    headers?: Record<string, string>;
+    /**
+     * Whether to skip caching
+     */
+    skipCache?: boolean;
+}

package/dist/types/api.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Common API interfaces for Quickbase client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/config.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Configuration interface for the Quickbase connector
+ */
+export interface QuickbaseConfig {
+    /**
+     * Quickbase realm hostname
+     */
+    realmHost: string;
+    /**
+     * Quickbase user token for authentication
+     */
+    userToken: string;
+    /**
+     * Application ID
+     */
+    appId?: string;
+    /**
+     * User agent string
+     */
+    userAgent?: string;
+    /**
+     * Enable caching of API responses
+     */
+    cacheEnabled?: boolean;
+    /**
+     * Cache time-to-live in seconds
+     */
+    cacheTtl?: number;
+    /**
+     * Maximum number of retry attempts
+     */
+    maxRetries?: number;
+    /**
+     * Retry delay in milliseconds
+     */
+    retryDelay?: number;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Request timeout in milliseconds
+     */
+    requestTimeout?: number;
+    /**
+     * Rate limit - maximum requests per second
+     */
+    rateLimit?: number;
+}

package/dist/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/mcp.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Types for the MCP (Model Context Protocol) integration
+ */
+import { ApiResponse } from './api';
+/**
+ * Base MCP tool interface
+ */
+export interface McpTool<TParams, TResult> {
+    /**
+     * Tool name
+     */
+    name: string;
+    /**
+     * Tool description
+     */
+    description: string;
+    /**
+     * Function to execute the tool
+     */
+    execute: (params: TParams) => Promise<ApiResponse<TResult>>;
+    /**
+     * Parameter schema for the tool
+     */
+    paramSchema: Record<string, unknown>;
+}
+/**
+ * MCP tool registry
+ */
+export interface ToolRegistry {
+    /**
+     * Get a tool by name
+     */
+    getTool(name: string): McpTool<unknown, unknown> | undefined;
+    /**
+     * Register a tool
+     */
+    registerTool<TParams, TResult>(tool: McpTool<TParams, TResult>): void;
+    /**
+     * Get all registered tools
+     */
+    getAllTools(): McpTool<unknown, unknown>[];
+}
+/**
+ * MCP request format
+ */
+export interface McpRequest {
+    /**
+     * Name of the tool to execute
+     */
+    tool: string;
+    /**
+     * Tool parameters
+     */
+    params?: Record<string, unknown>;
+}

package/dist/types/mcp.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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":""}

package/dist/utils/cache.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Cache service for API responses
+ */
+export declare class CacheService {
+    private cache;
+    private enabled;
+    private static instances;
+    private static cleanupHandlerInstalled;
+    private operationLock;
+    /**
+     * Creates a new cache service
+     * @param ttl Default TTL in seconds (default: 3600)
+     * @param enabled Whether caching is enabled (default: true)
+     */
+    constructor(ttl?: number, enabled?: boolean);
+    /**
+     * Gets a value from the cache
+     * @param key Cache key
+     * @returns The cached value or undefined if not found
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * 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<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * Removes a value from the cache
+     * @param key Cache key
+     */
+    del(key: string): void;
+    /**
+     * Clears all cache entries
+     */
+    clear(): void;
+    /**
+     * Enables or disables the cache
+     * @param enabled Whether the cache should be enabled
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Returns whether the cache is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Checks if a key exists in the cache
+     * @param key Cache key
+     * @returns True if the key exists, false otherwise
+     */
+    has(key: string): boolean;
+    /**
+     * Removes a value from the cache (alias for del)
+     * @param key Cache key
+     */
+    delete(key: string): void;
+    /**
+     * Gets cache statistics
+     * @returns Cache statistics
+     */
+    getStats(): {
+        hits: number;
+        misses: number;
+        keys: number;
+    };
+    /**
+     * Sets a new default TTL
+     * @param ttl New TTL in seconds
+     */
+    setTtl(ttl: number): void;
+    private safeTtlUpdate;
+    /**
+     * Cleanup this cache instance
+     */
+    cleanup(): void;
+    /**
+     * Install process cleanup handlers (called once)
+     */
+    private static installCleanupHandlers;
+    /**
+     * Get cleanup statistics
+     */
+    static getStats(): {
+        instances: number;
+    };
+}