@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/spreadsheet/sheet-operations.js

@@ -0,0 +1,811 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get ensureSheetIfNeeded () {
+        return ensureSheetIfNeeded;
+    },
+    get ensureTabAndHeaders () {
+        return ensureTabAndHeaders;
+    },
+    get findSheetByRef () {
+        return findSheetByRef;
+    }
+});
+var _columnutilities = require("./column-utilities.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 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 _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 ensureSheetIfNeeded(sheets, id, sheetTitle, ensureSheet, headers, logger) {
+    return _async_to_generator(function() {
+        var _res_data_replies__addSheet_properties, _res_data_replies__addSheet, _res_data_replies_, _res_data_replies, _res_data, ssResp, ss, has, _ss_sheets_find_properties, _ss_sheets_find, _ss_sheets, sid, result, _ref, merged, e, _logger_warn, res, createdId, result1, _ref1, merged1, e1, _logger_warn1;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    if (!sheetTitle) return [
+                        2,
+                        {
+                            sheetCreated: false
+                        }
+                    ];
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id
+                        })
+                    ];
+                case 1:
+                    ssResp = _state.sent();
+                    ss = ssResp.data;
+                    has = Array.isArray(ss === null || ss === void 0 ? void 0 : ss.sheets) && ss.sheets.some(function(s) {
+                        var _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
+                    });
+                    if (!has) return [
+                        3,
+                        6
+                    ];
+                    sid = (_ss_sheets = ss.sheets) === null || _ss_sheets === void 0 ? void 0 : (_ss_sheets_find = _ss_sheets.find(function(s) {
+                        var _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
+                    })) === null || _ss_sheets_find === void 0 ? void 0 : (_ss_sheets_find_properties = _ss_sheets_find.properties) === null || _ss_sheets_find_properties === void 0 ? void 0 : _ss_sheets_find_properties.sheetId;
+                    result = {
+                        sheetCreated: false
+                    };
+                    if (sid != null) result.sheetGUID = String(sid);
+                    if (!headers) return [
+                        3,
+                        5
+                    ];
+                    _state.label = 2;
+                case 2:
+                    _state.trys.push([
+                        2,
+                        4,
+                        ,
+                        5
+                    ]);
+                    return [
+                        4,
+                        ensureTabAndHeaders(sheets, {
+                            spreadsheetId: id,
+                            sheetTitle: sheetTitle,
+                            requiredHeader: headers,
+                            logger: logger
+                        })
+                    ];
+                case 3:
+                    _ref = _state.sent(), merged = _ref.header;
+                    if (merged) result.headersEnsured = true;
+                    return [
+                        3,
+                        5
+                    ];
+                case 4:
+                    e = _state.sent();
+                    (_logger_warn = logger.warn) === null || _logger_warn === void 0 ? void 0 : _logger_warn.call(logger, 'ensureTabAndHeaders after sheet creation failed', e);
+                    return [
+                        3,
+                        5
+                    ];
+                case 5:
+                    return [
+                        2,
+                        result
+                    ];
+                case 6:
+                    if (!ensureSheet) return [
+                        2,
+                        {
+                            sheetCreated: false
+                        }
+                    ];
+                    return [
+                        4,
+                        sheets.spreadsheets.batchUpdate({
+                            spreadsheetId: id,
+                            requestBody: {
+                                requests: [
+                                    {
+                                        addSheet: {
+                                            properties: {
+                                                title: sheetTitle
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        })
+                    ];
+                case 7:
+                    res = _state.sent();
+                    createdId = (_res_data = res.data) === null || _res_data === void 0 ? void 0 : (_res_data_replies = _res_data.replies) === null || _res_data_replies === void 0 ? void 0 : (_res_data_replies_ = _res_data_replies[0]) === null || _res_data_replies_ === void 0 ? void 0 : (_res_data_replies__addSheet = _res_data_replies_.addSheet) === null || _res_data_replies__addSheet === void 0 ? void 0 : (_res_data_replies__addSheet_properties = _res_data_replies__addSheet.properties) === null || _res_data_replies__addSheet_properties === void 0 ? void 0 : _res_data_replies__addSheet_properties.sheetId;
+                    result1 = {
+                        sheetCreated: !!createdId
+                    };
+                    if (createdId != null) result1.sheetGUID = String(createdId);
+                    if (!(createdId && headers)) return [
+                        3,
+                        11
+                    ];
+                    _state.label = 8;
+                case 8:
+                    _state.trys.push([
+                        8,
+                        10,
+                        ,
+                        11
+                    ]);
+                    return [
+                        4,
+                        ensureTabAndHeaders(sheets, {
+                            spreadsheetId: id,
+                            sheetTitle: sheetTitle,
+                            requiredHeader: headers,
+                            logger: logger
+                        })
+                    ];
+                case 9:
+                    _ref1 = _state.sent(), merged1 = _ref1.header;
+                    if (merged1) result1.headersEnsured = true;
+                    return [
+                        3,
+                        11
+                    ];
+                case 10:
+                    e1 = _state.sent();
+                    (_logger_warn1 = logger.warn) === null || _logger_warn1 === void 0 ? void 0 : _logger_warn1.call(logger, 'ensureTabAndHeaders after sheet creation failed', e1);
+                    return [
+                        3,
+                        11
+                    ];
+                case 11:
+                    return [
+                        2,
+                        result1
+                    ];
+            }
+        });
+    })();
+}
+function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
+    return _async_to_generator(function() {
+        var _ssResp_data, _logger_debug, _logger_warn, ssResp, sheets, trimmedRef, _logger_warn1, exactTitleMatch, _logger_debug1, exactGuidMatch, _logger_debug2, caseInsensitiveMatch, _logger_debug3, trimmedTitleMatch, _logger_debug4, caseInsensitiveTrimmedMatch, _logger_debug5, partialMatch, _logger_debug6;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    return [
+                        4,
+                        client.spreadsheets.get({
+                            spreadsheetId: spreadsheetId
+                        })
+                    ];
+                case 1:
+                    ssResp = _state.sent();
+                    sheets = ((_ssResp_data = ssResp.data) === null || _ssResp_data === void 0 ? void 0 : _ssResp_data.sheets) || [];
+                    trimmedRef = sheetRef === null || sheetRef === void 0 ? void 0 : sheetRef.trim();
+                    (_logger_debug = logger.debug) === null || _logger_debug === void 0 ? void 0 : _logger_debug.call(logger, 'findSheetByRef called', {
+                        spreadsheetId: spreadsheetId,
+                        sheetRef: sheetRef,
+                        trimmedRef: trimmedRef,
+                        availableSheets: sheets.map(function(s) {
+                            var _s_properties, _s_properties1;
+                            return {
+                                title: s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title,
+                                id: s === null || s === void 0 ? void 0 : (_s_properties1 = s.properties) === null || _s_properties1 === void 0 ? void 0 : _s_properties1.sheetId
+                            };
+                        })
+                    });
+                    if (!trimmedRef) {
+                        ;
+                        (_logger_warn1 = logger.warn) === null || _logger_warn1 === void 0 ? void 0 : _logger_warn1.call(logger, 'findSheetByRef empty sheetRef');
+                        return [
+                            2,
+                            null
+                        ];
+                    }
+                    // Strategy 1: Try exact title match first (most common case)
+                    exactTitleMatch = sheets.find(function(s) {
+                        var _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === trimmedRef;
+                    });
+                    if (exactTitleMatch) {
+                        ;
+                        (_logger_debug1 = logger.debug) === null || _logger_debug1 === void 0 ? void 0 : _logger_debug1.call(logger, 'findSheetByRef exact title match found');
+                        return [
+                            2,
+                            exactTitleMatch
+                        ];
+                    }
+                    // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)
+                    exactGuidMatch = sheets.find(function(s) {
+                        var _s_properties;
+                        return String(s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === trimmedRef;
+                    });
+                    if (exactGuidMatch) {
+                        ;
+                        (_logger_debug2 = logger.debug) === null || _logger_debug2 === void 0 ? void 0 : _logger_debug2.call(logger, 'findSheetByRef exact GUID match found');
+                        return [
+                            2,
+                            exactGuidMatch
+                        ];
+                    }
+                    // Strategy 3: Case-insensitive title match
+                    caseInsensitiveMatch = sheets.find(function(s) {
+                        var _s_properties_title, _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : (_s_properties_title = _s_properties.title) === null || _s_properties_title === void 0 ? void 0 : _s_properties_title.toLowerCase()) === trimmedRef.toLowerCase();
+                    });
+                    if (caseInsensitiveMatch) {
+                        ;
+                        (_logger_debug3 = logger.debug) === null || _logger_debug3 === void 0 ? void 0 : _logger_debug3.call(logger, 'findSheetByRef case-insensitive title match found');
+                        return [
+                            2,
+                            caseInsensitiveMatch
+                        ];
+                    }
+                    // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)
+                    trimmedTitleMatch = sheets.find(function(s) {
+                        var _s_properties_title, _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : (_s_properties_title = _s_properties.title) === null || _s_properties_title === void 0 ? void 0 : _s_properties_title.trim()) === trimmedRef;
+                    });
+                    if (trimmedTitleMatch) {
+                        ;
+                        (_logger_debug4 = logger.debug) === null || _logger_debug4 === void 0 ? void 0 : _logger_debug4.call(logger, 'findSheetByRef trimmed title match found');
+                        return [
+                            2,
+                            trimmedTitleMatch
+                        ];
+                    }
+                    // Strategy 5: Case-insensitive + trimmed title match
+                    caseInsensitiveTrimmedMatch = sheets.find(function(s) {
+                        var _s_properties_title, _s_properties;
+                        return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : (_s_properties_title = _s_properties.title) === null || _s_properties_title === void 0 ? void 0 : _s_properties_title.trim().toLowerCase()) === trimmedRef.toLowerCase();
+                    });
+                    if (caseInsensitiveTrimmedMatch) {
+                        ;
+                        (_logger_debug5 = logger.debug) === null || _logger_debug5 === void 0 ? void 0 : _logger_debug5.call(logger, 'findSheetByRef case-insensitive trimmed title match found');
+                        return [
+                            2,
+                            caseInsensitiveTrimmedMatch
+                        ];
+                    }
+                    // Strategy 6: Partial title match (last resort)
+                    partialMatch = sheets.find(function(s) {
+                        var _s_properties_title, _s_properties;
+                        return s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : (_s_properties_title = _s_properties.title) === null || _s_properties_title === void 0 ? void 0 : _s_properties_title.toLowerCase().includes(trimmedRef.toLowerCase());
+                    });
+                    if (partialMatch) {
+                        ;
+                        (_logger_debug6 = logger.debug) === null || _logger_debug6 === void 0 ? void 0 : _logger_debug6.call(logger, 'findSheetByRef partial title match found');
+                        return [
+                            2,
+                            partialMatch
+                        ];
+                    }
+                    (_logger_warn = logger.warn) === null || _logger_warn === void 0 ? void 0 : _logger_warn.call(logger, 'findSheetByRef no match found', {
+                        searchRef: trimmedRef,
+                        availableTitles: sheets.map(function(s) {
+                            var _s_properties;
+                            return s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title;
+                        }),
+                        availableIds: sheets.map(function(s) {
+                            var _s_properties;
+                            return s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId;
+                        })
+                    });
+                    return [
+                        2,
+                        null
+                    ];
+            }
+        });
+    })();
+}
+function ensureTabAndHeaders(_0, _1) {
+    return _async_to_generator(function(sheets, param) {
+        var spreadsheetId, sheetTitle, sheetRef, _param_requiredHeader, requiredHeader, _param_keyColumns, keyColumns, logger, _Math, _Math1, resolvedSheetTitle, sheet, _sheet_properties, defaultHeader, header, existingHeader, resp, vr, values, _err, unused, mergedHeader, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, col, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, name, keySet, chunkSize, startRow, normalizeKeyColumnsByName, keyColsIdx, validKeyIdxs, minIdx, maxIdx, startCol, endCol, endRow, range, respChunk, vrChunk, chunkRows, _iteratorNormalCompletion2, _didIteratorError2, _iteratorError2, _loop, _iterator2, _step2;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    spreadsheetId = param.spreadsheetId, sheetTitle = param.sheetTitle, sheetRef = param.sheetRef, _param_requiredHeader = param.requiredHeader, requiredHeader = _param_requiredHeader === void 0 ? null : _param_requiredHeader, _param_keyColumns = param.keyColumns, keyColumns = _param_keyColumns === void 0 ? [
+                        'id'
+                    ] : _param_keyColumns, logger = param.logger;
+                    if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');
+                    if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');
+                    if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');
+                    // Resolve the actual sheet title from sheetRef if provided
+                    resolvedSheetTitle = sheetTitle;
+                    if (!sheetRef) return [
+                        3,
+                        2
+                    ];
+                    return [
+                        4,
+                        findSheetByRef(sheets, spreadsheetId, sheetRef, logger)
+                    ];
+                case 1:
+                    sheet = _state.sent();
+                    if (sheet) {
+                        ;
+                        resolvedSheetTitle = ((_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) || sheetRef;
+                    } else {
+                        // Sheet doesn't exist, use the sheetRef as the title for creation
+                        resolvedSheetTitle = sheetRef;
+                    }
+                    _state.label = 2;
+                case 2:
+                    if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');
+                    defaultHeader = [
+                        'id',
+                        'provider',
+                        'threadId',
+                        'to',
+                        'from',
+                        'cc',
+                        'bcc',
+                        'date',
+                        'subject',
+                        'labels',
+                        'snippet',
+                        'body'
+                    ];
+                    header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
+                    existingHeader = null;
+                    _state.label = 3;
+                case 3:
+                    _state.trys.push([
+                        3,
+                        5,
+                        ,
+                        11
+                    ]);
+                    return [
+                        4,
+                        sheets.spreadsheets.values.get({
+                            spreadsheetId: spreadsheetId,
+                            range: "".concat(resolvedSheetTitle, "!1:1"),
+                            majorDimension: 'ROWS'
+                        })
+                    ];
+                case 4:
+                    resp = _state.sent();
+                    vr = resp.data;
+                    values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
+                    existingHeader = values.length ? values : null;
+                    return [
+                        3,
+                        11
+                    ];
+                case 5:
+                    _err = _state.sent();
+                    _state.label = 6;
+                case 6:
+                    _state.trys.push([
+                        6,
+                        8,
+                        ,
+                        9
+                    ]);
+                    return [
+                        4,
+                        sheets.spreadsheets.batchUpdate({
+                            spreadsheetId: spreadsheetId,
+                            requestBody: {
+                                requests: [
+                                    {
+                                        addSheet: {
+                                            properties: {
+                                                title: resolvedSheetTitle
+                                            }
+                                        }
+                                    }
+                                ]
+                            }
+                        })
+                    ];
+                case 7:
+                    _state.sent();
+                    return [
+                        3,
+                        9
+                    ];
+                case 8:
+                    unused = _state.sent();
+                    return [
+                        3,
+                        9
+                    ];
+                case 9:
+                    return [
+                        4,
+                        sheets.spreadsheets.values.append({
+                            spreadsheetId: spreadsheetId,
+                            range: "".concat(resolvedSheetTitle, "!A1"),
+                            valueInputOption: 'RAW',
+                            insertDataOption: 'INSERT_ROWS',
+                            requestBody: {
+                                values: [
+                                    header
+                                ]
+                            }
+                        })
+                    ];
+                case 10:
+                    _state.sent();
+                    return [
+                        2,
+                        {
+                            header: header,
+                            keySet: new Set()
+                        }
+                    ];
+                case 11:
+                    if (!!existingHeader) return [
+                        3,
+                        13
+                    ];
+                    return [
+                        4,
+                        sheets.spreadsheets.values.append({
+                            spreadsheetId: spreadsheetId,
+                            range: "".concat(resolvedSheetTitle, "!A1"),
+                            valueInputOption: 'RAW',
+                            insertDataOption: 'INSERT_ROWS',
+                            requestBody: {
+                                values: [
+                                    header
+                                ]
+                            }
+                        })
+                    ];
+                case 12:
+                    _state.sent();
+                    return [
+                        2,
+                        {
+                            header: header,
+                            keySet: new Set()
+                        }
+                    ];
+                case 13:
+                    mergedHeader = existingHeader.slice();
+                    _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        for(_iterator = header[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                            col = _step.value;
+                            if (!mergedHeader.includes(col)) mergedHeader.push(col);
+                        }
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                    if (Array.isArray(keyColumns)) {
+                        _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                        try {
+                            for(_iterator1 = keyColumns[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                                name = _step1.value;
+                                if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');
+                                if (!mergedHeader.includes(name)) mergedHeader.push(name);
+                            }
+                        } catch (err) {
+                            _didIteratorError1 = true;
+                            _iteratorError1 = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                    _iterator1.return();
+                                }
+                            } finally{
+                                if (_didIteratorError1) {
+                                    throw _iteratorError1;
+                                }
+                            }
+                        }
+                    }
+                    if (!(mergedHeader.length !== existingHeader.length)) return [
+                        3,
+                        15
+                    ];
+                    return [
+                        4,
+                        sheets.spreadsheets.values.update({
+                            spreadsheetId: spreadsheetId,
+                            range: "".concat(resolvedSheetTitle, "!1:1"),
+                            valueInputOption: 'RAW',
+                            requestBody: {
+                                values: [
+                                    mergedHeader
+                                ]
+                            }
+                        })
+                    ];
+                case 14:
+                    _state.sent();
+                    _state.label = 15;
+                case 15:
+                    keySet = new Set();
+                    chunkSize = 1000;
+                    startRow = 2;
+                    normalizeKeyColumnsByName = function(kc, hdr) {
+                        if (!Array.isArray(kc) || kc.length === 0) return [];
+                        return kc.map(function(name) {
+                            if (typeof name !== 'string' || name.length === 0) return -1;
+                            var idx = hdr.indexOf(name);
+                            return Number.isInteger(idx) && idx >= 0 ? idx : -1;
+                        });
+                    };
+                    keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);
+                    validKeyIdxs = keyColsIdx.filter(function(i) {
+                        return i >= 0;
+                    });
+                    if (validKeyIdxs.length === 0) return [
+                        2,
+                        {
+                            header: mergedHeader,
+                            keySet: new Set(),
+                            keyColumnsIdx: keyColsIdx
+                        }
+                    ];
+                    minIdx = (_Math = Math).min.apply(_Math, _to_consumable_array(validKeyIdxs));
+                    maxIdx = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(validKeyIdxs));
+                    startCol = (0, _columnutilities.a1Col)(minIdx + 1);
+                    endCol = (0, _columnutilities.a1Col)(maxIdx + 1);
+                    _state.label = 16;
+                case 16:
+                    if (!true) return [
+                        3,
+                        18
+                    ];
+                    endRow = startRow + chunkSize - 1;
+                    range = "".concat(resolvedSheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
+                    return [
+                        4,
+                        sheets.spreadsheets.values.get({
+                            spreadsheetId: spreadsheetId,
+                            range: range,
+                            majorDimension: 'ROWS'
+                        })
+                    ];
+                case 17:
+                    respChunk = _state.sent();
+                    vrChunk = respChunk.data;
+                    chunkRows = (vrChunk === null || vrChunk === void 0 ? void 0 : vrChunk.values) || [];
+                    if (!chunkRows || chunkRows.length === 0) return [
+                        3,
+                        18
+                    ];
+                    _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+                    try {
+                        _loop = function() {
+                            var r = _step2.value;
+                            var row = Array.isArray(r) ? r : [];
+                            // Use the same key generation logic as appendRows for consistency
+                            var lower = mergedHeader.map(function(h) {
+                                return String(h !== null && h !== void 0 ? h : '').toLowerCase();
+                            });
+                            var provHeaderIdx = lower.indexOf('provider');
+                            var idHeaderIdx = lower.indexOf('messageid');
+                            if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');
+                            var compositeKey = void 0;
+                            if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {
+                                var _row_providerOffset, _row_idOffset;
+                                // Special case: if both provider and id columns exist, use them
+                                var providerOffset = provHeaderIdx - minIdx;
+                                var idOffset = idHeaderIdx - minIdx;
+                                var providerVal = providerOffset >= 0 ? String((_row_providerOffset = row[providerOffset]) !== null && _row_providerOffset !== void 0 ? _row_providerOffset : '').trim() : '';
+                                var messageVal = idOffset >= 0 ? String((_row_idOffset = row[idOffset]) !== null && _row_idOffset !== void 0 ? _row_idOffset : '').trim() : '';
+                                compositeKey = [
+                                    providerVal,
+                                    messageVal
+                                ].join('\\');
+                            } else {
+                                // General case: use the specified key columns
+                                var comps = keyColsIdx.map(function(i) {
+                                    var _row_;
+                                    return i < 0 ? '' : String((_row_ = row[i - minIdx]) !== null && _row_ !== void 0 ? _row_ : '').trim();
+                                });
+                                compositeKey = comps.join('\\');
+                            }
+                            if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
+                        };
+                        for(_iterator2 = chunkRows[Symbol.iterator](); !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true)_loop();
+                    } catch (err) {
+                        _didIteratorError2 = true;
+                        _iteratorError2 = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                                _iterator2.return();
+                            }
+                        } finally{
+                            if (_didIteratorError2) {
+                                throw _iteratorError2;
+                            }
+                        }
+                    }
+                    startRow += chunkRows.length;
+                    return [
+                        3,
+                        16
+                    ];
+                case 18:
+                    return [
+                        2,
+                        {
+                            header: mergedHeader,
+                            keySet: keySet,
+                            keyColumnsIdx: keyColsIdx
+                        }
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+/* 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; }