@mcp-z/mcp-sheets 2.6.0 → 2.6.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 (34) hide show
  1. package/dist/cjs/mcp/tools/columns-update.js +5 -1
  2. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  3. package/dist/cjs/mcp/tools/rows-append.js +1 -2
  4. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  5. package/dist/cjs/mcp/tools/rows-csv-append.js +1 -2
  6. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  7. package/dist/cjs/spreadsheet/data-operations.d.cts +8 -1
  8. package/dist/cjs/spreadsheet/data-operations.d.ts +8 -1
  9. package/dist/cjs/spreadsheet/data-operations.js +79 -101
  10. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  11. package/dist/cjs/spreadsheet/range-operations.d.cts +0 -67
  12. package/dist/cjs/spreadsheet/range-operations.d.ts +0 -67
  13. package/dist/cjs/spreadsheet/range-operations.js +0 -236
  14. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  15. package/dist/cjs/spreadsheet/sheet-operations.d.cts +4 -17
  16. package/dist/cjs/spreadsheet/sheet-operations.d.ts +4 -17
  17. package/dist/cjs/spreadsheet/sheet-operations.js +17 -221
  18. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  19. package/dist/esm/mcp/tools/columns-update.js +5 -1
  20. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  21. package/dist/esm/mcp/tools/rows-append.js +1 -2
  22. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  23. package/dist/esm/mcp/tools/rows-csv-append.js +1 -2
  24. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  25. package/dist/esm/spreadsheet/data-operations.d.ts +8 -1
  26. package/dist/esm/spreadsheet/data-operations.js +27 -35
  27. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  28. package/dist/esm/spreadsheet/range-operations.d.ts +0 -67
  29. package/dist/esm/spreadsheet/range-operations.js +0 -227
  30. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  31. package/dist/esm/spreadsheet/sheet-operations.d.ts +4 -17
  32. package/dist/esm/spreadsheet/sheet-operations.js +7 -115
  33. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  34. package/package.json +1 -1
@@ -9,9 +9,6 @@ function _export(target, all) {
9
9
  });
10
10
  }
11
11
  _export(exports, {
12
- get ensureSheetIfNeeded () {
13
- return ensureSheetIfNeeded;
14
- },
15
12
  get ensureTabAndHeaders () {
16
13
  return ensureTabAndHeaders;
17
14
  },
@@ -258,158 +255,6 @@ function scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol,
258
255
  });
259
256
  })();
260
257
  }
261
- function ensureSheetIfNeeded(sheets, id, sheetTitle, ensureSheet, headers, logger) {
262
- return _async_to_generator(function() {
263
- var _res_data_replies__addSheet_properties, _res_data_replies__addSheet, _res_data_replies_, _res_data_replies, _res_data, ssResp, ss, has, _ss_sheets_find_properties, _ss_sheets_find, _ss_sheets, sid, result, _ref, merged, e, _logger_warn, res, createdId, result1, _ref1, merged1, e1, _logger_warn1;
264
- return _ts_generator(this, function(_state) {
265
- switch(_state.label){
266
- case 0:
267
- if (!sheetTitle) return [
268
- 2,
269
- {
270
- sheetCreated: false
271
- }
272
- ];
273
- return [
274
- 4,
275
- sheets.spreadsheets.get({
276
- spreadsheetId: id
277
- })
278
- ];
279
- case 1:
280
- ssResp = _state.sent();
281
- ss = ssResp.data;
282
- has = Array.isArray(ss === null || ss === void 0 ? void 0 : ss.sheets) && ss.sheets.some(function(s) {
283
- var _s_properties;
284
- return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
285
- });
286
- if (!has) return [
287
- 3,
288
- 6
289
- ];
290
- sid = (_ss_sheets = ss.sheets) === null || _ss_sheets === void 0 ? void 0 : (_ss_sheets_find = _ss_sheets.find(function(s) {
291
- var _s_properties;
292
- return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
293
- })) === null || _ss_sheets_find === void 0 ? void 0 : (_ss_sheets_find_properties = _ss_sheets_find.properties) === null || _ss_sheets_find_properties === void 0 ? void 0 : _ss_sheets_find_properties.sheetId;
294
- result = {
295
- sheetCreated: false
296
- };
297
- if (sid != null) result.sheetGUID = String(sid);
298
- if (!headers) return [
299
- 3,
300
- 5
301
- ];
302
- _state.label = 2;
303
- case 2:
304
- _state.trys.push([
305
- 2,
306
- 4,
307
- ,
308
- 5
309
- ]);
310
- return [
311
- 4,
312
- ensureTabAndHeaders(sheets, {
313
- spreadsheetId: id,
314
- sheetTitle: sheetTitle,
315
- requiredHeader: headers,
316
- logger: logger
317
- })
318
- ];
319
- case 3:
320
- _ref = _state.sent(), merged = _ref.header;
321
- if (merged) result.headersEnsured = true;
322
- return [
323
- 3,
324
- 5
325
- ];
326
- case 4:
327
- e = _state.sent();
328
- (_logger_warn = logger.warn) === null || _logger_warn === void 0 ? void 0 : _logger_warn.call(logger, 'ensureTabAndHeaders after sheet creation failed', e);
329
- return [
330
- 3,
331
- 5
332
- ];
333
- case 5:
334
- return [
335
- 2,
336
- result
337
- ];
338
- case 6:
339
- if (!ensureSheet) return [
340
- 2,
341
- {
342
- sheetCreated: false
343
- }
344
- ];
345
- return [
346
- 4,
347
- sheets.spreadsheets.batchUpdate({
348
- spreadsheetId: id,
349
- requestBody: {
350
- requests: [
351
- {
352
- addSheet: {
353
- properties: {
354
- title: sheetTitle
355
- }
356
- }
357
- }
358
- ]
359
- }
360
- })
361
- ];
362
- case 7:
363
- res = _state.sent();
364
- createdId = (_res_data = res.data) === null || _res_data === void 0 ? void 0 : (_res_data_replies = _res_data.replies) === null || _res_data_replies === void 0 ? void 0 : (_res_data_replies_ = _res_data_replies[0]) === null || _res_data_replies_ === void 0 ? void 0 : (_res_data_replies__addSheet = _res_data_replies_.addSheet) === null || _res_data_replies__addSheet === void 0 ? void 0 : (_res_data_replies__addSheet_properties = _res_data_replies__addSheet.properties) === null || _res_data_replies__addSheet_properties === void 0 ? void 0 : _res_data_replies__addSheet_properties.sheetId;
365
- result1 = {
366
- sheetCreated: !!createdId
367
- };
368
- if (createdId != null) result1.sheetGUID = String(createdId);
369
- if (!(createdId && headers)) return [
370
- 3,
371
- 11
372
- ];
373
- _state.label = 8;
374
- case 8:
375
- _state.trys.push([
376
- 8,
377
- 10,
378
- ,
379
- 11
380
- ]);
381
- return [
382
- 4,
383
- ensureTabAndHeaders(sheets, {
384
- spreadsheetId: id,
385
- sheetTitle: sheetTitle,
386
- requiredHeader: headers,
387
- logger: logger
388
- })
389
- ];
390
- case 9:
391
- _ref1 = _state.sent(), merged1 = _ref1.header;
392
- if (merged1) result1.headersEnsured = true;
393
- return [
394
- 3,
395
- 11
396
- ];
397
- case 10:
398
- e1 = _state.sent();
399
- (_logger_warn1 = logger.warn) === null || _logger_warn1 === void 0 ? void 0 : _logger_warn1.call(logger, 'ensureTabAndHeaders after sheet creation failed', e1);
400
- return [
401
- 3,
402
- 11
403
- ];
404
- case 11:
405
- return [
406
- 2,
407
- result1
408
- ];
409
- }
410
- });
411
- })();
412
- }
413
258
  function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
414
259
  return _async_to_generator(function() {
415
260
  var _ssResp_data, _logger_debug, _logger_warn, ssResp, sheets, trimmedRef, _logger_warn1, exactTitleMatch, _logger_debug1, exactGuidMatch, _logger_debug2, caseInsensitiveMatch, _logger_debug3, trimmedTitleMatch, _logger_debug4, caseInsensitiveTrimmedMatch, _logger_debug5, partialMatch, _logger_debug6;
@@ -545,40 +390,16 @@ function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
545
390
  }
546
391
  function ensureTabAndHeaders(_0, _1) {
547
392
  return _async_to_generator(function(sheets, param) {
548
- var spreadsheetId, sheetTitle, sheetRef, _param_requiredHeader, requiredHeader, _param_keyColumns, keyColumns, logger, _Math, _Math1, resolvedSheetTitle, createTab, sheet, _sheet_properties, defaultHeader, header, resp, vr, values, existingHeader, mergedHeader, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, col, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, name, keySet, normalizeKeyColumnsByName, keyColsIdx, validKeyIdxs, minIdx, maxIdx, startCol, endCol;
393
+ var spreadsheetId, sheetTitle, _param_requiredHeader, requiredHeader, _param_keyColumns, keyColumns, _Math, _Math1, defaultHeader, header, resp, vr, values, existingHeader, mergedHeader, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, col, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, name, keySet, normalizeKeyColumnsByName, keyColsIdx, validKeyIdxs, minIdx, maxIdx, startCol, endCol;
549
394
  return _ts_generator(this, function(_state) {
550
395
  switch(_state.label){
551
396
  case 0:
552
- spreadsheetId = param.spreadsheetId, sheetTitle = param.sheetTitle, sheetRef = param.sheetRef, _param_requiredHeader = param.requiredHeader, requiredHeader = _param_requiredHeader === void 0 ? null : _param_requiredHeader, _param_keyColumns = param.keyColumns, keyColumns = _param_keyColumns === void 0 ? [
397
+ spreadsheetId = param.spreadsheetId, sheetTitle = param.sheetTitle, _param_requiredHeader = param.requiredHeader, requiredHeader = _param_requiredHeader === void 0 ? null : _param_requiredHeader, _param_keyColumns = param.keyColumns, keyColumns = _param_keyColumns === void 0 ? [
553
398
  'id'
554
- ] : _param_keyColumns, logger = param.logger;
399
+ ] : _param_keyColumns;
555
400
  if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');
556
401
  if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');
557
- if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');
558
- // Resolve the actual sheet title from sheetRef if provided
559
- resolvedSheetTitle = sheetTitle;
560
- createTab = false;
561
- if (!sheetRef) return [
562
- 3,
563
- 2
564
- ];
565
- return [
566
- 4,
567
- findSheetByRef(sheets, spreadsheetId, sheetRef, logger)
568
- ];
569
- case 1:
570
- sheet = _state.sent();
571
- if (sheet) {
572
- ;
573
- resolvedSheetTitle = ((_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) || sheetRef;
574
- } else {
575
- // Sheet doesn't exist, use the sheetRef as the title for creation
576
- resolvedSheetTitle = sheetRef;
577
- createTab = true;
578
- }
579
- _state.label = 2;
580
- case 2:
581
- if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');
402
+ if (!sheetTitle) throw new Error('ensureTabAndHeaders: sheetTitle is required');
582
403
  defaultHeader = [
583
404
  'id',
584
405
  'provider',
@@ -594,53 +415,28 @@ function ensureTabAndHeaders(_0, _1) {
594
415
  'body'
595
416
  ];
596
417
  header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
597
- if (!createTab) return [
598
- 3,
599
- 4
600
- ];
601
- return [
602
- 4,
603
- sheets.spreadsheets.batchUpdate({
604
- spreadsheetId: spreadsheetId,
605
- requestBody: {
606
- requests: [
607
- {
608
- addSheet: {
609
- properties: {
610
- title: resolvedSheetTitle
611
- }
612
- }
613
- }
614
- ]
615
- }
616
- })
617
- ];
618
- case 3:
619
- _state.sent();
620
- _state.label = 4;
621
- case 4:
622
418
  return [
623
419
  4,
624
420
  sheets.spreadsheets.values.get({
625
421
  spreadsheetId: spreadsheetId,
626
- range: "".concat(resolvedSheetTitle, "!1:1"),
422
+ range: "".concat(sheetTitle, "!1:1"),
627
423
  majorDimension: 'ROWS'
628
424
  })
629
425
  ];
630
- case 5:
426
+ case 1:
631
427
  resp = _state.sent();
632
428
  vr = resp.data;
633
429
  values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
634
430
  existingHeader = values.length ? values : null;
635
431
  if (!!existingHeader) return [
636
432
  3,
637
- 7
433
+ 3
638
434
  ];
639
435
  return [
640
436
  4,
641
437
  sheets.spreadsheets.values.append({
642
438
  spreadsheetId: spreadsheetId,
643
- range: "".concat(resolvedSheetTitle, "!A1"),
439
+ range: "".concat(sheetTitle, "!A1"),
644
440
  valueInputOption: 'RAW',
645
441
  insertDataOption: 'INSERT_ROWS',
646
442
  requestBody: {
@@ -650,7 +446,7 @@ function ensureTabAndHeaders(_0, _1) {
650
446
  }
651
447
  })
652
448
  ];
653
- case 6:
449
+ case 2:
654
450
  _state.sent();
655
451
  return [
656
452
  2,
@@ -659,7 +455,7 @@ function ensureTabAndHeaders(_0, _1) {
659
455
  keySet: new Set()
660
456
  }
661
457
  ];
662
- case 7:
458
+ case 3:
663
459
  mergedHeader = existingHeader.slice();
664
460
  _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
665
461
  try {
@@ -706,13 +502,13 @@ function ensureTabAndHeaders(_0, _1) {
706
502
  }
707
503
  if (!(mergedHeader.length !== existingHeader.length)) return [
708
504
  3,
709
- 9
505
+ 5
710
506
  ];
711
507
  return [
712
508
  4,
713
509
  sheets.spreadsheets.values.update({
714
510
  spreadsheetId: spreadsheetId,
715
- range: "".concat(resolvedSheetTitle, "!1:1"),
511
+ range: "".concat(sheetTitle, "!1:1"),
716
512
  valueInputOption: 'RAW',
717
513
  requestBody: {
718
514
  values: [
@@ -721,10 +517,10 @@ function ensureTabAndHeaders(_0, _1) {
721
517
  }
722
518
  })
723
519
  ];
724
- case 8:
520
+ case 4:
725
521
  _state.sent();
726
- _state.label = 9;
727
- case 9:
522
+ _state.label = 5;
523
+ case 5:
728
524
  keySet = new Set();
729
525
  normalizeKeyColumnsByName = function normalizeKeyColumnsByName(kc, hdr) {
730
526
  if (!Array.isArray(kc) || kc.length === 0) return [];
@@ -752,7 +548,7 @@ function ensureTabAndHeaders(_0, _1) {
752
548
  endCol = (0, _columnutilitiests.a1Col)(maxIdx + 1);
753
549
  return [
754
550
  4,
755
- scanKeyColumnRows(sheets, spreadsheetId, resolvedSheetTitle, startCol, endCol, function(row) {
551
+ scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol, function(row) {
756
552
  // Use the same key generation logic as appendRows for consistency
757
553
  var lower = mergedHeader.map(function(h) {
758
554
  return String(h !== null && h !== void 0 ? h : '').toLowerCase();
@@ -783,7 +579,7 @@ function ensureTabAndHeaders(_0, _1) {
783
579
  if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
784
580
  })
785
581
  ];
786
- case 10:
582
+ case 6:
787
583
  _state.sent();
788
584
  return [
789
585
  2,
@@ -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\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":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","rowCount","endRow","range","rows","response","error","wrapped","i","spreadsheets","get","fields","data","find","s","properties","title","gridProperties","Error","Math","min","values","majorDimension","message","String","cause","length","Array","isArray","id","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","some","sheetId","sheetGUID","requiredHeader","header","headersEnsured","warn","batchUpdate","requestBody","requests","addSheet","replies","client","sheetRef","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","toLowerCase","includes","searchRef","availableTitles","availableIds","keyColumns","resolvedSheetTitle","createTab","sheet","defaultHeader","resp","vr","existingHeader","mergedHeader","col","name","keySet","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","keyColumnsIdx","max","a1Col","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 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\nexport async function ensureTabAndHeaders(\n sheets: sheets_v4.Sheets,\n {\n spreadsheetId,\n sheetTitle,\n requiredHeader = null as string[] | null,\n keyColumns = ['id'] as string[],\n }: {\n spreadsheetId: string;\n sheetTitle: string;\n requiredHeader?: string[] | null;\n keyColumns?: string[];\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) throw new Error('ensureTabAndHeaders: sheetTitle is required');\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 const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${sheetTitle}!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: `${sheetTitle}!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: `${sheetTitle}!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, sheetTitle, 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":["ensureTabAndHeaders","findSheetByRef","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","rowCount","endRow","range","rows","response","error","wrapped","i","spreadsheets","get","fields","data","find","s","properties","title","gridProperties","Error","Math","min","values","majorDimension","message","String","cause","length","Array","isArray","client","sheetRef","logger","ssResp","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","id","sheetId","warn","toLowerCase","includes","searchRef","availableTitles","availableIds","requiredHeader","keyColumns","defaultHeader","header","resp","vr","existingHeader","mergedHeader","col","name","keySet","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","append","valueInputOption","insertDataOption","requestBody","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","keyColumnsIdx","max","a1Col","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
@@ -6,7 +6,7 @@ import { z } from 'zod';
6
6
  import { NATIVE_DATE_POINTER } from '../../constants.js';
7
7
  import { googleAuth } from '../../lib/google-auth.js';
8
8
  import { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
9
- import { generateRowKey, snapshotHeaderKeysAndPositions, upsertByKey } from '../../spreadsheet/data-operations.js';
9
+ import { allWritesFailed, generateRowKey, snapshotHeaderKeysAndPositions, upsertByKey } from '../../spreadsheet/data-operations.js';
10
10
  // Input schema for columns update requests with enhanced validation
11
11
  const inputSchema = z.object({
12
12
  id: SpreadsheetIdSchema,
@@ -239,6 +239,10 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
239
239
  options: upsertOptions,
240
240
  logger
241
241
  });
242
+ if (allWritesFailed(upsertResult)) {
243
+ var _upsertResult_errors1;
244
+ throw new Error(`every write failed: ${(_upsertResult_errors1 = upsertResult.errors) === null || _upsertResult_errors1 === void 0 ? void 0 : _upsertResult_errors1.join('; ')}`);
245
+ }
242
246
  // Track headers that were added (if any)
243
247
  // This would require additional logic in upsertByKey to return added headers
244
248
  const headersAdded = [];
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { allWritesFailed, generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n if (allWritesFailed(upsertResult)) {\n throw new Error(`every write failed: ${upsertResult.errors?.join('; ')}`);\n }\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","allWritesFailed","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","Error","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,SAASA,UAAUC,SAAS,QAAQ,qBAAqB;AAEzD,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,qBAAqB;AACzD,SAASC,UAAU,QAAQ,2BAA2B;AACtD,SAASC,eAAe,EAAEC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AACnI,SAASC,eAAe,EAAEC,cAAc,EAAwCC,8BAA8B,EAAsBC,WAAW,QAAQ,uCAAuC;AAE9L,oEAAoE;AACpE,MAAMC,cAAcZ,EACjBa,MAAM,CAAC;IACNC,IAAIP;IACJQ,KAAKV;IACLW,MAAMhB,EAAEiB,KAAK,CAACjB,EAAEiB,KAAK,CAACd,kBAAkBe,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMC,QAAQ,CAAC;IAClEC,SAASrB,EAAEiB,KAAK,CAACjB,EAAEsB,MAAM,GAAGJ,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMD,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IACrEG,UAAUvB,EAAEiB,KAAK,CAACjB,EAAEsB,MAAM,GAAGJ,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMD,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IACtEI,UAAUxB,EACPyB,IAAI,CAAC;QAAC;QAAiB;QAAe;KAAW,EACjDC,OAAO,CAAC,iBACRN,QAAQ,CAAC;IACZO,kBAAkB3B,EAAEyB,IAAI,CAAC;QAAC;QAAO;KAAe,EAAEC,OAAO,CAAC,gBAAgBN,QAAQ,CAAC;AACrF,GACCQ,MAAM,CACL,CAACC;IACC,sDAAsD;IACtD,MAAMC,iBAAiBD,KAAKN,QAAQ,CAACQ,MAAM,CAAC,CAACC,MAAQ,CAACH,KAAKR,OAAO,CAACY,QAAQ,CAACD;IAC5E,OAAOF,eAAeI,MAAM,KAAK;AACnC,GACA;IACEC,SAAS;IACTC,MAAM;QAAC;KAAW;AACpB,GAEDR,MAAM,CACL,CAACC;IACC,yDAAyD;IACzD,MAAMQ,cAAcR,KAAKb,IAAI,CAACsB,SAAS,CAAC,CAACC,MAAQA,IAAIL,MAAM,KAAKL,KAAKR,OAAO,CAACa,MAAM;IACnF,OAAOG,gBAAgB,CAAC;AAC1B,GACA;IACEF,SAAS;IACTC,MAAM;QAAC;KAAO;AAChB,GAEDR,MAAM,CACL,CAACC;IACC,4CAA4C;IAC5C,MAAMW,gBAAgB,IAAIC,IAAIZ,KAAKN,QAAQ;IAC3C,OAAOiB,cAAcE,IAAI,KAAKb,KAAKN,QAAQ,CAACW,MAAM;AACpD,GACA;IACEC,SAAS;IACTC,MAAM;QAAC;KAAW;AACpB;AAGJ,wBAAwB;AACxB,MAAMO,sBAAsB3C,EAAEa,MAAM,CAAC;IACnC+B,MAAM5C,EAAE6C,OAAO,CAAC;IAChB/B,IAAIR;IACJS,KAAKX;IACL0C,kBAAkB9C,EAAEsB,MAAM,GAAGF,QAAQ,CAAC;IACtC2B,gBAAgB/C,EAAEsB,MAAM,GAAGF,QAAQ,CAAC;IACpC4B,YAAYhD,EAAEsB,MAAM,GAAGF,QAAQ,CAAC;IAChC6B,UAAUjD,EAAEsB,MAAM,GAAGF,QAAQ,CAAC;IAC9B8B,aAAalD,EAAEmD,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGjC,QAAQ,CAAC;IACrDkC,cAActD,EAAEiB,KAAK,CAACjB,EAAEsB,MAAM,IAAIF,QAAQ,CAAC;IAC3CmC,aAAavD,EAAEmD,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGjC,QAAQ,CAAC;IACrDoC,cAAcxD,EAAEiB,KAAK,CAACjB,EAAEsB,MAAM,IAAIF,QAAQ,CAAC;IAC3CqC,QAAQzD,EAAEiB,KAAK,CAACjB,EAAEsB,MAAM,IAAIoC,QAAQ,GAAGtC,QAAQ,CAAC;AAClD;AAEA,MAAMuC,eAAe3D,EAAE4D,kBAAkB,CAAC,QAAQ;IAACjB;IAAqB9C;CAAyB;AAEjG,MAAMgE,SAAS;IACbC,aAAa,CAAC,6QAA6Q,EAAE7D,qBAAqB;IAClTW;IACA+C,cAAc3D,EAAEa,MAAM,CAAC;QACrBkD,QAAQJ;IACV;AACF;AAKA,sDAAsD;AACtD,SAASK,yBAAyBzB,GAAQ,EAAElB,OAAiB,EAAE4C,QAA+B;IAC5F,OAAOxD,eAAe8B,KAAKlB,SAAS4C;AACtC;AAEA,eAAeC,QAAQ,EAAEpD,EAAE,EAAEC,GAAG,EAAEC,IAAI,EAAEK,OAAO,EAAEE,QAAQ,EAAEC,WAAW,eAAe,EAAEG,mBAAmB,cAAc,EAAS,EAAEwC,KAAoB;QAErJC;IADA,MAAMA,SAASD,MAAMC,MAAM;KAC3BA,gBAAAA,OAAOC,KAAK,cAAZD,oCAAAA,mBAAAA,QAAe,gCAAgC;QAC7CtD;QACAC;QACAuD,UAAUtD,KAAKkB,MAAM;QACrBqC,aAAalD,QAAQa,MAAM;QAC3BsC,iBAAiBjD;QACjBC;QACAG;IACF;IAEA,IAAI;kBAiCqB8C,iCASJC,yBACFA;YAXQD,6BAIXA,yBA0EdL,gBAqCeO,sBANfP;QA5IA,MAAM1E,SAASC,UAAU;YAAEiF,SAAS;YAAMC,MAAM3E,WAAWiE,MAAMW,WAAW,CAACD,IAAI;QAAE;QAEnF,yEAAyE;QAEzE,sFAAsF;QACtF,wEAAwE;QACxE,MAAME,iBAA2B,EAAE;QACnC/D,KAAKgE,OAAO,CAAC,CAACzC,KAAK0C;YACjB,MAAMC,YAAY3D,SAAS4D,GAAG,CAAC,CAACC;oBAEA7C;gBAD9B,MAAM8C,WAAWhE,QAAQiE,OAAO,CAACF;gBACjC,OAAOC,YAAY,IAAIE,QAAOhD,gBAAAA,GAAG,CAAC8C,SAAS,cAAb9C,2BAAAA,gBAAiB,IAAIiD,IAAI,KAAK;YAC9D;YAEA,IAAIN,UAAUO,IAAI,CAAC,CAACC,MAAQA,QAAQ,KAAK;gBACvCX,eAAeY,IAAI,CAAC,CAAC,IAAI,EAAEV,WAAW,EAAE,mCAAmC,EAAE1D,SAASqE,IAAI,CAAC,OAAO;YACpG;QACF;QAEA,IAAIb,eAAe7C,MAAM,GAAG,GAAG;gBAE7BkC;YADA,MAAMjC,UAAU,CAAC,0DAA0D,EAAE4C,eAAea,IAAI,CAAC,OAAO;aACxGxB,gBAAAA,OAAOyB,KAAK,cAAZzB,oCAAAA,mBAAAA,QAAe,+BAA+B;gBAAEyB,OAAO1D;YAAQ;YAC/D,MAAM,IAAIrC,cAAcC,kBAAkB+F,aAAa,EAAE3D;QAC3D;QAEA,oDAAoD;QACpD,MAAM4D,sBAAsB,MAAMrG,OAAOsG,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAepF;YACfqF,QAAQ;QACV;QAEA,MAAM1B,kBAAkBsB,oBAAoBlE,IAAI;QAChD,MAAMiB,4BAAmB2B,8BAAAA,gBAAgB2B,UAAU,cAA1B3B,kDAAAA,4BAA4B4B,KAAK,uCAAI;QAC9D,MAAMtD,kBAAiB0B,kCAAAA,gBAAgB1B,cAAc,cAA9B0B,6CAAAA,kCAAkC;QAEzD,oBAAoB;QACpB,MAAMC,SAAQD,0BAAAA,gBAAgB/E,MAAM,cAAtB+E,8CAAAA,wBAAwB6B,IAAI,CAAC,CAACC;gBAAaA;mBAAPhB,QAAOgB,gBAAAA,EAAEH,UAAU,cAAZG,oCAAAA,cAAcC,OAAO,MAAMzF;;QACpF,IAAI,EAAC2D,kBAAAA,4BAAAA,MAAO0B,UAAU,GAAE;gBACtBhC;aAAAA,eAAAA,OAAOqC,IAAI,cAAXrC,mCAAAA,kBAAAA,QAAc,sCAAsC;gBAAEtD;gBAAIC;gBAAKuD,UAAUtD,KAAKkB,MAAM;YAAC;YACrF,MAAM,IAAIpC,cAAcC,kBAAkB+F,aAAa,EAAE,CAAC,iBAAiB,EAAE/E,KAAK;QACpF;QAEA,MAAMiC,cAAa0B,0BAAAA,MAAM0B,UAAU,CAACC,KAAK,cAAtB3B,qCAAAA,0BAA0B3D;QAC7C,MAAM2F,YAAWhC,4BAAAA,MAAM0B,UAAU,CAACI,OAAO,cAAxB9B,uCAAAA,4BAA4B;QAC7C,MAAMzB,WAAW,CAAC,uCAAuC,EAAEnC,GAAG,UAAU,EAAE4F,UAAU;QAEpF,6CAA6C;QAC7C,MAAMC,gBAA+B;YACnCC,aAAa;gBACXC,YAAYtF;gBACZuF,oBAAoB;gBACpBC,WAAW;YACb;YACAC,cAAcxF,aAAa,mBAAmBA,aAAa;YAC3DyF,WAAW;YACXtF,kBAAkBA;QACpB;QAEA,oDAAoD;QACpD,MAAM,EAAEuF,QAAQC,YAAY,EAAE,GAAG,MAAMzG,+BAA+BhB,QAAQoB,IAAIkC,YAAYzB,UAAUoF,cAAcC,WAAW;QAEjI,gEAAgE;QAChE,IAAIQ,gBAAgBpG;QACpB,IAAIQ,aAAa,YAAY;gBAO3B4C;YANA,yCAAyC;YACzCgD,gBAAgBpG,KAAKe,MAAM,CAAC,CAACQ;gBAC3B,8DAA8D;gBAC9D,MAAM8E,MAAMrD,yBAAyBzB,KAAKlB,SAASsF,cAAcC,WAAW;gBAC5E,OAAOS,QAAQ,MAAM,CAACF,aAAaG,GAAG,CAACD;YACzC;aACAjD,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,uCAAuC;gBACpDmD,eAAevG,KAAKkB,MAAM;gBAC1BsF,eAAeJ,cAAclF,MAAM;YACrC;QACF,OAAO,IAAIV,aAAa,eAAe;gBAOrC4C;YANA,uCAAuC;YACvCgD,gBAAgBpG,KAAKe,MAAM,CAAC,CAACQ;gBAC3B,8DAA8D;gBAC9D,MAAM8E,MAAMrD,yBAAyBzB,KAAKlB,SAASsF,cAAcC,WAAW;gBAC5E,OAAOS,QAAQ,MAAMF,aAAaG,GAAG,CAACD;YACxC;aACAjD,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,0CAA0C;gBACvDmD,eAAevG,KAAKkB,MAAM;gBAC1BsF,eAAeJ,cAAclF,MAAM;YACrC;QACF;QAEA,8DAA8D;QAC9D,IAAIkF,cAAclF,MAAM,KAAK,GAAG;gBAC9BkC;aAAAA,eAAAA,OAAOqD,IAAI,cAAXrD,mCAAAA,kBAAAA,QAAc,+CAA+C;gBAAE5C;gBAAU+F,eAAevG,KAAKkB,MAAM;YAAC;YACpG,MAAM6B,SAAiB;gBACrBnB,MAAM;gBACN9B;gBACAC,KAAKwE,OAAOmB;gBACZ5D,kBAAkBA,oBAAoB;gBACtCC,gBAAgBA,kBAAkB;gBAClCC;gBACAC;gBACAC,aAAa;gBACbI,cAAc,EAAE;gBAChBC,aAAavC,KAAKkB,MAAM;gBACxBsB,cAAc,EAAE;gBAChBC,QAAQ;oBAAC,CAAC,0BAA0B,EAAEjC,SAAS,QAAQ,EAAER,KAAKkB,MAAM,CAAC,kBAAkB,CAAC;iBAAC;YAC3F;YACA,OAAO;gBACLwF,SAAS;oBAAC;wBAAE9E,MAAM;wBAAiB+E,MAAMC,KAAKC,SAAS,CAAC9D;oBAAQ;iBAAE;gBAClE+D,mBAAmB;oBAAE/D;gBAAO;YAC9B;QACF;SAEAK,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,oDAAoD;YACjE8B,eAAepF;YACfkC;YACA+E,kBAAkB1G;YAClBwF,YAAYtF;YACZC;YACAwG,oBAAoBZ,cAAclF,MAAM;QAC1C;QAEA,yDAAyD;QACzD,MAAMyC,eAAe,MAAMhE,YAAYjB,QAAQ;YAC7CwG,eAAepF;YACfkC;YACAhC,MAAMoG;YACNW,kBAAkB1G;YAClB4G,SAAStB;YACTvC;QACF;QAEA,IAAI5D,gBAAgBmE,eAAe;gBACMA;YAAvC,MAAM,IAAIuD,MAAM,CAAC,oBAAoB,GAAEvD,wBAAAA,aAAalB,MAAM,cAAnBkB,4CAAAA,sBAAqBiB,IAAI,CAAC,OAAO;QAC1E;QAEA,yCAAyC;QACzC,6EAA6E;QAC7E,MAAMpC,eAAyB,EAAE;QAEjC,oEAAoE;QACpE,MAAM2E,yBAAyBnH,KAAKkB,MAAM,GAAGkF,cAAclF,MAAM;QACjE,MAAMkG,mBAAmBzD,aAAapB,WAAW,GAAG4E;SAEpD/D,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,gDAAgD;YAC7DlB,aAAayB,aAAazB,WAAW;YACrCmF,eAAe1D,aAAa2D,QAAQ,CAACpG,MAAM;YAC3CqB,aAAa6E;YACbD;YACAI,qBAAqB5D,aAAapB,WAAW;YAC7CiF,aAAa7D,EAAAA,uBAAAA,aAAalB,MAAM,cAAnBkB,2CAAAA,qBAAqBzC,MAAM,KAAI;QAC9C;QAEA,MAAM6B,SAAiB;YACrBnB,MAAM;YACN9B;YACAC,KAAKwE,OAAOmB;YACZ5D,kBAAkBA,oBAAoB;YACtCC,gBAAgBA,kBAAkB;YAClCC;YACAC;YACAC,aAAayB,aAAazB,WAAW;YACrCI,cAAcqB,aAAa2D,QAAQ;YACnC/E,aAAa6E;YACb5E;YACAC,QAAQkB,aAAalB,MAAM;QAC7B;QAEA,OAAO;YACLiE,SAAS;gBAAC;oBAAE9E,MAAM;oBAAiB+E,MAAMC,KAAKC,SAAS,CAAC9D;gBAAQ;aAAE;YAClE+D,mBAAmB;gBAAE/D;YAAO;QAC9B;IACF,EAAE,OAAO8B,OAAO;YAEdzB;QADA,MAAMjC,UAAU0D,iBAAiBqC,QAAQrC,MAAM1D,OAAO,GAAGoD,OAAOM;SAChEzB,iBAAAA,OAAOyB,KAAK,cAAZzB,qCAAAA,oBAAAA,QAAe,+BAA+B;YAAEyB,OAAO1D;QAAQ;QAC/D,MAAM,IAAIrC,cAAcC,kBAAkB0I,aAAa,EAAE,CAAC,wBAAwB,EAAEtG,SAAS,EAAE;YAC7FuG,OAAO7C,iBAAiBqC,QAAQrC,MAAM6C,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNhF;QACAK;IACF;AACF"}
@@ -80,8 +80,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
80
80
  spreadsheetId: id,
81
81
  sheetTitle,
82
82
  requiredHeader: headers,
83
- keyColumns: deduplicateBy || [],
84
- logger
83
+ keyColumns: deduplicateBy || []
85
84
  });
86
85
  currentHeaders = headerResult.header;
87
86
  existingKeySet = headerResult.keySet;