@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/mcp/tools/columns-update.js

@@ -0,0 +1,482 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _index = require("../../schemas/index.js");
+var _dataoperations = require("../../spreadsheet/data-operations.js");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+// Input schema for columns update requests with enhanced validation
+var inputSchema = _zod.z.object({
+    id: _index.SpreadsheetIdSchema,
+    gid: _index.SheetGidSchema,
+    rows: _zod.z.array(_zod.z.array(_index.SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),
+    headers: _zod.z.array(_zod.z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),
+    updateBy: _zod.z.array(_zod.z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),
+    behavior: _zod.z.enum([
+        'add-or-update',
+        'update-only',
+        'add-only'
+    ]).default('add-or-update').describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),
+    valueInputOption: _zod.z.enum([
+        'RAW',
+        'USER_ENTERED'
+    ]).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)')
+}).refine(function(data) {
+    // Validate that all updateBy columns exist in headers
+    var missingColumns = data.updateBy.filter(function(col) {
+        return !data.headers.includes(col);
+    });
+    return missingColumns.length === 0;
+}, {
+    message: 'All updateBy columns must exist in the headers array',
+    path: [
+        'updateBy'
+    ]
+}).refine(function(data) {
+    // Validate that all rows have the same length as headers
+    var invalidRows = data.rows.findIndex(function(row) {
+        return row.length !== data.headers.length;
+    });
+    return invalidRows === -1;
+}, {
+    message: 'All rows must have the same length as the headers array',
+    path: [
+        'rows'
+    ]
+}).refine(function(data) {
+    // Validate that updateBy columns are unique
+    var uniqueColumns = new Set(data.updateBy);
+    return uniqueColumns.size === data.updateBy.length;
+}, {
+    message: 'updateBy columns must be unique',
+    path: [
+        'updateBy'
+    ]
+});
+// Success branch schema
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    id: _index.SpreadsheetIdOutput,
+    gid: _index.SheetGidOutput,
+    spreadsheetTitle: _zod.z.string().describe('Title of the updated spreadsheet'),
+    spreadsheetUrl: _zod.z.string().describe('URL of the updated spreadsheet'),
+    sheetTitle: _zod.z.string().describe('Title of the updated sheet'),
+    sheetUrl: _zod.z.string().describe('URL of the updated sheet'),
+    updatedRows: _zod.z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),
+    insertedKeys: _zod.z.array(_zod.z.string()).describe('Keys of rows that were successfully inserted (new rows)'),
+    rowsSkipped: _zod.z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),
+    headersAdded: _zod.z.array(_zod.z.string()).describe('Column headers that were added to the sheet (if any were missing)'),
+    errors: _zod.z.array(_zod.z.string()).optional().describe('Any non-fatal errors encountered during the operation')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+// Helper function to ensure consistent key generation
+function generateConsistentRowKey(row, headers, strategy) {
+    return (0, _dataoperations.generateRowKey)(row, headers, strategy);
+}
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, gid, rows, headers, updateBy, _param_behavior, behavior, _param_valueInputOption, valueInputOption, _logger_debug, logger, _ref, _spreadsheetData_spreadsheetUrl, _sheet_properties_title, _sheet_properties_sheetId, _spreadsheetData_properties, _spreadsheetData_sheets, _logger_debug1, _upsertResult_errors, _logger_debug2, sheets, emptyKeyErrors, _logger_error, message, spreadsheetResponse, spreadsheetData, spreadsheetTitle, spreadsheetUrl, sheet, _logger_warn, sheetTitle, sheetGid, sheetUrl, upsertOptions, _ref1, existingKeys, processedRows, _logger_debug3, _logger_debug4, _logger_info, result, upsertResult, headersAdded, rowsFilteredByBehavior, totalRowsSkipped, result1, error, _logger_error1, message1;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, gid = param.gid, rows = param.rows, headers = param.headers, updateBy = param.updateBy, _param_behavior = param.behavior, behavior = _param_behavior === void 0 ? 'add-or-update' : _param_behavior, _param_valueInputOption = param.valueInputOption, valueInputOption = _param_valueInputOption === void 0 ? 'USER_ENTERED' : _param_valueInputOption;
+                    logger = extra.logger;
+                    (_logger_debug = logger.debug) === null || _logger_debug === void 0 ? void 0 : _logger_debug.call(logger, 'sheets.columns.update called', {
+                        id: id,
+                        gid: gid,
+                        rowCount: rows.length,
+                        headerCount: headers.length,
+                        updateByColumns: updateBy,
+                        behavior: behavior,
+                        valueInputOption: valueInputOption
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        5,
+                        ,
+                        6
+                    ]);
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    // Note: Basic input validation is now handled by the enhanced Zod schema
+                    // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows
+                    // This validation happens before finding spreadsheet/sheet to fail fast
+                    emptyKeyErrors = [];
+                    rows.forEach(function(row, rowIndex) {
+                        var keyValues = updateBy.map(function(keyCol) {
+                            var _row_colIndex;
+                            var colIndex = headers.indexOf(keyCol);
+                            return colIndex >= 0 ? String((_row_colIndex = row[colIndex]) !== null && _row_colIndex !== void 0 ? _row_colIndex : '').trim() : '';
+                        });
+                        if (keyValues.some(function(val) {
+                            return val === '';
+                        })) {
+                            emptyKeyErrors.push("Row ".concat(rowIndex + 1, " has empty key values for columns: ").concat(updateBy.join(', ')));
+                        }
+                    });
+                    if (emptyKeyErrors.length > 0) {
+                        ;
+                        message = "Silent data loss prevented - empty key columns detected:\n".concat(emptyKeyErrors.join('\n'));
+                        (_logger_error = logger.error) === null || _logger_error === void 0 ? void 0 : _logger_error.call(logger, 'sheets.columns.update error', {
+                            error: message
+                        });
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, message);
+                    }
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id,
+                            fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title'
+                        })
+                    ];
+                case 2:
+                    spreadsheetResponse = _state.sent();
+                    spreadsheetData = spreadsheetResponse.data;
+                    spreadsheetTitle = (_ref = (_spreadsheetData_properties = spreadsheetData.properties) === null || _spreadsheetData_properties === void 0 ? void 0 : _spreadsheetData_properties.title) !== null && _ref !== void 0 ? _ref : '';
+                    spreadsheetUrl = (_spreadsheetData_spreadsheetUrl = spreadsheetData.spreadsheetUrl) !== null && _spreadsheetData_spreadsheetUrl !== void 0 ? _spreadsheetData_spreadsheetUrl : '';
+                    // Find sheet by gid
+                    sheet = (_spreadsheetData_sheets = spreadsheetData.sheets) === null || _spreadsheetData_sheets === void 0 ? void 0 : _spreadsheetData_sheets.find(function(s) {
+                        var _s_properties;
+                        return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
+                    });
+                    if (!(sheet === null || sheet === void 0 ? void 0 : sheet.properties)) {
+                        ;
+                        (_logger_warn = logger.warn) === null || _logger_warn === void 0 ? void 0 : _logger_warn.call(logger, 'Sheet not found for columns update', {
+                            id: id,
+                            gid: gid,
+                            rowCount: rows.length
+                        });
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                    }
+                    sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
+                    sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
+                    sheetUrl = "https://docs.google.com/spreadsheets/d/".concat(id, "/edit#gid=").concat(sheetGid);
+                    // Configure upsert options based on behavior
+                    upsertOptions = {
+                        keyStrategy: {
+                            keyColumns: updateBy,
+                            useProviderIdLogic: false,
+                            separator: '\\'
+                        },
+                        allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',
+                        batchSize: 50,
+                        valueInputOption: valueInputOption
+                    };
+                    return [
+                        4,
+                        (0, _dataoperations.snapshotHeaderKeysAndPositions)(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy)
+                    ];
+                case 3:
+                    _ref1 = _state.sent(), existingKeys = _ref1.keySet;
+                    // Filter rows based on behavior using consistent key generation
+                    processedRows = rows;
+                    if (behavior === 'add-only') {
+                        ;
+                        // Only include rows that don't exist yet
+                        processedRows = rows.filter(function(row) {
+                            // Use the same key generation strategy as the upsert function
+                            var key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);
+                            return key !== '' && !existingKeys.has(key);
+                        });
+                        (_logger_debug3 = logger.debug) === null || _logger_debug3 === void 0 ? void 0 : _logger_debug3.call(logger, 'Filtered rows for add-only behavior', {
+                            originalCount: rows.length,
+                            filteredCount: processedRows.length
+                        });
+                    } else if (behavior === 'update-only') {
+                        ;
+                        // Only include rows that already exist
+                        processedRows = rows.filter(function(row) {
+                            // Use the same key generation strategy as the upsert function
+                            var key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);
+                            return key !== '' && existingKeys.has(key);
+                        });
+                        (_logger_debug4 = logger.debug) === null || _logger_debug4 === void 0 ? void 0 : _logger_debug4.call(logger, 'Filtered rows for update-only behavior', {
+                            originalCount: rows.length,
+                            filteredCount: processedRows.length
+                        });
+                    }
+                    // Early return if no rows to process after behavior filtering
+                    if (processedRows.length === 0) {
+                        ;
+                        (_logger_info = logger.info) === null || _logger_info === void 0 ? void 0 : _logger_info.call(logger, 'No rows to process after behavior filtering', {
+                            behavior: behavior,
+                            originalCount: rows.length
+                        });
+                        result = {
+                            type: 'success',
+                            id: id,
+                            gid: String(sheetGid),
+                            spreadsheetTitle: spreadsheetTitle || '',
+                            spreadsheetUrl: spreadsheetUrl || '',
+                            sheetTitle: sheetTitle,
+                            sheetUrl: sheetUrl,
+                            updatedRows: 0,
+                            insertedKeys: [],
+                            rowsSkipped: rows.length,
+                            headersAdded: [],
+                            errors: [
+                                "No rows matched behavior '".concat(behavior, "' - all ").concat(rows.length, " rows were skipped")
+                            ]
+                        };
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify(result)
+                                    }
+                                ],
+                                structuredContent: {
+                                    result: result
+                                }
+                            }
+                        ];
+                    }
+                    (_logger_debug1 = logger.debug) === null || _logger_debug1 === void 0 ? void 0 : _logger_debug1.call(logger, 'sheets.columns.update executing upsert operation', {
+                        spreadsheetId: id,
+                        sheetTitle: sheetTitle,
+                        canonicalHeaders: headers,
+                        keyColumns: updateBy,
+                        behavior: behavior,
+                        processedRowsCount: processedRows.length
+                    });
+                    return [
+                        4,
+                        (0, _dataoperations.upsertByKey)(sheets, {
+                            spreadsheetId: id,
+                            sheetTitle: sheetTitle,
+                            rows: processedRows,
+                            canonicalHeaders: headers,
+                            options: upsertOptions,
+                            logger: logger
+                        })
+                    ];
+                case 4:
+                    upsertResult = _state.sent();
+                    // Track headers that were added (if any)
+                    // This would require additional logic in upsertByKey to return added headers
+                    headersAdded = [];
+                    // Calculate total rows skipped: behavior filter + upsert duplicates
+                    rowsFilteredByBehavior = rows.length - processedRows.length;
+                    totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;
+                    (_logger_debug2 = logger.debug) === null || _logger_debug2 === void 0 ? void 0 : _logger_debug2.call(logger, 'sheets.columns.update completed successfully', {
+                        updatedRows: upsertResult.updatedRows,
+                        insertedCount: upsertResult.inserted.length,
+                        rowsSkipped: totalRowsSkipped,
+                        rowsFilteredByBehavior: rowsFilteredByBehavior,
+                        rowsSkippedByUpsert: upsertResult.rowsSkipped,
+                        errorsCount: ((_upsertResult_errors = upsertResult.errors) === null || _upsertResult_errors === void 0 ? void 0 : _upsertResult_errors.length) || 0
+                    });
+                    result1 = {
+                        type: 'success',
+                        id: id,
+                        gid: String(sheetGid),
+                        spreadsheetTitle: spreadsheetTitle || '',
+                        spreadsheetUrl: spreadsheetUrl || '',
+                        sheetTitle: sheetTitle,
+                        sheetUrl: sheetUrl,
+                        updatedRows: upsertResult.updatedRows,
+                        insertedKeys: upsertResult.inserted,
+                        rowsSkipped: totalRowsSkipped,
+                        headersAdded: headersAdded,
+                        errors: upsertResult.errors
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result1)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result1
+                            }
+                        }
+                    ];
+                case 5:
+                    error = _state.sent();
+                    message1 = _instanceof(error, Error) ? error.message : String(error);
+                    (_logger_error1 = logger.error) === null || _logger_error1 === void 0 ? void 0 : _logger_error1.call(logger, 'sheets.columns.update error', {
+                        error: message1
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error updating columns: ".concat(message1), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 6:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'columns-update',
+        config: config,
+        handler: handler
+    };
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/mcp/tools/columns-update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.js';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    gid: SheetGidSchema,\n    rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n    headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n    updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n    behavior: z\n      .enum(['add-or-update', 'update-only', 'add-only'])\n      .default('add-or-update')\n      .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n    valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n  })\n  .refine(\n    (data) => {\n      // Validate that all updateBy columns exist in headers\n      const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n      return missingColumns.length === 0;\n    },\n    {\n      message: 'All updateBy columns must exist in the headers array',\n      path: ['updateBy'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that all rows have the same length as headers\n      const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n      return invalidRows === -1;\n    },\n    {\n      message: 'All rows must have the same length as the headers array',\n      path: ['rows'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that updateBy columns are unique\n      const uniqueColumns = new Set(data.updateBy);\n      return uniqueColumns.size === data.updateBy.length;\n    },\n    {\n      message: 'updateBy columns must be unique',\n      path: ['updateBy'],\n    }\n  );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n  insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n  rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n  headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n  errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n  return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.update called', {\n    id,\n    gid,\n    rowCount: rows.length,\n    headerCount: headers.length,\n    updateByColumns: updateBy,\n    behavior,\n    valueInputOption,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Note: Basic input validation is now handled by the enhanced Zod schema\n\n    // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n    // This validation happens before finding spreadsheet/sheet to fail fast\n    const emptyKeyErrors: string[] = [];\n    rows.forEach((row, rowIndex) => {\n      const keyValues = updateBy.map((keyCol) => {\n        const colIndex = headers.indexOf(keyCol);\n        return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n      });\n\n      if (keyValues.some((val) => val === '')) {\n        emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n      }\n    });\n\n    if (emptyKeyErrors.length > 0) {\n      const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n      logger.error?.('sheets.columns.update error', { error: message });\n      throw new McpError(ErrorCode.InvalidParams, message);\n    }\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    // Configure upsert options based on behavior\n    const upsertOptions: UpsertOptions = {\n      keyStrategy: {\n        keyColumns: updateBy,\n        useProviderIdLogic: false, // Use standard key generation for column-based updates\n        separator: '\\\\',\n      },\n      allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n      batchSize: 50,\n      valueInputOption: valueInputOption,\n    };\n\n    // Get existing keys to implement behavior filtering\n    const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n    // Filter rows based on behavior using consistent key generation\n    let processedRows = rows;\n    if (behavior === 'add-only') {\n      // Only include rows that don't exist yet\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && !existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for add-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    } else if (behavior === 'update-only') {\n      // Only include rows that already exist\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for update-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    }\n\n    // Early return if no rows to process after behavior filtering\n    if (processedRows.length === 0) {\n      logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetGid),\n        spreadsheetTitle: spreadsheetTitle || '',\n        spreadsheetUrl: spreadsheetUrl || '',\n        sheetTitle,\n        sheetUrl,\n        updatedRows: 0,\n        insertedKeys: [],\n        rowsSkipped: rows.length,\n        headersAdded: [],\n        errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n      };\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.debug?.('sheets.columns.update executing upsert operation', {\n      spreadsheetId: id,\n      sheetTitle,\n      canonicalHeaders: headers,\n      keyColumns: updateBy,\n      behavior,\n      processedRowsCount: processedRows.length,\n    });\n\n    // Execute the upsert operation using the shared function\n    const upsertResult = await upsertByKey(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      canonicalHeaders: headers,\n      options: upsertOptions,\n      logger,\n    });\n\n    // Track headers that were added (if any)\n    // This would require additional logic in upsertByKey to return added headers\n    const headersAdded: string[] = [];\n\n    // Calculate total rows skipped: behavior filter + upsert duplicates\n    const rowsFilteredByBehavior = rows.length - processedRows.length;\n    const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n    logger.debug?.('sheets.columns.update completed successfully', {\n      updatedRows: upsertResult.updatedRows,\n      insertedCount: upsertResult.inserted.length,\n      rowsSkipped: totalRowsSkipped,\n      rowsFilteredByBehavior,\n      rowsSkippedByUpsert: upsertResult.rowsSkipped,\n      errorsCount: upsertResult.errors?.length || 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      updatedRows: upsertResult.updatedRows,\n      insertedKeys: upsertResult.inserted,\n      rowsSkipped: totalRowsSkipped,\n      headersAdded,\n      errors: upsertResult.errors,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.update error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error updating columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","rows","array","SheetCellSchema","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","generateRowKey","handler","extra","logger","spreadsheetData","sheet","upsertResult","sheets","emptyKeyErrors","spreadsheetResponse","sheetGid","upsertOptions","existingKeys","processedRows","rowsFilteredByBehavior","totalRowsSkipped","error","debug","rowCount","headerCount","updateByColumns","google","version","auth","authContext","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","McpError","ErrorCode","InvalidParams","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","snapshotHeaderKeysAndPositions","keySet","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","upsertByKey","options","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/csv-get-columns.d.cts

@@ -0,0 +1,43 @@
+/** Get column names from CSV file (peek at first row only) */
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    sourceUri: z.ZodString;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    columns: z.ZodArray<z.ZodString>;
+    isEmpty: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ sourceUri }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Get first row from CSV file (streaming, no memory overhead). Returns columns array and isEmpty flag.";
+        readonly inputSchema: z.ZodObject<{
+            sourceUri: z.ZodString;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                columns: z.ZodArray<z.ZodString>;
+                isEmpty: z.ZodBoolean;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/csv-get-columns.d.ts

@@ -0,0 +1,43 @@
+/** Get column names from CSV file (peek at first row only) */
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    sourceUri: z.ZodString;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    columns: z.ZodArray<z.ZodString>;
+    isEmpty: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ sourceUri }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Get first row from CSV file (streaming, no memory overhead). Returns columns array and isEmpty flag.";
+        readonly inputSchema: z.ZodObject<{
+            sourceUri: z.ZodString;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                columns: z.ZodArray<z.ZodString>;
+                isEmpty: z.ZodBoolean;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};