@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/mcp/tools/rows-csv-append.js

@@ -0,0 +1,859 @@
+/** Import CSV data to Google Sheets with database-style row append and deduplication */ "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 _csvparse = require("csv-parse");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _index = require("../../schemas/index.js");
+var _csvstreaming = require("../../spreadsheet/csv-streaming.js");
+var _deduplicationutils = require("../../spreadsheet/deduplication-utils.js");
+var _sheetoperations = require("../../spreadsheet/sheet-operations.js");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _async_iterator(iterable) {
+    var method, async, sync, retry = 2;
+    for("undefined" != typeof Symbol && (async = Symbol.asyncIterator, sync = Symbol.iterator); retry--;){
+        if (async && null != (method = iterable[async])) return method.call(iterable);
+        if (sync && null != (method = iterable[sync])) return new AsyncFromSyncIterator(method.call(iterable));
+        async = "@@asyncIterator", sync = "@@iterator";
+    }
+    throw new TypeError("Object is not async iterable");
+}
+function AsyncFromSyncIterator(s) {
+    function AsyncFromSyncIteratorContinuation(r) {
+        if (Object(r) !== r) return Promise.reject(new TypeError(r + " is not an object."));
+        var done = r.done;
+        return Promise.resolve(r.value).then(function(value) {
+            return {
+                value: value,
+                done: done
+            };
+        });
+    }
+    return AsyncFromSyncIterator = function(s) {
+        this.s = s, this.n = s.next;
+    }, AsyncFromSyncIterator.prototype = {
+        s: null,
+        n: null,
+        next: function() {
+            return AsyncFromSyncIteratorContinuation(this.n.apply(this.s, arguments));
+        },
+        return: function(value) {
+            var ret = this.s.return;
+            return void 0 === ret ? Promise.resolve({
+                value: value,
+                done: !0
+            }) : AsyncFromSyncIteratorContinuation(ret.apply(this.s, arguments));
+        },
+        throw: function(value) {
+            var thr = this.s.return;
+            return void 0 === thr ? Promise.reject(value) : AsyncFromSyncIteratorContinuation(thr.apply(this.s, arguments));
+        }
+    }, new AsyncFromSyncIterator(s);
+}
+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 _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+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
+        };
+    }
+}
+function _ts_values(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function() {
+            if (o && i >= o.length) o = void 0;
+            return {
+                value: o && o[i++],
+                done: !o
+            };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+// Header mapping schema: source/target can be string (name) or number (0-based index)
+var HeaderMapItemSchema = _zod.z.object({
+    source: _zod.z.union([
+        _zod.z.string(),
+        _zod.z.number().int().min(0)
+    ]).describe('CSV column: header name (string) or 0-based index (number)'),
+    target: _zod.z.union([
+        _zod.z.string(),
+        _zod.z.number().int().min(0)
+    ]).describe('Sheet column: header name (string) or 0-based index (number)')
+});
+var inputSchema = _zod.z.object({
+    id: _index.SpreadsheetIdSchema,
+    gid: _index.SheetGidSchema,
+    sourceUri: _zod.z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),
+    sourceHasHeaders: _zod.z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),
+    headerMap: _zod.z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),
+    deduplicateBy: _zod.z.array(_zod.z.union([
+        _zod.z.string(),
+        _zod.z.number().int().min(0)
+    ])).optional().describe('Sheet columns for deduplication (names or indices)')
+});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    id: _index.SpreadsheetIdOutput,
+    gid: _index.SheetGidOutput,
+    sheetTitle: _zod.z.string().describe('Sheet tab name'),
+    updatedRows: _zod.z.number().describe('Number of rows appended'),
+    rowsSkipped: _zod.z.number().optional().describe('Number of duplicate rows skipped'),
+    sheetUrl: _zod.z.string().optional().describe('URL to view the sheet')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */ var BATCH_SIZE = 1000;
+/**
+ * Resolve column reference to numeric index
+ * @param ref Column reference (string name or number index)
+ * @param headers Header row (null when sourceHasHeaders=false)
+ * @param sourceHasHeaders Whether headers are present
+ * @returns 0-based column index
+ */ function resolveColumnReference(ref, headers, sourceHasHeaders, context) {
+    // If number, use directly as 0-based index
+    if (typeof ref === 'number') {
+        if (ref < 0) {
+            throw new Error("".concat(context, ": Column index must be >= 0, got ").concat(ref));
+        }
+        return ref;
+    }
+    // If string, must be header name
+    if (!sourceHasHeaders || !headers) {
+        throw new Error("".concat(context, ': String column reference "').concat(ref, '" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.'));
+    }
+    var index = headers.indexOf(ref);
+    if (index === -1) {
+        throw new Error("".concat(context, ': Header "').concat(ref, '" not found in [').concat(headers.join(', '), "]"));
+    }
+    return index;
+}
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy, logger, _ref, _spreadsheetResponse_data_sheets, _sheet_properties, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, source, target, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, colRef, sheets, spreadsheetResponse, sheet, sheetTitle, sheetHeaders, existingKeySet, keyColumns, targetHeaderNames, headerResult, CHUNK_SIZE, startRow, hasMore, endRow, chunkRange, response, rows, _iteratorNormalCompletion2, _didIteratorError2, _iteratorError2, _iterator2, _step2, row, key, sourceHeaders, batch, totalRows, rowsSkipped, readStream, parser, appendBatch, resolvedMap, _iteratorAbruptCompletion, _didIteratorError3, _iteratorError3, _loop, _iterator3, _step3, err, updatedRows, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, gid = param.gid, sourceUri = param.sourceUri, sourceHasHeaders = param.sourceHasHeaders, headerMap = param.headerMap, deduplicateBy = param.deduplicateBy;
+                    logger = extra.logger;
+                    logger.info('sheets.rows.csv-append called', {
+                        id: id,
+                        gid: gid,
+                        sourceUri: sourceUri,
+                        sourceHasHeaders: sourceHasHeaders,
+                        headerMap: headerMap,
+                        deduplicateBy: deduplicateBy
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        25,
+                        ,
+                        26
+                    ]);
+                    if (headerMap.length === 0) {
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'headerMap cannot be empty');
+                    }
+                    // Validate: if sourceHasHeaders=false, all references must be numeric
+                    if (!sourceHasHeaders) {
+                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        try {
+                            for(_iterator = headerMap[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                _step_value = _step.value, source = _step_value.source, target = _step_value.target;
+                                if (typeof source === 'string') {
+                                    throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string source: "'.concat(source, '"'));
+                                }
+                                if (typeof target === 'string') {
+                                    throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string target: "'.concat(target, '"'));
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError = true;
+                            _iteratorError = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                        if (deduplicateBy) {
+                            _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                            try {
+                                for(_iterator1 = deduplicateBy[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                                    colRef = _step1.value;
+                                    if (typeof colRef === 'string') {
+                                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "'.concat(colRef, '"'));
+                                    }
+                                }
+                            } catch (err) {
+                                _didIteratorError1 = true;
+                                _iteratorError1 = err;
+                            } finally{
+                                try {
+                                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                        _iterator1.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError1) {
+                                        throw _iteratorError1;
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id,
+                            fields: 'sheets.properties.sheetId,sheets.properties.title'
+                        })
+                    ];
+                case 2:
+                    spreadsheetResponse = _state.sent();
+                    sheet = (_spreadsheetResponse_data_sheets = spreadsheetResponse.data.sheets) === null || _spreadsheetResponse_data_sheets === void 0 ? void 0 : _spreadsheetResponse_data_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) {
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Sheet not found');
+                    }
+                    sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
+                    // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)
+                    sheetHeaders = null;
+                    existingKeySet = new Set();
+                    keyColumns = deduplicateBy || [];
+                    if (!sourceHasHeaders) return [
+                        3,
+                        4
+                    ];
+                    // Extract target header names from headerMap
+                    targetHeaderNames = headerMap.map(function(param) {
+                        var target = param.target;
+                        return target;
+                    }).filter(function(t) {
+                        return typeof t === 'string';
+                    });
+                    return [
+                        4,
+                        (0, _sheetoperations.ensureTabAndHeaders)(sheets, {
+                            spreadsheetId: id,
+                            sheetTitle: sheetTitle,
+                            requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,
+                            keyColumns: keyColumns.filter(function(k) {
+                                return typeof k === 'string';
+                            }),
+                            logger: logger
+                        })
+                    ];
+                case 3:
+                    headerResult = _state.sent();
+                    sheetHeaders = headerResult.header;
+                    existingKeySet = headerResult.keySet;
+                    return [
+                        3,
+                        8
+                    ];
+                case 4:
+                    if (!(deduplicateBy && deduplicateBy.length > 0)) return [
+                        3,
+                        8
+                    ];
+                    // Read data in chunks for memory efficiency with large sheets
+                    CHUNK_SIZE = 1000;
+                    startRow = 1;
+                    hasMore = true;
+                    _state.label = 5;
+                case 5:
+                    if (!hasMore) return [
+                        3,
+                        7
+                    ];
+                    endRow = startRow + CHUNK_SIZE - 1;
+                    chunkRange = "".concat(sheetTitle, "!A").concat(startRow, ":ZZZ").concat(endRow);
+                    return [
+                        4,
+                        sheets.spreadsheets.values.get({
+                            spreadsheetId: id,
+                            range: chunkRange
+                        })
+                    ];
+                case 6:
+                    response = _state.sent();
+                    rows = response.data.values || [];
+                    _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+                    try {
+                        for(_iterator2 = rows[Symbol.iterator](); !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+                            row = _step2.value;
+                            key = (0, _deduplicationutils.buildDeduplicationKey)(row, keyColumns, null, false);
+                            if (key.replace(/::/g, '') !== '') {
+                                existingKeySet.add(key);
+                            }
+                        }
+                    } catch (err) {
+                        _didIteratorError2 = true;
+                        _iteratorError2 = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                                _iterator2.return();
+                            }
+                        } finally{
+                            if (_didIteratorError2) {
+                                throw _iteratorError2;
+                            }
+                        }
+                    }
+                    // Check if there are more rows to read
+                    if (rows.length < CHUNK_SIZE) {
+                        hasMore = false;
+                    } else {
+                        startRow += CHUNK_SIZE;
+                    }
+                    return [
+                        3,
+                        5
+                    ];
+                case 7:
+                    logger.info('sheets.rows.csv-append existing keys loaded', {
+                        keyCount: existingKeySet.size
+                    });
+                    _state.label = 8;
+                case 8:
+                    // Streaming CSV processing state
+                    sourceHeaders = null;
+                    batch = [];
+                    totalRows = 0;
+                    rowsSkipped = 0;
+                    return [
+                        4,
+                        (0, _csvstreaming.getCsvReadStream)(sourceUri)
+                    ];
+                case 9:
+                    readStream = _state.sent();
+                    // Create CSV parser
+                    parser = readStream.pipe((0, _csvparse.parse)({
+                        columns: !!sourceHasHeaders,
+                        skip_empty_lines: true,
+                        trim: true,
+                        cast: true,
+                        relax_column_count: true
+                    }));
+                    // Helper to append batch to Sheets
+                    appendBatch = function(rows) {
+                        return _async_to_generator(function() {
+                            return _ts_generator(this, function(_state) {
+                                switch(_state.label){
+                                    case 0:
+                                        if (rows.length === 0) return [
+                                            2
+                                        ];
+                                        return [
+                                            4,
+                                            sheets.spreadsheets.values.append({
+                                                spreadsheetId: id,
+                                                range: "".concat(sheetTitle, "!A:A"),
+                                                valueInputOption: 'USER_ENTERED',
+                                                requestBody: {
+                                                    values: rows,
+                                                    majorDimension: 'ROWS'
+                                                }
+                                            })
+                                        ];
+                                    case 1:
+                                        _state.sent();
+                                        logger.info('sheets.rows.csv-append batch appended', {
+                                            batchSize: rows.length,
+                                            totalRows: totalRows
+                                        });
+                                        return [
+                                            2
+                                        ];
+                                }
+                            });
+                        })();
+                    };
+                    // Resolve headerMap to numeric indices (do this after extracting CSV headers)
+                    resolvedMap = [];
+                    _iteratorAbruptCompletion = false, _didIteratorError3 = false;
+                    _state.label = 10;
+                case 10:
+                    _state.trys.push([
+                        10,
+                        16,
+                        17,
+                        22
+                    ]);
+                    _loop = function() {
+                        var _value, record, _Math, sourceRow, maxTargetIdx, sheetRow, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, sourceIdx, targetIdx, _sourceRow_sourceIdx, key, _Math1, sourceRow1, maxTargetIdx1, sheetRow1, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, _step_value1, sourceIdx1, targetIdx1, _sourceRow_sourceIdx1, key1;
+                        return _ts_generator(this, function(_state) {
+                            switch(_state.label){
+                                case 0:
+                                    _value = _step3.value;
+                                    record = _value;
+                                    if (sourceHasHeaders) {
+                                        ;
+                                        // Extract source headers from first record
+                                        if (sourceHeaders === null) {
+                                            sourceHeaders = Object.keys(record);
+                                            logger.info('sheets.rows.csv-append source headers', {
+                                                sourceHeaders: sourceHeaders
+                                            });
+                                            // Resolve headerMap now that we have both source and sheet headers
+                                            resolvedMap = headerMap.map(function(param) {
+                                                var source = param.source, target = param.target;
+                                                return {
+                                                    sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),
+                                                    targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target')
+                                                };
+                                            });
+                                        }
+                                        // Map source record to sheet row
+                                        sourceRow = sourceHeaders === null || sourceHeaders === void 0 ? void 0 : sourceHeaders.map(function(h) {
+                                            var _record_h;
+                                            return (_record_h = record[h]) !== null && _record_h !== void 0 ? _record_h : null;
+                                        });
+                                        maxTargetIdx = (_Math = Math).max.apply(_Math, _to_consumable_array(resolvedMap.map(function(m) {
+                                            return m.targetIdx;
+                                        })));
+                                        sheetRow = new Array(maxTargetIdx + 1).fill(null);
+                                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                        try {
+                                            for(_iterator = resolvedMap[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                                _step_value = _step.value, sourceIdx = _step_value.sourceIdx, targetIdx = _step_value.targetIdx;
+                                                if (sourceRow) {
+                                                    ;
+                                                    sheetRow[targetIdx] = (_sourceRow_sourceIdx = sourceRow[sourceIdx]) !== null && _sourceRow_sourceIdx !== void 0 ? _sourceRow_sourceIdx : null;
+                                                }
+                                            }
+                                        } catch (err) {
+                                            _didIteratorError = true;
+                                            _iteratorError = err;
+                                        } finally{
+                                            try {
+                                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                                    _iterator.return();
+                                                }
+                                            } finally{
+                                                if (_didIteratorError) {
+                                                    throw _iteratorError;
+                                                }
+                                            }
+                                        }
+                                        // Check deduplication
+                                        if (deduplicateBy && deduplicateBy.length > 0) {
+                                            key = (0, _deduplicationutils.buildDeduplicationKey)(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);
+                                            if (existingKeySet.has(key)) {
+                                                rowsSkipped++;
+                                                return [
+                                                    2,
+                                                    "continue" // Skip duplicate
+                                                ];
+                                            }
+                                            existingKeySet.add(key); // Add to set for future deduplication
+                                        }
+                                        // Add to batch
+                                        batch.push(sheetRow);
+                                        totalRows++;
+                                    } else {
+                                        ;
+                                        // sourceHasHeaders=false: record is an array (not an object)
+                                        // Resolve map on first row
+                                        if (resolvedMap.length === 0) {
+                                            resolvedMap = headerMap.map(function(param) {
+                                                var source = param.source, target = param.target;
+                                                return {
+                                                    sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),
+                                                    targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target')
+                                                };
+                                            });
+                                        }
+                                        sourceRow1 = record;
+                                        maxTargetIdx1 = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(resolvedMap.map(function(m) {
+                                            return m.targetIdx;
+                                        })));
+                                        sheetRow1 = new Array(maxTargetIdx1 + 1).fill(null);
+                                        _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                                        try {
+                                            for(_iterator1 = resolvedMap[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                                                _step_value1 = _step1.value, sourceIdx1 = _step_value1.sourceIdx, targetIdx1 = _step_value1.targetIdx;
+                                                if (sourceIdx1 < sourceRow1.length) {
+                                                    ;
+                                                    sheetRow1[targetIdx1] = (_sourceRow_sourceIdx1 = sourceRow1[sourceIdx1]) !== null && _sourceRow_sourceIdx1 !== void 0 ? _sourceRow_sourceIdx1 : null;
+                                                }
+                                            }
+                                        } catch (err) {
+                                            _didIteratorError1 = true;
+                                            _iteratorError1 = err;
+                                        } finally{
+                                            try {
+                                                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                                    _iterator1.return();
+                                                }
+                                            } finally{
+                                                if (_didIteratorError1) {
+                                                    throw _iteratorError1;
+                                                }
+                                            }
+                                        }
+                                        // Check deduplication
+                                        if (deduplicateBy && deduplicateBy.length > 0) {
+                                            key1 = (0, _deduplicationutils.buildDeduplicationKey)(sheetRow1, keyColumns, null, sourceHasHeaders);
+                                            if (existingKeySet.has(key1)) {
+                                                rowsSkipped++;
+                                                return [
+                                                    2,
+                                                    "continue" // Skip duplicate
+                                                ];
+                                            }
+                                            existingKeySet.add(key1);
+                                        }
+                                        // Add to batch
+                                        batch.push(sheetRow1);
+                                        totalRows++;
+                                    }
+                                    if (!(batch.length >= BATCH_SIZE)) return [
+                                        3,
+                                        2
+                                    ];
+                                    return [
+                                        4,
+                                        appendBatch(batch)
+                                    ];
+                                case 1:
+                                    _state.sent();
+                                    batch = []; // Clear batch
+                                    _state.label = 2;
+                                case 2:
+                                    return [
+                                        2
+                                    ];
+                            }
+                        });
+                    };
+                    _iterator3 = _async_iterator(parser);
+                    _state.label = 11;
+                case 11:
+                    return [
+                        4,
+                        _iterator3.next()
+                    ];
+                case 12:
+                    if (!(_iteratorAbruptCompletion = !(_step3 = _state.sent()).done)) return [
+                        3,
+                        15
+                    ];
+                    return [
+                        5,
+                        _ts_values(_loop())
+                    ];
+                case 13:
+                    _state.sent();
+                    _state.label = 14;
+                case 14:
+                    _iteratorAbruptCompletion = false;
+                    return [
+                        3,
+                        11
+                    ];
+                case 15:
+                    return [
+                        3,
+                        22
+                    ];
+                case 16:
+                    err = _state.sent();
+                    _didIteratorError3 = true;
+                    _iteratorError3 = err;
+                    return [
+                        3,
+                        22
+                    ];
+                case 17:
+                    _state.trys.push([
+                        17,
+                        ,
+                        20,
+                        21
+                    ]);
+                    if (!(_iteratorAbruptCompletion && _iterator3.return != null)) return [
+                        3,
+                        19
+                    ];
+                    return [
+                        4,
+                        _iterator3.return()
+                    ];
+                case 18:
+                    _state.sent();
+                    _state.label = 19;
+                case 19:
+                    return [
+                        3,
+                        21
+                    ];
+                case 20:
+                    if (_didIteratorError3) {
+                        throw _iteratorError3;
+                    }
+                    return [
+                        7
+                    ];
+                case 21:
+                    return [
+                        7
+                    ];
+                case 22:
+                    if (!(batch.length > 0)) return [
+                        3,
+                        24
+                    ];
+                    return [
+                        4,
+                        appendBatch(batch)
+                    ];
+                case 23:
+                    _state.sent();
+                    _state.label = 24;
+                case 24:
+                    logger.info('sheets.rows.csv-append streaming complete', {
+                        totalRows: totalRows,
+                        rowsSkipped: rowsSkipped
+                    });
+                    updatedRows = totalRows;
+                    logger.info('sheets.rows.csv-append completed', {
+                        id: id,
+                        gid: gid,
+                        updatedRows: updatedRows,
+                        rowsSkipped: rowsSkipped,
+                        sourceUri: sourceUri
+                    });
+                    result = {
+                        type: 'success',
+                        id: id,
+                        gid: gid,
+                        sheetTitle: sheetTitle,
+                        updatedRows: updatedRows,
+                        rowsSkipped: rowsSkipped,
+                        sheetUrl: "https://docs.google.com/spreadsheets/d/".concat(id, "/edit#gid=").concat(gid)
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 25:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('sheets.rows.csv-append error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error appending CSV rows: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 26:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'rows-csv-append',
+        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; }