@mcp-z/mcp-sheets 2.5.0 → 2.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/constants.d.cts +24 -0
- package/dist/cjs/constants.d.ts +24 -0
- package/dist/cjs/constants.js +56 -0
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-format.d.cts +3 -3
- package/dist/cjs/mcp/tools/cells-format.d.ts +3 -3
- package/dist/cjs/mcp/tools/cells-format.js +3 -2
- package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-get.d.cts +2 -2
- package/dist/cjs/mcp/tools/columns-get.d.ts +2 -2
- package/dist/cjs/mcp/tools/columns-get.js +2 -1
- package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/columns-update.js +3 -2
- package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
- package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
- package/dist/cjs/mcp/tools/rows-append.js +2 -1
- package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-get.d.cts +2 -2
- package/dist/cjs/mcp/tools/rows-get.d.ts +2 -2
- package/dist/cjs/mcp/tools/rows-get.js +2 -1
- package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/values-batch-update.js +3 -2
- package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
- package/dist/cjs/mcp/tools/values-csv-update.js +3 -2
- package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/cjs/mcp/tools/values-search.d.cts +2 -2
- package/dist/cjs/mcp/tools/values-search.d.ts +2 -2
- package/dist/cjs/mcp/tools/values-search.js +2 -1
- package/dist/cjs/mcp/tools/values-search.js.map +1 -1
- package/dist/cjs/spreadsheet/data-operations.js +1 -17
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +1 -5
- package/dist/cjs/spreadsheet/range-operations.d.ts +1 -5
- package/dist/cjs/spreadsheet/range-operations.js +0 -28
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.js +24 -74
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/constants.d.ts +24 -0
- package/dist/esm/constants.js +41 -0
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/mcp/tools/cells-format.d.ts +3 -3
- package/dist/esm/mcp/tools/cells-format.js +3 -2
- package/dist/esm/mcp/tools/cells-format.js.map +1 -1
- package/dist/esm/mcp/tools/columns-get.d.ts +2 -2
- package/dist/esm/mcp/tools/columns-get.js +2 -1
- package/dist/esm/mcp/tools/columns-get.js.map +1 -1
- package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
- package/dist/esm/mcp/tools/columns-update.js +3 -2
- package/dist/esm/mcp/tools/columns-update.js.map +1 -1
- package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
- package/dist/esm/mcp/tools/rows-append.js +2 -1
- package/dist/esm/mcp/tools/rows-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
- package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-get.d.ts +2 -2
- package/dist/esm/mcp/tools/rows-get.js +2 -1
- package/dist/esm/mcp/tools/rows-get.js.map +1 -1
- package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
- package/dist/esm/mcp/tools/values-batch-update.js +3 -2
- package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
- package/dist/esm/mcp/tools/values-csv-update.js +3 -2
- package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
- package/dist/esm/mcp/tools/values-search.d.ts +2 -2
- package/dist/esm/mcp/tools/values-search.js +2 -1
- package/dist/esm/mcp/tools/values-search.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.js +7 -11
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +1 -5
- package/dist/esm/spreadsheet/range-operations.js +0 -27
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.js +19 -36
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/package.json +1 -1
|
@@ -545,7 +545,7 @@ function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
|
|
|
545
545
|
}
|
|
546
546
|
function ensureTabAndHeaders(_0, _1) {
|
|
547
547
|
return _async_to_generator(function(sheets, param) {
|
|
548
|
-
var spreadsheetId, sheetTitle, sheetRef, _param_requiredHeader, requiredHeader, _param_keyColumns, keyColumns, logger, _Math, _Math1, resolvedSheetTitle, sheet, _sheet_properties, defaultHeader, header,
|
|
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;
|
|
549
549
|
return _ts_generator(this, function(_state) {
|
|
550
550
|
switch(_state.label){
|
|
551
551
|
case 0:
|
|
@@ -557,6 +557,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
557
557
|
if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');
|
|
558
558
|
// Resolve the actual sheet title from sheetRef if provided
|
|
559
559
|
resolvedSheetTitle = sheetTitle;
|
|
560
|
+
createTab = false;
|
|
560
561
|
if (!sheetRef) return [
|
|
561
562
|
3,
|
|
562
563
|
2
|
|
@@ -573,6 +574,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
573
574
|
} else {
|
|
574
575
|
// Sheet doesn't exist, use the sheetRef as the title for creation
|
|
575
576
|
resolvedSheetTitle = sheetRef;
|
|
577
|
+
createTab = true;
|
|
576
578
|
}
|
|
577
579
|
_state.label = 2;
|
|
578
580
|
case 2:
|
|
@@ -592,42 +594,10 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
592
594
|
'body'
|
|
593
595
|
];
|
|
594
596
|
header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
|
|
595
|
-
|
|
596
|
-
_state.label = 3;
|
|
597
|
-
case 3:
|
|
598
|
-
_state.trys.push([
|
|
597
|
+
if (!createTab) return [
|
|
599
598
|
3,
|
|
600
|
-
|
|
601
|
-
,
|
|
602
|
-
11
|
|
603
|
-
]);
|
|
604
|
-
return [
|
|
605
|
-
4,
|
|
606
|
-
sheets.spreadsheets.values.get({
|
|
607
|
-
spreadsheetId: spreadsheetId,
|
|
608
|
-
range: "".concat(resolvedSheetTitle, "!1:1"),
|
|
609
|
-
majorDimension: 'ROWS'
|
|
610
|
-
})
|
|
599
|
+
4
|
|
611
600
|
];
|
|
612
|
-
case 4:
|
|
613
|
-
resp = _state.sent();
|
|
614
|
-
vr = resp.data;
|
|
615
|
-
values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
|
|
616
|
-
existingHeader = values.length ? values : null;
|
|
617
|
-
return [
|
|
618
|
-
3,
|
|
619
|
-
11
|
|
620
|
-
];
|
|
621
|
-
case 5:
|
|
622
|
-
_err = _state.sent();
|
|
623
|
-
_state.label = 6;
|
|
624
|
-
case 6:
|
|
625
|
-
_state.trys.push([
|
|
626
|
-
6,
|
|
627
|
-
8,
|
|
628
|
-
,
|
|
629
|
-
9
|
|
630
|
-
]);
|
|
631
601
|
return [
|
|
632
602
|
4,
|
|
633
603
|
sheets.spreadsheets.batchUpdate({
|
|
@@ -645,46 +615,26 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
645
615
|
}
|
|
646
616
|
})
|
|
647
617
|
];
|
|
648
|
-
case
|
|
618
|
+
case 3:
|
|
649
619
|
_state.sent();
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
9
|
|
653
|
-
];
|
|
654
|
-
case 8:
|
|
655
|
-
unused = _state.sent();
|
|
656
|
-
return [
|
|
657
|
-
3,
|
|
658
|
-
9
|
|
659
|
-
];
|
|
660
|
-
case 9:
|
|
620
|
+
_state.label = 4;
|
|
621
|
+
case 4:
|
|
661
622
|
return [
|
|
662
623
|
4,
|
|
663
|
-
sheets.spreadsheets.values.
|
|
624
|
+
sheets.spreadsheets.values.get({
|
|
664
625
|
spreadsheetId: spreadsheetId,
|
|
665
|
-
range: "".concat(resolvedSheetTitle, "!
|
|
666
|
-
|
|
667
|
-
insertDataOption: 'INSERT_ROWS',
|
|
668
|
-
requestBody: {
|
|
669
|
-
values: [
|
|
670
|
-
header
|
|
671
|
-
]
|
|
672
|
-
}
|
|
626
|
+
range: "".concat(resolvedSheetTitle, "!1:1"),
|
|
627
|
+
majorDimension: 'ROWS'
|
|
673
628
|
})
|
|
674
629
|
];
|
|
675
|
-
case
|
|
676
|
-
_state.sent();
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
header: header,
|
|
681
|
-
keySet: new Set()
|
|
682
|
-
}
|
|
683
|
-
];
|
|
684
|
-
case 11:
|
|
630
|
+
case 5:
|
|
631
|
+
resp = _state.sent();
|
|
632
|
+
vr = resp.data;
|
|
633
|
+
values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
|
|
634
|
+
existingHeader = values.length ? values : null;
|
|
685
635
|
if (!!existingHeader) return [
|
|
686
636
|
3,
|
|
687
|
-
|
|
637
|
+
7
|
|
688
638
|
];
|
|
689
639
|
return [
|
|
690
640
|
4,
|
|
@@ -700,7 +650,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
700
650
|
}
|
|
701
651
|
})
|
|
702
652
|
];
|
|
703
|
-
case
|
|
653
|
+
case 6:
|
|
704
654
|
_state.sent();
|
|
705
655
|
return [
|
|
706
656
|
2,
|
|
@@ -709,7 +659,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
709
659
|
keySet: new Set()
|
|
710
660
|
}
|
|
711
661
|
];
|
|
712
|
-
case
|
|
662
|
+
case 7:
|
|
713
663
|
mergedHeader = existingHeader.slice();
|
|
714
664
|
_iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
|
|
715
665
|
try {
|
|
@@ -756,7 +706,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
756
706
|
}
|
|
757
707
|
if (!(mergedHeader.length !== existingHeader.length)) return [
|
|
758
708
|
3,
|
|
759
|
-
|
|
709
|
+
9
|
|
760
710
|
];
|
|
761
711
|
return [
|
|
762
712
|
4,
|
|
@@ -771,10 +721,10 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
771
721
|
}
|
|
772
722
|
})
|
|
773
723
|
];
|
|
774
|
-
case
|
|
724
|
+
case 8:
|
|
775
725
|
_state.sent();
|
|
776
|
-
_state.label =
|
|
777
|
-
case
|
|
726
|
+
_state.label = 9;
|
|
727
|
+
case 9:
|
|
778
728
|
keySet = new Set();
|
|
779
729
|
normalizeKeyColumnsByName = function normalizeKeyColumnsByName(kc, hdr) {
|
|
780
730
|
if (!Array.isArray(kc) || kc.length === 0) return [];
|
|
@@ -833,7 +783,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
833
783
|
if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
|
|
834
784
|
})
|
|
835
785
|
];
|
|
836
|
-
case
|
|
786
|
+
case 10:
|
|
837
787
|
_state.sent();
|
|
838
788
|
return [
|
|
839
789
|
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 if (sheetRef) {\n const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n if (sheet) {\n resolvedSheetTitle = sheet.properties?.title || sheetRef;\n } else {\n // Sheet doesn't exist, use the sheetRef as the title for creation\n resolvedSheetTitle = sheetRef;\n }\n }\n\n if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n let existingHeader: string[] | null = null;\n try {\n const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n const vr = resp.data as ValueRange;\n const values = ((vr?.values || [])[0] || []) as string[];\n existingHeader = values.length ? values : null;\n } catch (_err: unknown) {\n try {\n await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n } catch {}\n await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n return { header, keySet: new Set<string>() };\n }\n\n if (!existingHeader) {\n await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n return { header, keySet: new Set<string>() };\n }\n\n const mergedHeader = existingHeader.slice();\n for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n if (Array.isArray(keyColumns)) {\n for (const name of keyColumns) {\n if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n if (!mergedHeader.includes(name)) mergedHeader.push(name);\n }\n }\n\n if (mergedHeader.length !== existingHeader.length) {\n await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n }\n\n const keySet = new Set<string>();\n\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","sheet","defaultHeader","existingHeader","resp","vr","_err","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 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"}
|
package/dist/esm/constants.d.ts
CHANGED
|
@@ -7,3 +7,27 @@
|
|
|
7
7
|
export declare const GOOGLE_SCOPE = "openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive";
|
|
8
8
|
export declare const PASTE_TYPES: readonly ["PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA", "PASTE_DATA_VALIDATION", "PASTE_CONDITIONAL_FORMATTING"];
|
|
9
9
|
export declare const PASTE_ORIENTATIONS: readonly ["NORMAL", "TRANSPOSE"];
|
|
10
|
+
export declare const NATIVE_DATE_POINTER = "Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
11
|
+
export declare const RENDER_DESCRIPTION = "How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.";
|
|
12
|
+
export declare const NATIVE_DATE_EXAMPLE_WRITE: {
|
|
13
|
+
readonly requests: readonly [{
|
|
14
|
+
readonly range: "B2";
|
|
15
|
+
readonly majorDimension: "ROWS";
|
|
16
|
+
readonly values: readonly [readonly [46334.5]];
|
|
17
|
+
}];
|
|
18
|
+
readonly valueInputOption: "RAW";
|
|
19
|
+
};
|
|
20
|
+
export declare const NATIVE_DATE_EXAMPLE_FORMAT: {
|
|
21
|
+
readonly requests: readonly [{
|
|
22
|
+
readonly range: "B2";
|
|
23
|
+
readonly numberFormat: {
|
|
24
|
+
readonly type: "DATE";
|
|
25
|
+
readonly pattern: "yyyy-mm-dd hh:mm";
|
|
26
|
+
};
|
|
27
|
+
}];
|
|
28
|
+
};
|
|
29
|
+
export declare const NATIVE_DATE_EXAMPLE_READ: {
|
|
30
|
+
readonly range: "B2";
|
|
31
|
+
readonly render: "UNFORMATTED_VALUE";
|
|
32
|
+
};
|
|
33
|
+
export declare const NATIVE_DATE_GUIDANCE: string;
|
package/dist/esm/constants.js
CHANGED
|
@@ -19,3 +19,44 @@ export const PASTE_ORIENTATIONS = [
|
|
|
19
19
|
'NORMAL',
|
|
20
20
|
'TRANSPOSE'
|
|
21
21
|
];
|
|
22
|
+
// Native-date guidance shared by the write, format and read tool descriptions; the example arguments are checked against the tool schemas in test/unit/constants.test.ts.
|
|
23
|
+
// Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and .../ValueInputOption
|
|
24
|
+
export const NATIVE_DATE_POINTER = 'Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.';
|
|
25
|
+
export const RENDER_DESCRIPTION = 'How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.';
|
|
26
|
+
// Example call arguments (id/gid/includeData omitted), step 1 to 3 of the native-date write, format and read-back.
|
|
27
|
+
export const NATIVE_DATE_EXAMPLE_WRITE = {
|
|
28
|
+
requests: [
|
|
29
|
+
{
|
|
30
|
+
range: 'B2',
|
|
31
|
+
majorDimension: 'ROWS',
|
|
32
|
+
values: [
|
|
33
|
+
[
|
|
34
|
+
46334.5
|
|
35
|
+
]
|
|
36
|
+
]
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
valueInputOption: 'RAW'
|
|
40
|
+
};
|
|
41
|
+
export const NATIVE_DATE_EXAMPLE_FORMAT = {
|
|
42
|
+
requests: [
|
|
43
|
+
{
|
|
44
|
+
range: 'B2',
|
|
45
|
+
numberFormat: {
|
|
46
|
+
type: 'DATE',
|
|
47
|
+
pattern: 'yyyy-mm-dd hh:mm'
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
]
|
|
51
|
+
};
|
|
52
|
+
export const NATIVE_DATE_EXAMPLE_READ = {
|
|
53
|
+
range: 'B2',
|
|
54
|
+
render: 'UNFORMATTED_VALUE'
|
|
55
|
+
};
|
|
56
|
+
export const NATIVE_DATE_GUIDANCE = [
|
|
57
|
+
"NATIVE DATES: a native Sheets date/time is a serial number plus a date number format. The integer counts days from 1899-12-30; the fraction is the time of day (46334.5 = 2026-11-08 12:00, with a matching format). A serial carries no timezone of its own and is read in the spreadsheet's timezone.",
|
|
58
|
+
'RAW stores values as supplied, so a date-looking string stays text; a numeric serial plus a date format is an explicit native-date write. USER_ENTERED may parse date strings the way the Sheets UI does, using the workbook locale.',
|
|
59
|
+
'Keep the intended wall time/timezone and recorded precision: a date-only record is not an exact midnight event time, and existing timestamps are not reinterpreted.',
|
|
60
|
+
`Example: (1) values-batch-update ${JSON.stringify(NATIVE_DATE_EXAMPLE_WRITE)}; (2) cells-format ${JSON.stringify(NATIVE_DATE_EXAMPLE_FORMAT)}; (3) rows-get (or columns-get / values-search) ${JSON.stringify(NATIVE_DATE_EXAMPLE_READ)} returns 46334.5 (numeric, so it is not text), while render FORMATTED_VALUE returns "2026-11-08 12:00"; then check dependent chronological formulas.`,
|
|
61
|
+
'Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and https://developers.google.com/workspace/sheets/api/reference/rest/v4/ValueInputOption'
|
|
62
|
+
].join(' ');
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n\n// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)\nexport const PASTE_TYPES = ['PASTE_NORMAL', 'PASTE_VALUES', 'PASTE_FORMAT', 'PASTE_NO_BORDERS', 'PASTE_FORMULA', 'PASTE_DATA_VALIDATION', 'PASTE_CONDITIONAL_FORMATTING'] as const;\nexport const PASTE_ORIENTATIONS = ['NORMAL', 'TRANSPOSE'] as const;\n"],"names":["GOOGLE_SCOPE","PASTE_TYPES","PASTE_ORIENTATIONS"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L;AAExN,+FAA+F;AAC/F,OAAO,MAAMC,cAAc;IAAC;IAAgB;IAAgB;IAAgB;IAAoB;IAAiB;IAAyB;CAA+B,CAAU;AACnL,OAAO,MAAMC,qBAAqB;IAAC;IAAU;CAAY,CAAU"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n\n// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)\nexport const PASTE_TYPES = ['PASTE_NORMAL', 'PASTE_VALUES', 'PASTE_FORMAT', 'PASTE_NO_BORDERS', 'PASTE_FORMULA', 'PASTE_DATA_VALIDATION', 'PASTE_CONDITIONAL_FORMATTING'] as const;\nexport const PASTE_ORIENTATIONS = ['NORMAL', 'TRANSPOSE'] as const;\n\n// Native-date guidance shared by the write, format and read tool descriptions; the example arguments are checked against the tool schemas in test/unit/constants.test.ts.\n// Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and .../ValueInputOption\nexport const NATIVE_DATE_POINTER = 'Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.';\n\nexport const RENDER_DESCRIPTION =\n 'How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting; native dates come back as numeric serials (days since 1899-12-30), text dates as strings, so use it to confirm a date is numeric. FORMULA: show formula text instead of result.';\n\n// Example call arguments (id/gid/includeData omitted), step 1 to 3 of the native-date write, format and read-back.\nexport const NATIVE_DATE_EXAMPLE_WRITE = { requests: [{ range: 'B2', majorDimension: 'ROWS', values: [[46334.5]] }], valueInputOption: 'RAW' } as const;\nexport const NATIVE_DATE_EXAMPLE_FORMAT = { requests: [{ range: 'B2', numberFormat: { type: 'DATE', pattern: 'yyyy-mm-dd hh:mm' } }] } as const;\nexport const NATIVE_DATE_EXAMPLE_READ = { range: 'B2', render: 'UNFORMATTED_VALUE' } as const;\n\nexport const NATIVE_DATE_GUIDANCE = [\n \"NATIVE DATES: a native Sheets date/time is a serial number plus a date number format. The integer counts days from 1899-12-30; the fraction is the time of day (46334.5 = 2026-11-08 12:00, with a matching format). A serial carries no timezone of its own and is read in the spreadsheet's timezone.\",\n 'RAW stores values as supplied, so a date-looking string stays text; a numeric serial plus a date format is an explicit native-date write. USER_ENTERED may parse date strings the way the Sheets UI does, using the workbook locale.',\n 'Keep the intended wall time/timezone and recorded precision: a date-only record is not an exact midnight event time, and existing timestamps are not reinterpreted.',\n `Example: (1) values-batch-update ${JSON.stringify(NATIVE_DATE_EXAMPLE_WRITE)}; (2) cells-format ${JSON.stringify(NATIVE_DATE_EXAMPLE_FORMAT)}; (3) rows-get (or columns-get / values-search) ${JSON.stringify(NATIVE_DATE_EXAMPLE_READ)} returns 46334.5 (numeric, so it is not text), while render FORMATTED_VALUE returns \"2026-11-08 12:00\"; then check dependent chronological formulas.`,\n 'Docs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/DateTimeRenderOption and https://developers.google.com/workspace/sheets/api/reference/rest/v4/ValueInputOption',\n].join(' ');\n"],"names":["GOOGLE_SCOPE","PASTE_TYPES","PASTE_ORIENTATIONS","NATIVE_DATE_POINTER","RENDER_DESCRIPTION","NATIVE_DATE_EXAMPLE_WRITE","requests","range","majorDimension","values","valueInputOption","NATIVE_DATE_EXAMPLE_FORMAT","numberFormat","type","pattern","NATIVE_DATE_EXAMPLE_READ","render","NATIVE_DATE_GUIDANCE","JSON","stringify","join"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L;AAExN,+FAA+F;AAC/F,OAAO,MAAMC,cAAc;IAAC;IAAgB;IAAgB;IAAgB;IAAoB;IAAiB;IAAyB;CAA+B,CAAU;AACnL,OAAO,MAAMC,qBAAqB;IAAC;IAAU;CAAY,CAAU;AAEnE,0KAA0K;AAC1K,2HAA2H;AAC3H,OAAO,MAAMC,sBAAsB,gJAAgJ;AAEnL,OAAO,MAAMC,qBACX,sTAAsT;AAExT,mHAAmH;AACnH,OAAO,MAAMC,4BAA4B;IAAEC,UAAU;QAAC;YAAEC,OAAO;YAAMC,gBAAgB;YAAQC,QAAQ;gBAAC;oBAAC;iBAAQ;aAAC;QAAC;KAAE;IAAEC,kBAAkB;AAAM,EAAW;AACxJ,OAAO,MAAMC,6BAA6B;IAAEL,UAAU;QAAC;YAAEC,OAAO;YAAMK,cAAc;gBAAEC,MAAM;gBAAQC,SAAS;YAAmB;QAAE;KAAE;AAAC,EAAW;AAChJ,OAAO,MAAMC,2BAA2B;IAAER,OAAO;IAAMS,QAAQ;AAAoB,EAAW;AAE9F,OAAO,MAAMC,uBAAuB;IAClC;IACA;IACA;IACA,CAAC,iCAAiC,EAAEC,KAAKC,SAAS,CAACd,2BAA2B,mBAAmB,EAAEa,KAAKC,SAAS,CAACR,4BAA4B,gDAAgD,EAAEO,KAAKC,SAAS,CAACJ,0BAA0B,oJAAoJ,CAAC;IAC9X;CACD,CAACK,IAAI,CAAC,KAAK"}
|
|
@@ -25,11 +25,11 @@ declare const inputSchema: z.ZodObject<{
|
|
|
25
25
|
}>>;
|
|
26
26
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
27
27
|
type: z.ZodEnum<{
|
|
28
|
+
DATE: "DATE";
|
|
28
29
|
TEXT: "TEXT";
|
|
29
30
|
NUMBER: "NUMBER";
|
|
30
31
|
PERCENT: "PERCENT";
|
|
31
32
|
CURRENCY: "CURRENCY";
|
|
32
|
-
DATE: "DATE";
|
|
33
33
|
TIME: "TIME";
|
|
34
34
|
}>;
|
|
35
35
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -71,7 +71,7 @@ declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Pr
|
|
|
71
71
|
export default function createTool(): {
|
|
72
72
|
name: string;
|
|
73
73
|
config: {
|
|
74
|
-
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.";
|
|
74
|
+
readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
|
|
75
75
|
readonly inputSchema: z.ZodObject<{
|
|
76
76
|
id: z.ZodString;
|
|
77
77
|
gid: z.ZodCoercedString<unknown>;
|
|
@@ -96,11 +96,11 @@ export default function createTool(): {
|
|
|
96
96
|
}>>;
|
|
97
97
|
numberFormat: z.ZodOptional<z.ZodObject<{
|
|
98
98
|
type: z.ZodEnum<{
|
|
99
|
+
DATE: "DATE";
|
|
99
100
|
TEXT: "TEXT";
|
|
100
101
|
NUMBER: "NUMBER";
|
|
101
102
|
PERCENT: "PERCENT";
|
|
102
103
|
CURRENCY: "CURRENCY";
|
|
103
|
-
DATE: "DATE";
|
|
104
104
|
TIME: "TIME";
|
|
105
105
|
}>;
|
|
106
106
|
pattern: z.ZodOptional<z.ZodString>;
|
|
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
|
|
|
3
3
|
const { AuthRequiredBranchSchema } = schemas;
|
|
4
4
|
import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
|
|
5
5
|
import { z } from 'zod';
|
|
6
|
+
import { NATIVE_DATE_POINTER } from '../../constants.js';
|
|
6
7
|
import { googleAuth } from '../../lib/google-auth.js';
|
|
7
8
|
import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
|
|
8
9
|
import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
|
|
@@ -22,7 +23,7 @@ const NumberFormatSchema = z.object({
|
|
|
22
23
|
'DATE',
|
|
23
24
|
'TIME'
|
|
24
25
|
]).describe('Number format type'),
|
|
25
|
-
pattern: z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency)')
|
|
26
|
+
pattern: z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency, "yyyy-mm-dd hh:mm" for a date/time serial)')
|
|
26
27
|
});
|
|
27
28
|
// Border schema
|
|
28
29
|
const BorderSchema = z.object({
|
|
@@ -70,7 +71,7 @@ const outputSchema = z.discriminatedUnion('type', [
|
|
|
70
71
|
AuthRequiredBranchSchema
|
|
71
72
|
]);
|
|
72
73
|
const config = {
|
|
73
|
-
description:
|
|
74
|
+
description: `Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:"DATE", pattern:"yyyy-mm-dd hh:mm"} only displays a numeric serial as a date; it does not convert text. ${NATIVE_DATE_POINTER}`,
|
|
74
75
|
inputSchema,
|
|
75
76
|
outputSchema: z.object({
|
|
76
77
|
result: outputSchema
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, 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 { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\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\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, 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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency, \"yyyy-mm-dd hh:mm\" for a date/time serial)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. ${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\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
|
|
@@ -6,8 +6,8 @@ declare const inputSchema: z.ZodObject<{
|
|
|
6
6
|
id: z.ZodString;
|
|
7
7
|
gid: z.ZodCoercedString<unknown>;
|
|
8
8
|
render: z.ZodOptional<z.ZodEnum<{
|
|
9
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
10
9
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
10
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
11
11
|
FORMULA: "FORMULA";
|
|
12
12
|
}>>;
|
|
13
13
|
}, z.core.$strip>;
|
|
@@ -32,8 +32,8 @@ export default function createTool(): {
|
|
|
32
32
|
id: z.ZodString;
|
|
33
33
|
gid: z.ZodCoercedString<unknown>;
|
|
34
34
|
render: z.ZodOptional<z.ZodEnum<{
|
|
35
|
-
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
36
35
|
UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
|
|
36
|
+
FORMATTED_VALUE: "FORMATTED_VALUE";
|
|
37
37
|
FORMULA: "FORMULA";
|
|
38
38
|
}>>;
|
|
39
39
|
}, z.core.$strip>;
|
|
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
|
|
|
3
3
|
const { AuthRequiredBranchSchema } = schemas;
|
|
4
4
|
import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
|
|
5
5
|
import { z } from 'zod';
|
|
6
|
+
import { RENDER_DESCRIPTION } from '../../constants.js';
|
|
6
7
|
import { googleAuth } from '../../lib/google-auth.js';
|
|
7
8
|
import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
|
|
8
9
|
const inputSchema = z.object({
|
|
@@ -12,7 +13,7 @@ const inputSchema = z.object({
|
|
|
12
13
|
'FORMATTED_VALUE',
|
|
13
14
|
'UNFORMATTED_VALUE',
|
|
14
15
|
'FORMULA'
|
|
15
|
-
]).optional().describe(
|
|
16
|
+
]).optional().describe(RENDER_DESCRIPTION)
|
|
16
17
|
});
|
|
17
18
|
// Success branch schema - uses columns: for consistency with standard vocabulary
|
|
18
19
|
const successBranchSchema = z.object({
|