@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/spreadsheet/range-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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.js';\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 * Calculates total cells affected by multiple ranges\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","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","ranges","reduce","total","dimensions","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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"}

package/dist/cjs/spreadsheet/sheet-operations.d.cts

@@ -0,0 +1,30 @@
+import type { sheets_v4 } from 'googleapis';
+import type { Logger } from '../types.js';
+export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
+    sheetCreated: boolean;
+    sheetGUID?: string;
+    headersEnsured?: boolean;
+}>;
+export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet>;
+export declare 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[];
+}>;
+export declare 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[];
+}>;

package/dist/cjs/spreadsheet/sheet-operations.d.ts

@@ -0,0 +1,30 @@
+import type { sheets_v4 } from 'googleapis';
+import type { Logger } from '../types.js';
+export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
+    sheetCreated: boolean;
+    sheetGUID?: string;
+    headersEnsured?: boolean;
+}>;
+export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet>;
+export declare 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[];
+}>;
+export declare 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[];
+}>;