@mcp-z/mcp-sheets 1.0.7 → 1.1.0

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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 * 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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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/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 * 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

@@ -5,7 +5,7 @@ export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string
     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 findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet | null>;
 export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
     spreadsheetId: string;
     sheetTitle: string;

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

@@ -5,7 +5,7 @@ export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string
     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 findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet | null>;
 export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
     spreadsheetId: string;
     sheetTitle: string;

package/dist/cjs/spreadsheet/sheet-operations.js

@@ -693,7 +693,7 @@ function ensureTabAndHeaders(_0, _1) {
                     keySet = new Set();
                     chunkSize = 1000;
                     startRow = 2;
-                    normalizeKeyColumnsByName = function(kc, hdr) {
+                    normalizeKeyColumnsByName = function normalizeKeyColumnsByName(kc, hdr) {
                         if (!Array.isArray(kc) || kc.length === 0) return [];
                         return kc.map(function(name) {
                             if (typeof name !== 'string' || name.length === 0) return -1;

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from 'googleapis';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n  if (!sheetTitle) return { sheetCreated: false };\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n  const ss = ssResp.data;\n  const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n  if (has) {\n    const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n    const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n    if (sid != null) result.sheetGUID = String(sid);\n    if (headers) {\n      try {\n        const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n        if (merged) result.headersEnsured = true;\n      } catch (e) {\n        logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n      }\n    }\n    return result;\n  }\n  if (!ensureSheet) return { sheetCreated: false };\n\n  const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n  const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n  const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n  if (createdId != null) result.sheetGUID = String(createdId);\n  if (createdId && headers) {\n    try {\n      const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n      if (merged) result.headersEnsured = true;\n    } catch (e) {\n      logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n    }\n  }\n  return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n  const ssResp = await client.spreadsheets.get({ spreadsheetId });\n  const sheets = ssResp.data?.sheets || [];\n  const trimmedRef = sheetRef?.trim();\n\n  logger.debug?.('findSheetByRef called', {\n    spreadsheetId,\n    sheetRef,\n    trimmedRef,\n    availableSheets: sheets.map((s) => ({\n      title: s?.properties?.title,\n      id: s?.properties?.sheetId,\n    })),\n  });\n\n  if (!trimmedRef) {\n    logger.warn?.('findSheetByRef empty sheetRef');\n    return null;\n  }\n\n  // Strategy 1: Try exact title match first (most common case)\n  const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n  if (exactTitleMatch) {\n    logger.debug?.('findSheetByRef exact title match found');\n    return exactTitleMatch;\n  }\n\n  // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n  const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n  if (exactGuidMatch) {\n    logger.debug?.('findSheetByRef exact GUID match found');\n    return exactGuidMatch;\n  }\n\n  // Strategy 3: Case-insensitive title match\n  const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveMatch) {\n    logger.debug?.('findSheetByRef case-insensitive title match found');\n    return caseInsensitiveMatch;\n  }\n\n  // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n  const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n  if (trimmedTitleMatch) {\n    logger.debug?.('findSheetByRef trimmed title match found');\n    return trimmedTitleMatch;\n  }\n\n  // Strategy 5: Case-insensitive + trimmed title match\n  const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveTrimmedMatch) {\n    logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n    return caseInsensitiveTrimmedMatch;\n  }\n\n  // Strategy 6: Partial title match (last resort)\n  const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n  if (partialMatch) {\n    logger.debug?.('findSheetByRef partial title match found');\n    return partialMatch;\n  }\n\n  logger.warn?.('findSheetByRef no match found', {\n    searchRef: trimmedRef,\n    availableTitles: sheets.map((s) => s?.properties?.title),\n    availableIds: sheets.map((s) => s?.properties?.sheetId),\n  });\n  return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    requiredHeader = null as string[] | null,\n    keyColumns = ['id'] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    requiredHeader?: string[] | null;\n    keyColumns?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n  if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title for creation\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n  const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n  const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n  let existingHeader: string[] | null = null;\n  try {\n    const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = resp.data as ValueRange;\n    const values = ((vr?.values || [])[0] || []) as string[];\n    existingHeader = values.length ? values : null;\n  } catch (_err: unknown) {\n    try {\n      await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n    } catch {}\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  if (!existingHeader) {\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  const mergedHeader = existingHeader.slice();\n  for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n  if (Array.isArray(keyColumns)) {\n    for (const name of keyColumns) {\n      if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n      if (!mergedHeader.includes(name)) mergedHeader.push(name);\n    }\n  }\n\n  if (mergedHeader.length !== existingHeader.length) {\n    await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n  }\n\n  const keySet = new Set<string>();\n  const chunkSize = 1000;\n  let startRow = 2;\n\n  const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    return kc.map((name) => {\n      if (typeof name !== 'string' || name.length === 0) return -1;\n      const idx = hdr.indexOf(name);\n      return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n    });\n  };\n\n  const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n  const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n  if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n  const minIdx = Math.min(...validKeyIdxs);\n  const maxIdx = Math.max(...validKeyIdxs);\n  const startCol = a1Col(minIdx + 1);\n  const endCol = a1Col(maxIdx + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n    const respChunk = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n    const vrChunk = respChunk.data as ValueRange;\n    const chunkRows = (vrChunk?.values || []) as string[][];\n    if (!chunkRows || chunkRows.length === 0) break;\n    for (const r of chunkRows) {\n      const row = Array.isArray(r) ? r : [];\n\n      // Use the same key generation logic as appendRows for consistency\n      const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n      const provHeaderIdx = lower.indexOf('provider');\n      let idHeaderIdx = lower.indexOf('messageid');\n      if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n      let compositeKey: string;\n\n      if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n        // Special case: if both provider and id columns exist, use them\n        const providerOffset = provHeaderIdx - minIdx;\n        const idOffset = idHeaderIdx - minIdx;\n        const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n        const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n        compositeKey = [providerVal, messageVal].join('\\\\');\n      } else {\n        // General case: use the specified key columns\n        const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n        compositeKey = comps.join('\\\\');\n      }\n\n      if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n    }\n    startRow += chunkRows.length;\n  }\n  return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","sheets","id","sheetTitle","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","spreadsheets","get","spreadsheetId","data","Array","isArray","some","s","properties","title","find","sheetId","sheetGUID","String","requiredHeader","header","headersEnsured","warn","batchUpdate","requestBody","requests","addSheet","replies","client","sheetRef","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","toLowerCase","includes","searchRef","availableTitles","availableIds","keyColumns","Math","resolvedSheetTitle","sheet","defaultHeader","existingHeader","resp","vr","values","_err","mergedHeader","col","name","keySet","chunkSize","startRow","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","startCol","endCol","endRow","range","respChunk","vrChunk","chunkRows","Error","length","majorDimension","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","i","keyColumnsIdx","min","max","a1Col","r","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from 'googleapis';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n  if (!sheetTitle) return { sheetCreated: false };\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n  const ss = ssResp.data;\n  const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n  if (has) {\n    const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n    const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n    if (sid != null) result.sheetGUID = String(sid);\n    if (headers) {\n      try {\n        const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n        if (merged) result.headersEnsured = true;\n      } catch (e) {\n        logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n      }\n    }\n    return result;\n  }\n  if (!ensureSheet) return { sheetCreated: false };\n\n  const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n  const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n  const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n  if (createdId != null) result.sheetGUID = String(createdId);\n  if (createdId && headers) {\n    try {\n      const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n      if (merged) result.headersEnsured = true;\n    } catch (e) {\n      logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n    }\n  }\n  return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n  const ssResp = await client.spreadsheets.get({ spreadsheetId });\n  const sheets = ssResp.data?.sheets || [];\n  const trimmedRef = sheetRef?.trim();\n\n  logger.debug?.('findSheetByRef called', {\n    spreadsheetId,\n    sheetRef,\n    trimmedRef,\n    availableSheets: sheets.map((s) => ({\n      title: s?.properties?.title,\n      id: s?.properties?.sheetId,\n    })),\n  });\n\n  if (!trimmedRef) {\n    logger.warn?.('findSheetByRef empty sheetRef');\n    return null;\n  }\n\n  // Strategy 1: Try exact title match first (most common case)\n  const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n  if (exactTitleMatch) {\n    logger.debug?.('findSheetByRef exact title match found');\n    return exactTitleMatch;\n  }\n\n  // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n  const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n  if (exactGuidMatch) {\n    logger.debug?.('findSheetByRef exact GUID match found');\n    return exactGuidMatch;\n  }\n\n  // Strategy 3: Case-insensitive title match\n  const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveMatch) {\n    logger.debug?.('findSheetByRef case-insensitive title match found');\n    return caseInsensitiveMatch;\n  }\n\n  // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n  const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n  if (trimmedTitleMatch) {\n    logger.debug?.('findSheetByRef trimmed title match found');\n    return trimmedTitleMatch;\n  }\n\n  // Strategy 5: Case-insensitive + trimmed title match\n  const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveTrimmedMatch) {\n    logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n    return caseInsensitiveTrimmedMatch;\n  }\n\n  // Strategy 6: Partial title match (last resort)\n  const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n  if (partialMatch) {\n    logger.debug?.('findSheetByRef partial title match found');\n    return partialMatch;\n  }\n\n  logger.warn?.('findSheetByRef no match found', {\n    searchRef: trimmedRef,\n    availableTitles: sheets.map((s) => s?.properties?.title),\n    availableIds: sheets.map((s) => s?.properties?.sheetId),\n  });\n  return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    requiredHeader = null as string[] | null,\n    keyColumns = ['id'] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    requiredHeader?: string[] | null;\n    keyColumns?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n  if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title for creation\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n  const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n  const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n  let existingHeader: string[] | null = null;\n  try {\n    const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = resp.data as ValueRange;\n    const values = ((vr?.values || [])[0] || []) as string[];\n    existingHeader = values.length ? values : null;\n  } catch (_err: unknown) {\n    try {\n      await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n    } catch {}\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  if (!existingHeader) {\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  const mergedHeader = existingHeader.slice();\n  for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n  if (Array.isArray(keyColumns)) {\n    for (const name of keyColumns) {\n      if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n      if (!mergedHeader.includes(name)) mergedHeader.push(name);\n    }\n  }\n\n  if (mergedHeader.length !== existingHeader.length) {\n    await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n  }\n\n  const keySet = new Set<string>();\n  const chunkSize = 1000;\n  let startRow = 2;\n\n  const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    return kc.map((name) => {\n      if (typeof name !== 'string' || name.length === 0) return -1;\n      const idx = hdr.indexOf(name);\n      return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n    });\n  };\n\n  const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n  const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n  if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n  const minIdx = Math.min(...validKeyIdxs);\n  const maxIdx = Math.max(...validKeyIdxs);\n  const startCol = a1Col(minIdx + 1);\n  const endCol = a1Col(maxIdx + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n    const respChunk = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n    const vrChunk = respChunk.data as ValueRange;\n    const chunkRows = (vrChunk?.values || []) as string[][];\n    if (!chunkRows || chunkRows.length === 0) break;\n    for (const r of chunkRows) {\n      const row = Array.isArray(r) ? r : [];\n\n      // Use the same key generation logic as appendRows for consistency\n      const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n      const provHeaderIdx = lower.indexOf('provider');\n      let idHeaderIdx = lower.indexOf('messageid');\n      if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n      let compositeKey: string;\n\n      if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n        // Special case: if both provider and id columns exist, use them\n        const providerOffset = provHeaderIdx - minIdx;\n        const idOffset = idHeaderIdx - minIdx;\n        const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n        const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n        compositeKey = [providerVal, messageVal].join('\\\\');\n      } else {\n        // General case: use the specified key columns\n        const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n        compositeKey = comps.join('\\\\');\n      }\n\n      if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n    }\n    startRow += chunkRows.length;\n  }\n  return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","sheets","id","sheetTitle","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","spreadsheets","get","spreadsheetId","data","Array","isArray","some","s","properties","title","find","sheetId","sheetGUID","String","requiredHeader","header","headersEnsured","warn","batchUpdate","requestBody","requests","addSheet","replies","client","sheetRef","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","toLowerCase","includes","searchRef","availableTitles","availableIds","keyColumns","Math","resolvedSheetTitle","sheet","defaultHeader","existingHeader","resp","vr","values","_err","mergedHeader","col","name","keySet","chunkSize","startRow","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","startCol","endCol","endRow","range","respChunk","vrChunk","chunkRows","Error","length","majorDimension","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","i","keyColumnsIdx","min","max","a1Col","r","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}

package/dist/cjs/spreadsheet/spreadsheet-management.d.cts

@@ -3,19 +3,19 @@ export declare const SPREADSHEET_URL_RE: RegExp;
 export declare const SPREADSHEET_ID_RE: RegExp;
 export declare function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string): Promise<{
     id: string;
-    spreadsheetTitle: any;
-    url: any;
-    modifiedTime: any;
-}>;
+    spreadsheetTitle: string | null | undefined;
+    url: string | null | undefined;
+    modifiedTime: string | null | undefined;
+} | null>;
 export declare function findByName(drive: drive_v3.Drive, name: string): Promise<{
     id: string;
     spreadsheetTitle: string;
     url: string;
-    modifiedTime: string;
+    modifiedTime: string | null | undefined;
 }[]>;
 export declare function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string): Promise<{
     id: string;
-    spreadsheetTitle: any;
-    url: any;
-    modifiedTime: any;
+    spreadsheetTitle: string | null | undefined;
+    url: string | null | undefined;
+    modifiedTime: string | null | undefined;
 }[]>;

package/dist/cjs/spreadsheet/spreadsheet-management.d.ts

@@ -3,19 +3,19 @@ export declare const SPREADSHEET_URL_RE: RegExp;
 export declare const SPREADSHEET_ID_RE: RegExp;
 export declare function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string): Promise<{
     id: string;
-    spreadsheetTitle: any;
-    url: any;
-    modifiedTime: any;
-}>;
+    spreadsheetTitle: string | null | undefined;
+    url: string | null | undefined;
+    modifiedTime: string | null | undefined;
+} | null>;
 export declare function findByName(drive: drive_v3.Drive, name: string): Promise<{
     id: string;
     spreadsheetTitle: string;
     url: string;
-    modifiedTime: string;
+    modifiedTime: string | null | undefined;
 }[]>;
 export declare function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string): Promise<{
     id: string;
-    spreadsheetTitle: any;
-    url: any;
-    modifiedTime: any;
+    spreadsheetTitle: string | null | undefined;
+    url: string | null | undefined;
+    modifiedTime: string | null | undefined;
 }[]>;

package/dist/cjs/spreadsheet/spreadsheet-management.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.ts';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_ID_RE","SPREADSHEET_URL_RE","findById","findByName","findSpreadsheetsByRef","sheets","drive","id","ss","ssResp","dmResp","dm","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","files","fileId","fields","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","resp","escaped","q","String","replace","m","list","pageSize","map","f","ref","trimmedRef","urlMatch","r","trim","match","length","test"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.ts';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_ID_RE","SPREADSHEET_URL_RE","findById","findByName","findSpreadsheetsByRef","sheets","drive","id","ss","ssResp","dmResp","dm","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","files","fileId","fields","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","resp","escaped","q","String","replace","m","list","pageSize","map","f","ref","trimmedRef","urlMatch","r","trim","match","length","test"],"mappings":"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"}

package/dist/esm/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n"],"names":["GOOGLE_SCOPE"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n"],"names":["GOOGLE_SCOPE"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L"}

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { createConfig, handleVersionHelp } from './setup/config.ts';\nimport { createHTTPServer } from './setup/http.ts';\nimport { createStdioServer } from './setup/stdio.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["createConfig","handleVersionHelp","createHTTPServer","createStdioServer","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","URL","url","pathname"],"mappings":"AAAA,SAASA,YAAY,EAAEC,iBAAiB,QAAQ,oBAAoB;AACpE,SAASC,gBAAgB,QAAQ,kBAAkB;AACnD,SAASC,iBAAiB,QAAQ,mBAAmB;AAGrD,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGF,OAAOG,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMV,kBAAkBM,UAAU,MAAMP,iBAAiBO;IAEvHK,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAER,OAAOG,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,6CAA6C;IAC7C,MAAMP,SAAST;IACf,MAAMQ,YAAYC;AACpB;AAEA,IAAIK,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIK,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDT;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { createConfig, handleVersionHelp } from './setup/config.ts';\nimport { createHTTPServer } from './setup/http.ts';\nimport { createStdioServer } from './setup/stdio.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["createConfig","handleVersionHelp","createHTTPServer","createStdioServer","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","URL","url","pathname"],"mappings":"AAAA,SAASA,YAAY,EAAEC,iBAAiB,QAAQ,oBAAoB;AACpE,SAASC,gBAAgB,QAAQ,kBAAkB;AACnD,SAASC,iBAAiB,QAAQ,mBAAmB;AAGrD,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGF,OAAOG,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMV,kBAAkBM,UAAU,MAAMP,iBAAiBO;IAEvHK,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAER,OAAOG,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,6CAA6C;IAC7C,MAAMP,SAAST;IACf,MAAMQ,YAAYC;AACpB;AAEA,IAAIK,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIK,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDT;AACF"}

package/dist/esm/lib/create-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["keyvRegistry","createStore","uri","store","Error"],"mappings":"AACA,OAAOA,kBAAkB,gBAAgB;AAEzC,eAAe,eAAeC,YAAeC,GAAW;IACtD,MAAMC,QAAQ,MAAMH,aAAgBE;IACpC,IAAI,CAACC,OAAO,MAAM,IAAIC,MAAM,CAAC,gCAAgC,EAAEF,KAAK;IACpE,OAAOC;AACT"}

package/dist/esm/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/index.ts"],"sourcesContent":["export * as promptFactories from './prompts/index.ts';\nexport * as resourceFactories from './resources/index.ts';\nexport * as toolFactories from './tools/index.ts';\n"],"names":["promptFactories","resourceFactories","toolFactories"],"mappings":"AAAA,kCAAiC,qBAAqB;AAAtD,SAAO,oBAAKA,eAAe,GAA2B;AACtD,oCAAmC,uBAAuB;AAA1D,SAAO,sBAAKC,iBAAiB,GAA6B;AAC1D,gCAA+B,mBAAmB;AAAlD,SAAO,kBAAKC,aAAa,GAAyB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/index.ts"],"sourcesContent":["export * as promptFactories from './prompts/index.ts';\nexport * as resourceFactories from './resources/index.ts';\nexport * as toolFactories from './tools/index.ts';\n"],"names":["promptFactories","resourceFactories","toolFactories"],"mappings":"AAAA,kCAAiC,qBAAqB;AAAtD,SAAO,oBAAKA,eAAe,GAA2B;AACtD,oCAAmC,uBAAuB;AAA1D,SAAO,sBAAKC,iBAAiB,GAA6B;AAC1D,gCAA+B,mBAAmB;AAAlD,SAAO,kBAAKC,aAAa,GAAyB"}

package/dist/esm/mcp/prompts/a1-notation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}

package/dist/esm/mcp/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/prompts/index.ts"],"sourcesContent":["export { default as a1Notation } from './a1-notation.ts';\n"],"names":["default","a1Notation"],"mappings":"AAAA,SAASA,WAAWC,UAAU,QAAQ,mBAAmB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/index.ts"],"sourcesContent":["export { default as a1Notation } from './a1-notation.ts';\n"],"names":["default","a1Notation"],"mappings":"AAAA,SAASA,WAAWC,UAAU,QAAQ,mBAAmB"}

package/dist/esm/mcp/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/resources/index.ts"],"sourcesContent":["export { default as spreadsheet } from './spreadsheet.ts';\n"],"names":["default","spreadsheet"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,mBAAmB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/index.ts"],"sourcesContent":["export { default as spreadsheet } from './spreadsheet.ts';\n"],"names":["default","spreadsheet"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,mBAAmB"}

package/dist/esm/mcp/resources/spreadsheet.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = google.sheets({ version: 'v4', auth: authContext.auth });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = google.sheets({ version: 'v4', auth: authContext.auth });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}

package/dist/esm/mcp/tools/cells-format.js

@@ -83,7 +83,7 @@ async function handler({ id, gid, requests }, extra) {
         requestCount: requests.length
     });
     try {
-        var _sheet_properties_title;
+        var _sheet_properties_title, _sheet_properties_sheetId;
         var _spreadsheetResponse_data_sheets;
         const sheets = google.sheets({
             version: 'v4',
@@ -108,7 +108,8 @@ async function handler({ id, gid, requests }, extra) {
             throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
-        const sheetId = sheet.properties.sheetId;
+        // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
+        const sheetId = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
         const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;
         // Build batch update requests
         const batchRequests = [];