@mcp-z/mcp-sheets 2.5.1 → 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 (54) hide show
  1. package/README.md +1 -1
  2. package/dist/cjs/lib/create-store.d.cts +2 -1
  3. package/dist/cjs/lib/create-store.d.ts +2 -1
  4. package/dist/cjs/lib/create-store.js +82 -7
  5. package/dist/cjs/lib/create-store.js.map +1 -1
  6. package/dist/cjs/mcp/tools/columns-update.js +5 -1
  7. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  8. package/dist/cjs/mcp/tools/csv-get-columns.js +1 -1
  9. package/dist/cjs/mcp/tools/lib/dimension-operations.js +1 -1
  10. package/dist/cjs/mcp/tools/rows-append.js +1 -2
  11. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  12. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -3
  13. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  14. package/dist/cjs/setup/http.js +1 -1
  15. package/dist/cjs/setup/runtime.d.cts +2 -2
  16. package/dist/cjs/setup/runtime.d.ts +2 -2
  17. package/dist/cjs/setup/runtime.js +6 -6
  18. package/dist/cjs/setup/runtime.js.map +1 -1
  19. package/dist/cjs/setup/stdio.js +1 -1
  20. package/dist/cjs/spreadsheet/data-operations.d.cts +8 -1
  21. package/dist/cjs/spreadsheet/data-operations.d.ts +8 -1
  22. package/dist/cjs/spreadsheet/data-operations.js +80 -102
  23. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  24. package/dist/cjs/spreadsheet/markdown-runs.js +1 -1
  25. package/dist/cjs/spreadsheet/range-operations.d.cts +0 -67
  26. package/dist/cjs/spreadsheet/range-operations.d.ts +0 -67
  27. package/dist/cjs/spreadsheet/range-operations.js +1 -237
  28. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  29. package/dist/cjs/spreadsheet/sheet-operations.d.cts +4 -17
  30. package/dist/cjs/spreadsheet/sheet-operations.d.ts +4 -17
  31. package/dist/cjs/spreadsheet/sheet-operations.js +18 -222
  32. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  33. package/dist/esm/lib/create-store.d.ts +2 -1
  34. package/dist/esm/lib/create-store.js +22 -4
  35. package/dist/esm/lib/create-store.js.map +1 -1
  36. package/dist/esm/mcp/tools/columns-update.js +5 -1
  37. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  38. package/dist/esm/mcp/tools/rows-append.js +1 -2
  39. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  40. package/dist/esm/mcp/tools/rows-csv-append.js +1 -2
  41. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  42. package/dist/esm/setup/runtime.d.ts +2 -2
  43. package/dist/esm/setup/runtime.js +6 -6
  44. package/dist/esm/setup/runtime.js.map +1 -1
  45. package/dist/esm/spreadsheet/data-operations.d.ts +8 -1
  46. package/dist/esm/spreadsheet/data-operations.js +27 -35
  47. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  48. package/dist/esm/spreadsheet/range-operations.d.ts +0 -67
  49. package/dist/esm/spreadsheet/range-operations.js +0 -227
  50. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  51. package/dist/esm/spreadsheet/sheet-operations.d.ts +4 -17
  52. package/dist/esm/spreadsheet/sheet-operations.js +7 -115
  53. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  54. package/package.json +7 -7
@@ -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
  },
@@ -178,7 +175,7 @@ function _unsupported_iterable_to_array(o, minLen) {
178
175
  if (typeof o === "string") return _array_like_to_array(o, minLen);
179
176
  var n = Object.prototype.toString.call(o).slice(8, -1);
180
177
  if (n === "Object" && o.constructor) n = o.constructor.name;
181
- if (n === "Map" || n === "Set") return Array.from(n);
178
+ if (n === "Map" || n === "Set") return Array.from(o);
182
179
  if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
183
180
  }
184
181
  function scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol, onRow) {
@@ -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":";;;;;;;;;;;QA2CsBA;eAAAA;;QA+GAC;eAAAA;;QA3EAC;eAAAA;;QApEAC;eAAAA;;;iCATA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASf,SAAeA,kBAAkBC,MAAwB,EAAEC,aAAqB,EAAEC,UAAkB,EAAEC,QAAgB,EAAEC,MAAc,EAAEC,KAAmD;;YAM/KC,kDAAAA,mCAAAA,wBAAAA,mBAAAA,YALXC,WACFC,UAGEF,MACAG,UAMEC,QACAC,OAEFC,MAGMC,gBADFA,UAECC,OAEDC,SAKCC;;;;oBAzBLT,YAAY;oBACdC,WAAW,GAAG,kCAAkC;oBAGvC;;wBAAMR,OAAOiB,YAAY,CAACC,GAAG,CAAC;4BAAEjB,eAAAA;4BAAekB,QAAQ;wBAAmD;;;oBAAjHb,OAAO;oBACPG,YAAWH,aAAAA,KAAKc,IAAI,cAATd,kCAAAA,oBAAAA,WAAWN,MAAM,cAAjBM,yCAAAA,yBAAAA,kBAAmBe,IAAI,CAAC,SAACC;4BAAMA;+BAAAA,EAAAA,gBAAAA,EAAEC,UAAU,cAAZD,oCAAAA,cAAcE,KAAK,MAAKtB;oCAAvDI,8CAAAA,oCAAAA,uBAAoEiB,UAAU,cAA9EjB,yDAAAA,mDAAAA,kCAAgFmB,cAAc,cAA9FnB,uEAAAA,iDAAgGG,QAAQ;oBACzH,IAAI,OAAOA,aAAa,UAAU;wBAChC,MAAM,IAAIiB,MAAM,AAAC,0CAAoD,OAAXxB,YAAW;oBACvE;;;yBAEOM,CAAAA,YAAYC,QAAO;;;;oBAClBC,SAASiB,KAAKC,GAAG,CAACpB,WAAWD,YAAY,GAAGE;oBAC5CE,QAAQ,AAAC,GAAgBR,OAAdD,YAAW,KAAcM,OAAXL,UAAuBC,OAAZI,UAAS,KAAYE,OAATN,QAAgB,OAAPM;oBAE3DE,OAAAA,KAAAA;;;;;;;;;oBAEe;;wBAAMZ,OAAOiB,YAAY,CAACY,MAAM,CAACX,GAAG,CAAC;4BAAEjB,eAAAA;4BAAeU,OAAAA;4BAAOmB,gBAAgB;wBAAO;;;oBAA/FjB,WAAW;oBACjBD,OAAQC,EAAAA,iBAAAA,SAASO,IAAI,cAAbP,qCAAAA,eAAegB,MAAM;;;;;;oBACtBf;oBACP,sFAAsF;oBAChFC,UAAU,IAAIW,MAAM,AAAC,mCAA4CZ,OAAVH,OAAM,MAA2D,OAAvDG,AAAK,YAALA,OAAiBY,SAAQZ,MAAMiB,OAAO,GAAGC,OAAOlB;oBACvHC,QAAQkB,KAAK,GAAGnB;oBAChB,MAAMC;;oBAGR,IAASC,IAAI,GAAGA,IAAIJ,KAAKsB,MAAM,EAAElB,IAAKX,MAAM8B,MAAMC,OAAO,CAACxB,IAAI,CAACI,EAAE,IAAIJ,IAAI,CAACI,EAAE,OAAOR,WAAWQ;oBAE9FR,WAAWE,SAAS;;;;;;;;;;;IAExB;;AAEO,SAAed,oBAAoBI,MAAwB,EAAEqC,EAAU,EAAEnC,UAAkB,EAAEoC,WAAoB,EAAEC,OAA6B,EAAEC,MAAc;;YAsBnJC,wCAAAA,6BAAAA,oBAAAA,mBAAAA,WApBZC,QACAC,IACAC,KAEQD,4BAAAA,iBAAAA,YAANE,KACAC,QAIyB,MAAXC,QAETC,GACPR,cAOAC,KACAQ,WACAH,SAIyB,OAAXC,SAETC,IACPR;;;;oBA7BJ,IAAI,CAACtC,YAAY;;wBAAO;4BAAEgD,cAAc;wBAAM;;oBAC/B;;wBAAMlD,OAAOiB,YAAY,CAACC,GAAG,CAAC;4BAAEjB,eAAeoC;wBAAG;;;oBAA3DK,SAAS;oBACTC,KAAKD,OAAOtB,IAAI;oBAChBwB,MAAMT,MAAMC,OAAO,CAACO,eAAAA,yBAAAA,GAAI3C,MAAM,KAAK2C,GAAG3C,MAAM,CAACmD,IAAI,CAAC,SAAC7B;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKtB;;yBACpF0C,KAAAA;;;;oBACIC,OAAMF,aAAAA,GAAG3C,MAAM,cAAT2C,kCAAAA,kBAAAA,WAAWtB,IAAI,CAAC,SAACC;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKtB;oCAAhDyC,uCAAAA,6BAAAA,gBAA6DpB,UAAU,cAAvEoB,iDAAAA,2BAAyES,OAAO;oBACtFN,SAAkF;wBAAEI,cAAc;oBAAM;oBAC9G,IAAIL,OAAO,MAAMC,OAAOO,SAAS,GAAGrB,OAAOa;yBACvCN,SAAAA;;;;;;;;;;;;oBAE2B;;wBAAM1C,oBAAoBG,QAAQ;4BAAEC,eAAeoC;4BAAInC,YAAAA;4BAAYoD,gBAAgBf;4BAASC,QAAAA;wBAAO;;;oBAAnG,OAAA,eAAXO,SAAW,KAAnBQ;oBACR,IAAIR,QAAQD,OAAOU,cAAc,GAAG;;;;;;oBAC7BR;qBACPR,eAAAA,OAAOiB,IAAI,cAAXjB,mCAAAA,kBAAAA,QAAc,mDAAmDQ;;;;;;oBAGrE;;wBAAOF;;;oBAET,IAAI,CAACR,aAAa;;wBAAO;4BAAEY,cAAc;wBAAM;;oBAEnC;;wBAAMlD,OAAOiB,YAAY,CAACyC,WAAW,CAAC;4BAAEzD,eAAeoC;4BAAIsB,aAAa;gCAAEC,QAAQ;oCAAG;wCAAEC,UAAU;4CAAEtC,YAAY;gDAAEC,OAAOtB;4CAAW;wCAAE;oCAAE;;4BAAG;wBAAE;;;oBAAlJuC,MAAM;oBACNQ,aAAYR,YAAAA,IAAIrB,IAAI,cAARqB,iCAAAA,oBAAAA,UAAUqB,OAAO,cAAjBrB,yCAAAA,qBAAAA,iBAAmB,CAAC,EAAE,cAAtBA,0CAAAA,8BAAAA,mBAAwBoB,QAAQ,cAAhCpB,mDAAAA,yCAAAA,4BAAkClB,UAAU,cAA5CkB,6DAAAA,uCAA8CW,OAAO;oBACjEN,UAAkF;wBAAEI,cAAc,CAAC,CAACD;oBAAU;oBACpH,IAAIA,aAAa,MAAMH,QAAOO,SAAS,GAAGrB,OAAOiB;yBAC7CA,CAAAA,aAAaV,OAAM,GAAnBU;;;;;;;;;;;;oBAE2B;;wBAAMpD,oBAAoBG,QAAQ;4BAAEC,eAAeoC;4BAAInC,YAAAA;4BAAYoD,gBAAgBf;4BAASC,QAAAA;wBAAO;;;oBAAnG,QAAA,eAAXO,UAAW,MAAnBQ;oBACR,IAAIR,SAAQD,QAAOU,cAAc,GAAG;;;;;;oBAC7BR;qBACPR,gBAAAA,OAAOiB,IAAI,cAAXjB,oCAAAA,mBAAAA,QAAc,mDAAmDQ;;;;;;oBAGrE;;wBAAOF;;;;IACT;;AAEO,SAAehD,eAAeiE,MAAwB,EAAE9D,aAAqB,EAAE+D,QAAgB,EAAExB,MAAc;;YAErGE,cAGfF,eAyDAA,cA7DME,QACA1C,QACAiE,YAaJzB,eAKI0B,iBAEJ1B,gBAKI2B,gBAEJ3B,gBAKI4B,sBAEJ5B,gBAKI6B,mBAEJ7B,gBAKI8B,6BAEJ9B,gBAKI+B,cAEJ/B;;;;oBAzDa;;wBAAMuB,OAAO9C,YAAY,CAACC,GAAG,CAAC;4BAAEjB,eAAAA;wBAAc;;;oBAAvDyC,SAAS;oBACT1C,SAAS0C,EAAAA,eAAAA,OAAOtB,IAAI,cAAXsB,mCAAAA,aAAa1C,MAAM;oBAC5BiE,aAAaD,qBAAAA,+BAAAA,SAAUQ,IAAI;qBAEjChC,gBAAAA,OAAOiC,KAAK,cAAZjC,oCAAAA,mBAAAA,QAAe,yBAAyB;wBACtCvC,eAAAA;wBACA+D,UAAAA;wBACAC,YAAAA;wBACAS,iBAAiB1E,OAAO2E,GAAG,CAAC,SAACrD;gCACpBA,eACHA;mCAF8B;gCAClCE,KAAK,EAAEF,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK;gCAC3Ba,EAAE,EAAEf,cAAAA,yBAAAA,iBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,eAAe8B,OAAO;4BAC5B;;oBACF;oBAEA,IAAI,CAACa,YAAY;;yBACfzB,gBAAAA,OAAOiB,IAAI,cAAXjB,oCAAAA,mBAAAA,QAAc;wBACd;;4BAAO;;oBACT;oBAEA,6DAA6D;oBACvD0B,kBAAkBlE,OAAOqB,IAAI,CAAC,SAACC;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKyC;;oBACpE,IAAIC,iBAAiB;;yBACnB1B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO0B;;oBACT;oBAEA,0EAA0E;oBACpEC,iBAAiBnE,OAAOqB,IAAI,CAAC,SAACC;4BAAaA;+BAAPU,OAAOV,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAe8B,OAAO,MAAMa;;oBAC7E,IAAIE,gBAAgB;;yBAClB3B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO2B;;oBACT;oBAEA,2CAA2C;oBACrCC,uBAAuBpE,OAAOqB,IAAI,CAAC,SAACC;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsBsD,WAAW,QAAOX,WAAWW,WAAW;;oBAC9G,IAAIR,sBAAsB;;yBACxB5B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO4B;;oBACT;oBAEA,4EAA4E;oBACtEC,oBAAoBrE,OAAOqB,IAAI,CAAC,SAACC;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsBkD,IAAI,QAAOP;;oBAC9E,IAAII,mBAAmB;;yBACrB7B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO6B;;oBACT;oBAEA,qDAAqD;oBAC/CC,8BAA8BtE,OAAOqB,IAAI,CAAC,SAACC;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsBkD,IAAI,GAAGI,WAAW,QAAOX,WAAWW,WAAW;;oBAC5H,IAAIN,6BAA6B;;yBAC/B9B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO8B;;oBACT;oBAEA,gDAAgD;oBAC1CC,eAAevE,OAAOqB,IAAI,CAAC,SAACC;4BAAMA,qBAAAA;+BAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsBsD,WAAW,GAAGC,QAAQ,CAACZ,WAAWW,WAAW;;oBAC3G,IAAIL,cAAc;;yBAChB/B,iBAAAA,OAAOiC,KAAK,cAAZjC,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO+B;;oBACT;qBAEA/B,eAAAA,OAAOiB,IAAI,cAAXjB,mCAAAA,kBAAAA,QAAc,iCAAiC;wBAC7CsC,WAAWb;wBACXc,iBAAiB/E,OAAO2E,GAAG,CAAC,SAACrD;gCAAMA;mCAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK;;wBACvDwD,cAAchF,OAAO2E,GAAG,CAAC,SAACrD;gCAAMA;mCAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAe8B,OAAO;;oBACxD;oBACA;;wBAAO;;;;IACT;;AAOO,SAAevD;wCACpBG,MAAwB,EACxB,KAcC;YAbCC,eACAC,YACA8D,iCACAV,mCACA2B,YACAzC,QA4Eab,OACAA,QA9DXuD,oBACAC,WAEIC,OAEiBA,mBAUnBC,eACA9B,QAMA+B,MACAC,IACA1D,QACA2D,gBAOAC,cACD,2BAAA,mBAAA,gBAAA,WAAA,OAAMC,KAGJ,4BAAA,oBAAA,iBAAA,YAAA,QAAMC,MAUPC,QAEAC,2BASAC,YACAC,cAGAC,QACAC,QACA9F,UACAC;;;;oBApFJH,gBADF,MACEA,eACAC,aAFF,MAEEA,YACA8D,WAHF,MAGEA,kCAHF,MAIEV,gBAAAA,oDAAiB,kDAJnB,MAKE2B,YAAAA;wBAAc;2CACdzC,SANF,MAMEA;oBAUF,IAAI,CAACxC,QAAQ,MAAM,IAAI0B,MAAM;oBAC7B,IAAI,CAACzB,eAAe,MAAM,IAAIyB,MAAM;oBACpC,IAAI,CAACxB,cAAc,CAAC8D,UAAU,MAAM,IAAItC,MAAM;oBAE9C,2DAA2D;oBACvDwD,qBAAqBhF;oBACrBiF,YAAY;yBACZnB,UAAAA;;;;oBACY;;wBAAMlE,eAAeE,QAAQC,eAAe+D,UAAUxB;;;oBAA9D4C,QAAQ;oBACd,IAAIA,OAAO;;wBACTF,qBAAqBE,EAAAA,oBAAAA,MAAM7D,UAAU,cAAhB6D,wCAAAA,kBAAkB5D,KAAK,KAAIwC;oBAClD,OAAO;wBACL,kEAAkE;wBAClEkB,qBAAqBlB;wBACrBmB,YAAY;oBACd;;;oBAGF,IAAI,CAACD,oBAAoB,MAAM,IAAIxD,MAAM;oBAEnC2D;wBAAiB;wBAAM;wBAAY;wBAAY;wBAAM;wBAAQ;wBAAM;wBAAO;wBAAQ;wBAAW;wBAAU;wBAAW;;oBAClH9B,SAASpB,MAAMC,OAAO,CAACkB,mBAAmBA,eAAepB,MAAM,GAAGoB,iBAAiB+B;yBAErFF,WAAAA;;;;oBACF;;wBAAMnF,OAAOiB,YAAY,CAACyC,WAAW,CAAC;4BAAEzD,eAAAA;4BAAe0D,aAAa;gCAAEC,QAAQ;oCAAG;wCAAEC,UAAU;4CAAEtC,YAAY;gDAAEC,OAAO0D;4CAAmB;wCAAE;oCAAE;;4BAAG;wBAAE;;;oBAAhJ;;;oBAGW;;wBAAMlF,OAAOiB,YAAY,CAACY,MAAM,CAACX,GAAG,CAAC;4BAAEjB,eAAAA;4BAAeU,OAAO,AAAC,GAAqB,OAAnBuE,oBAAmB;4BAAOpD,gBAAgB;wBAAO;;;oBAAxHwD,OAAO;oBACPC,KAAKD,KAAKlE,IAAI;oBACdS,SAAU,AAAC0D,CAAAA,CAAAA,eAAAA,yBAAAA,GAAI1D,MAAM,OAAK,CAAE,CAAC,EAAE;oBAC/B2D,iBAAkC3D,OAAOK,MAAM,GAAGL,SAAS;yBAE7D,CAAC2D,gBAAD;;;;oBACF;;wBAAMxF,OAAOiB,YAAY,CAACY,MAAM,CAACqE,MAAM,CAAC;4BAAEjG,eAAAA;4BAAeU,OAAO,AAAC,GAAqB,OAAnBuE,oBAAmB;4BAAMiB,kBAAkB;4BAAOC,kBAAkB;4BAAezC,aAAa;gCAAE9B,MAAM;oCAAG0B;;4BAAQ;wBAAE;;;oBAAxL;oBACA;;wBAAO;4BAAEA,QAAAA;4BAAQqC,QAAQ,IAAIS;wBAAc;;;oBAGvCZ,eAAeD,eAAec,KAAK;oBACpC,kCAAA,2BAAA;;wBAAL,IAAK,YAAa/C,6BAAb,6BAAA,QAAA,yBAAA;4BAAMmC,MAAN;4BAAqB,IAAI,CAACD,aAAaZ,QAAQ,CAACa,MAAMD,aAAac,IAAI,CAACb;;;wBAAxE;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBAEL,IAAIvD,MAAMC,OAAO,CAAC6C,aAAa;wBACxB,mCAAA,4BAAA;;4BAAL,IAAK,aAAcA,iCAAd,8BAAA,SAAA,0BAAA,kCAA0B;gCAApBU,OAAN;gCACH,IAAI,OAAOA,SAAS,YAAYA,KAAKzD,MAAM,KAAK,GAAG,MAAM,IAAIR,MAAM;gCACnE,IAAI,CAAC+D,aAAaZ,QAAQ,CAACc,OAAOF,aAAac,IAAI,CAACZ;4BACtD;;4BAHK;4BAAA;;;qCAAA,8BAAA;oCAAA;;;oCAAA;0CAAA;;;;oBAIP;yBAEIF,CAAAA,aAAavD,MAAM,KAAKsD,eAAetD,MAAM,AAAD,GAA5CuD;;;;oBACF;;wBAAMzF,OAAOiB,YAAY,CAACY,MAAM,CAAC2E,MAAM,CAAC;4BAAEvG,eAAAA;4BAAeU,OAAO,AAAC,GAAqB,OAAnBuE,oBAAmB;4BAAOiB,kBAAkB;4BAAOxC,aAAa;gCAAE9B,MAAM;oCAAG4D;;4BAAc;wBAAE;;;oBAA9J;;;oBAGIG,SAAS,IAAIS;oBAEbR,4BAA4B,mCAACY,IAAcC;wBAC/C,IAAI,CAACvE,MAAMC,OAAO,CAACqE,OAAOA,GAAGvE,MAAM,KAAK,GAAG,OAAO,EAAE;wBACpD,OAAOuE,GAAG9B,GAAG,CAAC,SAACgB;4BACb,IAAI,OAAOA,SAAS,YAAYA,KAAKzD,MAAM,KAAK,GAAG,OAAO,CAAC;4BAC3D,IAAMyE,MAAMD,IAAIE,OAAO,CAACjB;4BACxB,OAAOkB,OAAOC,SAAS,CAACH,QAAQA,OAAO,IAAIA,MAAM,CAAC;wBACpD;oBACF;oBAEMb,aAAaD,0BAA0BZ,YAAYQ;oBACnDM,eAAeD,WAAWiB,MAAM,CAAC,SAAC/F;+BAAMA,KAAK;;oBACnD,IAAI+E,aAAa7D,MAAM,KAAK,GAAG;;wBAAO;4BAAEqB,QAAQkC;4BAAcG,QAAQ,IAAIS;4BAAeW,eAAelB;wBAAW;;oBAE7GE,SAASrE,CAAAA,QAAAA,MAAKC,GAAG,OAARD,OAAS,qBAAGoE;oBACrBE,SAAStE,CAAAA,SAAAA,MAAKsF,GAAG,OAARtF,QAAS,qBAAGoE;oBACrB5F,WAAW+G,IAAAA,wBAAK,EAAClB,SAAS;oBAC1B5F,SAAS8G,IAAAA,wBAAK,EAACjB,SAAS;oBAE9B;;wBAAMlG,kBAAkBC,QAAQC,eAAeiF,oBAAoB/E,UAAUC,QAAQ,SAAC+G;4BACpF,kEAAkE;4BAClE,IAAMC,QAAQ3B,aAAad,GAAG,CAAC,SAAC0C;uCAAMrF,OAAOqF,cAAAA,eAAAA,IAAK,IAAIzC,WAAW;;4BACjE,IAAM0C,gBAAgBF,MAAMR,OAAO,CAAC;4BACpC,IAAIW,cAAcH,MAAMR,OAAO,CAAC;4BAChC,IAAIW,gBAAgB,CAAC,GAAGA,cAAcH,MAAMR,OAAO,CAAC;4BAEpD,IAAIY;4BAEJ,IAAIF,iBAAiB,KAAKC,eAAe,GAAG;oCAIOJ,qBACPA;gCAJ1C,gEAAgE;gCAChE,IAAMM,iBAAiBH,gBAAgBtB;gCACvC,IAAM0B,WAAWH,cAAcvB;gCAC/B,IAAM2B,cAAcF,kBAAkB,IAAIzF,QAAOmF,sBAAAA,GAAG,CAACM,eAAe,cAAnBN,iCAAAA,sBAAuB,IAAI3C,IAAI,KAAK;gCACrF,IAAMoD,aAAaF,YAAY,IAAI1F,QAAOmF,gBAAAA,GAAG,CAACO,SAAS,cAAbP,2BAAAA,gBAAiB,IAAI3C,IAAI,KAAK;gCACxEgD,eAAe;oCAACG;oCAAaC;iCAAW,CAACC,IAAI,CAAC;4BAChD,OAAO;gCACL,8CAA8C;gCAC9C,IAAMC,QAAQhC,WAAWnB,GAAG,CAAC,SAAC3D;wCAA2BmG;2CAApBnG,IAAI,IAAI,KAAKgB,QAAOmF,QAAAA,GAAG,CAACnG,IAAIgF,OAAO,cAAfmB,mBAAAA,QAAmB,IAAI3C,IAAI;;gCACpFgD,eAAeM,MAAMD,IAAI,CAAC;4BAC5B;4BAEA,IAAIL,aAAaO,OAAO,CAAC,QAAQ,QAAQ,IAAInC,OAAOoC,GAAG,CAACR;wBAC1D;;;oBAvBA;oBAwBA;;wBAAO;4BAAEjE,QAAQkC;4BAAcG,QAAAA;4BAAQoB,eAAelB;wBAAW;;;;IACnE"}
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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"}
@@ -1,2 +1,3 @@
1
+ import type { Logger } from '@mcp-z/server';
1
2
  import type Keyv from 'keyv';
2
- export default function createStore<T>(uri: string): Promise<Keyv<T>>;
3
+ export default function createStore<T>(uri: string, logger?: Logger): Promise<Keyv<T>>;
@@ -1,8 +1,26 @@
1
- import keyvRegistry from 'keyv-registry';
1
+ import keyvRegistry, { migrateKeyv5Keys } from 'keyv-registry';
2
2
  // keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry
3
3
  // loads adapters with require() rather than depending on any of them itself.
4
- export default async function createStore(uri) {
5
- const store = await keyvRegistry(uri);
6
- if (!store) throw new Error(`Failed to create store for URI: ${uri}`);
4
+ export default async function createStore(uri, logger) {
5
+ // Errors name the protocol only: a redis URI can hold a password.
6
+ const protocol = `${uri.split(':')[0]}:`;
7
+ let store;
8
+ try {
9
+ store = await keyvRegistry(uri);
10
+ } catch (cause) {
11
+ const error = new Error(`Failed to create store for ${protocol}`);
12
+ error.cause = cause;
13
+ throw error;
14
+ }
15
+ if (!store) throw new Error(`Failed to create store for ${protocol}`);
16
+ try {
17
+ // One-time move of sign-ins saved by keyv 5 versions of this server. Removed in the next major.
18
+ const moved = await migrateKeyv5Keys(store);
19
+ if (moved > 0) logger === null || logger === void 0 ? void 0 : logger.info(`Moved ${moved} saved sign-in entries to the keyv 6 format`);
20
+ } catch (error) {
21
+ // Keep the migration error as the one reported, even if closing the store fails too.
22
+ await store.disconnect().catch(()=>{});
23
+ throw error;
24
+ }
7
25
  return store;
8
26
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n const store = await keyvRegistry<T>(uri);\n if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,sFAAsF;AACtF,6EAA6E;AAE7E,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type { Logger } from '@mcp-z/server';\nimport type Keyv from 'keyv';\nimport keyvRegistry, { migrateKeyv5Keys } from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string, logger?: Logger): Promise<Keyv<T>> {\n // Errors name the protocol only: a redis URI can hold a password.\n const protocol = `${uri.split(':')[0]}:`;\n let store: Keyv<T> | undefined;\n try {\n store = await keyvRegistry<T>(uri);\n } catch (cause) {\n const error = new Error(`Failed to create store for ${protocol}`);\n (error as Error & { cause?: unknown }).cause = cause;\n throw error;\n }\n if (!store) throw new Error(`Failed to create store for ${protocol}`);\n try {\n // One-time move of sign-ins saved by keyv 5 versions of this server. Removed in the next major.\n const moved = await migrateKeyv5Keys(store as Keyv);\n if (moved > 0) logger?.info(`Moved ${moved} saved sign-in entries to the keyv 6 format`);\n } catch (error) {\n // Keep the migration error as the one reported, even if closing the store fails too.\n await store.disconnect().catch(() => {});\n throw error;\n }\n return store;\n}\n"],"names":["keyvRegistry","migrateKeyv5Keys","createStore","uri","logger","protocol","split","store","cause","error","Error","moved","info","disconnect","catch"],"mappings":"AAEA,OAAOA,gBAAgBC,gBAAgB,QAAQ,gBAAgB;AAE/D,sFAAsF;AACtF,6EAA6E;AAE7E,eAAe,eAAeC,YAAeC,GAAW,EAAEC,MAAe;IACvE,kEAAkE;IAClE,MAAMC,WAAW,GAAGF,IAAIG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,IAAIC;IACJ,IAAI;QACFA,QAAQ,MAAMP,aAAgBG;IAChC,EAAE,OAAOK,OAAO;QACd,MAAMC,QAAQ,IAAIC,MAAM,CAAC,2BAA2B,EAAEL,UAAU;QAC/DI,MAAsCD,KAAK,GAAGA;QAC/C,MAAMC;IACR;IACA,IAAI,CAACF,OAAO,MAAM,IAAIG,MAAM,CAAC,2BAA2B,EAAEL,UAAU;IACpE,IAAI;QACF,gGAAgG;QAChG,MAAMM,QAAQ,MAAMV,iBAAiBM;QACrC,IAAII,QAAQ,GAAGP,mBAAAA,6BAAAA,OAAQQ,IAAI,CAAC,CAAC,MAAM,EAAED,MAAM,2CAA2C,CAAC;IACzF,EAAE,OAAOF,OAAO;QACd,qFAAqF;QACrF,MAAMF,MAAMM,UAAU,GAAGC,KAAK,CAAC,KAAO;QACtC,MAAML;IACR;IACA,OAAOF;AACT"}
@@ -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 = [];