@mcp-z/mcp-sheets 2.4.1 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +45 -29
  2. package/dist/cjs/constants.d.cts +2 -0
  3. package/dist/cjs/constants.d.ts +2 -0
  4. package/dist/cjs/constants.js +27 -3
  5. package/dist/cjs/constants.js.map +1 -1
  6. package/dist/cjs/mcp/tools/cells-copy.d.cts +165 -0
  7. package/dist/cjs/mcp/tools/cells-copy.d.ts +165 -0
  8. package/dist/cjs/mcp/tools/cells-copy.js +388 -0
  9. package/dist/cjs/mcp/tools/cells-copy.js.map +1 -0
  10. package/dist/cjs/mcp/tools/csv-get-columns.js +107 -29
  11. package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
  12. package/dist/cjs/mcp/tools/index.d.cts +1 -0
  13. package/dist/cjs/mcp/tools/index.d.ts +1 -0
  14. package/dist/cjs/mcp/tools/index.js +4 -0
  15. package/dist/cjs/mcp/tools/index.js.map +1 -1
  16. package/dist/cjs/schemas/index.d.cts +1 -0
  17. package/dist/cjs/schemas/index.d.ts +1 -0
  18. package/dist/cjs/schemas/index.js +16 -0
  19. package/dist/cjs/schemas/index.js.map +1 -1
  20. package/dist/cjs/setup/config.js +26 -14
  21. package/dist/cjs/setup/config.js.map +1 -1
  22. package/dist/cjs/setup/version-help.js +1 -1
  23. package/dist/cjs/setup/version-help.js.map +1 -1
  24. package/dist/cjs/spreadsheet/data-operations.js +59 -164
  25. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  26. package/dist/cjs/spreadsheet/range-operations.d.cts +26 -0
  27. package/dist/cjs/spreadsheet/range-operations.d.ts +26 -0
  28. package/dist/cjs/spreadsheet/range-operations.js +48 -0
  29. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  30. package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
  31. package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
  32. package/dist/cjs/spreadsheet/sheet-operations.js +92 -52
  33. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  34. package/dist/esm/constants.d.ts +2 -0
  35. package/dist/esm/constants.js +14 -0
  36. package/dist/esm/constants.js.map +1 -1
  37. package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
  38. package/dist/esm/mcp/tools/cells-copy.js +190 -0
  39. package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
  40. package/dist/esm/mcp/tools/csv-get-columns.js +44 -6
  41. package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
  42. package/dist/esm/mcp/tools/index.d.ts +1 -0
  43. package/dist/esm/mcp/tools/index.js +1 -0
  44. package/dist/esm/mcp/tools/index.js.map +1 -1
  45. package/dist/esm/schemas/index.d.ts +1 -0
  46. package/dist/esm/schemas/index.js +9 -0
  47. package/dist/esm/schemas/index.js.map +1 -1
  48. package/dist/esm/setup/config.js +26 -14
  49. package/dist/esm/setup/config.js.map +1 -1
  50. package/dist/esm/setup/version-help.js +7 -0
  51. package/dist/esm/setup/version-help.js.map +1 -1
  52. package/dist/esm/spreadsheet/data-operations.js +40 -84
  53. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  54. package/dist/esm/spreadsheet/range-operations.d.ts +26 -0
  55. package/dist/esm/spreadsheet/range-operations.js +50 -0
  56. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  57. package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
  58. package/dist/esm/spreadsheet/sheet-operations.js +69 -43
  59. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  60. package/package.json +3 -3
@@ -743,9 +743,41 @@ function mapRowsToHeader(param) {
743
743
  return mappedRow;
744
744
  });
745
745
  }
746
+ /** Calls onKey with each non-empty generated key of the data rows and its 1-indexed row number; see scanKeyColumnRows for the bounded, error-reporting scan. */ function scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, onKey) {
747
+ return _async_to_generator(function() {
748
+ var _Math, _Math1, minIndex, maxIndex;
749
+ return _ts_generator(this, function(_state) {
750
+ switch(_state.label){
751
+ case 0:
752
+ minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
753
+ maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
754
+ return [
755
+ 4,
756
+ (0, _sheetoperationsts.scanKeyColumnRows)(sheets, spreadsheetId, sheetTitle, (0, _columnutilitiests.a1Col)(minIndex + 1), (0, _columnutilitiests.a1Col)(maxIndex + 1), function(rawRow, rowNumber) {
757
+ // Reconstruct full row for key generation
758
+ var fullRow = new Array(header.length).fill('');
759
+ keyIndices.forEach(function(globalIndex) {
760
+ var localRowArrayIndex = globalIndex - minIndex;
761
+ if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {
762
+ fullRow[globalIndex] = rawRow[localRowArrayIndex];
763
+ }
764
+ });
765
+ var key = generateRowKey(fullRow, header, strategy);
766
+ if (key.replace(/\\+/g, '') !== '') onKey(key, rowNumber);
767
+ })
768
+ ];
769
+ case 1:
770
+ _state.sent();
771
+ return [
772
+ 2
773
+ ];
774
+ }
775
+ });
776
+ })();
777
+ }
746
778
  function snapshotHeaderAndKeys(_0, _1, _2, _3) {
747
779
  return _async_to_generator(function(sheets, spreadsheetId, sheetTitle) {
748
- var keyColumns, keyStrategy, _Math, _Math1, _ref, _ref1, header, keySet, strategy, keyIndices, chunkSize, startRow, minIndex, maxIndex, startCol, endCol, endRow, range, _response_data, response, rows, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _loop, _iterator, _step, unused;
780
+ var keyColumns, keyStrategy, _ref, _ref1, header, keySet, strategy, keyIndices;
749
781
  var _arguments = arguments;
750
782
  return _ts_generator(this, function(_state) {
751
783
  switch(_state.label){
@@ -799,97 +831,14 @@ function snapshotHeaderAndKeys(_0, _1, _2, _3) {
799
831
  }
800
832
  ];
801
833
  }
802
- // Read key columns data in chunks
803
- chunkSize = 1000;
804
- startRow = 2;
805
- minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
806
- maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
807
- startCol = (0, _columnutilitiests.a1Col)(minIndex + 1);
808
- endCol = (0, _columnutilitiests.a1Col)(maxIndex + 1);
809
- _state.label = 2;
810
- case 2:
811
- if (!true) return [
812
- 3,
813
- 7
814
- ];
815
- endRow = startRow + chunkSize - 1;
816
- range = "".concat(sheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
817
- _state.label = 3;
818
- case 3:
819
- _state.trys.push([
820
- 3,
821
- 5,
822
- ,
823
- 6
824
- ]);
825
834
  return [
826
835
  4,
827
- sheets.spreadsheets.values.get({
828
- spreadsheetId: spreadsheetId,
829
- range: range,
830
- majorDimension: 'ROWS'
836
+ scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, function(key) {
837
+ keySet.add(key);
831
838
  })
832
839
  ];
833
- case 4:
834
- response = _state.sent();
835
- rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
836
- if (rows.length === 0) return [
837
- 3,
838
- 7
839
- ];
840
- _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
841
- try {
842
- _loop = function() {
843
- var rawRow = _step.value;
844
- // Reconstruct full row for key generation
845
- var fullRow = new Array(header.length).fill('');
846
- keyIndices.forEach(function(globalIndex, _localIndex) {
847
- var localRowIndex = globalIndex - minIndex;
848
- if (localRowIndex >= 0 && localRowIndex < rawRow.length) {
849
- fullRow[globalIndex] = rawRow[localRowIndex];
850
- }
851
- });
852
- var key = generateRowKey(fullRow, header, strategy);
853
- if (key.replace(/\\+/g, '') !== '') {
854
- keySet.add(key);
855
- }
856
- };
857
- for(_iterator = rows[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
858
- } catch (err) {
859
- _didIteratorError = true;
860
- _iteratorError = err;
861
- } finally{
862
- try {
863
- if (!_iteratorNormalCompletion && _iterator.return != null) {
864
- _iterator.return();
865
- }
866
- } finally{
867
- if (_didIteratorError) {
868
- throw _iteratorError;
869
- }
870
- }
871
- }
872
- startRow += rows.length;
873
- if (rows.length < chunkSize) return [
874
- 3,
875
- 7
876
- ]; // Last chunk
877
- return [
878
- 3,
879
- 6
880
- ];
881
- case 5:
882
- unused = _state.sent();
883
- return [
884
- 3,
885
- 7
886
- ]; // End of data or error
887
- case 6:
888
- return [
889
- 3,
890
- 2
891
- ];
892
- case 7:
840
+ case 2:
841
+ _state.sent();
893
842
  return [
894
843
  2,
895
844
  {
@@ -902,9 +851,17 @@ function snapshotHeaderAndKeys(_0, _1, _2, _3) {
902
851
  });
903
852
  }).apply(this, arguments);
904
853
  }
854
+ /** Message naming every duplicate key and its 1-indexed row numbers */ function formatDuplicateSheetKeys(keyToRows) {
855
+ var parts = [];
856
+ keyToRows.forEach(function(rows, key) {
857
+ if (rows.length > 1) parts.push('"'.concat(key, '" (rows ').concat(rows.join(', '), ")"));
858
+ });
859
+ if (parts.length === 0) return undefined;
860
+ return "duplicate keys found on the sheet: ".concat(parts.join('; '), ". Nothing was written; make each key unique and retry.");
861
+ }
905
862
  function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
906
863
  return _async_to_generator(function(sheets, spreadsheetId, sheetTitle) {
907
- var keyColumns, keyStrategy, _Math, _Math1, _ref, _ref1, header, keySet, keyToRowMap, strategy, keyIndices, chunkSize, startRow, minIndex, maxIndex, startCol, endCol, endRow, range, _loop, _response_data, response, rows, localRowIndex, unused;
864
+ var keyColumns, keyStrategy, _ref, _ref1, header, keySet, keyToRowMap, keyToRows, strategy, keyIndices, duplicateMessage;
908
865
  var _arguments = arguments;
909
866
  return _ts_generator(this, function(_state) {
910
867
  switch(_state.label){
@@ -920,6 +877,7 @@ function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
920
877
  header = _state.sent();
921
878
  keySet = new Set();
922
879
  keyToRowMap = new Map();
880
+ keyToRows = new Map();
923
881
  if (header.length === 0) {
924
882
  return [
925
883
  2,
@@ -961,85 +919,22 @@ function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
961
919
  }
962
920
  ];
963
921
  }
964
- // Read key columns data in chunks and track row positions
965
- chunkSize = 1000;
966
- startRow = 2; // Start from row 2 (after header)
967
- minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
968
- maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
969
- startCol = (0, _columnutilitiests.a1Col)(minIndex + 1);
970
- endCol = (0, _columnutilitiests.a1Col)(maxIndex + 1);
971
- _state.label = 2;
972
- case 2:
973
- if (!true) return [
974
- 3,
975
- 7
976
- ];
977
- endRow = startRow + chunkSize - 1;
978
- range = "".concat(sheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
979
- _state.label = 3;
980
- case 3:
981
- _state.trys.push([
982
- 3,
983
- 5,
984
- ,
985
- 6
986
- ]);
987
- _loop = function(localRowIndex) {
988
- var rawRow = rows[localRowIndex];
989
- var globalRowNumber = startRow + localRowIndex;
990
- // Reconstruct full row for key generation
991
- var fullRow = new Array(header.length).fill('');
992
- if (rawRow) {
993
- keyIndices.forEach(function(globalIndex, _localIndex) {
994
- var localRowArrayIndex = globalIndex - minIndex;
995
- if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {
996
- fullRow[globalIndex] = rawRow[localRowArrayIndex];
997
- }
998
- });
999
- }
1000
- var key = generateRowKey(fullRow, header, strategy);
1001
- if (key.replace(/\\+/g, '') !== '') {
1002
- keySet.add(key);
1003
- keyToRowMap.set(key, globalRowNumber); // Store 1-indexed row number
1004
- }
1005
- };
1006
922
  return [
1007
923
  4,
1008
- sheets.spreadsheets.values.get({
1009
- spreadsheetId: spreadsheetId,
1010
- range: range,
1011
- majorDimension: 'ROWS'
924
+ scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, function(key, rowNumber) {
925
+ keySet.add(key);
926
+ keyToRowMap.set(key, rowNumber); // Store 1-indexed row number
927
+ var seenRows = keyToRows.get(key);
928
+ if (seenRows) seenRows.push(rowNumber);
929
+ else keyToRows.set(key, [
930
+ rowNumber
931
+ ]);
1012
932
  })
1013
933
  ];
1014
- case 4:
1015
- response = _state.sent();
1016
- rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
1017
- if (rows.length === 0) return [
1018
- 3,
1019
- 7
1020
- ];
1021
- for(localRowIndex = 0; localRowIndex < rows.length; localRowIndex++)_loop(localRowIndex);
1022
- startRow += rows.length;
1023
- if (rows.length < chunkSize) return [
1024
- 3,
1025
- 7
1026
- ]; // Last chunk
1027
- return [
1028
- 3,
1029
- 6
1030
- ];
1031
- case 5:
1032
- unused = _state.sent();
1033
- return [
1034
- 3,
1035
- 7
1036
- ]; // End of data or error
1037
- case 6:
1038
- return [
1039
- 3,
1040
- 2
1041
- ];
1042
- case 7:
934
+ case 2:
935
+ _state.sent();
936
+ duplicateMessage = formatDuplicateSheetKeys(keyToRows);
937
+ if (duplicateMessage) throw new Error(duplicateMessage);
1043
938
  return [
1044
939
  2,
1045
940
  {
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/data-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\nimport { findSheetByRef } from './sheet-operations.ts';\n\n// Core data types\nexport type Cell = string | number | boolean | null | undefined;\nexport type Row = Cell[];\n\n// Enhanced type definitions for shared data operations\nexport interface ColumnMapping {\n canonical: string;\n sheet: string;\n index: number;\n}\n\nexport interface HeaderValidationResult {\n valid: boolean;\n missingColumns: string[];\n extraColumns: string[];\n mappings: ColumnMapping[];\n}\n\nexport interface KeyGenerationStrategy {\n keyColumns: string[];\n useProviderIdLogic: boolean;\n separator?: string;\n}\n\nexport interface DataPartition {\n toAppend: Row[];\n toUpdate: Array<{ row: Row; existingRowIndex: number }>;\n skippedKeys: string[];\n}\n\nexport interface BatchOperationResult {\n updatedRows: number;\n inserted: string[];\n rowsSkipped: number;\n errors?: string[];\n}\n\nexport interface UpsertOptions {\n keyStrategy: KeyGenerationStrategy;\n allowUpdates: boolean;\n batchSize?: number;\n valueInputOption?: 'RAW' | 'USER_ENTERED';\n}\n\nexport async function discoverHeader(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string): Promise<string[]> {\n try {\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId,\n range: `${sheetTitle}!1:1`,\n majorDimension: 'ROWS',\n });\n return ((response.data?.values || [])[0] || []) as string[];\n } catch {\n return [];\n }\n}\n\nexport function validateAndMapHeaders(sheetHeaders: string[], canonicalHeaders: string[], requiredColumns: string[] = []): HeaderValidationResult {\n const normalizeColumn = (col: string) =>\n String(col ?? '')\n .toLowerCase()\n .replace(/[^a-z0-9]/g, '');\n\n const sheetNormalized = sheetHeaders.map(normalizeColumn);\n const canonicalNormalized = canonicalHeaders.map(normalizeColumn);\n const requiredNormalized = requiredColumns.map(normalizeColumn);\n\n const mappings: ColumnMapping[] = [];\n const missingColumns: string[] = [];\n const extraColumns: string[] = [...sheetHeaders];\n\n // Create mappings for canonical columns\n canonicalHeaders.forEach((canonical, canonicalIndex) => {\n const canonicalNorm = canonicalNormalized[canonicalIndex];\n if (!canonicalNorm) return; // Skip if normalization resulted in empty string\n\n let sheetIndex = sheetNormalized.indexOf(canonicalNorm);\n\n // Special handling for 'id' -> 'messageid' mapping\n if (sheetIndex === -1 && canonicalNorm === 'id') {\n sheetIndex = sheetNormalized.indexOf('messageid');\n }\n\n if (sheetIndex !== -1) {\n const sheetHeader = sheetHeaders[sheetIndex];\n if (sheetHeader !== undefined) {\n mappings.push({\n canonical,\n sheet: sheetHeader,\n index: sheetIndex,\n });\n // Remove from extra columns\n const extraIndex = extraColumns.indexOf(sheetHeader);\n if (extraIndex !== -1) {\n extraColumns.splice(extraIndex, 1);\n }\n }\n } else if (requiredNormalized.includes(canonicalNorm)) {\n missingColumns.push(canonical);\n }\n });\n\n return {\n valid: missingColumns.length === 0,\n missingColumns,\n extraColumns,\n mappings,\n };\n}\n\n/** Ensures consistent key generation across all functions */\nexport function generateRowKey(row: Row, header: string[], strategy: KeyGenerationStrategy): string {\n const { keyColumns, useProviderIdLogic, separator = '\\\\' } = strategy;\n\n // Normalize header for consistent lookups\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n\n if (useProviderIdLogic) {\n const providerIndex = lowerHeader.indexOf('provider');\n let idIndex = lowerHeader.indexOf('messageid');\n if (idIndex === -1) idIndex = lowerHeader.indexOf('id');\n\n if (providerIndex >= 0 && idIndex >= 0) {\n const providerVal = String(row[providerIndex] ?? '').trim();\n const idVal = String(row[idIndex] ?? '').trim();\n if (providerVal || idVal) {\n // Only return key if at least one component exists\n return [providerVal, idVal].join(separator);\n }\n }\n }\n\n // Standard key generation using specified columns\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n let index = lowerHeader.indexOf(normalizedName);\n // Consistent fallback: id -> messageid\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return ''; // Return empty string for invalid key configurations\n }\n\n const components = keyIndices.map((index) => String(row[index] ?? '').trim());\n // Only return key if all components are non-empty\n if (components.every((comp) => comp.length > 0)) {\n return components.join(separator);\n }\n\n return '';\n}\n\nexport function validateRowKeys(rows: Row[], header: string[], strategy: KeyGenerationStrategy): { valid: boolean; duplicateKeys: string[]; keyMap: Map<string, number[]> } {\n const keyMap = new Map<string, number[]>();\n const duplicateKeys: string[] = [];\n\n rows.forEach((row, index) => {\n const key = generateRowKey(row, header, strategy);\n if (key.replace(/\\\\+/g, '') === '') return; // Skip empty keys\n\n if (!keyMap.has(key)) {\n keyMap.set(key, []);\n }\n keyMap.get(key)?.push(index);\n });\n\n // Find duplicates\n keyMap.forEach((indices, key) => {\n if (indices.length > 1) {\n duplicateKeys.push(key);\n }\n });\n\n return {\n valid: duplicateKeys.length === 0,\n duplicateKeys,\n keyMap,\n };\n}\n\n// Overloaded function signatures for appendRows\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n rows = [],\n keySet = null as Set<string> | null,\n keyColumns = ['id'] as string[],\n header = [] as string[],\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n rows?: unknown[];\n keySet?: Set<string> | null;\n keyColumns?: string[];\n header?: string[];\n logger: Logger;\n }\n) {\n if (!sheets) throw new Error('appendRows: sheets is required');\n if (!spreadsheetId) throw new Error('appendRows: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('appendRows: either sheetTitle or sheetRef is required');\n\n // Resolve the actual sheet title from sheetRef if provided\n let resolvedSheetTitle = sheetTitle;\n if (sheetRef) {\n const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n if (sheet) {\n resolvedSheetTitle = sheet.properties?.title || sheetRef;\n } else {\n // Sheet doesn't exist, use the sheetRef as the title\n resolvedSheetTitle = sheetRef;\n }\n }\n\n if (!resolvedSheetTitle) throw new Error('appendRows: could not resolve sheet title');\n if (!Array.isArray(rows) || rows.length === 0) return { updatedRows: 0, inserted: [] as string[] };\n\n if (!Array.isArray(header) || header.length === 0) {\n const respHeader = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n const vr = respHeader.data as sheets_v4.Schema$ValueRange;\n header = ((vr?.values || [])[0] || []) as string[];\n }\n\n const resolveKeyIndices = (kc: string[], hdr: string[]) => {\n if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n for (const c of kc) {\n if (typeof c !== 'string' || c.length === 0) throw new Error('appendRows: keyColumns must be an array of non-empty strings');\n }\n if (!Array.isArray(hdr) || hdr.length === 0) {\n throw new Error('appendRows: header array is required when keyColumns are header names');\n }\n return kc.map((name) => {\n const idx = hdr.indexOf(name);\n if (idx === -1) throw new Error(`appendRows: header name \"${name}\" not found in header`);\n return idx;\n });\n };\n\n const keyColsIdx = resolveKeyIndices(keyColumns, header);\n\n // Internal batch size to avoid Google Sheets limits\n const batchSize = 50;\n\n if (!keyColsIdx || keyColsIdx.length === 0) {\n let totalUpdated = 0;\n for (let i = 0; i < rows.length; i += batchSize) {\n const batch = rows.slice(i, i + batchSize);\n const resp = await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: batch as unknown[][] } });\n const app = resp.data as sheets_v4.Schema$AppendValuesResponse;\n const updatedRows = Number(app?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n }\n return { updatedRows: totalUpdated, inserted: [] as string[], rowsSkipped: 0 };\n }\n\n const toKey = (r: unknown[]) => {\n const row = r as (string | number | boolean | null | undefined)[];\n\n // Use consistent key generation strategy\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: true,\n separator: '\\\\',\n };\n\n return generateRowKey(row, header, strategy);\n };\n\n const rowsToInsert: unknown[][] = [];\n const insertedKeys: string[] = [];\n for (const r of rows as unknown[][]) {\n const key = toKey(r as unknown[]);\n if (keySet && keySet.has(key)) continue;\n rowsToInsert.push(r as unknown[]);\n insertedKeys.push(key);\n }\n\n if (rowsToInsert.length === 0) {\n const rowsSkipped = rows.length - rowsToInsert.length; // Should be rows.length when all are skipped\n return { updatedRows: 0, inserted: [] as string[], rowsSkipped };\n }\n\n // Use smaller internal batch size to avoid Google Sheets character limit errors\n // Especially important when dealing with emails that may have long bodies\n const INTERNAL_BATCH_SIZE = 50;\n\n let totalUpdated = 0;\n for (let i = 0; i < rowsToInsert.length; i += INTERNAL_BATCH_SIZE) {\n const batch = rowsToInsert.slice(i, i + INTERNAL_BATCH_SIZE);\n try {\n const resp = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: 'RAW',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: batch as unknown[][] },\n });\n const app2 = resp.data as sheets_v4.Schema$AppendValuesResponse;\n const updatedRows = Number(app2?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n } catch (error) {\n // If a batch fails, try with smaller batches to handle partial success\n if (batch.length > 1) {\n for (const singleRow of batch) {\n try {\n const singleResp = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: 'RAW',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: [singleRow as unknown[]] },\n });\n const singleApp = singleResp.data as sheets_v4.Schema$AppendValuesResponse;\n const singleUpdatedRows = Number(singleApp?.updates?.updatedRows || 1);\n totalUpdated += singleUpdatedRows;\n } catch (singleError) {\n // Skip problematic individual rows but continue processing\n logger.warn?.(`Failed to insert single row: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n }\n }\n } else {\n // Single row batch failed, skip it\n logger.warn?.(`Failed to insert batch: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n }\n const rowsSkipped = rows.length - rowsToInsert.length;\n return { updatedRows: totalUpdated, inserted: insertedKeys, rowsSkipped };\n}\n\nexport function mapRowsToHeader({ rows = [], header = [], canonical = [] as string[] }: { rows?: Row[]; header?: string[]; canonical?: string[] }): Row[] {\n if (!Array.isArray(rows) || rows.length === 0) return [];\n if (!Array.isArray(header) || header.length === 0) return rows;\n if (!Array.isArray(canonical) || canonical.length === 0) return rows;\n\n const validation = validateAndMapHeaders(header, canonical);\n const mappingLookup = new Map(validation.mappings.map((m) => [m.canonical, m.index]));\n\n return rows.map((row: Row) => {\n // Fill with null to skip unmapped columns (preserve existing values)\n // Use '' (empty string) only when explicitly wanting to clear a cell\n const mappedRow: Row = new Array(header.length).fill(null);\n\n canonical.forEach((canonicalCol, canonicalIndex) => {\n const sheetIndex = mappingLookup.get(canonicalCol);\n if (sheetIndex !== undefined && canonicalIndex < row.length) {\n // Preserve null values - they signal \"skip this cell\"\n mappedRow[sheetIndex] = row[canonicalIndex];\n }\n });\n\n return mappedRow;\n });\n}\n\nexport async function snapshotHeaderAndKeys(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyIndices: number[] }> {\n const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n const keySet = new Set<string>();\n\n if (header.length === 0) {\n return { header, keySet, keyIndices: [] };\n }\n\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n separator: keyStrategy?.separator ?? '\\\\',\n };\n\n // Find key column indices\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n let index = lowerHeader.indexOf(normalizedName);\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return { header, keySet, keyIndices };\n }\n\n // Read key columns data in chunks\n const chunkSize = 1000;\n let startRow = 2;\n const minIndex = Math.min(...keyIndices);\n const maxIndex = Math.max(...keyIndices);\n const startCol = a1Col(minIndex + 1);\n const endCol = a1Col(maxIndex + 1);\n\n while (true) {\n const endRow = startRow + chunkSize - 1;\n const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n try {\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId,\n range,\n majorDimension: 'ROWS',\n });\n\n const rows = (response.data?.values || []) as string[][];\n if (rows.length === 0) break;\n\n for (const rawRow of rows) {\n // Reconstruct full row for key generation\n const fullRow: Row = new Array(header.length).fill('');\n keyIndices.forEach((globalIndex, _localIndex) => {\n const localRowIndex = globalIndex - minIndex;\n if (localRowIndex >= 0 && localRowIndex < rawRow.length) {\n fullRow[globalIndex] = rawRow[localRowIndex];\n }\n });\n\n const key = generateRowKey(fullRow, header, strategy);\n if (key.replace(/\\\\+/g, '') !== '') {\n keySet.add(key);\n }\n }\n\n startRow += rows.length;\n if (rows.length < chunkSize) break; // Last chunk\n } catch {\n break; // End of data or error\n }\n }\n\n return { header, keySet, keyIndices };\n}\n\n/** Tracks row positions for updates in addition to keys */\nexport async function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyToRowMap: Map<string, number>; keyIndices: number[] }> {\n const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n const keySet = new Set<string>();\n const keyToRowMap = new Map<string, number>();\n\n if (header.length === 0) {\n return { header, keySet, keyToRowMap, keyIndices: [] };\n }\n\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n separator: keyStrategy?.separator ?? '\\\\',\n };\n\n // Find key column indices\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n let index = lowerHeader.indexOf(normalizedName);\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return { header, keySet, keyToRowMap, keyIndices };\n }\n\n // Read key columns data in chunks and track row positions\n const chunkSize = 1000;\n let startRow = 2; // Start from row 2 (after header)\n const minIndex = Math.min(...keyIndices);\n const maxIndex = Math.max(...keyIndices);\n const startCol = a1Col(minIndex + 1);\n const endCol = a1Col(maxIndex + 1);\n\n while (true) {\n const endRow = startRow + chunkSize - 1;\n const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n try {\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId,\n range,\n majorDimension: 'ROWS',\n });\n\n const rows = (response.data?.values || []) as string[][];\n if (rows.length === 0) break;\n\n for (let localRowIndex = 0; localRowIndex < rows.length; localRowIndex++) {\n const rawRow = rows[localRowIndex];\n const globalRowNumber = startRow + localRowIndex;\n\n // Reconstruct full row for key generation\n const fullRow: Row = new Array(header.length).fill('');\n if (rawRow) {\n keyIndices.forEach((globalIndex, _localIndex) => {\n const localRowArrayIndex = globalIndex - minIndex;\n if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {\n fullRow[globalIndex] = rawRow[localRowArrayIndex];\n }\n });\n }\n\n const key = generateRowKey(fullRow, header, strategy);\n if (key.replace(/\\\\+/g, '') !== '') {\n keySet.add(key);\n keyToRowMap.set(key, globalRowNumber); // Store 1-indexed row number\n }\n }\n\n startRow += rows.length;\n if (rows.length < chunkSize) break; // Last chunk\n } catch {\n break; // End of data or error\n }\n }\n\n return { header, keySet, keyToRowMap, keyIndices };\n}\n\n/**\n * Partitions data into updates vs appends based on existing keys with row position tracking\n */\nexport function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates = false, keyToRowMap?: Map<string, number>): DataPartition {\n const toAppend: Row[] = [];\n const toUpdate: Array<{ row: Row; existingRowIndex: number }> = [];\n const skippedKeys: string[] = [];\n\n rows.forEach((row) => {\n const key = generateRowKey(row, header, keyStrategy);\n if (key.replace(/\\\\+/g, '') === '') {\n // Skip rows with empty keys\n return;\n }\n\n if (existingKeys.has(key)) {\n if (allowUpdates && keyToRowMap) {\n const existingRowIndex = keyToRowMap.get(key);\n if (existingRowIndex !== undefined) {\n toUpdate.push({ row, existingRowIndex });\n } else {\n skippedKeys.push(key);\n }\n } else {\n skippedKeys.push(key);\n }\n } else {\n toAppend.push(row);\n }\n });\n\n return {\n toAppend,\n toUpdate,\n skippedKeys,\n };\n}\n\n/**\n * Performs batch updates on existing rows using batchUpdate API\n */\nexport async function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{ row: Row; existingRowIndex: number }>, header: string[], batchSize: number, valueInputOption: 'RAW' | 'USER_ENTERED'): Promise<{ updatedRows: number; errors?: string[] }> {\n const errors: string[] = [];\n let totalUpdated = 0;\n\n // Process updates in batches\n for (let i = 0; i < updates.length; i += batchSize) {\n const batch = updates.slice(i, i + batchSize);\n\n try {\n const requests: sheets_v4.Schema$Request[] = [];\n\n for (const { row, existingRowIndex } of batch) {\n requests.push({\n updateCells: {\n range: {\n sheetId: 0, // Will be resolved by sheet title in the range\n startRowIndex: existingRowIndex - 1, // Convert to 0-indexed\n endRowIndex: existingRowIndex, // Exclusive\n startColumnIndex: 0,\n endColumnIndex: header.length,\n },\n rows: [\n {\n values: row.map((cellValue) => ({\n userEnteredValue: {\n stringValue: String(cellValue ?? ''),\n },\n })),\n },\n ],\n fields: 'userEnteredValue',\n },\n });\n }\n\n if (requests.length > 0) {\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId,\n requestBody: {\n requests,\n },\n });\n\n totalUpdated += batch.length;\n }\n } catch (error) {\n const errorMsg = `Batch update ${Math.floor(i / batchSize) + 1} failed: ${error instanceof Error ? error.message : String(error)}`;\n errors.push(errorMsg);\n\n // Try individual updates for failed batches\n for (const { row, existingRowIndex } of batch) {\n try {\n const range = `${sheetTitle}!A${existingRowIndex}:${a1Col(header.length)}${existingRowIndex}`;\n await sheets.spreadsheets.values.update({\n spreadsheetId,\n range,\n valueInputOption,\n requestBody: {\n values: [row as (string | number | boolean | null | undefined)[]],\n },\n });\n totalUpdated += 1;\n } catch (singleError) {\n errors.push(`Failed to update row ${existingRowIndex}: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n }\n }\n }\n }\n\n const result: { updatedRows: number; errors?: string[] } = {\n updatedRows: totalUpdated,\n };\n\n if (errors.length > 0) {\n result.errors = errors;\n }\n\n return result;\n}\n\nexport async function upsertByKey(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n rows,\n canonicalHeaders,\n options,\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n rows: Row[];\n canonicalHeaders?: string[];\n options: UpsertOptions;\n logger: Logger;\n }\n): Promise<BatchOperationResult> {\n // Validate inputs\n if (!sheets) throw new Error('upsertByKey: sheets client is required');\n if (!spreadsheetId) throw new Error('upsertByKey: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('upsertByKey: either sheetTitle or sheetRef is required');\n if (!Array.isArray(rows) || rows.length === 0) {\n return { updatedRows: 0, inserted: [], rowsSkipped: 0 };\n }\n\n // Step 1: Input validation (duplicate key checking)\n let resolvedSheetTitle = sheetTitle;\n if (sheetRef) {\n const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n resolvedSheetTitle = sheet?.properties?.title || sheetRef;\n }\n\n if (!resolvedSheetTitle) {\n throw new Error('upsertByKey: could not resolve sheet title');\n }\n\n // Validate for duplicate keys in input data\n const inputValidation = validateRowKeys(rows, canonicalHeaders || [], options.keyStrategy);\n if (!inputValidation.valid) {\n throw new Error(`upsertByKey: duplicate keys found in input data: ${inputValidation.duplicateKeys.join(', ')}`);\n }\n\n // Step 2: Header discovery and column mapping\n const currentHeader = await discoverHeader(sheets, spreadsheetId, resolvedSheetTitle);\n let effectiveHeader = currentHeader;\n\n // If sheet is empty and we have canonical headers, use them\n if (currentHeader.length === 0 && canonicalHeaders && canonicalHeaders.length > 0) {\n effectiveHeader = canonicalHeaders;\n // Write headers to sheet\n await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: options.valueInputOption || 'USER_ENTERED',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: [effectiveHeader] },\n });\n }\n\n // Validate headers if we have requirements\n if (canonicalHeaders && canonicalHeaders.length > 0) {\n const headerValidation = validateAndMapHeaders(effectiveHeader, canonicalHeaders);\n if (!headerValidation.valid) {\n throw new Error(`upsertByKey: missing required columns: ${headerValidation.missingColumns.join(', ')}`);\n }\n }\n\n // Step 3: Key column reading for existing row lookup with position tracking\n const { keySet: existingKeys, keyToRowMap } = await snapshotHeaderKeysAndPositions(sheets, spreadsheetId, resolvedSheetTitle, options.keyStrategy.keyColumns, options.keyStrategy);\n\n // Step 4: Partition changes (updates vs appends)\n let processedRows = rows;\n\n // Map canonical data to sheet structure if needed\n if (canonicalHeaders && canonicalHeaders.length > 0 && effectiveHeader.length > 0) {\n processedRows = mapRowsToHeader({\n rows,\n header: effectiveHeader,\n canonical: canonicalHeaders,\n });\n }\n\n const partition = partitionDataForUpsert(processedRows, effectiveHeader, options.keyStrategy, existingKeys, options.allowUpdates, keyToRowMap);\n\n // Step 5: Efficient batch writing\n const batchSize = options.batchSize || 50;\n const errors: string[] = [];\n let totalUpdated = 0;\n const insertedKeys: string[] = [];\n\n // Handle appends with proper error handling and partial success tracking\n if (partition.toAppend.length > 0) {\n for (let i = 0; i < partition.toAppend.length; i += batchSize) {\n const batch = partition.toAppend.slice(i, i + batchSize);\n try {\n const response = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: options.valueInputOption || 'USER_ENTERED',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: batch },\n });\n\n const updatedRows = Number(response.data?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n\n // Track inserted keys for successful batch\n batch.forEach((row) => {\n const key = generateRowKey(row, effectiveHeader, options.keyStrategy);\n if (key.replace(/\\\\+/g, '') !== '') {\n insertedKeys.push(key);\n }\n });\n } catch (error) {\n const errorMsg = `Batch ${Math.floor(i / batchSize) + 1} append failed: ${error instanceof Error ? error.message : String(error)}`;\n errors.push(errorMsg);\n }\n }\n }\n\n // Handle updates with proper row position tracking\n if (partition.toUpdate.length > 0 && options.allowUpdates) {\n try {\n const updateResult = await performBatchUpdates(sheets, spreadsheetId, resolvedSheetTitle, partition.toUpdate, effectiveHeader, batchSize, options.valueInputOption || 'USER_ENTERED');\n totalUpdated += updateResult.updatedRows;\n if (updateResult.errors) {\n errors.push(...updateResult.errors);\n }\n } catch (updateError) {\n const errorMsg = `Update operations failed: ${updateError instanceof Error ? updateError.message : String(updateError)}`;\n errors.push(errorMsg);\n }\n }\n\n const result: BatchOperationResult = {\n updatedRows: totalUpdated,\n inserted: insertedKeys,\n rowsSkipped: partition.skippedKeys.length,\n };\n\n if (errors.length > 0) {\n result.errors = errors;\n }\n\n return result;\n}\n"],"names":["appendRows","discoverHeader","generateRowKey","mapRowsToHeader","partitionDataForUpsert","performBatchUpdates","snapshotHeaderAndKeys","snapshotHeaderKeysAndPositions","upsertByKey","validateAndMapHeaders","validateRowKeys","sheets","spreadsheetId","sheetTitle","response","spreadsheets","values","get","range","majorDimension","data","sheetHeaders","canonicalHeaders","requiredColumns","normalizeColumn","col","String","toLowerCase","replace","sheetNormalized","map","canonicalNormalized","requiredNormalized","mappings","missingColumns","extraColumns","forEach","canonical","canonicalIndex","canonicalNorm","sheetIndex","indexOf","sheetHeader","undefined","push","sheet","index","extraIndex","splice","includes","valid","length","row","header","strategy","keyColumns","useProviderIdLogic","separator","lowerHeader","h","providerIndex","idIndex","providerVal","trim","idVal","join","keyIndices","name","normalizedName","filter","components","every","comp","rows","keyMap","Map","duplicateKeys","key","has","set","indices","sheetRef","keySet","logger","resolvedSheetTitle","respHeader","vr","resolveKeyIndices","keyColsIdx","batchSize","totalUpdated","i","app","batch","resp","updatedRows","toKey","rowsToInsert","insertedKeys","r","rowsSkipped","INTERNAL_BATCH_SIZE","app2","error","singleRow","singleApp","singleResp","singleUpdatedRows","singleError","Error","findSheetByRef","properties","title","Array","isArray","inserted","kc","hdr","c","idx","slice","append","valueInputOption","insertDataOption","requestBody","Number","updates","warn","message","validation","mappingLookup","m","mappedRow","fill","canonicalCol","keyStrategy","Math","chunkSize","startRow","minIndex","maxIndex","startCol","endCol","endRow","Set","min","max","a1Col","rawRow","fullRow","globalIndex","_localIndex","localRowIndex","add","keyToRowMap","globalRowNumber","localRowArrayIndex","existingKeys","allowUpdates","toAppend","toUpdate","skippedKeys","existingRowIndex","errors","requests","errorMsg","result","updateCells","sheetId","startRowIndex","endRowIndex","startColumnIndex","endColumnIndex","cellValue","userEnteredValue","stringValue","fields","batchUpdate","floor","update","options","inputValidation","currentHeader","effectiveHeader","headerValidation","processedRows","partition","updateResult","updateError"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/data-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\nimport { findSheetByRef, scanKeyColumnRows } from './sheet-operations.ts';\n\n// Core data types\nexport type Cell = string | number | boolean | null | undefined;\nexport type Row = Cell[];\n\n// Enhanced type definitions for shared data operations\nexport interface ColumnMapping {\n canonical: string;\n sheet: string;\n index: number;\n}\n\nexport interface HeaderValidationResult {\n valid: boolean;\n missingColumns: string[];\n extraColumns: string[];\n mappings: ColumnMapping[];\n}\n\nexport interface KeyGenerationStrategy {\n keyColumns: string[];\n useProviderIdLogic: boolean;\n separator?: string;\n}\n\nexport interface DataPartition {\n toAppend: Row[];\n toUpdate: Array<{ row: Row; existingRowIndex: number }>;\n skippedKeys: string[];\n}\n\nexport interface BatchOperationResult {\n updatedRows: number;\n inserted: string[];\n rowsSkipped: number;\n errors?: string[];\n}\n\nexport interface UpsertOptions {\n keyStrategy: KeyGenerationStrategy;\n allowUpdates: boolean;\n batchSize?: number;\n valueInputOption?: 'RAW' | 'USER_ENTERED';\n}\n\nexport async function discoverHeader(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string): Promise<string[]> {\n try {\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId,\n range: `${sheetTitle}!1:1`,\n majorDimension: 'ROWS',\n });\n return ((response.data?.values || [])[0] || []) as string[];\n } catch {\n return [];\n }\n}\n\nexport function validateAndMapHeaders(sheetHeaders: string[], canonicalHeaders: string[], requiredColumns: string[] = []): HeaderValidationResult {\n const normalizeColumn = (col: string) =>\n String(col ?? '')\n .toLowerCase()\n .replace(/[^a-z0-9]/g, '');\n\n const sheetNormalized = sheetHeaders.map(normalizeColumn);\n const canonicalNormalized = canonicalHeaders.map(normalizeColumn);\n const requiredNormalized = requiredColumns.map(normalizeColumn);\n\n const mappings: ColumnMapping[] = [];\n const missingColumns: string[] = [];\n const extraColumns: string[] = [...sheetHeaders];\n\n // Create mappings for canonical columns\n canonicalHeaders.forEach((canonical, canonicalIndex) => {\n const canonicalNorm = canonicalNormalized[canonicalIndex];\n if (!canonicalNorm) return; // Skip if normalization resulted in empty string\n\n let sheetIndex = sheetNormalized.indexOf(canonicalNorm);\n\n // Special handling for 'id' -> 'messageid' mapping\n if (sheetIndex === -1 && canonicalNorm === 'id') {\n sheetIndex = sheetNormalized.indexOf('messageid');\n }\n\n if (sheetIndex !== -1) {\n const sheetHeader = sheetHeaders[sheetIndex];\n if (sheetHeader !== undefined) {\n mappings.push({\n canonical,\n sheet: sheetHeader,\n index: sheetIndex,\n });\n // Remove from extra columns\n const extraIndex = extraColumns.indexOf(sheetHeader);\n if (extraIndex !== -1) {\n extraColumns.splice(extraIndex, 1);\n }\n }\n } else if (requiredNormalized.includes(canonicalNorm)) {\n missingColumns.push(canonical);\n }\n });\n\n return {\n valid: missingColumns.length === 0,\n missingColumns,\n extraColumns,\n mappings,\n };\n}\n\n/** Ensures consistent key generation across all functions */\nexport function generateRowKey(row: Row, header: string[], strategy: KeyGenerationStrategy): string {\n const { keyColumns, useProviderIdLogic, separator = '\\\\' } = strategy;\n\n // Normalize header for consistent lookups\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n\n if (useProviderIdLogic) {\n const providerIndex = lowerHeader.indexOf('provider');\n let idIndex = lowerHeader.indexOf('messageid');\n if (idIndex === -1) idIndex = lowerHeader.indexOf('id');\n\n if (providerIndex >= 0 && idIndex >= 0) {\n const providerVal = String(row[providerIndex] ?? '').trim();\n const idVal = String(row[idIndex] ?? '').trim();\n if (providerVal || idVal) {\n // Only return key if at least one component exists\n return [providerVal, idVal].join(separator);\n }\n }\n }\n\n // Standard key generation using specified columns\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n let index = lowerHeader.indexOf(normalizedName);\n // Consistent fallback: id -> messageid\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return ''; // Return empty string for invalid key configurations\n }\n\n const components = keyIndices.map((index) => String(row[index] ?? '').trim());\n // Only return key if all components are non-empty\n if (components.every((comp) => comp.length > 0)) {\n return components.join(separator);\n }\n\n return '';\n}\n\nexport function validateRowKeys(rows: Row[], header: string[], strategy: KeyGenerationStrategy): { valid: boolean; duplicateKeys: string[]; keyMap: Map<string, number[]> } {\n const keyMap = new Map<string, number[]>();\n const duplicateKeys: string[] = [];\n\n rows.forEach((row, index) => {\n const key = generateRowKey(row, header, strategy);\n if (key.replace(/\\\\+/g, '') === '') return; // Skip empty keys\n\n if (!keyMap.has(key)) {\n keyMap.set(key, []);\n }\n keyMap.get(key)?.push(index);\n });\n\n // Find duplicates\n keyMap.forEach((indices, key) => {\n if (indices.length > 1) {\n duplicateKeys.push(key);\n }\n });\n\n return {\n valid: duplicateKeys.length === 0,\n duplicateKeys,\n keyMap,\n };\n}\n\n// Overloaded function signatures for appendRows\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n rows = [],\n keySet = null as Set<string> | null,\n keyColumns = ['id'] as string[],\n header = [] as string[],\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n rows?: unknown[];\n keySet?: Set<string> | null;\n keyColumns?: string[];\n header?: string[];\n logger: Logger;\n }\n) {\n if (!sheets) throw new Error('appendRows: sheets is required');\n if (!spreadsheetId) throw new Error('appendRows: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('appendRows: either sheetTitle or sheetRef is required');\n\n // Resolve the actual sheet title from sheetRef if provided\n let resolvedSheetTitle = sheetTitle;\n if (sheetRef) {\n const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n if (sheet) {\n resolvedSheetTitle = sheet.properties?.title || sheetRef;\n } else {\n // Sheet doesn't exist, use the sheetRef as the title\n resolvedSheetTitle = sheetRef;\n }\n }\n\n if (!resolvedSheetTitle) throw new Error('appendRows: could not resolve sheet title');\n if (!Array.isArray(rows) || rows.length === 0) return { updatedRows: 0, inserted: [] as string[] };\n\n if (!Array.isArray(header) || header.length === 0) {\n const respHeader = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n const vr = respHeader.data as sheets_v4.Schema$ValueRange;\n header = ((vr?.values || [])[0] || []) as string[];\n }\n\n const resolveKeyIndices = (kc: string[], hdr: string[]) => {\n if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n for (const c of kc) {\n if (typeof c !== 'string' || c.length === 0) throw new Error('appendRows: keyColumns must be an array of non-empty strings');\n }\n if (!Array.isArray(hdr) || hdr.length === 0) {\n throw new Error('appendRows: header array is required when keyColumns are header names');\n }\n return kc.map((name) => {\n const idx = hdr.indexOf(name);\n if (idx === -1) throw new Error(`appendRows: header name \"${name}\" not found in header`);\n return idx;\n });\n };\n\n const keyColsIdx = resolveKeyIndices(keyColumns, header);\n\n // Internal batch size to avoid Google Sheets limits\n const batchSize = 50;\n\n if (!keyColsIdx || keyColsIdx.length === 0) {\n let totalUpdated = 0;\n for (let i = 0; i < rows.length; i += batchSize) {\n const batch = rows.slice(i, i + batchSize);\n const resp = await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: batch as unknown[][] } });\n const app = resp.data as sheets_v4.Schema$AppendValuesResponse;\n const updatedRows = Number(app?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n }\n return { updatedRows: totalUpdated, inserted: [] as string[], rowsSkipped: 0 };\n }\n\n const toKey = (r: unknown[]) => {\n const row = r as (string | number | boolean | null | undefined)[];\n\n // Use consistent key generation strategy\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: true,\n separator: '\\\\',\n };\n\n return generateRowKey(row, header, strategy);\n };\n\n const rowsToInsert: unknown[][] = [];\n const insertedKeys: string[] = [];\n for (const r of rows as unknown[][]) {\n const key = toKey(r as unknown[]);\n if (keySet && keySet.has(key)) continue;\n rowsToInsert.push(r as unknown[]);\n insertedKeys.push(key);\n }\n\n if (rowsToInsert.length === 0) {\n const rowsSkipped = rows.length - rowsToInsert.length; // Should be rows.length when all are skipped\n return { updatedRows: 0, inserted: [] as string[], rowsSkipped };\n }\n\n // Use smaller internal batch size to avoid Google Sheets character limit errors\n // Especially important when dealing with emails that may have long bodies\n const INTERNAL_BATCH_SIZE = 50;\n\n let totalUpdated = 0;\n for (let i = 0; i < rowsToInsert.length; i += INTERNAL_BATCH_SIZE) {\n const batch = rowsToInsert.slice(i, i + INTERNAL_BATCH_SIZE);\n try {\n const resp = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: 'RAW',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: batch as unknown[][] },\n });\n const app2 = resp.data as sheets_v4.Schema$AppendValuesResponse;\n const updatedRows = Number(app2?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n } catch (error) {\n // If a batch fails, try with smaller batches to handle partial success\n if (batch.length > 1) {\n for (const singleRow of batch) {\n try {\n const singleResp = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: 'RAW',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: [singleRow as unknown[]] },\n });\n const singleApp = singleResp.data as sheets_v4.Schema$AppendValuesResponse;\n const singleUpdatedRows = Number(singleApp?.updates?.updatedRows || 1);\n totalUpdated += singleUpdatedRows;\n } catch (singleError) {\n // Skip problematic individual rows but continue processing\n logger.warn?.(`Failed to insert single row: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n }\n }\n } else {\n // Single row batch failed, skip it\n logger.warn?.(`Failed to insert batch: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n }\n const rowsSkipped = rows.length - rowsToInsert.length;\n return { updatedRows: totalUpdated, inserted: insertedKeys, rowsSkipped };\n}\n\nexport function mapRowsToHeader({ rows = [], header = [], canonical = [] as string[] }: { rows?: Row[]; header?: string[]; canonical?: string[] }): Row[] {\n if (!Array.isArray(rows) || rows.length === 0) return [];\n if (!Array.isArray(header) || header.length === 0) return rows;\n if (!Array.isArray(canonical) || canonical.length === 0) return rows;\n\n const validation = validateAndMapHeaders(header, canonical);\n const mappingLookup = new Map(validation.mappings.map((m) => [m.canonical, m.index]));\n\n return rows.map((row: Row) => {\n // Fill with null to skip unmapped columns (preserve existing values)\n // Use '' (empty string) only when explicitly wanting to clear a cell\n const mappedRow: Row = new Array(header.length).fill(null);\n\n canonical.forEach((canonicalCol, canonicalIndex) => {\n const sheetIndex = mappingLookup.get(canonicalCol);\n if (sheetIndex !== undefined && canonicalIndex < row.length) {\n // Preserve null values - they signal \"skip this cell\"\n mappedRow[sheetIndex] = row[canonicalIndex];\n }\n });\n\n return mappedRow;\n });\n}\n\n/** Calls onKey with each non-empty generated key of the data rows and its 1-indexed row number; see scanKeyColumnRows for the bounded, error-reporting scan. */\nasync function scanKeyRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, header: string[], keyIndices: number[], strategy: KeyGenerationStrategy, onKey: (key: string, rowNumber: number) => void): Promise<void> {\n const minIndex = Math.min(...keyIndices);\n const maxIndex = Math.max(...keyIndices);\n\n await scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, a1Col(minIndex + 1), a1Col(maxIndex + 1), (rawRow, rowNumber) => {\n // Reconstruct full row for key generation\n const fullRow: Row = new Array(header.length).fill('');\n keyIndices.forEach((globalIndex) => {\n const localRowArrayIndex = globalIndex - minIndex;\n if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {\n fullRow[globalIndex] = rawRow[localRowArrayIndex];\n }\n });\n\n const key = generateRowKey(fullRow, header, strategy);\n if (key.replace(/\\\\+/g, '') !== '') onKey(key, rowNumber);\n });\n}\n\nexport async function snapshotHeaderAndKeys(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyIndices: number[] }> {\n const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n const keySet = new Set<string>();\n\n if (header.length === 0) {\n return { header, keySet, keyIndices: [] };\n }\n\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n separator: keyStrategy?.separator ?? '\\\\',\n };\n\n // Find key column indices\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n let index = lowerHeader.indexOf(normalizedName);\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return { header, keySet, keyIndices };\n }\n\n await scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, (key) => {\n keySet.add(key);\n });\n\n return { header, keySet, keyIndices };\n}\n\n/** Message naming every duplicate key and its 1-indexed row numbers */\nfunction formatDuplicateSheetKeys(keyToRows: Map<string, number[]>): string | undefined {\n const parts: string[] = [];\n keyToRows.forEach((rows, key) => {\n if (rows.length > 1) parts.push(`\"${key}\" (rows ${rows.join(', ')})`);\n });\n if (parts.length === 0) return undefined;\n return `duplicate keys found on the sheet: ${parts.join('; ')}. Nothing was written; make each key unique and retry.`;\n}\n\n/** Tracks row positions for updates in addition to keys */\nexport async function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyToRowMap: Map<string, number>; keyIndices: number[] }> {\n const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n const keySet = new Set<string>();\n const keyToRowMap = new Map<string, number>();\n const keyToRows = new Map<string, number[]>();\n\n if (header.length === 0) {\n return { header, keySet, keyToRowMap, keyIndices: [] };\n }\n\n const strategy: KeyGenerationStrategy = {\n keyColumns,\n useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n separator: keyStrategy?.separator ?? '\\\\',\n };\n\n // Find key column indices\n const keyIndices = keyColumns\n .map((name) => {\n const normalizedName = String(name ?? '').toLowerCase();\n const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n let index = lowerHeader.indexOf(normalizedName);\n if (index === -1 && normalizedName === 'id') {\n index = lowerHeader.indexOf('messageid');\n }\n return index;\n })\n .filter((index) => index >= 0);\n\n if (keyIndices.length === 0) {\n return { header, keySet, keyToRowMap, keyIndices };\n }\n\n await scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, (key, rowNumber) => {\n keySet.add(key);\n keyToRowMap.set(key, rowNumber); // Store 1-indexed row number\n const seenRows = keyToRows.get(key);\n if (seenRows) seenRows.push(rowNumber);\n else keyToRows.set(key, [rowNumber]);\n });\n\n const duplicateMessage = formatDuplicateSheetKeys(keyToRows);\n if (duplicateMessage) throw new Error(duplicateMessage);\n\n return { header, keySet, keyToRowMap, keyIndices };\n}\n\n/**\n * Partitions data into updates vs appends based on existing keys with row position tracking\n */\nexport function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates = false, keyToRowMap?: Map<string, number>): DataPartition {\n const toAppend: Row[] = [];\n const toUpdate: Array<{ row: Row; existingRowIndex: number }> = [];\n const skippedKeys: string[] = [];\n\n rows.forEach((row) => {\n const key = generateRowKey(row, header, keyStrategy);\n if (key.replace(/\\\\+/g, '') === '') {\n // Skip rows with empty keys\n return;\n }\n\n if (existingKeys.has(key)) {\n if (allowUpdates && keyToRowMap) {\n const existingRowIndex = keyToRowMap.get(key);\n if (existingRowIndex !== undefined) {\n toUpdate.push({ row, existingRowIndex });\n } else {\n skippedKeys.push(key);\n }\n } else {\n skippedKeys.push(key);\n }\n } else {\n toAppend.push(row);\n }\n });\n\n return {\n toAppend,\n toUpdate,\n skippedKeys,\n };\n}\n\n/**\n * Performs batch updates on existing rows using batchUpdate API\n */\nexport async function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{ row: Row; existingRowIndex: number }>, header: string[], batchSize: number, valueInputOption: 'RAW' | 'USER_ENTERED'): Promise<{ updatedRows: number; errors?: string[] }> {\n const errors: string[] = [];\n let totalUpdated = 0;\n\n // Process updates in batches\n for (let i = 0; i < updates.length; i += batchSize) {\n const batch = updates.slice(i, i + batchSize);\n\n try {\n const requests: sheets_v4.Schema$Request[] = [];\n\n for (const { row, existingRowIndex } of batch) {\n requests.push({\n updateCells: {\n range: {\n sheetId: 0, // Will be resolved by sheet title in the range\n startRowIndex: existingRowIndex - 1, // Convert to 0-indexed\n endRowIndex: existingRowIndex, // Exclusive\n startColumnIndex: 0,\n endColumnIndex: header.length,\n },\n rows: [\n {\n values: row.map((cellValue) => ({\n userEnteredValue: {\n stringValue: String(cellValue ?? ''),\n },\n })),\n },\n ],\n fields: 'userEnteredValue',\n },\n });\n }\n\n if (requests.length > 0) {\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId,\n requestBody: {\n requests,\n },\n });\n\n totalUpdated += batch.length;\n }\n } catch (error) {\n const errorMsg = `Batch update ${Math.floor(i / batchSize) + 1} failed: ${error instanceof Error ? error.message : String(error)}`;\n errors.push(errorMsg);\n\n // Try individual updates for failed batches\n for (const { row, existingRowIndex } of batch) {\n try {\n const range = `${sheetTitle}!A${existingRowIndex}:${a1Col(header.length)}${existingRowIndex}`;\n await sheets.spreadsheets.values.update({\n spreadsheetId,\n range,\n valueInputOption,\n requestBody: {\n values: [row as (string | number | boolean | null | undefined)[]],\n },\n });\n totalUpdated += 1;\n } catch (singleError) {\n errors.push(`Failed to update row ${existingRowIndex}: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n }\n }\n }\n }\n\n const result: { updatedRows: number; errors?: string[] } = {\n updatedRows: totalUpdated,\n };\n\n if (errors.length > 0) {\n result.errors = errors;\n }\n\n return result;\n}\n\nexport async function upsertByKey(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n rows,\n canonicalHeaders,\n options,\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n rows: Row[];\n canonicalHeaders?: string[];\n options: UpsertOptions;\n logger: Logger;\n }\n): Promise<BatchOperationResult> {\n // Validate inputs\n if (!sheets) throw new Error('upsertByKey: sheets client is required');\n if (!spreadsheetId) throw new Error('upsertByKey: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('upsertByKey: either sheetTitle or sheetRef is required');\n if (!Array.isArray(rows) || rows.length === 0) {\n return { updatedRows: 0, inserted: [], rowsSkipped: 0 };\n }\n\n // Step 1: Input validation (duplicate key checking)\n let resolvedSheetTitle = sheetTitle;\n if (sheetRef) {\n const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n resolvedSheetTitle = sheet?.properties?.title || sheetRef;\n }\n\n if (!resolvedSheetTitle) {\n throw new Error('upsertByKey: could not resolve sheet title');\n }\n\n // Validate for duplicate keys in input data\n const inputValidation = validateRowKeys(rows, canonicalHeaders || [], options.keyStrategy);\n if (!inputValidation.valid) {\n throw new Error(`upsertByKey: duplicate keys found in input data: ${inputValidation.duplicateKeys.join(', ')}`);\n }\n\n // Step 2: Header discovery and column mapping\n const currentHeader = await discoverHeader(sheets, spreadsheetId, resolvedSheetTitle);\n let effectiveHeader = currentHeader;\n\n // If sheet is empty and we have canonical headers, use them\n if (currentHeader.length === 0 && canonicalHeaders && canonicalHeaders.length > 0) {\n effectiveHeader = canonicalHeaders;\n // Write headers to sheet\n await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: options.valueInputOption || 'USER_ENTERED',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: [effectiveHeader] },\n });\n }\n\n // Validate headers if we have requirements\n if (canonicalHeaders && canonicalHeaders.length > 0) {\n const headerValidation = validateAndMapHeaders(effectiveHeader, canonicalHeaders);\n if (!headerValidation.valid) {\n throw new Error(`upsertByKey: missing required columns: ${headerValidation.missingColumns.join(', ')}`);\n }\n }\n\n // Step 3: Key column reading for existing row lookup with position tracking\n const { keySet: existingKeys, keyToRowMap } = await snapshotHeaderKeysAndPositions(sheets, spreadsheetId, resolvedSheetTitle, options.keyStrategy.keyColumns, options.keyStrategy);\n\n // Step 4: Partition changes (updates vs appends)\n let processedRows = rows;\n\n // Map canonical data to sheet structure if needed\n if (canonicalHeaders && canonicalHeaders.length > 0 && effectiveHeader.length > 0) {\n processedRows = mapRowsToHeader({\n rows,\n header: effectiveHeader,\n canonical: canonicalHeaders,\n });\n }\n\n const partition = partitionDataForUpsert(processedRows, effectiveHeader, options.keyStrategy, existingKeys, options.allowUpdates, keyToRowMap);\n\n // Step 5: Efficient batch writing\n const batchSize = options.batchSize || 50;\n const errors: string[] = [];\n let totalUpdated = 0;\n const insertedKeys: string[] = [];\n\n // Handle appends with proper error handling and partial success tracking\n if (partition.toAppend.length > 0) {\n for (let i = 0; i < partition.toAppend.length; i += batchSize) {\n const batch = partition.toAppend.slice(i, i + batchSize);\n try {\n const response = await sheets.spreadsheets.values.append({\n spreadsheetId,\n range: `${resolvedSheetTitle}!A1`,\n valueInputOption: options.valueInputOption || 'USER_ENTERED',\n insertDataOption: 'INSERT_ROWS',\n requestBody: { values: batch },\n });\n\n const updatedRows = Number(response.data?.updates?.updatedRows || batch.length);\n totalUpdated += updatedRows;\n\n // Track inserted keys for successful batch\n batch.forEach((row) => {\n const key = generateRowKey(row, effectiveHeader, options.keyStrategy);\n if (key.replace(/\\\\+/g, '') !== '') {\n insertedKeys.push(key);\n }\n });\n } catch (error) {\n const errorMsg = `Batch ${Math.floor(i / batchSize) + 1} append failed: ${error instanceof Error ? error.message : String(error)}`;\n errors.push(errorMsg);\n }\n }\n }\n\n // Handle updates with proper row position tracking\n if (partition.toUpdate.length > 0 && options.allowUpdates) {\n try {\n const updateResult = await performBatchUpdates(sheets, spreadsheetId, resolvedSheetTitle, partition.toUpdate, effectiveHeader, batchSize, options.valueInputOption || 'USER_ENTERED');\n totalUpdated += updateResult.updatedRows;\n if (updateResult.errors) {\n errors.push(...updateResult.errors);\n }\n } catch (updateError) {\n const errorMsg = `Update operations failed: ${updateError instanceof Error ? updateError.message : String(updateError)}`;\n errors.push(errorMsg);\n }\n }\n\n const result: BatchOperationResult = {\n updatedRows: totalUpdated,\n inserted: insertedKeys,\n rowsSkipped: partition.skippedKeys.length,\n };\n\n if (errors.length > 0) {\n result.errors = errors;\n }\n\n return result;\n}\n"],"names":["appendRows","discoverHeader","generateRowKey","mapRowsToHeader","partitionDataForUpsert","performBatchUpdates","snapshotHeaderAndKeys","snapshotHeaderKeysAndPositions","upsertByKey","validateAndMapHeaders","validateRowKeys","sheets","spreadsheetId","sheetTitle","response","spreadsheets","values","get","range","majorDimension","data","sheetHeaders","canonicalHeaders","requiredColumns","normalizeColumn","col","String","toLowerCase","replace","sheetNormalized","map","canonicalNormalized","requiredNormalized","mappings","missingColumns","extraColumns","forEach","canonical","canonicalIndex","canonicalNorm","sheetIndex","indexOf","sheetHeader","undefined","push","sheet","index","extraIndex","splice","includes","valid","length","row","header","strategy","keyColumns","useProviderIdLogic","separator","lowerHeader","h","providerIndex","idIndex","providerVal","trim","idVal","join","keyIndices","name","normalizedName","filter","components","every","comp","rows","keyMap","Map","duplicateKeys","key","has","set","indices","sheetRef","keySet","logger","resolvedSheetTitle","respHeader","vr","resolveKeyIndices","keyColsIdx","batchSize","totalUpdated","i","app","batch","resp","updatedRows","toKey","rowsToInsert","insertedKeys","r","rowsSkipped","INTERNAL_BATCH_SIZE","app2","error","singleRow","singleApp","singleResp","singleUpdatedRows","singleError","Error","findSheetByRef","properties","title","Array","isArray","inserted","kc","hdr","c","idx","slice","append","valueInputOption","insertDataOption","requestBody","Number","updates","warn","message","validation","mappingLookup","m","mappedRow","fill","canonicalCol","scanKeyRows","onKey","Math","minIndex","maxIndex","min","max","scanKeyColumnRows","a1Col","rawRow","rowNumber","fullRow","globalIndex","localRowArrayIndex","keyStrategy","Set","add","formatDuplicateSheetKeys","keyToRows","parts","keyToRowMap","duplicateMessage","seenRows","existingKeys","allowUpdates","toAppend","toUpdate","skippedKeys","existingRowIndex","errors","requests","errorMsg","result","updateCells","sheetId","startRowIndex","endRowIndex","startColumnIndex","endColumnIndex","cellValue","userEnteredValue","stringValue","fields","batchUpdate","floor","update","options","inputValidation","currentHeader","effectiveHeader","headerValidation","processedRows","partition","updateResult","updateError"],"mappings":"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"}
@@ -183,3 +183,29 @@ export declare function rangeReferenceToGridRange(rangeRef: RangeReference, shee
183
183
  startColumnIndex?: number;
184
184
  endColumnIndex?: number;
185
185
  };
186
+ /**
187
+ * A finite, sheet-local block of cells with 1-based inclusive bounds.
188
+ */
189
+ export interface CellBlock {
190
+ startRow: number;
191
+ endRow: number;
192
+ startColumn: number;
193
+ endColumn: number;
194
+ }
195
+ /**
196
+ * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.
197
+ * Throws for invalid syntax, whole rows/columns and reversed bounds.
198
+ */
199
+ export declare function parseFiniteCellBlock(notation: string): CellBlock;
200
+ /**
201
+ * Formats a block as A1 notation (a single cell when it spans one cell).
202
+ */
203
+ export declare function cellBlockToA1(block: CellBlock): string;
204
+ /**
205
+ * Footprint of a copy-paste: the cells written in the destination.
206
+ *
207
+ * - destination is one cell: the (oriented) source size anchored at that cell
208
+ * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)
209
+ * - anything else throws
210
+ */
211
+ export declare function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock;
@@ -183,3 +183,29 @@ export declare function rangeReferenceToGridRange(rangeRef: RangeReference, shee
183
183
  startColumnIndex?: number;
184
184
  endColumnIndex?: number;
185
185
  };
186
+ /**
187
+ * A finite, sheet-local block of cells with 1-based inclusive bounds.
188
+ */
189
+ export interface CellBlock {
190
+ startRow: number;
191
+ endRow: number;
192
+ startColumn: number;
193
+ endColumn: number;
194
+ }
195
+ /**
196
+ * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.
197
+ * Throws for invalid syntax, whole rows/columns and reversed bounds.
198
+ */
199
+ export declare function parseFiniteCellBlock(notation: string): CellBlock;
200
+ /**
201
+ * Formats a block as A1 notation (a single cell when it spans one cell).
202
+ */
203
+ export declare function cellBlockToA1(block: CellBlock): string;
204
+ /**
205
+ * Footprint of a copy-paste: the cells written in the destination.
206
+ *
207
+ * - destination is one cell: the (oriented) source size anchored at that cell
208
+ * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)
209
+ * - anything else throws
210
+ */
211
+ export declare function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock;