@mcp-z/mcp-sheets 2.4.2 → 2.5.1

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 (119) hide show
  1. package/README.md +45 -29
  2. package/dist/cjs/constants.d.cts +26 -0
  3. package/dist/cjs/constants.d.ts +26 -0
  4. package/dist/cjs/constants.js +83 -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/cells-format.d.cts +3 -3
  11. package/dist/cjs/mcp/tools/cells-format.d.ts +3 -3
  12. package/dist/cjs/mcp/tools/cells-format.js +3 -2
  13. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  14. package/dist/cjs/mcp/tools/columns-get.d.cts +2 -2
  15. package/dist/cjs/mcp/tools/columns-get.d.ts +2 -2
  16. package/dist/cjs/mcp/tools/columns-get.js +2 -1
  17. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  18. package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
  19. package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
  20. package/dist/cjs/mcp/tools/columns-update.js +3 -2
  21. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  22. package/dist/cjs/mcp/tools/index.d.cts +1 -0
  23. package/dist/cjs/mcp/tools/index.d.ts +1 -0
  24. package/dist/cjs/mcp/tools/index.js +4 -0
  25. package/dist/cjs/mcp/tools/index.js.map +1 -1
  26. package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
  27. package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
  28. package/dist/cjs/mcp/tools/rows-append.js +2 -1
  29. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  30. package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
  31. package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
  32. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
  33. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  34. package/dist/cjs/mcp/tools/rows-get.d.cts +2 -2
  35. package/dist/cjs/mcp/tools/rows-get.d.ts +2 -2
  36. package/dist/cjs/mcp/tools/rows-get.js +2 -1
  37. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  38. package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
  39. package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
  40. package/dist/cjs/mcp/tools/values-batch-update.js +3 -2
  41. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  42. package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
  43. package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
  44. package/dist/cjs/mcp/tools/values-csv-update.js +3 -2
  45. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  46. package/dist/cjs/mcp/tools/values-search.d.cts +2 -2
  47. package/dist/cjs/mcp/tools/values-search.d.ts +2 -2
  48. package/dist/cjs/mcp/tools/values-search.js +2 -1
  49. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  50. package/dist/cjs/schemas/index.d.cts +1 -0
  51. package/dist/cjs/schemas/index.d.ts +1 -0
  52. package/dist/cjs/schemas/index.js +16 -0
  53. package/dist/cjs/schemas/index.js.map +1 -1
  54. package/dist/cjs/setup/config.js +26 -14
  55. package/dist/cjs/setup/config.js.map +1 -1
  56. package/dist/cjs/setup/version-help.js +1 -1
  57. package/dist/cjs/setup/version-help.js.map +1 -1
  58. package/dist/cjs/spreadsheet/data-operations.js +60 -181
  59. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  60. package/dist/cjs/spreadsheet/range-operations.d.cts +27 -5
  61. package/dist/cjs/spreadsheet/range-operations.d.ts +27 -5
  62. package/dist/cjs/spreadsheet/range-operations.js +48 -28
  63. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  64. package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
  65. package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
  66. package/dist/cjs/spreadsheet/sheet-operations.js +114 -124
  67. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  68. package/dist/esm/constants.d.ts +26 -0
  69. package/dist/esm/constants.js +55 -0
  70. package/dist/esm/constants.js.map +1 -1
  71. package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
  72. package/dist/esm/mcp/tools/cells-copy.js +190 -0
  73. package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
  74. package/dist/esm/mcp/tools/cells-format.d.ts +3 -3
  75. package/dist/esm/mcp/tools/cells-format.js +3 -2
  76. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  77. package/dist/esm/mcp/tools/columns-get.d.ts +2 -2
  78. package/dist/esm/mcp/tools/columns-get.js +2 -1
  79. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  80. package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
  81. package/dist/esm/mcp/tools/columns-update.js +3 -2
  82. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  83. package/dist/esm/mcp/tools/index.d.ts +1 -0
  84. package/dist/esm/mcp/tools/index.js +1 -0
  85. package/dist/esm/mcp/tools/index.js.map +1 -1
  86. package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
  87. package/dist/esm/mcp/tools/rows-append.js +2 -1
  88. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  89. package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
  90. package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
  91. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  92. package/dist/esm/mcp/tools/rows-get.d.ts +2 -2
  93. package/dist/esm/mcp/tools/rows-get.js +2 -1
  94. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  95. package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
  96. package/dist/esm/mcp/tools/values-batch-update.js +3 -2
  97. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  98. package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
  99. package/dist/esm/mcp/tools/values-csv-update.js +3 -2
  100. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  101. package/dist/esm/mcp/tools/values-search.d.ts +2 -2
  102. package/dist/esm/mcp/tools/values-search.js +2 -1
  103. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  104. package/dist/esm/schemas/index.d.ts +1 -0
  105. package/dist/esm/schemas/index.js +9 -0
  106. package/dist/esm/schemas/index.js.map +1 -1
  107. package/dist/esm/setup/config.js +26 -14
  108. package/dist/esm/setup/config.js.map +1 -1
  109. package/dist/esm/setup/version-help.js +7 -0
  110. package/dist/esm/setup/version-help.js.map +1 -1
  111. package/dist/esm/spreadsheet/data-operations.js +47 -95
  112. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  113. package/dist/esm/spreadsheet/range-operations.d.ts +27 -5
  114. package/dist/esm/spreadsheet/range-operations.js +50 -27
  115. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  116. package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
  117. package/dist/esm/spreadsheet/sheet-operations.js +88 -79
  118. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  119. package/package.json +3 -3
@@ -1,5 +1,11 @@
1
1
  import type { sheets_v4 } from '@googleapis/sheets';
2
2
  import type { Logger } from '../types.js';
3
+ /**
4
+ * Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.
5
+ * The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),
6
+ * and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
7
+ */
8
+ export declare function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void>;
3
9
  export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
4
10
  sheetCreated: boolean;
5
11
  sheetGUID?: string;
@@ -1,4 +1,46 @@
1
1
  import { a1Col } from './column-utilities.js';
2
+ /**
3
+ * Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.
4
+ * The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),
5
+ * and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
6
+ */ export async function scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol, onRow) {
7
+ var _meta_data_sheets_find_properties_gridProperties, _meta_data_sheets_find_properties, _meta_data_sheets_find, _meta_data_sheets, _meta_data;
8
+ const chunkSize = 1000;
9
+ let startRow = 2; // Start from row 2 (after header)
10
+ // Bound the scan by the grid so a read error is never mistaken for end of data
11
+ const meta = await sheets.spreadsheets.get({
12
+ spreadsheetId,
13
+ fields: 'sheets.properties(title,gridProperties.rowCount)'
14
+ });
15
+ const rowCount = (_meta_data = meta.data) === null || _meta_data === void 0 ? void 0 : (_meta_data_sheets = _meta_data.sheets) === null || _meta_data_sheets === void 0 ? void 0 : (_meta_data_sheets_find = _meta_data_sheets.find((s)=>{
16
+ var _s_properties;
17
+ return ((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
18
+ })) === null || _meta_data_sheets_find === void 0 ? void 0 : (_meta_data_sheets_find_properties = _meta_data_sheets_find.properties) === null || _meta_data_sheets_find_properties === void 0 ? void 0 : (_meta_data_sheets_find_properties_gridProperties = _meta_data_sheets_find_properties.gridProperties) === null || _meta_data_sheets_find_properties_gridProperties === void 0 ? void 0 : _meta_data_sheets_find_properties_gridProperties.rowCount;
19
+ if (typeof rowCount !== 'number') {
20
+ throw new Error(`Could not read the row count of sheet "${sheetTitle}"`);
21
+ }
22
+ while(startRow <= rowCount){
23
+ const endRow = Math.min(startRow + chunkSize - 1, rowCount);
24
+ const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;
25
+ let rows;
26
+ try {
27
+ var _response_data;
28
+ const response = await sheets.spreadsheets.values.get({
29
+ spreadsheetId,
30
+ range,
31
+ majorDimension: 'ROWS'
32
+ });
33
+ rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
34
+ } catch (error) {
35
+ // The build target's Error constructor has no options argument, so set cause directly
36
+ const wrapped = new Error(`Failed to read key columns from ${range}: ${error instanceof Error ? error.message : String(error)}`);
37
+ wrapped.cause = error;
38
+ throw wrapped;
39
+ }
40
+ for(let i = 0; i < rows.length; i++)onRow(Array.isArray(rows[i]) ? rows[i] : [], startRow + i);
41
+ startRow = endRow + 1;
42
+ }
43
+ }
2
44
  export async function ensureSheetIfNeeded(sheets, id, sheetTitle, ensureSheet, headers, logger) {
3
45
  var _res_data_replies__addSheet_properties, _res_data_replies__addSheet, _res_data_replies_, _res_data_replies, _res_data;
4
46
  if (!sheetTitle) return {
@@ -181,6 +223,7 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
181
223
  if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');
182
224
  // Resolve the actual sheet title from sheetRef if provided
183
225
  let resolvedSheetTitle = sheetTitle;
226
+ let createTab = false;
184
227
  if (sheetRef) {
185
228
  const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);
186
229
  if (sheet) {
@@ -189,6 +232,7 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
189
232
  } else {
190
233
  // Sheet doesn't exist, use the sheetRef as the title for creation
191
234
  resolvedSheetTitle = sheetRef;
235
+ createTab = true;
192
236
  }
193
237
  }
194
238
  if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');
@@ -207,49 +251,30 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
207
251
  'body'
208
252
  ];
209
253
  const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
210
- let existingHeader = null;
211
- try {
212
- const resp = await sheets.spreadsheets.values.get({
254
+ if (createTab) {
255
+ await sheets.spreadsheets.batchUpdate({
213
256
  spreadsheetId,
214
- range: `${resolvedSheetTitle}!1:1`,
215
- majorDimension: 'ROWS'
216
- });
217
- const vr = resp.data;
218
- const values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
219
- existingHeader = values.length ? values : null;
220
- } catch (_err) {
221
- try {
222
- await sheets.spreadsheets.batchUpdate({
223
- spreadsheetId,
224
- requestBody: {
225
- requests: [
226
- {
227
- addSheet: {
228
- properties: {
229
- title: resolvedSheetTitle
230
- }
257
+ requestBody: {
258
+ requests: [
259
+ {
260
+ addSheet: {
261
+ properties: {
262
+ title: resolvedSheetTitle
231
263
  }
232
264
  }
233
- ]
234
- }
235
- });
236
- } catch {}
237
- await sheets.spreadsheets.values.append({
238
- spreadsheetId,
239
- range: `${resolvedSheetTitle}!A1`,
240
- valueInputOption: 'RAW',
241
- insertDataOption: 'INSERT_ROWS',
242
- requestBody: {
243
- values: [
244
- header
265
+ }
245
266
  ]
246
267
  }
247
268
  });
248
- return {
249
- header,
250
- keySet: new Set()
251
- };
252
269
  }
270
+ const resp = await sheets.spreadsheets.values.get({
271
+ spreadsheetId,
272
+ range: `${resolvedSheetTitle}!1:1`,
273
+ majorDimension: 'ROWS'
274
+ });
275
+ const vr = resp.data;
276
+ const values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
277
+ const existingHeader = values.length ? values : null;
253
278
  if (!existingHeader) {
254
279
  await sheets.spreadsheets.values.append({
255
280
  spreadsheetId,
@@ -288,8 +313,6 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
288
313
  });
289
314
  }
290
315
  const keySet = new Set();
291
- const chunkSize = 1000;
292
- let startRow = 2;
293
316
  const normalizeKeyColumnsByName = (kc, hdr)=>{
294
317
  if (!Array.isArray(kc) || kc.length === 0) return [];
295
318
  return kc.map((name)=>{
@@ -309,48 +332,34 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
309
332
  const maxIdx = Math.max(...validKeyIdxs);
310
333
  const startCol = a1Col(minIdx + 1);
311
334
  const endCol = a1Col(maxIdx + 1);
312
- while(true){
313
- const endRow = startRow + chunkSize - 1;
314
- const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;
315
- const respChunk = await sheets.spreadsheets.values.get({
316
- spreadsheetId,
317
- range,
318
- majorDimension: 'ROWS'
319
- });
320
- const vrChunk = respChunk.data;
321
- const chunkRows = (vrChunk === null || vrChunk === void 0 ? void 0 : vrChunk.values) || [];
322
- if (!chunkRows || chunkRows.length === 0) break;
323
- for (const r of chunkRows){
324
- const row = Array.isArray(r) ? r : [];
325
- // Use the same key generation logic as appendRows for consistency
326
- const lower = mergedHeader.map((h)=>String(h !== null && h !== void 0 ? h : '').toLowerCase());
327
- const provHeaderIdx = lower.indexOf('provider');
328
- let idHeaderIdx = lower.indexOf('messageid');
329
- if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');
330
- let compositeKey;
331
- if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {
332
- var _row_providerOffset, _row_idOffset;
333
- // Special case: if both provider and id columns exist, use them
334
- const providerOffset = provHeaderIdx - minIdx;
335
- const idOffset = idHeaderIdx - minIdx;
336
- const providerVal = providerOffset >= 0 ? String((_row_providerOffset = row[providerOffset]) !== null && _row_providerOffset !== void 0 ? _row_providerOffset : '').trim() : '';
337
- const messageVal = idOffset >= 0 ? String((_row_idOffset = row[idOffset]) !== null && _row_idOffset !== void 0 ? _row_idOffset : '').trim() : '';
338
- compositeKey = [
339
- providerVal,
340
- messageVal
341
- ].join('\\');
342
- } else {
343
- // General case: use the specified key columns
344
- const comps = keyColsIdx.map((i)=>{
345
- var _row_;
346
- return i < 0 ? '' : String((_row_ = row[i - minIdx]) !== null && _row_ !== void 0 ? _row_ : '').trim();
347
- });
348
- compositeKey = comps.join('\\');
349
- }
350
- if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
335
+ await scanKeyColumnRows(sheets, spreadsheetId, resolvedSheetTitle, startCol, endCol, (row)=>{
336
+ // Use the same key generation logic as appendRows for consistency
337
+ const lower = mergedHeader.map((h)=>String(h !== null && h !== void 0 ? h : '').toLowerCase());
338
+ const provHeaderIdx = lower.indexOf('provider');
339
+ let idHeaderIdx = lower.indexOf('messageid');
340
+ if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');
341
+ let compositeKey;
342
+ if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {
343
+ var _row_providerOffset, _row_idOffset;
344
+ // Special case: if both provider and id columns exist, use them
345
+ const providerOffset = provHeaderIdx - minIdx;
346
+ const idOffset = idHeaderIdx - minIdx;
347
+ const providerVal = providerOffset >= 0 ? String((_row_providerOffset = row[providerOffset]) !== null && _row_providerOffset !== void 0 ? _row_providerOffset : '').trim() : '';
348
+ const messageVal = idOffset >= 0 ? String((_row_idOffset = row[idOffset]) !== null && _row_idOffset !== void 0 ? _row_idOffset : '').trim() : '';
349
+ compositeKey = [
350
+ providerVal,
351
+ messageVal
352
+ ].join('\\');
353
+ } else {
354
+ // General case: use the specified key columns
355
+ const comps = keyColsIdx.map((i)=>{
356
+ var _row_;
357
+ return i < 0 ? '' : String((_row_ = row[i - minIdx]) !== null && _row_ !== void 0 ? _row_ : '').trim();
358
+ });
359
+ compositeKey = comps.join('\\');
351
360
  }
352
- startRow += chunkRows.length;
353
- }
361
+ if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
362
+ });
354
363
  return {
355
364
  header: mergedHeader,
356
365
  keySet,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n if (!sheetTitle) return { sheetCreated: false };\n const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n const ss = ssResp.data;\n const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n if (has) {\n const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n if (sid != null) result.sheetGUID = String(sid);\n if (headers) {\n try {\n const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n if (merged) result.headersEnsured = true;\n } catch (e) {\n logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n }\n }\n return result;\n }\n if (!ensureSheet) return { sheetCreated: false };\n\n const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n if (createdId != null) result.sheetGUID = String(createdId);\n if (createdId && headers) {\n try {\n const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n if (merged) result.headersEnsured = true;\n } catch (e) {\n logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n }\n }\n return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n const ssResp = await client.spreadsheets.get({ spreadsheetId });\n const sheets = ssResp.data?.sheets || [];\n const trimmedRef = sheetRef?.trim();\n\n logger.debug?.('findSheetByRef called', {\n spreadsheetId,\n sheetRef,\n trimmedRef,\n availableSheets: sheets.map((s) => ({\n title: s?.properties?.title,\n id: s?.properties?.sheetId,\n })),\n });\n\n if (!trimmedRef) {\n logger.warn?.('findSheetByRef empty sheetRef');\n return null;\n }\n\n // Strategy 1: Try exact title match first (most common case)\n const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n if (exactTitleMatch) {\n logger.debug?.('findSheetByRef exact title match found');\n return exactTitleMatch;\n }\n\n // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n if (exactGuidMatch) {\n logger.debug?.('findSheetByRef exact GUID match found');\n return exactGuidMatch;\n }\n\n // Strategy 3: Case-insensitive title match\n const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n if (caseInsensitiveMatch) {\n logger.debug?.('findSheetByRef case-insensitive title match found');\n return caseInsensitiveMatch;\n }\n\n // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n if (trimmedTitleMatch) {\n logger.debug?.('findSheetByRef trimmed title match found');\n return trimmedTitleMatch;\n }\n\n // Strategy 5: Case-insensitive + trimmed title match\n const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n if (caseInsensitiveTrimmedMatch) {\n logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n return caseInsensitiveTrimmedMatch;\n }\n\n // Strategy 6: Partial title match (last resort)\n const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n if (partialMatch) {\n logger.debug?.('findSheetByRef partial title match found');\n return partialMatch;\n }\n\n logger.warn?.('findSheetByRef no match found', {\n searchRef: trimmedRef,\n availableTitles: sheets.map((s) => s?.properties?.title),\n availableIds: sheets.map((s) => s?.properties?.sheetId),\n });\n return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n requiredHeader = null as string[] | null,\n keyColumns = ['id'] as string[],\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n requiredHeader?: string[] | null;\n keyColumns?: string[];\n logger: Logger;\n }\n) {\n if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: 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 for creation\n resolvedSheetTitle = sheetRef;\n }\n }\n\n if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n let existingHeader: string[] | null = null;\n try {\n const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n const vr = resp.data as ValueRange;\n const values = ((vr?.values || [])[0] || []) as string[];\n existingHeader = values.length ? values : null;\n } catch (_err: unknown) {\n try {\n await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n } catch {}\n await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n return { header, keySet: new Set<string>() };\n }\n\n if (!existingHeader) {\n await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n return { header, keySet: new Set<string>() };\n }\n\n const mergedHeader = existingHeader.slice();\n for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n if (Array.isArray(keyColumns)) {\n for (const name of keyColumns) {\n if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n if (!mergedHeader.includes(name)) mergedHeader.push(name);\n }\n }\n\n if (mergedHeader.length !== existingHeader.length) {\n await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n }\n\n const keySet = new Set<string>();\n const chunkSize = 1000;\n let startRow = 2;\n\n const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n return kc.map((name) => {\n if (typeof name !== 'string' || name.length === 0) return -1;\n const idx = hdr.indexOf(name);\n return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n });\n };\n\n const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n const minIdx = Math.min(...validKeyIdxs);\n const maxIdx = Math.max(...validKeyIdxs);\n const startCol = a1Col(minIdx + 1);\n const endCol = a1Col(maxIdx + 1);\n\n while (true) {\n const endRow = startRow + chunkSize - 1;\n const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n const respChunk = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n const vrChunk = respChunk.data as ValueRange;\n const chunkRows = (vrChunk?.values || []) as string[][];\n if (!chunkRows || chunkRows.length === 0) break;\n for (const r of chunkRows) {\n const row = Array.isArray(r) ? r : [];\n\n // Use the same key generation logic as appendRows for consistency\n const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n const provHeaderIdx = lower.indexOf('provider');\n let idHeaderIdx = lower.indexOf('messageid');\n if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n let compositeKey: string;\n\n if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n // Special case: if both provider and id columns exist, use them\n const providerOffset = provHeaderIdx - minIdx;\n const idOffset = idHeaderIdx - minIdx;\n const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n compositeKey = [providerVal, messageVal].join('\\\\');\n } else {\n // General case: use the specified key columns\n const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n compositeKey = comps.join('\\\\');\n }\n\n if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n }\n startRow += chunkRows.length;\n }\n return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["a1Col","ensureSheetIfNeeded","sheets","id","sheetTitle","ensureSheet","headers","logger","res","sheetCreated","ssResp","spreadsheets","get","spreadsheetId","ss","data","has","Array","isArray","some","s","properties","title","sid","find","sheetId","result","sheetGUID","String","header","merged","ensureTabAndHeaders","requiredHeader","headersEnsured","e","warn","batchUpdate","requestBody","requests","addSheet","createdId","replies","findSheetByRef","client","sheetRef","trimmedRef","trim","debug","availableSheets","map","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","toLowerCase","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","includes","searchRef","availableTitles","availableIds","keyColumns","Error","resolvedSheetTitle","sheet","defaultHeader","length","existingHeader","resp","values","range","majorDimension","vr","_err","append","valueInputOption","insertDataOption","keySet","Set","mergedHeader","slice","col","push","name","update","chunkSize","startRow","normalizeKeyColumnsByName","kc","hdr","idx","indexOf","Number","isInteger","keyColsIdx","validKeyIdxs","filter","i","keyColumnsIdx","minIdx","Math","min","maxIdx","max","startCol","endCol","endRow","respChunk","vrChunk","chunkRows","r","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\n/**\n * Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.\n * The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),\n * and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.\n */\nexport async function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void> {\n const chunkSize = 1000;\n let startRow = 2; // Start from row 2 (after header)\n\n // Bound the scan by the grid so a read error is never mistaken for end of data\n const meta = await sheets.spreadsheets.get({ spreadsheetId, fields: 'sheets.properties(title,gridProperties.rowCount)' });\n const rowCount = meta.data?.sheets?.find((s) => s.properties?.title === sheetTitle)?.properties?.gridProperties?.rowCount;\n if (typeof rowCount !== 'number') {\n throw new Error(`Could not read the row count of sheet \"${sheetTitle}\"`);\n }\n\n while (startRow <= rowCount) {\n const endRow = Math.min(startRow + chunkSize - 1, rowCount);\n const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n let rows: string[][];\n try {\n const response = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n rows = (response.data?.values || []) as string[][];\n } catch (error) {\n // The build target's Error constructor has no options argument, so set cause directly\n const wrapped = new Error(`Failed to read key columns from ${range}: ${error instanceof Error ? error.message : String(error)}`) as Error & { cause?: unknown };\n wrapped.cause = error;\n throw wrapped;\n }\n\n for (let i = 0; i < rows.length; i++) onRow(Array.isArray(rows[i]) ? rows[i] : [], startRow + i);\n\n startRow = endRow + 1;\n }\n}\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n if (!sheetTitle) return { sheetCreated: false };\n const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n const ss = ssResp.data;\n const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n if (has) {\n const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n if (sid != null) result.sheetGUID = String(sid);\n if (headers) {\n try {\n const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n if (merged) result.headersEnsured = true;\n } catch (e) {\n logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n }\n }\n return result;\n }\n if (!ensureSheet) return { sheetCreated: false };\n\n const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n if (createdId != null) result.sheetGUID = String(createdId);\n if (createdId && headers) {\n try {\n const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n if (merged) result.headersEnsured = true;\n } catch (e) {\n logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n }\n }\n return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n const ssResp = await client.spreadsheets.get({ spreadsheetId });\n const sheets = ssResp.data?.sheets || [];\n const trimmedRef = sheetRef?.trim();\n\n logger.debug?.('findSheetByRef called', {\n spreadsheetId,\n sheetRef,\n trimmedRef,\n availableSheets: sheets.map((s) => ({\n title: s?.properties?.title,\n id: s?.properties?.sheetId,\n })),\n });\n\n if (!trimmedRef) {\n logger.warn?.('findSheetByRef empty sheetRef');\n return null;\n }\n\n // Strategy 1: Try exact title match first (most common case)\n const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n if (exactTitleMatch) {\n logger.debug?.('findSheetByRef exact title match found');\n return exactTitleMatch;\n }\n\n // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n if (exactGuidMatch) {\n logger.debug?.('findSheetByRef exact GUID match found');\n return exactGuidMatch;\n }\n\n // Strategy 3: Case-insensitive title match\n const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n if (caseInsensitiveMatch) {\n logger.debug?.('findSheetByRef case-insensitive title match found');\n return caseInsensitiveMatch;\n }\n\n // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n if (trimmedTitleMatch) {\n logger.debug?.('findSheetByRef trimmed title match found');\n return trimmedTitleMatch;\n }\n\n // Strategy 5: Case-insensitive + trimmed title match\n const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n if (caseInsensitiveTrimmedMatch) {\n logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n return caseInsensitiveTrimmedMatch;\n }\n\n // Strategy 6: Partial title match (last resort)\n const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n if (partialMatch) {\n logger.debug?.('findSheetByRef partial title match found');\n return partialMatch;\n }\n\n logger.warn?.('findSheetByRef no match found', {\n searchRef: trimmedRef,\n availableTitles: sheets.map((s) => s?.properties?.title),\n availableIds: sheets.map((s) => s?.properties?.sheetId),\n });\n return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n sheetRef,\n requiredHeader = null as string[] | null,\n keyColumns = ['id'] as string[],\n logger,\n }: {\n spreadsheetId: string;\n sheetTitle?: string;\n sheetRef?: string;\n requiredHeader?: string[] | null;\n keyColumns?: string[];\n logger: Logger;\n }\n) {\n if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');\n\n // Resolve the actual sheet title from sheetRef if provided\n let resolvedSheetTitle = sheetTitle;\n let createTab = false;\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 for creation\n resolvedSheetTitle = sheetRef;\n createTab = true;\n }\n }\n\n if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n if (createTab) {\n await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n }\n\n const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n const vr = resp.data as ValueRange;\n const values = ((vr?.values || [])[0] || []) as string[];\n const existingHeader: string[] | null = values.length ? values : null;\n\n if (!existingHeader) {\n await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n return { header, keySet: new Set<string>() };\n }\n\n const mergedHeader = existingHeader.slice();\n for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n if (Array.isArray(keyColumns)) {\n for (const name of keyColumns) {\n if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n if (!mergedHeader.includes(name)) mergedHeader.push(name);\n }\n }\n\n if (mergedHeader.length !== existingHeader.length) {\n await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n }\n\n const keySet = new Set<string>();\n\n const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n return kc.map((name) => {\n if (typeof name !== 'string' || name.length === 0) return -1;\n const idx = hdr.indexOf(name);\n return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n });\n };\n\n const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n const minIdx = Math.min(...validKeyIdxs);\n const maxIdx = Math.max(...validKeyIdxs);\n const startCol = a1Col(minIdx + 1);\n const endCol = a1Col(maxIdx + 1);\n\n await scanKeyColumnRows(sheets, spreadsheetId, resolvedSheetTitle, startCol, endCol, (row) => {\n // Use the same key generation logic as appendRows for consistency\n const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n const provHeaderIdx = lower.indexOf('provider');\n let idHeaderIdx = lower.indexOf('messageid');\n if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n let compositeKey: string;\n\n if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n // Special case: if both provider and id columns exist, use them\n const providerOffset = provHeaderIdx - minIdx;\n const idOffset = idHeaderIdx - minIdx;\n const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n compositeKey = [providerVal, messageVal].join('\\\\');\n } else {\n // General case: use the specified key columns\n const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n compositeKey = comps.join('\\\\');\n }\n\n if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n });\n return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["a1Col","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","spreadsheets","get","fields","rowCount","data","find","s","properties","title","gridProperties","Error","endRow","Math","min","range","rows","response","values","majorDimension","error","wrapped","message","String","cause","i","length","Array","isArray","ensureSheetIfNeeded","id","ensureSheet","headers","logger","res","sheetCreated","ssResp","ss","has","some","sid","sheetId","result","sheetGUID","header","merged","ensureTabAndHeaders","requiredHeader","headersEnsured","e","warn","batchUpdate","requestBody","requests","addSheet","createdId","replies","findSheetByRef","client","sheetRef","trimmedRef","trim","debug","availableSheets","map","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","toLowerCase","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","includes","searchRef","availableTitles","availableIds","keyColumns","resolvedSheetTitle","createTab","sheet","defaultHeader","resp","vr","existingHeader","append","valueInputOption","insertDataOption","keySet","Set","mergedHeader","slice","col","push","name","update","normalizeKeyColumnsByName","kc","hdr","idx","indexOf","Number","isInteger","keyColsIdx","validKeyIdxs","filter","keyColumnsIdx","minIdx","maxIdx","max","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-z/mcp-sheets",
3
- "version": "2.4.2",
3
+ "version": "2.5.1",
4
4
  "description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
5
5
  "keywords": [
6
6
  "sheets",
@@ -69,11 +69,11 @@
69
69
  "version": "tsds version"
70
70
  },
71
71
  "dependencies": {
72
- "@googleapis/drive": "^26.0.0",
72
+ "@googleapis/drive": "^27.1.0",
73
73
  "@googleapis/sheets": "^18.0.0",
74
74
  "@mcp-z/oauth": "^2.0.0",
75
75
  "@mcp-z/oauth-google": "^2.0.1",
76
- "@mcp-z/server": "^2.2.0",
76
+ "@mcp-z/server": "^2.3.0",
77
77
  "cors": "^2.0.0",
78
78
  "csv-parse": "^7.0.2",
79
79
  "express": "^5.0.0",