mcp-quickbase 2.0.1

package/dist/tools/fields/update_field.js

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

package/dist/tools/fields/update_field.js.map

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

package/dist/tools/files/download_file.d.ts

@@ -0,0 +1,111 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for download_file tool
+ */
+export interface DownloadFileParams {
+    /**
+     * The ID of the table containing the record
+     */
+    table_id: string;
+    /**
+     * The ID of the record containing the file
+     */
+    record_id: string;
+    /**
+     * The ID of the file attachment field
+     */
+    field_id: string;
+    /**
+     * Path where the file should be saved
+     */
+    output_path: string;
+    /**
+     * The version of the file to download (default 0 for latest)
+     */
+    version?: string;
+}
+/**
+ * Response from downloading a file
+ */
+export interface DownloadFileResult {
+    /**
+     * The ID of the record the file was downloaded from
+     */
+    recordId: string;
+    /**
+     * The ID of the field the file was downloaded from
+     */
+    fieldId: string;
+    /**
+     * The ID of the table containing the record
+     */
+    tableId: string;
+    /**
+     * The name of the downloaded file
+     */
+    fileName: string;
+    /**
+     * The size of the downloaded file in bytes
+     */
+    fileSize: number;
+    /**
+     * The version of the file
+     */
+    version: string;
+    /**
+     * The path where the file was saved
+     */
+    outputPath: string;
+    /**
+     * Download timestamp
+     */
+    downloadTime: string;
+}
+/**
+ * Tool for downloading a file from a field in a Quickbase record
+ */
+export declare class DownloadFileTool extends BaseTool<DownloadFileParams, DownloadFileResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for download_file
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            record_id: {
+                type: string;
+                description: string;
+            };
+            field_id: {
+                type: string;
+                description: string;
+            };
+            output_path: {
+                type: string;
+                description: string;
+            };
+            version: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the download_file tool
+     * @param params Tool parameters
+     * @returns Download result
+     */
+    protected run(params: DownloadFileParams): Promise<DownloadFileResult>;
+}

package/dist/tools/files/download_file.js

@@ -0,0 +1,173 @@
+"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.DownloadFileTool = void 0;
+const base_1 = require("../base");
+const logger_1 = require("../../utils/logger");
+const file_1 = require("../../utils/file");
+const path = __importStar(require("path"));
+const logger = (0, logger_1.createLogger)('DownloadFileTool');
+/**
+ * Tool for downloading a file from a field in a Quickbase record
+ */
+class DownloadFileTool extends base_1.BaseTool {
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client) {
+        super(client);
+        this.name = 'download_file';
+        this.description = 'Downloads a file from a field in a Quickbase record';
+        /**
+         * Parameter schema for download_file
+         */
+        this.paramSchema = {
+            type: 'object',
+            properties: {
+                table_id: {
+                    type: 'string',
+                    description: 'The ID of the Quickbase table'
+                },
+                record_id: {
+                    type: 'string',
+                    description: 'The ID of the record'
+                },
+                field_id: {
+                    type: 'string',
+                    description: 'The ID of the field (must be a file attachment field)'
+                },
+                output_path: {
+                    type: 'string',
+                    description: 'Path where the file should be saved'
+                },
+                version: {
+                    type: 'string',
+                    description: 'The version of the file to download (default 0 for latest)'
+                }
+            },
+            required: ['table_id', 'record_id', 'field_id', 'output_path']
+        };
+    }
+    /**
+     * Run the download_file tool
+     * @param params Tool parameters
+     * @returns Download result
+     */
+    async run(params) {
+        const { table_id, record_id, field_id, output_path, version = '0' } = params;
+        logger.info('Downloading file from Quickbase record', {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            version
+        });
+        // Check if the output directory exists
+        const outputDir = path.dirname(output_path);
+        if (!(0, file_1.ensureDirectoryExists)(outputDir)) {
+            throw new Error(`Unable to create output directory: ${outputDir}`);
+        }
+        // Build the URL for downloading the file
+        const queryParams = {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            version
+        };
+        // Construct the query string
+        const queryString = Object.entries(queryParams)
+            .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
+            .join('&');
+        // Download the file
+        const response = await this.client.request({
+            method: 'GET',
+            path: `/files?${queryString}`
+        });
+        if (!response.success || !response.data) {
+            logger.error('Failed to download file', {
+                error: response.error,
+                tableId: table_id,
+                recordId: record_id,
+                fieldId: field_id
+            });
+            throw new Error(response.error?.message || 'Failed to download file');
+        }
+        const fileData = response.data;
+        // Extract file information
+        const fileName = fileData.fileName || 'downloaded_file';
+        const fileContent = fileData.fileData;
+        if (!fileContent) {
+            throw new Error('Downloaded file does not contain any data');
+        }
+        // Determine if the file content is base64 encoded
+        const isBase64 = typeof fileContent === 'string' &&
+            /^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}==)?$/.test(fileContent);
+        // Decode and write the file
+        let fileBuffer;
+        if (isBase64) {
+            fileBuffer = Buffer.from(fileContent, 'base64');
+        }
+        else if (typeof fileContent === 'string') {
+            fileBuffer = Buffer.from(fileContent);
+        }
+        else {
+            throw new Error('Unsupported file data format');
+        }
+        // Write the file to the output path
+        const writeSuccess = (0, file_1.writeFile)(output_path, fileBuffer);
+        if (!writeSuccess) {
+            throw new Error(`Failed to write file to ${output_path}`);
+        }
+        logger.info('Successfully downloaded file', {
+            tableId: table_id,
+            recordId: record_id,
+            fieldId: field_id,
+            fileName,
+            outputPath: output_path
+        });
+        return {
+            recordId: record_id,
+            fieldId: field_id,
+            tableId: table_id,
+            fileName,
+            fileSize: fileBuffer.length,
+            version,
+            outputPath: output_path,
+            downloadTime: new Date().toISOString()
+        };
+    }
+}
+exports.DownloadFileTool = DownloadFileTool;
+//# sourceMappingURL=download_file.js.map

package/dist/tools/files/download_file.js.map

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

package/dist/tools/files/index.d.ts

@@ -0,0 +1,8 @@
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Register all file operation tools with the registry
+ * @param client Quickbase client
+ */
+export declare function registerFileTools(client: QuickbaseClient): void;
+export * from './upload_file';
+export * from './download_file';

package/dist/tools/files/index.js

@@ -0,0 +1,37 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFileTools = registerFileTools;
+const registry_1 = require("../registry");
+const upload_file_1 = require("./upload_file");
+const download_file_1 = require("./download_file");
+const logger_1 = require("../../utils/logger");
+const logger = (0, logger_1.createLogger)('FileTools');
+/**
+ * Register all file operation tools with the registry
+ * @param client Quickbase client
+ */
+function registerFileTools(client) {
+    logger.info('Registering file operation tools');
+    // Register individual tools
+    registry_1.toolRegistry.registerTool(new upload_file_1.UploadFileTool(client));
+    registry_1.toolRegistry.registerTool(new download_file_1.DownloadFileTool(client));
+    logger.info('File operation tools registered');
+}
+// Export all tools
+__exportStar(require("./upload_file"), exports);
+__exportStar(require("./download_file"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/files/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAYA,8CAQC;AAnBD,0CAA2C;AAC3C,+CAA+C;AAC/C,mDAAmD;AACnD,+CAAkD;AAElD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,WAAW,CAAC,CAAC;AAEzC;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAAuB;IACvD,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAEhD,4BAA4B;IAC5B,uBAAY,CAAC,YAAY,CAAC,IAAI,4BAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,uBAAY,CAAC,YAAY,CAAC,IAAI,gCAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAExD,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;AACjD,CAAC;AAED,mBAAmB;AACnB,gDAA8B;AAC9B,kDAAgC"}

package/dist/tools/files/upload_file.d.ts

@@ -0,0 +1,107 @@
+import { BaseTool } from '../base';
+import { QuickbaseClient } from '../../client/quickbase';
+/**
+ * Parameters for upload_file tool
+ */
+export interface UploadFileParams {
+    /**
+     * The ID of the table containing the record
+     */
+    table_id: string;
+    /**
+     * The ID of the record to attach the file to
+     */
+    record_id: string;
+    /**
+     * The ID of the file attachment field
+     */
+    field_id: string;
+    /**
+     * Path to the file to upload
+     */
+    file_path: string;
+    /**
+     * Custom file name (optional, defaults to the original filename)
+     */
+    file_name?: string;
+}
+/**
+ * Response from uploading a file
+ */
+export interface UploadFileResult {
+    /**
+     * The ID of the record the file was attached to
+     */
+    recordId: string;
+    /**
+     * The ID of the field the file was attached to
+     */
+    fieldId: string;
+    /**
+     * The ID of the table containing the record
+     */
+    tableId: string;
+    /**
+     * The name of the uploaded file
+     */
+    fileName: string;
+    /**
+     * The size of the uploaded file in bytes
+     */
+    fileSize: number;
+    /**
+     * The version of the file (incremented for each upload to the same field)
+     */
+    version?: number;
+    /**
+     * Upload timestamp
+     */
+    uploadTime?: string;
+}
+/**
+ * Tool for uploading a file to a field in a Quickbase record
+ */
+export declare class UploadFileTool extends BaseTool<UploadFileParams, UploadFileResult> {
+    name: string;
+    description: string;
+    /**
+     * Parameter schema for upload_file
+     */
+    paramSchema: {
+        type: string;
+        properties: {
+            table_id: {
+                type: string;
+                description: string;
+            };
+            record_id: {
+                type: string;
+                description: string;
+            };
+            field_id: {
+                type: string;
+                description: string;
+            };
+            file_path: {
+                type: string;
+                description: string;
+            };
+            file_name: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    /**
+     * Constructor
+     * @param client Quickbase client
+     */
+    constructor(client: QuickbaseClient);
+    /**
+     * Run the upload_file tool
+     * @param params Tool parameters
+     * @returns Upload result
+     */
+    protected run(params: UploadFileParams): Promise<UploadFileResult>;
+}