@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.
- package/README.md +1 -1
- package/dist/cjs/lib/create-store.d.cts +2 -1
- package/dist/cjs/lib/create-store.d.ts +2 -1
- package/dist/cjs/lib/create-store.js +82 -7
- package/dist/cjs/lib/create-store.js.map +1 -1
- package/dist/cjs/mcp/tools/columns-update.js +5 -1
- package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
- package/dist/cjs/mcp/tools/csv-get-columns.js +1 -1
- package/dist/cjs/mcp/tools/lib/dimension-operations.js +1 -1
- package/dist/cjs/mcp/tools/rows-append.js +1 -2
- package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
- package/dist/cjs/mcp/tools/rows-csv-append.js +2 -3
- package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/cjs/setup/http.js +1 -1
- package/dist/cjs/setup/runtime.d.cts +2 -2
- package/dist/cjs/setup/runtime.d.ts +2 -2
- package/dist/cjs/setup/runtime.js +6 -6
- package/dist/cjs/setup/runtime.js.map +1 -1
- package/dist/cjs/setup/stdio.js +1 -1
- package/dist/cjs/spreadsheet/data-operations.d.cts +8 -1
- package/dist/cjs/spreadsheet/data-operations.d.ts +8 -1
- package/dist/cjs/spreadsheet/data-operations.js +80 -102
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/markdown-runs.js +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +0 -67
- package/dist/cjs/spreadsheet/range-operations.d.ts +0 -67
- package/dist/cjs/spreadsheet/range-operations.js +1 -237
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.d.cts +4 -17
- package/dist/cjs/spreadsheet/sheet-operations.d.ts +4 -17
- package/dist/cjs/spreadsheet/sheet-operations.js +18 -222
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/lib/create-store.d.ts +2 -1
- package/dist/esm/lib/create-store.js +22 -4
- package/dist/esm/lib/create-store.js.map +1 -1
- package/dist/esm/mcp/tools/columns-update.js +5 -1
- package/dist/esm/mcp/tools/columns-update.js.map +1 -1
- package/dist/esm/mcp/tools/rows-append.js +1 -2
- package/dist/esm/mcp/tools/rows-append.js.map +1 -1
- package/dist/esm/mcp/tools/rows-csv-append.js +1 -2
- package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
- package/dist/esm/setup/runtime.d.ts +2 -2
- package/dist/esm/setup/runtime.js +6 -6
- package/dist/esm/setup/runtime.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.d.ts +8 -1
- package/dist/esm/spreadsheet/data-operations.js +27 -35
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +0 -67
- package/dist/esm/spreadsheet/range-operations.js +0 -227
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.d.ts +4 -17
- package/dist/esm/spreadsheet/sheet-operations.js +7 -115
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/package.json +7 -7
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/range-operations.ts"],"sourcesContent":["/**\n * Range Operations Utilities for Google Sheets\n *\n * This module provides comprehensive utilities for working with A1 notation,\n * range parsing, batch operations, and range validation in Google Sheets.\n *\n * Key features:\n * - A1 notation validation and parsing\n * - Range manipulation and calculation utilities\n * - Batch operation builders for Google Sheets API\n * - Cell count and dimension calculations\n * - Range conflict detection for batch operations\n * - Google Sheets limits validation and enforcement\n */\n\nimport { a1Col } from './column-utilities.ts';\n\n// Google Sheets constants and limits\nexport const GOOGLE_SHEETS_LIMITS = {\n MAX_ROWS: 10_000_000,\n MAX_COLUMNS: 18_278, // ZZZ in base-26\n MAX_CELLS: 10_000_000, // Approximate limit for total cells\n MAX_BATCH_REQUESTS: 1000,\n MAX_DIMENSION_BATCH_REQUESTS: 100,\n} as const;\n\n/**\n * Represents a parsed cell reference (e.g., A1, B5)\n */\nexport interface CellReference {\n column: string;\n columnIndex: number; // 1-based\n row: number; // 1-based\n}\n\n/**\n * Represents a parsed range (e.g., A1:B5, A:B, 1:2)\n */\nexport interface RangeReference {\n type: 'cell' | 'row' | 'column' | 'range';\n startCell?: CellReference;\n endCell?: CellReference;\n startRow?: number;\n endRow?: number;\n startColumn?: string;\n endColumn?: string;\n startColumnIndex?: number;\n endColumnIndex?: number;\n}\n\n/**\n * Represents dimensions of a range\n */\nexport interface RangeDimensions {\n rows: number;\n columns: number;\n cells: number;\n}\n\n/**\n * Represents a range conflict between two ranges\n */\nexport interface RangeConflict {\n range1: string;\n range2: string;\n conflictType: 'overlap' | 'contains' | 'contained' | 'adjacent';\n description: string;\n}\n\n/**\n * A1 Notation Validation Utilities\n */\n\n/**\n * Validates if a string is a valid A1 notation\n */\nexport function isValidA1Notation(notation: string): boolean {\n if (!notation || typeof notation !== 'string') {\n return false;\n }\n\n // Use the same regex pattern as in the schema\n const a1Pattern = /^(?:[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000)(?::[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000))?|[A-Z]{1,3}:[A-Z]{1,3}|(?:[1-9]\\d{0,6}|10000000):(?:[1-9]\\d{0,6}|10000000))$/;\n\n if (!a1Pattern.test(notation)) {\n return false;\n }\n\n // Additional validation for Google Sheets limits\n const parts = notation.split(':');\n\n for (const part of parts) {\n // Check cell reference\n const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (cellMatch && cellMatch[1] && cellMatch[2]) {\n const [, colStr, rowStr] = cellMatch;\n\n // Validate column\n const colNum = columnStringToIndex(colStr);\n if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n return false;\n }\n\n // Validate row\n const rowNum = parseInt(rowStr, 10);\n if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n return false;\n }\n }\n\n // Check column reference\n const colMatch = part.match(/^([A-Z]{1,3})$/);\n if (colMatch && colMatch[1]) {\n const colNum = columnStringToIndex(colMatch[1]);\n if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n return false;\n }\n }\n\n // Check row reference\n const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n if (rowMatch && rowMatch[1]) {\n const rowNum = parseInt(rowMatch[1], 10);\n if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n return false;\n }\n }\n }\n\n return true;\n}\n\n/**\n * Validates A1 notation and throws detailed error if invalid\n */\nexport function validateA1Notation(notation: string): void {\n if (!isValidA1Notation(notation)) {\n throw new Error(`Invalid A1 notation: \"${notation}\". Valid formats: A1, A1:B2, A:B, 1:2`);\n }\n}\n\n/**\n * Range Parsing and Manipulation Functions\n */\n\n/**\n * Converts column string (A, B, AA, etc.) to 1-based index\n */\nexport function columnStringToIndex(colStr: string): number {\n let colNum = 0;\n for (let i = 0; i < colStr.length; i++) {\n colNum = colNum * 26 + (colStr.charCodeAt(i) - 64);\n }\n return colNum;\n}\n\n/**\n * Converts 1-based column index to column string (A, B, AA, etc.)\n */\nexport function columnIndexToString(colIndex: number): string {\n return a1Col(colIndex);\n}\n\n/**\n * Parses a cell reference (e.g., \"A1\", \"Z999\") into its components\n */\nexport function parseCellReference(cellRef: string): CellReference {\n const match = cellRef.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid cell reference: ${cellRef}`);\n }\n\n const [, column, rowStr] = match;\n const row = parseInt(rowStr, 10);\n const columnIndex = columnStringToIndex(column);\n\n return {\n column,\n columnIndex,\n row,\n };\n}\n\n/**\n * Parses A1 notation into a structured range reference\n */\nexport function parseA1Notation(notation: string): RangeReference {\n validateA1Notation(notation);\n\n const parts = notation.split(':');\n\n if (parts.length === 1) {\n const part = parts[0];\n if (!part) {\n throw new Error('Invalid A1 notation: empty part after split');\n }\n\n // Single cell reference (e.g., A1)\n const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (cellMatch && cellMatch[1] && cellMatch[2]) {\n const startCell = parseCellReference(part);\n return {\n type: 'cell',\n startCell,\n endCell: startCell,\n };\n }\n\n // Single column reference (e.g., A)\n const colMatch = part.match(/^([A-Z]{1,3})$/);\n if (colMatch && colMatch[1]) {\n const column = colMatch[1];\n const columnIndex = columnStringToIndex(column);\n return {\n type: 'column',\n startColumn: column,\n endColumn: column,\n startColumnIndex: columnIndex,\n endColumnIndex: columnIndex,\n };\n }\n\n // Single row reference (e.g., 1)\n const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n if (rowMatch && rowMatch[1]) {\n const row = parseInt(rowMatch[1], 10);\n return {\n type: 'row',\n startRow: row,\n endRow: row,\n };\n }\n }\n\n if (parts.length === 2 && parts[0] && parts[1]) {\n const [start, end] = parts;\n\n // Cell range (e.g., A1:B5)\n const startCellMatch = start.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n const endCellMatch = end.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n\n if (startCellMatch && endCellMatch && startCellMatch[1] && startCellMatch[2] && endCellMatch[1] && endCellMatch[2]) {\n const startCell = parseCellReference(start);\n const endCell = parseCellReference(end);\n return {\n type: 'range',\n startCell,\n endCell,\n };\n }\n\n // Column range (e.g., A:B)\n const startColMatch = start.match(/^([A-Z]{1,3})$/);\n const endColMatch = end.match(/^([A-Z]{1,3})$/);\n\n if (startColMatch && endColMatch && startColMatch[1] && endColMatch[1]) {\n const startColumn = startColMatch[1];\n const endColumn = endColMatch[1];\n const startColumnIndex = columnStringToIndex(startColumn);\n const endColumnIndex = columnStringToIndex(endColumn);\n return {\n type: 'column',\n startColumn,\n endColumn,\n startColumnIndex,\n endColumnIndex,\n };\n }\n\n // Row range (e.g., 1:5)\n const startRowMatch = start.match(/^([1-9]\\d{0,6}|10000000)$/);\n const endRowMatch = end.match(/^([1-9]\\d{0,6}|10000000)$/);\n\n if (startRowMatch && endRowMatch && startRowMatch[1] && endRowMatch[1]) {\n const startRow = parseInt(startRowMatch[1], 10);\n const endRow = parseInt(endRowMatch[1], 10);\n return {\n type: 'row',\n startRow,\n endRow,\n };\n }\n }\n\n throw new Error(`Unable to parse A1 notation: ${notation}`);\n}\n\n/**\n * Converts a range reference back to A1 notation\n */\nexport function rangeToA1Notation(range: RangeReference): string {\n switch (range.type) {\n case 'cell':\n if (!range.startCell) throw new Error('Invalid cell range: missing startCell');\n return `${range.startCell.column}${range.startCell.row}`;\n\n case 'range':\n if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing start or end cell');\n return `${range.startCell.column}${range.startCell.row}:${range.endCell.column}${range.endCell.row}`;\n\n case 'column':\n if (!range.startColumn || !range.endColumn) throw new Error('Invalid column range: missing start or end column');\n if (range.startColumn === range.endColumn) {\n return range.startColumn;\n }\n return `${range.startColumn}:${range.endColumn}`;\n\n case 'row':\n if (range.startRow === undefined || range.endRow === undefined) throw new Error('Invalid row range: missing start or end row');\n if (range.startRow === range.endRow) {\n return range.startRow.toString();\n }\n return `${range.startRow}:${range.endRow}`;\n\n default:\n throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n }\n}\n\n/**\n * Cell Count and Dimension Calculation Utilities\n */\n\n/**\n * Calculates the dimensions of a range\n */\nexport function calculateRangeDimensions(notation: string): RangeDimensions {\n const range = parseA1Notation(notation);\n\n switch (range.type) {\n case 'cell':\n return { rows: 1, columns: 1, cells: 1 };\n\n case 'range': {\n if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing cells');\n const rows = range.endCell.row - range.startCell.row + 1;\n const columns = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n return { rows, columns, cells: rows * columns };\n }\n\n case 'column': {\n if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n throw new Error('Invalid column range: missing column indices');\n }\n const columnCount = range.endColumnIndex - range.startColumnIndex + 1;\n return {\n rows: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n columns: columnCount,\n cells: GOOGLE_SHEETS_LIMITS.MAX_ROWS * columnCount,\n };\n }\n\n case 'row': {\n if (range.startRow === undefined || range.endRow === undefined) {\n throw new Error('Invalid row range: missing row numbers');\n }\n const rowCount = range.endRow - range.startRow + 1;\n return {\n rows: rowCount,\n columns: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n cells: rowCount * GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n };\n }\n\n default:\n throw new Error(`Unknown range type: ${(range as { type: string }).type}`);\n }\n}\n\n/**\n * Counts cells in a finite sheet-local range, rejecting reversed bounds.\n */\nexport function calculateFiniteRangeCellCount(notation: string): number {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n const dimensions = calculateRangeDimensions(notation);\n if (dimensions.rows < 1 || dimensions.columns < 1) throw new Error(`Range end must not precede its start: ${notation}`);\n return dimensions.cells;\n}\n\nexport function calculateTotalCells(ranges: string[]): number {\n return ranges.reduce((total, range) => {\n const dimensions = calculateRangeDimensions(range);\n return total + dimensions.cells;\n }, 0);\n}\n\n/**\n * Batch Operation Builders for Google API\n */\n\n/**\n * Builds a values batch update request for Google Sheets API\n */\nexport function buildValuesBatchUpdateRequest(\n requests: Array<{\n range: string;\n values: (string | number | boolean | null | undefined)[][];\n majorDimension?: 'ROWS' | 'COLUMNS';\n }>,\n sheetTitle: string,\n options: {\n valueInputOption?: 'RAW' | 'USER_ENTERED';\n includeValuesInResponse?: boolean;\n responseDateTimeRenderOption?: 'FORMATTED_STRING' | 'SERIAL_NUMBER';\n responseValueRenderOption?: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';\n } = {}\n) {\n // Validate all ranges first\n requests.forEach((req, index) => {\n try {\n validateA1Notation(req.range);\n } catch (error) {\n throw new Error(`Invalid range in request ${index}: ${error}`);\n }\n });\n\n // Calculate total cells for validation\n const totalCells = calculateTotalCells(requests.map((r) => r.range));\n if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n throw new Error(`Batch update exceeds maximum cells limit: ${totalCells} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS}`);\n }\n\n // Build the request\n const data = requests.map((req) => ({\n range: `${sheetTitle}!${req.range}`,\n values: req.values,\n majorDimension: req.majorDimension || 'ROWS',\n }));\n\n return {\n valueInputOption: options.valueInputOption || 'USER_ENTERED',\n data,\n includeValuesInResponse: options.includeValuesInResponse || false,\n responseDateTimeRenderOption: options.responseDateTimeRenderOption || 'FORMATTED_STRING',\n responseValueRenderOption: options.responseValueRenderOption || 'FORMATTED_VALUE',\n };\n}\n\n/**\n * Range Conflict Detection\n */\n\n/**\n * Checks if two ranges overlap\n */\nexport function rangesOverlap(range1: string, range2: string): boolean {\n try {\n const parsed1 = parseA1Notation(range1);\n const parsed2 = parseA1Notation(range2);\n\n // Different types might still overlap, so we need to normalize to cell ranges\n const normalized1 = normalizeRangeToBounds(parsed1);\n const normalized2 = normalizeRangeToBounds(parsed2);\n\n // Check for overlap\n return !(normalized1.endRow < normalized2.startRow || normalized2.endRow < normalized1.startRow || normalized1.endCol < normalized2.startCol || normalized2.endCol < normalized1.startCol);\n } catch {\n // If we can't parse the ranges, assume no overlap\n return false;\n }\n}\n\n/**\n * Normalizes a range to bounds for overlap checking\n */\nfunction normalizeRangeToBounds(range: RangeReference): {\n startRow: number;\n endRow: number;\n startCol: number;\n endCol: number;\n} {\n switch (range.type) {\n case 'cell':\n if (!range.startCell) throw new Error('Invalid cell range');\n return {\n startRow: range.startCell.row,\n endRow: range.startCell.row,\n startCol: range.startCell.columnIndex,\n endCol: range.startCell.columnIndex,\n };\n\n case 'range':\n if (!range.startCell || !range.endCell) throw new Error('Invalid range');\n return {\n startRow: range.startCell.row,\n endRow: range.endCell.row,\n startCol: range.startCell.columnIndex,\n endCol: range.endCell.columnIndex,\n };\n\n case 'column':\n if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n throw new Error('Invalid column range');\n }\n return {\n startRow: 1,\n endRow: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n startCol: range.startColumnIndex,\n endCol: range.endColumnIndex,\n };\n\n case 'row':\n if (range.startRow === undefined || range.endRow === undefined) {\n throw new Error('Invalid row range');\n }\n return {\n startRow: range.startRow,\n endRow: range.endRow,\n startCol: 1,\n endCol: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n };\n\n default:\n throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n }\n}\n\n/**\n * Detects conflicts between multiple ranges\n */\nexport function detectRangeConflicts(ranges: string[]): RangeConflict[] {\n const conflicts: RangeConflict[] = [];\n\n for (let i = 0; i < ranges.length; i++) {\n for (let j = i + 1; j < ranges.length; j++) {\n const range1 = ranges[i];\n const range2 = ranges[j];\n\n if (!range1 || !range2) continue;\n\n if (rangesOverlap(range1, range2)) {\n conflicts.push({\n range1,\n range2,\n conflictType: 'overlap',\n description: `Ranges ${range1} and ${range2} overlap`,\n });\n }\n }\n }\n\n return conflicts;\n}\n\n/**\n * Validates that a batch of ranges doesn't exceed Google Sheets limits\n */\nexport function validateBatchRanges(ranges: string[]): {\n valid: boolean;\n errors: string[];\n warnings: string[];\n totalCells: number;\n} {\n const errors: string[] = [];\n const warnings: string[] = [];\n let totalCells = 0;\n\n // Validate each range\n ranges.forEach((range, index) => {\n try {\n validateA1Notation(range);\n const dimensions = calculateRangeDimensions(range);\n totalCells += dimensions.cells;\n\n // Check for very large ranges that might cause performance issues\n if (dimensions.cells > 1_000_000) {\n warnings.push(`Range ${index + 1} (${range}) affects ${dimensions.cells.toLocaleString()} cells, which may impact performance`);\n }\n } catch (error) {\n errors.push(`Range ${index + 1} (${range}): ${error}`);\n }\n });\n\n // Check batch size limits\n if (ranges.length > GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS) {\n errors.push(`Too many ranges: ${ranges.length} > ${GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS}`);\n }\n\n // Check total cells limit\n if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n errors.push(`Total cells exceed limit: ${totalCells.toLocaleString()} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS.toLocaleString()}`);\n }\n\n // Check for conflicts\n const conflicts = detectRangeConflicts(ranges);\n conflicts.forEach((conflict) => {\n warnings.push(conflict.description);\n });\n\n return {\n valid: errors.length === 0,\n errors,\n warnings,\n totalCells,\n };\n}\n\n/**\n * Utility Functions for Common Range Operations\n */\n\n/**\n * Expands a range by a specified number of rows and columns\n */\nexport function expandRange(notation: string, expandRows: number, expandCols: number): string {\n const range = parseA1Notation(notation);\n\n if (range.type === 'cell' && range.startCell) {\n const newEndRow = Math.min(range.startCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n const newEndCol = Math.min(range.startCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n const newEndColStr = columnIndexToString(newEndCol);\n\n if (expandRows === 0 && expandCols === 0) {\n return notation;\n }\n\n return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n }\n\n if (range.type === 'range' && range.startCell && range.endCell) {\n const newEndRow = Math.min(range.endCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n const newEndCol = Math.min(range.endCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n const newEndColStr = columnIndexToString(newEndCol);\n\n return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n }\n\n // For row and column ranges, expansion doesn't make sense in the same way\n return notation;\n}\n\n/**\n * Splits a large range into smaller chunks for batch processing\n */\nexport function splitRangeIntoChunks(notation: string, maxCellsPerChunk = 100_000): string[] {\n const range = parseA1Notation(notation);\n const dimensions = calculateRangeDimensions(notation);\n\n if (dimensions.cells <= maxCellsPerChunk) {\n return [notation];\n }\n\n const chunks: string[] = [];\n\n if (range.type === 'range' && range.startCell && range.endCell) {\n const totalRows = range.endCell.row - range.startCell.row + 1;\n const totalCols = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n\n // Calculate chunk size based on max cells\n const cellsPerRow = totalCols;\n const maxRowsPerChunk = Math.floor(maxCellsPerChunk / cellsPerRow);\n\n if (maxRowsPerChunk >= 1) {\n // Split by rows\n for (let currentRow = range.startCell.row; currentRow <= range.endCell.row; currentRow += maxRowsPerChunk) {\n const chunkEndRow = Math.min(currentRow + maxRowsPerChunk - 1, range.endCell.row);\n const chunkRange = `${range.startCell.column}${currentRow}:${range.endCell.column}${chunkEndRow}`;\n chunks.push(chunkRange);\n }\n } else {\n // If even one row is too big, split by columns\n const maxColsPerChunk = Math.floor(maxCellsPerChunk / totalRows);\n\n for (let currentCol = range.startCell.columnIndex; currentCol <= range.endCell.columnIndex; currentCol += maxColsPerChunk) {\n const chunkEndCol = Math.min(currentCol + maxColsPerChunk - 1, range.endCell.columnIndex);\n const startColStr = columnIndexToString(currentCol);\n const endColStr = columnIndexToString(chunkEndCol);\n const chunkRange = `${startColStr}${range.startCell.row}:${endColStr}${range.endCell.row}`;\n chunks.push(chunkRange);\n }\n }\n } else {\n // For other range types, just return the original range\n // (column and row ranges are already at their limits)\n chunks.push(notation);\n }\n\n return chunks;\n}\n\n/**\n * Converts a RangeReference to Google Sheets API GridRange format\n *\n * This handles the different range types correctly:\n * - 'cell' and 'range' types: Extract indices from startCell/endCell\n * - 'row' types: Use startRow/endRow, omit column indices for full row\n * - 'column' types: Use startColumnIndex/endColumnIndex, omit row indices for full column\n *\n * Important: Google Sheets API uses 0-based indices, while A1 notation uses 1-based indices.\n * This function handles the conversion properly for each range type.\n */\nexport function rangeReferenceToGridRange(\n rangeRef: RangeReference,\n sheetId: number\n): {\n sheetId: number;\n startRowIndex?: number;\n endRowIndex?: number;\n startColumnIndex?: number;\n endColumnIndex?: number;\n} {\n if (rangeRef.type === 'cell' || rangeRef.type === 'range') {\n // For cell and range types, extract from startCell/endCell\n if (!rangeRef.startCell || !rangeRef.endCell) {\n throw new Error(`Invalid ${rangeRef.type} range: missing start or end cell`);\n }\n\n return {\n sheetId,\n // Convert 1-based row to 0-based startRowIndex\n startRowIndex: rangeRef.startCell.row - 1,\n // endRowIndex is exclusive (so row 5 becomes endRowIndex 5)\n endRowIndex: rangeRef.endCell.row,\n // Convert 1-based column index to 0-based startColumnIndex\n startColumnIndex: rangeRef.startCell.columnIndex - 1,\n // endColumnIndex is exclusive\n endColumnIndex: rangeRef.endCell.columnIndex,\n };\n }\n if (rangeRef.type === 'row') {\n // For row types, use startRow/endRow and omit column indices for full row width\n if (rangeRef.startRow === undefined || rangeRef.endRow === undefined) {\n throw new Error('Invalid row range: missing start or end row');\n }\n\n return {\n sheetId,\n // Convert 1-based row to 0-based startRowIndex\n startRowIndex: rangeRef.startRow - 1,\n // endRowIndex is exclusive\n endRowIndex: rangeRef.endRow,\n // Omit startColumnIndex and endColumnIndex to apply to all columns\n };\n }\n if (rangeRef.type === 'column') {\n // For column types, use startColumnIndex/endColumnIndex and omit row indices for full column height\n if (rangeRef.startColumnIndex === undefined || rangeRef.endColumnIndex === undefined) {\n throw new Error('Invalid column range: missing start or end column index');\n }\n\n return {\n sheetId,\n // Omit startRowIndex and endRowIndex to apply to all rows\n // Convert 1-based column index to 0-based startColumnIndex\n startColumnIndex: rangeRef.startColumnIndex - 1,\n // endColumnIndex is exclusive\n endColumnIndex: rangeRef.endColumnIndex,\n };\n }\n\n throw new Error(`Unknown range type: ${(rangeRef as { type: unknown }).type}`);\n}\n\n/**\n * A finite, sheet-local block of cells with 1-based inclusive bounds.\n */\nexport interface CellBlock {\n startRow: number;\n endRow: number;\n startColumn: number;\n endColumn: number;\n}\n\n/**\n * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.\n * Throws for invalid syntax, whole rows/columns and reversed bounds.\n */\nexport function parseFiniteCellBlock(notation: string): CellBlock {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n calculateFiniteRangeCellCount(notation);\n if (!range.startCell || !range.endCell) throw new Error(`Invalid range: ${notation}`);\n return { startRow: range.startCell.row, endRow: range.endCell.row, startColumn: range.startCell.columnIndex, endColumn: range.endCell.columnIndex };\n}\n\n/**\n * Formats a block as A1 notation (a single cell when it spans one cell).\n */\nexport function cellBlockToA1(block: CellBlock): string {\n const start = `${columnIndexToString(block.startColumn)}${block.startRow}`;\n if (block.startRow === block.endRow && block.startColumn === block.endColumn) return start;\n return `${start}:${columnIndexToString(block.endColumn)}${block.endRow}`;\n}\n\n/**\n * Footprint of a copy-paste: the cells written in the destination.\n *\n * - destination is one cell: the (oriented) source size anchored at that cell\n * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)\n * - anything else throws\n */\nexport function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock {\n const src = parseFiniteCellBlock(source);\n const dest = parseFiniteCellBlock(destination);\n const srcRows = src.endRow - src.startRow + 1;\n const srcColumns = src.endColumn - src.startColumn + 1;\n const rows = orientation === 'TRANSPOSE' ? srcColumns : srcRows;\n const columns = orientation === 'TRANSPOSE' ? srcRows : srcColumns;\n const destRows = dest.endRow - dest.startRow + 1;\n const destColumns = dest.endColumn - dest.startColumn + 1;\n\n if (destRows === 1 && destColumns === 1) {\n return { startRow: dest.startRow, endRow: dest.startRow + rows - 1, startColumn: dest.startColumn, endColumn: dest.startColumn + columns - 1 };\n }\n if (destRows % rows === 0 && destColumns % columns === 0) return dest;\n throw new Error(\n `Destination ${destination} is ${destRows}x${destColumns} cells; the ${orientation === 'TRANSPOSE' ? 'transposed ' : ''}source ${source} is ${rows}x${columns}. Use a single anchor cell (e.g., ${columnIndexToString(dest.startColumn)}${dest.startRow}) or a range whose height and width are whole multiples of ${rows}x${columns}.`\n );\n}\n"],"names":["a1Col","GOOGLE_SHEETS_LIMITS","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","isValidA1Notation","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","columnStringToIndex","rowNum","parseInt","colMatch","rowMatch","validateA1Notation","Error","i","length","charCodeAt","columnIndexToString","colIndex","parseCellReference","cellRef","column","row","columnIndex","parseA1Notation","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","rangeToA1Notation","range","undefined","toString","calculateRangeDimensions","rows","columns","cells","columnCount","rowCount","calculateFiniteRangeCellCount","dimensions","calculateTotalCells","ranges","reduce","total","buildValuesBatchUpdateRequest","requests","sheetTitle","options","forEach","req","index","error","totalCells","map","r","data","values","majorDimension","valueInputOption","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","rangesOverlap","range1","range2","parsed1","parsed2","normalized1","normalizeRangeToBounds","normalized2","endCol","startCol","detectRangeConflicts","conflicts","j","push","conflictType","description","validateBatchRanges","errors","warnings","toLocaleString","conflict","valid","expandRange","expandRows","expandCols","newEndRow","Math","min","newEndCol","newEndColStr","splitRangeIntoChunks","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","startColStr","endColStr","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex","parseFiniteCellBlock","cellBlockToA1","block","calculatePasteRange","source","destination","orientation","src","dest","srcRows","srcColumns","destRows","destColumns"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/range-operations.ts"],"sourcesContent":["/**\n * Range Operations Utilities for Google Sheets\n *\n * This module provides comprehensive utilities for working with A1 notation,\n * range parsing, batch operations, and range validation in Google Sheets.\n *\n * Key features:\n * - A1 notation validation and parsing\n * - Range manipulation and calculation utilities\n * - Batch operation builders for Google Sheets API\n * - Cell count and dimension calculations\n * - Range conflict detection for batch operations\n * - Google Sheets limits validation and enforcement\n */\n\nimport { a1Col } from './column-utilities.ts';\n\n// Google Sheets constants and limits\nexport const GOOGLE_SHEETS_LIMITS = {\n MAX_ROWS: 10_000_000,\n MAX_COLUMNS: 18_278, // ZZZ in base-26\n MAX_CELLS: 10_000_000, // Approximate limit for total cells\n MAX_BATCH_REQUESTS: 1000,\n MAX_DIMENSION_BATCH_REQUESTS: 100,\n} as const;\n\n/**\n * Represents a parsed cell reference (e.g., A1, B5)\n */\nexport interface CellReference {\n column: string;\n columnIndex: number; // 1-based\n row: number; // 1-based\n}\n\n/**\n * Represents a parsed range (e.g., A1:B5, A:B, 1:2)\n */\nexport interface RangeReference {\n type: 'cell' | 'row' | 'column' | 'range';\n startCell?: CellReference;\n endCell?: CellReference;\n startRow?: number;\n endRow?: number;\n startColumn?: string;\n endColumn?: string;\n startColumnIndex?: number;\n endColumnIndex?: number;\n}\n\n/**\n * Represents dimensions of a range\n */\nexport interface RangeDimensions {\n rows: number;\n columns: number;\n cells: number;\n}\n\n/**\n * A1 Notation Validation Utilities\n */\n\n/**\n * Validates if a string is a valid A1 notation\n */\nexport function isValidA1Notation(notation: string): boolean {\n if (!notation || typeof notation !== 'string') {\n return false;\n }\n\n // Use the same regex pattern as in the schema\n const a1Pattern = /^(?:[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000)(?::[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000))?|[A-Z]{1,3}:[A-Z]{1,3}|(?:[1-9]\\d{0,6}|10000000):(?:[1-9]\\d{0,6}|10000000))$/;\n\n if (!a1Pattern.test(notation)) {\n return false;\n }\n\n // Additional validation for Google Sheets limits\n const parts = notation.split(':');\n\n for (const part of parts) {\n // Check cell reference\n const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (cellMatch && cellMatch[1] && cellMatch[2]) {\n const [, colStr, rowStr] = cellMatch;\n\n // Validate column\n const colNum = columnStringToIndex(colStr);\n if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n return false;\n }\n\n // Validate row\n const rowNum = parseInt(rowStr, 10);\n if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n return false;\n }\n }\n\n // Check column reference\n const colMatch = part.match(/^([A-Z]{1,3})$/);\n if (colMatch && colMatch[1]) {\n const colNum = columnStringToIndex(colMatch[1]);\n if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n return false;\n }\n }\n\n // Check row reference\n const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n if (rowMatch && rowMatch[1]) {\n const rowNum = parseInt(rowMatch[1], 10);\n if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n return false;\n }\n }\n }\n\n return true;\n}\n\n/**\n * Validates A1 notation and throws detailed error if invalid\n */\nexport function validateA1Notation(notation: string): void {\n if (!isValidA1Notation(notation)) {\n throw new Error(`Invalid A1 notation: \"${notation}\". Valid formats: A1, A1:B2, A:B, 1:2`);\n }\n}\n\n/**\n * Range Parsing and Manipulation Functions\n */\n\n/**\n * Converts column string (A, B, AA, etc.) to 1-based index\n */\nexport function columnStringToIndex(colStr: string): number {\n let colNum = 0;\n for (let i = 0; i < colStr.length; i++) {\n colNum = colNum * 26 + (colStr.charCodeAt(i) - 64);\n }\n return colNum;\n}\n\n/**\n * Converts 1-based column index to column string (A, B, AA, etc.)\n */\nexport function columnIndexToString(colIndex: number): string {\n return a1Col(colIndex);\n}\n\n/**\n * Parses a cell reference (e.g., \"A1\", \"Z999\") into its components\n */\nexport function parseCellReference(cellRef: string): CellReference {\n const match = cellRef.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid cell reference: ${cellRef}`);\n }\n\n const [, column, rowStr] = match;\n const row = parseInt(rowStr, 10);\n const columnIndex = columnStringToIndex(column);\n\n return {\n column,\n columnIndex,\n row,\n };\n}\n\n/**\n * Parses A1 notation into a structured range reference\n */\nexport function parseA1Notation(notation: string): RangeReference {\n validateA1Notation(notation);\n\n const parts = notation.split(':');\n\n if (parts.length === 1) {\n const part = parts[0];\n if (!part) {\n throw new Error('Invalid A1 notation: empty part after split');\n }\n\n // Single cell reference (e.g., A1)\n const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n if (cellMatch && cellMatch[1] && cellMatch[2]) {\n const startCell = parseCellReference(part);\n return {\n type: 'cell',\n startCell,\n endCell: startCell,\n };\n }\n\n // Single column reference (e.g., A)\n const colMatch = part.match(/^([A-Z]{1,3})$/);\n if (colMatch && colMatch[1]) {\n const column = colMatch[1];\n const columnIndex = columnStringToIndex(column);\n return {\n type: 'column',\n startColumn: column,\n endColumn: column,\n startColumnIndex: columnIndex,\n endColumnIndex: columnIndex,\n };\n }\n\n // Single row reference (e.g., 1)\n const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n if (rowMatch && rowMatch[1]) {\n const row = parseInt(rowMatch[1], 10);\n return {\n type: 'row',\n startRow: row,\n endRow: row,\n };\n }\n }\n\n if (parts.length === 2 && parts[0] && parts[1]) {\n const [start, end] = parts;\n\n // Cell range (e.g., A1:B5)\n const startCellMatch = start.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n const endCellMatch = end.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n\n if (startCellMatch && endCellMatch && startCellMatch[1] && startCellMatch[2] && endCellMatch[1] && endCellMatch[2]) {\n const startCell = parseCellReference(start);\n const endCell = parseCellReference(end);\n return {\n type: 'range',\n startCell,\n endCell,\n };\n }\n\n // Column range (e.g., A:B)\n const startColMatch = start.match(/^([A-Z]{1,3})$/);\n const endColMatch = end.match(/^([A-Z]{1,3})$/);\n\n if (startColMatch && endColMatch && startColMatch[1] && endColMatch[1]) {\n const startColumn = startColMatch[1];\n const endColumn = endColMatch[1];\n const startColumnIndex = columnStringToIndex(startColumn);\n const endColumnIndex = columnStringToIndex(endColumn);\n return {\n type: 'column',\n startColumn,\n endColumn,\n startColumnIndex,\n endColumnIndex,\n };\n }\n\n // Row range (e.g., 1:5)\n const startRowMatch = start.match(/^([1-9]\\d{0,6}|10000000)$/);\n const endRowMatch = end.match(/^([1-9]\\d{0,6}|10000000)$/);\n\n if (startRowMatch && endRowMatch && startRowMatch[1] && endRowMatch[1]) {\n const startRow = parseInt(startRowMatch[1], 10);\n const endRow = parseInt(endRowMatch[1], 10);\n return {\n type: 'row',\n startRow,\n endRow,\n };\n }\n }\n\n throw new Error(`Unable to parse A1 notation: ${notation}`);\n}\n\n/**\n * Converts a range reference back to A1 notation\n */\nexport function rangeToA1Notation(range: RangeReference): string {\n switch (range.type) {\n case 'cell':\n if (!range.startCell) throw new Error('Invalid cell range: missing startCell');\n return `${range.startCell.column}${range.startCell.row}`;\n\n case 'range':\n if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing start or end cell');\n return `${range.startCell.column}${range.startCell.row}:${range.endCell.column}${range.endCell.row}`;\n\n case 'column':\n if (!range.startColumn || !range.endColumn) throw new Error('Invalid column range: missing start or end column');\n if (range.startColumn === range.endColumn) {\n return range.startColumn;\n }\n return `${range.startColumn}:${range.endColumn}`;\n\n case 'row':\n if (range.startRow === undefined || range.endRow === undefined) throw new Error('Invalid row range: missing start or end row');\n if (range.startRow === range.endRow) {\n return range.startRow.toString();\n }\n return `${range.startRow}:${range.endRow}`;\n\n default:\n throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n }\n}\n\n/**\n * Cell Count and Dimension Calculation Utilities\n */\n\n/**\n * Calculates the dimensions of a range\n */\nexport function calculateRangeDimensions(notation: string): RangeDimensions {\n const range = parseA1Notation(notation);\n\n switch (range.type) {\n case 'cell':\n return { rows: 1, columns: 1, cells: 1 };\n\n case 'range': {\n if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing cells');\n const rows = range.endCell.row - range.startCell.row + 1;\n const columns = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n return { rows, columns, cells: rows * columns };\n }\n\n case 'column': {\n if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n throw new Error('Invalid column range: missing column indices');\n }\n const columnCount = range.endColumnIndex - range.startColumnIndex + 1;\n return {\n rows: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n columns: columnCount,\n cells: GOOGLE_SHEETS_LIMITS.MAX_ROWS * columnCount,\n };\n }\n\n case 'row': {\n if (range.startRow === undefined || range.endRow === undefined) {\n throw new Error('Invalid row range: missing row numbers');\n }\n const rowCount = range.endRow - range.startRow + 1;\n return {\n rows: rowCount,\n columns: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n cells: rowCount * GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n };\n }\n\n default:\n throw new Error(`Unknown range type: ${(range as { type: string }).type}`);\n }\n}\n\n/**\n * Counts cells in a finite sheet-local range, rejecting reversed bounds.\n */\nexport function calculateFiniteRangeCellCount(notation: string): number {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n const dimensions = calculateRangeDimensions(notation);\n if (dimensions.rows < 1 || dimensions.columns < 1) throw new Error(`Range end must not precede its start: ${notation}`);\n return dimensions.cells;\n}\n\n/**\n * Converts a RangeReference to Google Sheets API GridRange format\n *\n * This handles the different range types correctly:\n * - 'cell' and 'range' types: Extract indices from startCell/endCell\n * - 'row' types: Use startRow/endRow, omit column indices for full row\n * - 'column' types: Use startColumnIndex/endColumnIndex, omit row indices for full column\n *\n * Important: Google Sheets API uses 0-based indices, while A1 notation uses 1-based indices.\n * This function handles the conversion properly for each range type.\n */\nexport function rangeReferenceToGridRange(\n rangeRef: RangeReference,\n sheetId: number\n): {\n sheetId: number;\n startRowIndex?: number;\n endRowIndex?: number;\n startColumnIndex?: number;\n endColumnIndex?: number;\n} {\n if (rangeRef.type === 'cell' || rangeRef.type === 'range') {\n // For cell and range types, extract from startCell/endCell\n if (!rangeRef.startCell || !rangeRef.endCell) {\n throw new Error(`Invalid ${rangeRef.type} range: missing start or end cell`);\n }\n\n return {\n sheetId,\n // Convert 1-based row to 0-based startRowIndex\n startRowIndex: rangeRef.startCell.row - 1,\n // endRowIndex is exclusive (so row 5 becomes endRowIndex 5)\n endRowIndex: rangeRef.endCell.row,\n // Convert 1-based column index to 0-based startColumnIndex\n startColumnIndex: rangeRef.startCell.columnIndex - 1,\n // endColumnIndex is exclusive\n endColumnIndex: rangeRef.endCell.columnIndex,\n };\n }\n if (rangeRef.type === 'row') {\n // For row types, use startRow/endRow and omit column indices for full row width\n if (rangeRef.startRow === undefined || rangeRef.endRow === undefined) {\n throw new Error('Invalid row range: missing start or end row');\n }\n\n return {\n sheetId,\n // Convert 1-based row to 0-based startRowIndex\n startRowIndex: rangeRef.startRow - 1,\n // endRowIndex is exclusive\n endRowIndex: rangeRef.endRow,\n // Omit startColumnIndex and endColumnIndex to apply to all columns\n };\n }\n if (rangeRef.type === 'column') {\n // For column types, use startColumnIndex/endColumnIndex and omit row indices for full column height\n if (rangeRef.startColumnIndex === undefined || rangeRef.endColumnIndex === undefined) {\n throw new Error('Invalid column range: missing start or end column index');\n }\n\n return {\n sheetId,\n // Omit startRowIndex and endRowIndex to apply to all rows\n // Convert 1-based column index to 0-based startColumnIndex\n startColumnIndex: rangeRef.startColumnIndex - 1,\n // endColumnIndex is exclusive\n endColumnIndex: rangeRef.endColumnIndex,\n };\n }\n\n throw new Error(`Unknown range type: ${(rangeRef as { type: unknown }).type}`);\n}\n\n/**\n * A finite, sheet-local block of cells with 1-based inclusive bounds.\n */\nexport interface CellBlock {\n startRow: number;\n endRow: number;\n startColumn: number;\n endColumn: number;\n}\n\n/**\n * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.\n * Throws for invalid syntax, whole rows/columns and reversed bounds.\n */\nexport function parseFiniteCellBlock(notation: string): CellBlock {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n calculateFiniteRangeCellCount(notation);\n if (!range.startCell || !range.endCell) throw new Error(`Invalid range: ${notation}`);\n return { startRow: range.startCell.row, endRow: range.endCell.row, startColumn: range.startCell.columnIndex, endColumn: range.endCell.columnIndex };\n}\n\n/**\n * Formats a block as A1 notation (a single cell when it spans one cell).\n */\nexport function cellBlockToA1(block: CellBlock): string {\n const start = `${columnIndexToString(block.startColumn)}${block.startRow}`;\n if (block.startRow === block.endRow && block.startColumn === block.endColumn) return start;\n return `${start}:${columnIndexToString(block.endColumn)}${block.endRow}`;\n}\n\n/**\n * Footprint of a copy-paste: the cells written in the destination.\n *\n * - destination is one cell: the (oriented) source size anchored at that cell\n * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)\n * - anything else throws\n */\nexport function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock {\n const src = parseFiniteCellBlock(source);\n const dest = parseFiniteCellBlock(destination);\n const srcRows = src.endRow - src.startRow + 1;\n const srcColumns = src.endColumn - src.startColumn + 1;\n const rows = orientation === 'TRANSPOSE' ? srcColumns : srcRows;\n const columns = orientation === 'TRANSPOSE' ? srcRows : srcColumns;\n const destRows = dest.endRow - dest.startRow + 1;\n const destColumns = dest.endColumn - dest.startColumn + 1;\n\n if (destRows === 1 && destColumns === 1) {\n return { startRow: dest.startRow, endRow: dest.startRow + rows - 1, startColumn: dest.startColumn, endColumn: dest.startColumn + columns - 1 };\n }\n if (destRows % rows === 0 && destColumns % columns === 0) return dest;\n throw new Error(\n `Destination ${destination} is ${destRows}x${destColumns} cells; the ${orientation === 'TRANSPOSE' ? 'transposed ' : ''}source ${source} is ${rows}x${columns}. Use a single anchor cell (e.g., ${columnIndexToString(dest.startColumn)}${dest.startRow}) or a range whose height and width are whole multiples of ${rows}x${columns}.`\n );\n}\n"],"names":["a1Col","GOOGLE_SHEETS_LIMITS","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","isValidA1Notation","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","columnStringToIndex","rowNum","parseInt","colMatch","rowMatch","validateA1Notation","Error","i","length","charCodeAt","columnIndexToString","colIndex","parseCellReference","cellRef","column","row","columnIndex","parseA1Notation","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","rangeToA1Notation","range","undefined","toString","calculateRangeDimensions","rows","columns","cells","columnCount","rowCount","calculateFiniteRangeCellCount","dimensions","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex","parseFiniteCellBlock","cellBlockToA1","block","calculatePasteRange","source","destination","orientation","src","dest","srcRows","srcColumns","destRows","destColumns"],"mappings":"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"}
|
|
@@ -6,31 +6,18 @@ import type { Logger } from '../types.js';
|
|
|
6
6
|
* and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
|
|
7
7
|
*/
|
|
8
8
|
export declare function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void>;
|
|
9
|
-
export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
|
|
10
|
-
sheetCreated: boolean;
|
|
11
|
-
sheetGUID?: string;
|
|
12
|
-
headersEnsured?: boolean;
|
|
13
|
-
}>;
|
|
14
9
|
export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet | null>;
|
|
15
|
-
export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets,
|
|
10
|
+
export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, { spreadsheetId, sheetTitle, requiredHeader, keyColumns, }: {
|
|
16
11
|
spreadsheetId: string;
|
|
17
12
|
sheetTitle: string;
|
|
18
13
|
requiredHeader?: string[] | null;
|
|
19
14
|
keyColumns?: string[];
|
|
20
|
-
logger: Logger;
|
|
21
15
|
}): Promise<{
|
|
22
16
|
header: string[];
|
|
23
17
|
keySet: Set<string>;
|
|
24
|
-
keyColumnsIdx?:
|
|
25
|
-
}
|
|
26
|
-
export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
|
|
27
|
-
spreadsheetId: string;
|
|
28
|
-
sheetRef: string;
|
|
29
|
-
requiredHeader?: string[] | null;
|
|
30
|
-
keyColumns?: string[];
|
|
31
|
-
logger: Logger;
|
|
32
|
-
}): Promise<{
|
|
18
|
+
keyColumnsIdx?: undefined;
|
|
19
|
+
} | {
|
|
33
20
|
header: string[];
|
|
34
21
|
keySet: Set<string>;
|
|
35
|
-
keyColumnsIdx
|
|
22
|
+
keyColumnsIdx: number[];
|
|
36
23
|
}>;
|
|
@@ -41,83 +41,6 @@ import { a1Col } from './column-utilities.js';
|
|
|
41
41
|
startRow = endRow + 1;
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
|
-
export async function ensureSheetIfNeeded(sheets, id, sheetTitle, ensureSheet, headers, logger) {
|
|
45
|
-
var _res_data_replies__addSheet_properties, _res_data_replies__addSheet, _res_data_replies_, _res_data_replies, _res_data;
|
|
46
|
-
if (!sheetTitle) return {
|
|
47
|
-
sheetCreated: false
|
|
48
|
-
};
|
|
49
|
-
const ssResp = await sheets.spreadsheets.get({
|
|
50
|
-
spreadsheetId: id
|
|
51
|
-
});
|
|
52
|
-
const ss = ssResp.data;
|
|
53
|
-
const has = Array.isArray(ss === null || ss === void 0 ? void 0 : ss.sheets) && ss.sheets.some((s)=>{
|
|
54
|
-
var _s_properties;
|
|
55
|
-
return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
|
|
56
|
-
});
|
|
57
|
-
if (has) {
|
|
58
|
-
var _ss_sheets_find_properties, _ss_sheets_find, _ss_sheets;
|
|
59
|
-
const sid = (_ss_sheets = ss.sheets) === null || _ss_sheets === void 0 ? void 0 : (_ss_sheets_find = _ss_sheets.find((s)=>{
|
|
60
|
-
var _s_properties;
|
|
61
|
-
return (s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
|
|
62
|
-
})) === 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;
|
|
63
|
-
const result = {
|
|
64
|
-
sheetCreated: false
|
|
65
|
-
};
|
|
66
|
-
if (sid != null) result.sheetGUID = String(sid);
|
|
67
|
-
if (headers) {
|
|
68
|
-
try {
|
|
69
|
-
const { header: merged } = await ensureTabAndHeaders(sheets, {
|
|
70
|
-
spreadsheetId: id,
|
|
71
|
-
sheetTitle,
|
|
72
|
-
requiredHeader: headers,
|
|
73
|
-
logger
|
|
74
|
-
});
|
|
75
|
-
if (merged) result.headersEnsured = true;
|
|
76
|
-
} catch (e) {
|
|
77
|
-
var _logger_warn;
|
|
78
|
-
(_logger_warn = logger.warn) === null || _logger_warn === void 0 ? void 0 : _logger_warn.call(logger, 'ensureTabAndHeaders after sheet creation failed', e);
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
return result;
|
|
82
|
-
}
|
|
83
|
-
if (!ensureSheet) return {
|
|
84
|
-
sheetCreated: false
|
|
85
|
-
};
|
|
86
|
-
const res = await sheets.spreadsheets.batchUpdate({
|
|
87
|
-
spreadsheetId: id,
|
|
88
|
-
requestBody: {
|
|
89
|
-
requests: [
|
|
90
|
-
{
|
|
91
|
-
addSheet: {
|
|
92
|
-
properties: {
|
|
93
|
-
title: sheetTitle
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
]
|
|
98
|
-
}
|
|
99
|
-
});
|
|
100
|
-
const 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;
|
|
101
|
-
const result = {
|
|
102
|
-
sheetCreated: !!createdId
|
|
103
|
-
};
|
|
104
|
-
if (createdId != null) result.sheetGUID = String(createdId);
|
|
105
|
-
if (createdId && headers) {
|
|
106
|
-
try {
|
|
107
|
-
const { header: merged } = await ensureTabAndHeaders(sheets, {
|
|
108
|
-
spreadsheetId: id,
|
|
109
|
-
sheetTitle,
|
|
110
|
-
requiredHeader: headers,
|
|
111
|
-
logger
|
|
112
|
-
});
|
|
113
|
-
if (merged) result.headersEnsured = true;
|
|
114
|
-
} catch (e) {
|
|
115
|
-
var _logger_warn1;
|
|
116
|
-
(_logger_warn1 = logger.warn) === null || _logger_warn1 === void 0 ? void 0 : _logger_warn1.call(logger, 'ensureTabAndHeaders after sheet creation failed', e);
|
|
117
|
-
}
|
|
118
|
-
}
|
|
119
|
-
return result;
|
|
120
|
-
}
|
|
121
44
|
export async function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
|
|
122
45
|
var _ssResp_data, _logger_debug, _logger_warn;
|
|
123
46
|
const ssResp = await client.spreadsheets.get({
|
|
@@ -215,27 +138,12 @@ export async function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
|
|
|
215
138
|
});
|
|
216
139
|
return null;
|
|
217
140
|
}
|
|
218
|
-
export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle,
|
|
141
|
+
export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, requiredHeader = null, keyColumns = [
|
|
219
142
|
'id'
|
|
220
|
-
]
|
|
143
|
+
] }) {
|
|
221
144
|
if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');
|
|
222
145
|
if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');
|
|
223
|
-
if (!sheetTitle
|
|
224
|
-
// Resolve the actual sheet title from sheetRef if provided
|
|
225
|
-
let resolvedSheetTitle = sheetTitle;
|
|
226
|
-
let createTab = false;
|
|
227
|
-
if (sheetRef) {
|
|
228
|
-
const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);
|
|
229
|
-
if (sheet) {
|
|
230
|
-
var _sheet_properties;
|
|
231
|
-
resolvedSheetTitle = ((_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) || sheetRef;
|
|
232
|
-
} else {
|
|
233
|
-
// Sheet doesn't exist, use the sheetRef as the title for creation
|
|
234
|
-
resolvedSheetTitle = sheetRef;
|
|
235
|
-
createTab = true;
|
|
236
|
-
}
|
|
237
|
-
}
|
|
238
|
-
if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');
|
|
146
|
+
if (!sheetTitle) throw new Error('ensureTabAndHeaders: sheetTitle is required');
|
|
239
147
|
const defaultHeader = [
|
|
240
148
|
'id',
|
|
241
149
|
'provider',
|
|
@@ -251,25 +159,9 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
|
|
|
251
159
|
'body'
|
|
252
160
|
];
|
|
253
161
|
const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
|
|
254
|
-
if (createTab) {
|
|
255
|
-
await sheets.spreadsheets.batchUpdate({
|
|
256
|
-
spreadsheetId,
|
|
257
|
-
requestBody: {
|
|
258
|
-
requests: [
|
|
259
|
-
{
|
|
260
|
-
addSheet: {
|
|
261
|
-
properties: {
|
|
262
|
-
title: resolvedSheetTitle
|
|
263
|
-
}
|
|
264
|
-
}
|
|
265
|
-
}
|
|
266
|
-
]
|
|
267
|
-
}
|
|
268
|
-
});
|
|
269
|
-
}
|
|
270
162
|
const resp = await sheets.spreadsheets.values.get({
|
|
271
163
|
spreadsheetId,
|
|
272
|
-
range: `${
|
|
164
|
+
range: `${sheetTitle}!1:1`,
|
|
273
165
|
majorDimension: 'ROWS'
|
|
274
166
|
});
|
|
275
167
|
const vr = resp.data;
|
|
@@ -278,7 +170,7 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
|
|
|
278
170
|
if (!existingHeader) {
|
|
279
171
|
await sheets.spreadsheets.values.append({
|
|
280
172
|
spreadsheetId,
|
|
281
|
-
range: `${
|
|
173
|
+
range: `${sheetTitle}!A1`,
|
|
282
174
|
valueInputOption: 'RAW',
|
|
283
175
|
insertDataOption: 'INSERT_ROWS',
|
|
284
176
|
requestBody: {
|
|
@@ -303,7 +195,7 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
|
|
|
303
195
|
if (mergedHeader.length !== existingHeader.length) {
|
|
304
196
|
await sheets.spreadsheets.values.update({
|
|
305
197
|
spreadsheetId,
|
|
306
|
-
range: `${
|
|
198
|
+
range: `${sheetTitle}!1:1`,
|
|
307
199
|
valueInputOption: 'RAW',
|
|
308
200
|
requestBody: {
|
|
309
201
|
values: [
|
|
@@ -332,7 +224,7 @@ export async function ensureTabAndHeaders(sheets, { spreadsheetId, sheetTitle, s
|
|
|
332
224
|
const maxIdx = Math.max(...validKeyIdxs);
|
|
333
225
|
const startCol = a1Col(minIdx + 1);
|
|
334
226
|
const endCol = a1Col(maxIdx + 1);
|
|
335
|
-
await scanKeyColumnRows(sheets, spreadsheetId,
|
|
227
|
+
await scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol, (row)=>{
|
|
336
228
|
// Use the same key generation logic as appendRows for consistency
|
|
337
229
|
const lower = mergedHeader.map((h)=>String(h !== null && h !== void 0 ? h : '').toLowerCase());
|
|
338
230
|
const provHeaderIdx = lower.indexOf('provider');
|
|
@@ -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":["a1Col","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","spreadsheets","get","fields","rowCount","data","find","s","properties","title","gridProperties","Error","endRow","Math","min","range","rows","response","values","majorDimension","error","wrapped","message","String","cause","i","length","Array","isArray","ensureSheetIfNeeded","id","ensureSheet","headers","logger","res","sheetCreated","ssResp","ss","has","some","sid","sheetId","result","sheetGUID","header","merged","ensureTabAndHeaders","requiredHeader","headersEnsured","e","warn","batchUpdate","requestBody","requests","addSheet","createdId","replies","findSheetByRef","client","sheetRef","trimmedRef","trim","debug","availableSheets","map","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","toLowerCase","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","includes","searchRef","availableTitles","availableIds","keyColumns","resolvedSheetTitle","createTab","sheet","defaultHeader","resp","vr","existingHeader","append","valueInputOption","insertDataOption","keySet","Set","mergedHeader","slice","col","push","name","update","normalizeKeyColumnsByName","kc","hdr","idx","indexOf","Number","isInteger","keyColsIdx","validKeyIdxs","filter","keyColumnsIdx","minIdx","maxIdx","max","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
|
|
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":["a1Col","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","spreadsheets","get","fields","rowCount","data","find","s","properties","title","gridProperties","Error","endRow","Math","min","range","rows","response","values","majorDimension","error","wrapped","message","String","cause","i","length","Array","isArray","findSheetByRef","client","sheetRef","logger","ssResp","trimmedRef","trim","debug","availableSheets","map","id","sheetId","warn","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","toLowerCase","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","includes","searchRef","availableTitles","availableIds","ensureTabAndHeaders","requiredHeader","keyColumns","defaultHeader","header","resp","vr","existingHeader","append","valueInputOption","insertDataOption","requestBody","keySet","Set","mergedHeader","slice","col","push","name","update","normalizeKeyColumnsByName","kc","hdr","idx","indexOf","Number","isInteger","keyColsIdx","validKeyIdxs","filter","keyColumnsIdx","minIdx","maxIdx","max","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcp-z/mcp-sheets",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.6.1",
|
|
4
4
|
"description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"sheets",
|
|
@@ -71,28 +71,28 @@
|
|
|
71
71
|
"dependencies": {
|
|
72
72
|
"@googleapis/drive": "^27.1.0",
|
|
73
73
|
"@googleapis/sheets": "^18.0.0",
|
|
74
|
-
"@mcp-z/oauth": "^2.
|
|
75
|
-
"@mcp-z/oauth-google": "^2.0
|
|
74
|
+
"@mcp-z/oauth": "^2.2.0",
|
|
75
|
+
"@mcp-z/oauth-google": "^2.4.0",
|
|
76
76
|
"@mcp-z/server": "^2.3.0",
|
|
77
77
|
"cors": "^2.0.0",
|
|
78
78
|
"csv-parse": "^7.0.2",
|
|
79
79
|
"express": "^5.0.0",
|
|
80
80
|
"keyv-file": "5.3.3",
|
|
81
|
-
"keyv-registry": "^
|
|
81
|
+
"keyv-registry": "^3.0.0",
|
|
82
82
|
"module-root-sync": "^2.0.0",
|
|
83
83
|
"pino": "^10.0.0",
|
|
84
84
|
"zod": "^4.2.0"
|
|
85
85
|
},
|
|
86
86
|
"devDependencies": {
|
|
87
|
-
"@mcp-z/client": "^2.
|
|
87
|
+
"@mcp-z/client": "^2.5.0",
|
|
88
88
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
89
89
|
"@types/cors": "^2.8.19",
|
|
90
90
|
"@types/express": "^5.0.6",
|
|
91
91
|
"@types/mocha": "^10.0.10",
|
|
92
|
-
"@types/node": "^
|
|
92
|
+
"@types/node": "^22.0.0",
|
|
93
93
|
"fs-remove-compat": "^1.0.4",
|
|
94
94
|
"get-port": "5.1.1",
|
|
95
|
-
"keyv": "^
|
|
95
|
+
"keyv": "^6.1.0",
|
|
96
96
|
"node-version-use": "^2.4.7",
|
|
97
97
|
"p-throttle": "^8.1.1",
|
|
98
98
|
"portable-env": "^1.4.0",
|