@mcp-z/mcp-sheets 2.4.2 → 2.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -29
- package/dist/cjs/constants.d.cts +26 -0
- package/dist/cjs/constants.d.ts +26 -0
- package/dist/cjs/constants.js +83 -3
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-copy.d.cts +165 -0
- package/dist/cjs/mcp/tools/cells-copy.d.ts +165 -0
- package/dist/cjs/mcp/tools/cells-copy.js +388 -0
- package/dist/cjs/mcp/tools/cells-copy.js.map +1 -0
- 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/index.d.cts +1 -0
- package/dist/cjs/mcp/tools/index.d.ts +1 -0
- package/dist/cjs/mcp/tools/index.js +4 -0
- package/dist/cjs/mcp/tools/index.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/schemas/index.d.cts +1 -0
- package/dist/cjs/schemas/index.d.ts +1 -0
- package/dist/cjs/schemas/index.js +16 -0
- package/dist/cjs/schemas/index.js.map +1 -1
- package/dist/cjs/setup/config.js +26 -14
- package/dist/cjs/setup/config.js.map +1 -1
- package/dist/cjs/setup/version-help.js +1 -1
- package/dist/cjs/setup/version-help.js.map +1 -1
- package/dist/cjs/spreadsheet/data-operations.js +60 -181
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +27 -5
- package/dist/cjs/spreadsheet/range-operations.d.ts +27 -5
- package/dist/cjs/spreadsheet/range-operations.js +48 -28
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
- package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
- package/dist/cjs/spreadsheet/sheet-operations.js +114 -124
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/constants.d.ts +26 -0
- package/dist/esm/constants.js +55 -0
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
- package/dist/esm/mcp/tools/cells-copy.js +190 -0
- package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
- 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/index.d.ts +1 -0
- package/dist/esm/mcp/tools/index.js +1 -0
- package/dist/esm/mcp/tools/index.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/schemas/index.d.ts +1 -0
- package/dist/esm/schemas/index.js +9 -0
- package/dist/esm/schemas/index.js.map +1 -1
- package/dist/esm/setup/config.js +26 -14
- package/dist/esm/setup/config.js.map +1 -1
- package/dist/esm/setup/version-help.js +7 -0
- package/dist/esm/setup/version-help.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.js +47 -95
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +27 -5
- package/dist/esm/spreadsheet/range-operations.js +50 -27
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
- package/dist/esm/spreadsheet/sheet-operations.js +88 -79
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/package.json +3 -3
|
@@ -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 * Gets the intersection of two ranges\n */\nexport function getRangeIntersection(range1: string, range2: string): string | null {\n try {\n const parsed1 = parseA1Notation(range1);\n const parsed2 = parseA1Notation(range2);\n\n const bounds1 = normalizeRangeToBounds(parsed1);\n const bounds2 = normalizeRangeToBounds(parsed2);\n\n // Check if they overlap\n if (!rangesOverlap(range1, range2)) {\n return null;\n }\n\n // Calculate intersection bounds\n const startRow = Math.max(bounds1.startRow, bounds2.startRow);\n const endRow = Math.min(bounds1.endRow, bounds2.endRow);\n const startCol = Math.max(bounds1.startCol, bounds2.startCol);\n const endCol = Math.min(bounds1.endCol, bounds2.endCol);\n\n const startColStr = columnIndexToString(startCol);\n const endColStr = columnIndexToString(endCol);\n\n if (startRow === endRow && startCol === endCol) {\n return `${startColStr}${startRow}`;\n }\n\n return `${startColStr}${startRow}:${endColStr}${endRow}`;\n } catch {\n return null;\n }\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"],"names":["GOOGLE_SHEETS_LIMITS","buildValuesBatchUpdateRequest","calculateFiniteRangeCellCount","calculateRangeDimensions","calculateTotalCells","columnIndexToString","columnStringToIndex","detectRangeConflicts","expandRange","getRangeIntersection","isValidA1Notation","parseA1Notation","parseCellReference","rangeReferenceToGridRange","rangeToA1Notation","rangesOverlap","splitRangeIntoChunks","validateA1Notation","validateBatchRanges","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","rowNum","parseInt","colMatch","rowMatch","Error","i","length","charCodeAt","colIndex","a1Col","cellRef","column","row","columnIndex","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","range","undefined","toString","rows","columns","cells","columnCount","rowCount","dimensions","ranges","reduce","total","requests","sheetTitle","options","forEach","req","index","error","totalCells","map","r","data","values","majorDimension","valueInputOption","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","range1","range2","parsed1","parsed2","normalized1","normalizeRangeToBounds","normalized2","endCol","startCol","conflicts","j","push","conflictType","description","errors","warnings","toLocaleString","conflict","valid","expandRows","expandCols","newEndRow","Math","min","newEndCol","newEndColStr","bounds1","bounds2","max","startColStr","endColStr","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","rangeRef","sheetId","startRowIndex","endRowIndex"],"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 * 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":["GOOGLE_SHEETS_LIMITS","buildValuesBatchUpdateRequest","calculateFiniteRangeCellCount","calculatePasteRange","calculateRangeDimensions","calculateTotalCells","cellBlockToA1","columnIndexToString","columnStringToIndex","detectRangeConflicts","expandRange","isValidA1Notation","parseA1Notation","parseCellReference","parseFiniteCellBlock","rangeReferenceToGridRange","rangeToA1Notation","rangesOverlap","splitRangeIntoChunks","validateA1Notation","validateBatchRanges","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","rowNum","parseInt","colMatch","rowMatch","Error","i","length","charCodeAt","colIndex","a1Col","cellRef","column","row","columnIndex","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","range","undefined","toString","rows","columns","cells","columnCount","rowCount","dimensions","ranges","reduce","total","requests","sheetTitle","options","forEach","req","index","error","totalCells","map","r","data","values","majorDimension","valueInputOption","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","range1","range2","parsed1","parsed2","normalized1","normalizeRangeToBounds","normalized2","endCol","startCol","conflicts","j","push","conflictType","description","errors","warnings","toLocaleString","conflict","valid","expandRows","expandCols","newEndRow","Math","min","newEndCol","newEndColStr","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","startColStr","endColStr","rangeRef","sheetId","startRowIndex","endRowIndex","block","source","destination","orientation","src","dest","srcRows","srcColumns","destRows","destColumns"],"mappings":"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"}
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
import type { sheets_v4 } from '@googleapis/sheets';
|
|
2
2
|
import type { Logger } from '../types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.
|
|
5
|
+
* The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),
|
|
6
|
+
* and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
|
|
7
|
+
*/
|
|
8
|
+
export declare function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void>;
|
|
3
9
|
export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
|
|
4
10
|
sheetCreated: boolean;
|
|
5
11
|
sheetGUID?: string;
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
import type { sheets_v4 } from '@googleapis/sheets';
|
|
2
2
|
import type { Logger } from '../types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.
|
|
5
|
+
* The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),
|
|
6
|
+
* and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
|
|
7
|
+
*/
|
|
8
|
+
export declare function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void>;
|
|
3
9
|
export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
|
|
4
10
|
sheetCreated: boolean;
|
|
5
11
|
sheetGUID?: string;
|
|
@@ -17,6 +17,9 @@ _export(exports, {
|
|
|
17
17
|
},
|
|
18
18
|
get findSheetByRef () {
|
|
19
19
|
return findSheetByRef;
|
|
20
|
+
},
|
|
21
|
+
get scanKeyColumnRows () {
|
|
22
|
+
return scanKeyColumnRows;
|
|
20
23
|
}
|
|
21
24
|
});
|
|
22
25
|
var _columnutilitiests = require("./column-utilities.js");
|
|
@@ -54,6 +57,12 @@ function _async_to_generator(fn) {
|
|
|
54
57
|
});
|
|
55
58
|
};
|
|
56
59
|
}
|
|
60
|
+
function _instanceof(left, right) {
|
|
61
|
+
"@swc/helpers - instanceof";
|
|
62
|
+
if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
|
|
63
|
+
return !!right[Symbol.hasInstance](left);
|
|
64
|
+
} else return left instanceof right;
|
|
65
|
+
}
|
|
57
66
|
function _iterable_to_array(iter) {
|
|
58
67
|
if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
|
|
59
68
|
return Array.from(iter);
|
|
@@ -172,6 +181,83 @@ function _unsupported_iterable_to_array(o, minLen) {
|
|
|
172
181
|
if (n === "Map" || n === "Set") return Array.from(n);
|
|
173
182
|
if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
|
|
174
183
|
}
|
|
184
|
+
function scanKeyColumnRows(sheets, spreadsheetId, sheetTitle, startCol, endCol, onRow) {
|
|
185
|
+
return _async_to_generator(function() {
|
|
186
|
+
var _meta_data_sheets_find_properties_gridProperties, _meta_data_sheets_find_properties, _meta_data_sheets_find, _meta_data_sheets, _meta_data, chunkSize, startRow, meta, rowCount, endRow, range, rows, _response_data, response, error, wrapped, i;
|
|
187
|
+
return _ts_generator(this, function(_state) {
|
|
188
|
+
switch(_state.label){
|
|
189
|
+
case 0:
|
|
190
|
+
chunkSize = 1000;
|
|
191
|
+
startRow = 2; // Start from row 2 (after header)
|
|
192
|
+
return [
|
|
193
|
+
4,
|
|
194
|
+
sheets.spreadsheets.get({
|
|
195
|
+
spreadsheetId: spreadsheetId,
|
|
196
|
+
fields: 'sheets.properties(title,gridProperties.rowCount)'
|
|
197
|
+
})
|
|
198
|
+
];
|
|
199
|
+
case 1:
|
|
200
|
+
meta = _state.sent();
|
|
201
|
+
rowCount = (_meta_data = meta.data) === null || _meta_data === void 0 ? void 0 : (_meta_data_sheets = _meta_data.sheets) === null || _meta_data_sheets === void 0 ? void 0 : (_meta_data_sheets_find = _meta_data_sheets.find(function(s) {
|
|
202
|
+
var _s_properties;
|
|
203
|
+
return ((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.title) === sheetTitle;
|
|
204
|
+
})) === null || _meta_data_sheets_find === void 0 ? void 0 : (_meta_data_sheets_find_properties = _meta_data_sheets_find.properties) === null || _meta_data_sheets_find_properties === void 0 ? void 0 : (_meta_data_sheets_find_properties_gridProperties = _meta_data_sheets_find_properties.gridProperties) === null || _meta_data_sheets_find_properties_gridProperties === void 0 ? void 0 : _meta_data_sheets_find_properties_gridProperties.rowCount;
|
|
205
|
+
if (typeof rowCount !== 'number') {
|
|
206
|
+
throw new Error('Could not read the row count of sheet "'.concat(sheetTitle, '"'));
|
|
207
|
+
}
|
|
208
|
+
_state.label = 2;
|
|
209
|
+
case 2:
|
|
210
|
+
if (!(startRow <= rowCount)) return [
|
|
211
|
+
3,
|
|
212
|
+
7
|
|
213
|
+
];
|
|
214
|
+
endRow = Math.min(startRow + chunkSize - 1, rowCount);
|
|
215
|
+
range = "".concat(sheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
|
|
216
|
+
rows = void 0;
|
|
217
|
+
_state.label = 3;
|
|
218
|
+
case 3:
|
|
219
|
+
_state.trys.push([
|
|
220
|
+
3,
|
|
221
|
+
5,
|
|
222
|
+
,
|
|
223
|
+
6
|
|
224
|
+
]);
|
|
225
|
+
return [
|
|
226
|
+
4,
|
|
227
|
+
sheets.spreadsheets.values.get({
|
|
228
|
+
spreadsheetId: spreadsheetId,
|
|
229
|
+
range: range,
|
|
230
|
+
majorDimension: 'ROWS'
|
|
231
|
+
})
|
|
232
|
+
];
|
|
233
|
+
case 4:
|
|
234
|
+
response = _state.sent();
|
|
235
|
+
rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
|
|
236
|
+
return [
|
|
237
|
+
3,
|
|
238
|
+
6
|
|
239
|
+
];
|
|
240
|
+
case 5:
|
|
241
|
+
error = _state.sent();
|
|
242
|
+
// The build target's Error constructor has no options argument, so set cause directly
|
|
243
|
+
wrapped = new Error("Failed to read key columns from ".concat(range, ": ").concat(_instanceof(error, Error) ? error.message : String(error)));
|
|
244
|
+
wrapped.cause = error;
|
|
245
|
+
throw wrapped;
|
|
246
|
+
case 6:
|
|
247
|
+
for(i = 0; i < rows.length; i++)onRow(Array.isArray(rows[i]) ? rows[i] : [], startRow + i);
|
|
248
|
+
startRow = endRow + 1;
|
|
249
|
+
return [
|
|
250
|
+
3,
|
|
251
|
+
2
|
|
252
|
+
];
|
|
253
|
+
case 7:
|
|
254
|
+
return [
|
|
255
|
+
2
|
|
256
|
+
];
|
|
257
|
+
}
|
|
258
|
+
});
|
|
259
|
+
})();
|
|
260
|
+
}
|
|
175
261
|
function ensureSheetIfNeeded(sheets, id, sheetTitle, ensureSheet, headers, logger) {
|
|
176
262
|
return _async_to_generator(function() {
|
|
177
263
|
var _res_data_replies__addSheet_properties, _res_data_replies__addSheet, _res_data_replies_, _res_data_replies, _res_data, ssResp, ss, has, _ss_sheets_find_properties, _ss_sheets_find, _ss_sheets, sid, result, _ref, merged, e, _logger_warn, res, createdId, result1, _ref1, merged1, e1, _logger_warn1;
|
|
@@ -459,7 +545,7 @@ function findSheetByRef(client, spreadsheetId, sheetRef, logger) {
|
|
|
459
545
|
}
|
|
460
546
|
function ensureTabAndHeaders(_0, _1) {
|
|
461
547
|
return _async_to_generator(function(sheets, param) {
|
|
462
|
-
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;
|
|
463
549
|
return _ts_generator(this, function(_state) {
|
|
464
550
|
switch(_state.label){
|
|
465
551
|
case 0:
|
|
@@ -471,6 +557,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
471
557
|
if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');
|
|
472
558
|
// Resolve the actual sheet title from sheetRef if provided
|
|
473
559
|
resolvedSheetTitle = sheetTitle;
|
|
560
|
+
createTab = false;
|
|
474
561
|
if (!sheetRef) return [
|
|
475
562
|
3,
|
|
476
563
|
2
|
|
@@ -487,6 +574,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
487
574
|
} else {
|
|
488
575
|
// Sheet doesn't exist, use the sheetRef as the title for creation
|
|
489
576
|
resolvedSheetTitle = sheetRef;
|
|
577
|
+
createTab = true;
|
|
490
578
|
}
|
|
491
579
|
_state.label = 2;
|
|
492
580
|
case 2:
|
|
@@ -506,42 +594,10 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
506
594
|
'body'
|
|
507
595
|
];
|
|
508
596
|
header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;
|
|
509
|
-
|
|
510
|
-
_state.label = 3;
|
|
511
|
-
case 3:
|
|
512
|
-
_state.trys.push([
|
|
597
|
+
if (!createTab) return [
|
|
513
598
|
3,
|
|
514
|
-
|
|
515
|
-
,
|
|
516
|
-
11
|
|
517
|
-
]);
|
|
518
|
-
return [
|
|
519
|
-
4,
|
|
520
|
-
sheets.spreadsheets.values.get({
|
|
521
|
-
spreadsheetId: spreadsheetId,
|
|
522
|
-
range: "".concat(resolvedSheetTitle, "!1:1"),
|
|
523
|
-
majorDimension: 'ROWS'
|
|
524
|
-
})
|
|
599
|
+
4
|
|
525
600
|
];
|
|
526
|
-
case 4:
|
|
527
|
-
resp = _state.sent();
|
|
528
|
-
vr = resp.data;
|
|
529
|
-
values = ((vr === null || vr === void 0 ? void 0 : vr.values) || [])[0] || [];
|
|
530
|
-
existingHeader = values.length ? values : null;
|
|
531
|
-
return [
|
|
532
|
-
3,
|
|
533
|
-
11
|
|
534
|
-
];
|
|
535
|
-
case 5:
|
|
536
|
-
_err = _state.sent();
|
|
537
|
-
_state.label = 6;
|
|
538
|
-
case 6:
|
|
539
|
-
_state.trys.push([
|
|
540
|
-
6,
|
|
541
|
-
8,
|
|
542
|
-
,
|
|
543
|
-
9
|
|
544
|
-
]);
|
|
545
601
|
return [
|
|
546
602
|
4,
|
|
547
603
|
sheets.spreadsheets.batchUpdate({
|
|
@@ -559,46 +615,26 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
559
615
|
}
|
|
560
616
|
})
|
|
561
617
|
];
|
|
562
|
-
case
|
|
618
|
+
case 3:
|
|
563
619
|
_state.sent();
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
9
|
|
567
|
-
];
|
|
568
|
-
case 8:
|
|
569
|
-
unused = _state.sent();
|
|
570
|
-
return [
|
|
571
|
-
3,
|
|
572
|
-
9
|
|
573
|
-
];
|
|
574
|
-
case 9:
|
|
620
|
+
_state.label = 4;
|
|
621
|
+
case 4:
|
|
575
622
|
return [
|
|
576
623
|
4,
|
|
577
|
-
sheets.spreadsheets.values.
|
|
624
|
+
sheets.spreadsheets.values.get({
|
|
578
625
|
spreadsheetId: spreadsheetId,
|
|
579
|
-
range: "".concat(resolvedSheetTitle, "!
|
|
580
|
-
|
|
581
|
-
insertDataOption: 'INSERT_ROWS',
|
|
582
|
-
requestBody: {
|
|
583
|
-
values: [
|
|
584
|
-
header
|
|
585
|
-
]
|
|
586
|
-
}
|
|
626
|
+
range: "".concat(resolvedSheetTitle, "!1:1"),
|
|
627
|
+
majorDimension: 'ROWS'
|
|
587
628
|
})
|
|
588
629
|
];
|
|
589
|
-
case
|
|
590
|
-
_state.sent();
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
header: header,
|
|
595
|
-
keySet: new Set()
|
|
596
|
-
}
|
|
597
|
-
];
|
|
598
|
-
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;
|
|
599
635
|
if (!!existingHeader) return [
|
|
600
636
|
3,
|
|
601
|
-
|
|
637
|
+
7
|
|
602
638
|
];
|
|
603
639
|
return [
|
|
604
640
|
4,
|
|
@@ -614,7 +650,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
614
650
|
}
|
|
615
651
|
})
|
|
616
652
|
];
|
|
617
|
-
case
|
|
653
|
+
case 6:
|
|
618
654
|
_state.sent();
|
|
619
655
|
return [
|
|
620
656
|
2,
|
|
@@ -623,7 +659,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
623
659
|
keySet: new Set()
|
|
624
660
|
}
|
|
625
661
|
];
|
|
626
|
-
case
|
|
662
|
+
case 7:
|
|
627
663
|
mergedHeader = existingHeader.slice();
|
|
628
664
|
_iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
|
|
629
665
|
try {
|
|
@@ -670,7 +706,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
670
706
|
}
|
|
671
707
|
if (!(mergedHeader.length !== existingHeader.length)) return [
|
|
672
708
|
3,
|
|
673
|
-
|
|
709
|
+
9
|
|
674
710
|
];
|
|
675
711
|
return [
|
|
676
712
|
4,
|
|
@@ -685,13 +721,11 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
685
721
|
}
|
|
686
722
|
})
|
|
687
723
|
];
|
|
688
|
-
case
|
|
724
|
+
case 8:
|
|
689
725
|
_state.sent();
|
|
690
|
-
_state.label =
|
|
691
|
-
case
|
|
726
|
+
_state.label = 9;
|
|
727
|
+
case 9:
|
|
692
728
|
keySet = new Set();
|
|
693
|
-
chunkSize = 1000;
|
|
694
|
-
startRow = 2;
|
|
695
729
|
normalizeKeyColumnsByName = function normalizeKeyColumnsByName(kc, hdr) {
|
|
696
730
|
if (!Array.isArray(kc) || kc.length === 0) return [];
|
|
697
731
|
return kc.map(function(name) {
|
|
@@ -716,35 +750,9 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
716
750
|
maxIdx = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(validKeyIdxs));
|
|
717
751
|
startCol = (0, _columnutilitiests.a1Col)(minIdx + 1);
|
|
718
752
|
endCol = (0, _columnutilitiests.a1Col)(maxIdx + 1);
|
|
719
|
-
_state.label = 16;
|
|
720
|
-
case 16:
|
|
721
|
-
if (!true) return [
|
|
722
|
-
3,
|
|
723
|
-
18
|
|
724
|
-
];
|
|
725
|
-
endRow = startRow + chunkSize - 1;
|
|
726
|
-
range = "".concat(resolvedSheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
|
|
727
753
|
return [
|
|
728
754
|
4,
|
|
729
|
-
sheets
|
|
730
|
-
spreadsheetId: spreadsheetId,
|
|
731
|
-
range: range,
|
|
732
|
-
majorDimension: 'ROWS'
|
|
733
|
-
})
|
|
734
|
-
];
|
|
735
|
-
case 17:
|
|
736
|
-
respChunk = _state.sent();
|
|
737
|
-
vrChunk = respChunk.data;
|
|
738
|
-
chunkRows = (vrChunk === null || vrChunk === void 0 ? void 0 : vrChunk.values) || [];
|
|
739
|
-
if (!chunkRows || chunkRows.length === 0) return [
|
|
740
|
-
3,
|
|
741
|
-
18
|
|
742
|
-
];
|
|
743
|
-
_iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
|
|
744
|
-
try {
|
|
745
|
-
_loop = function() {
|
|
746
|
-
var r = _step2.value;
|
|
747
|
-
var row = Array.isArray(r) ? r : [];
|
|
755
|
+
scanKeyColumnRows(sheets, spreadsheetId, resolvedSheetTitle, startCol, endCol, function(row) {
|
|
748
756
|
// Use the same key generation logic as appendRows for consistency
|
|
749
757
|
var lower = mergedHeader.map(function(h) {
|
|
750
758
|
return String(h !== null && h !== void 0 ? h : '').toLowerCase();
|
|
@@ -752,7 +760,7 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
752
760
|
var provHeaderIdx = lower.indexOf('provider');
|
|
753
761
|
var idHeaderIdx = lower.indexOf('messageid');
|
|
754
762
|
if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');
|
|
755
|
-
var compositeKey
|
|
763
|
+
var compositeKey;
|
|
756
764
|
if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {
|
|
757
765
|
var _row_providerOffset, _row_idOffset;
|
|
758
766
|
// Special case: if both provider and id columns exist, use them
|
|
@@ -773,28 +781,10 @@ function ensureTabAndHeaders(_0, _1) {
|
|
|
773
781
|
compositeKey = comps.join('\\');
|
|
774
782
|
}
|
|
775
783
|
if (compositeKey.replace(/\\+/g, '') !== '') keySet.add(compositeKey);
|
|
776
|
-
}
|
|
777
|
-
for(_iterator2 = chunkRows[Symbol.iterator](); !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true)_loop();
|
|
778
|
-
} catch (err) {
|
|
779
|
-
_didIteratorError2 = true;
|
|
780
|
-
_iteratorError2 = err;
|
|
781
|
-
} finally{
|
|
782
|
-
try {
|
|
783
|
-
if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
|
|
784
|
-
_iterator2.return();
|
|
785
|
-
}
|
|
786
|
-
} finally{
|
|
787
|
-
if (_didIteratorError2) {
|
|
788
|
-
throw _iteratorError2;
|
|
789
|
-
}
|
|
790
|
-
}
|
|
791
|
-
}
|
|
792
|
-
startRow += chunkRows.length;
|
|
793
|
-
return [
|
|
794
|
-
3,
|
|
795
|
-
16
|
|
784
|
+
})
|
|
796
785
|
];
|
|
797
|
-
case
|
|
786
|
+
case 10:
|
|
787
|
+
_state.sent();
|
|
798
788
|
return [
|
|
799
789
|
2,
|
|
800
790
|
{
|