@mcp-z/mcp-sheets 2.1.0 → 2.2.0

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

@@ -1 +1 @@
-{"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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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\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

@@ -1,4 +1,5 @@
-import type { drive_v3, sheets_v4 } from 'googleapis';
+import type { drive_v3 } from '@googleapis/drive';
+import type { sheets_v4 } from '@googleapis/sheets';
 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<{

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

@@ -1,4 +1,5 @@
-import type { drive_v3, sheets_v4 } from 'googleapis';
+import type { drive_v3 } from '@googleapis/drive';
+import type { sheets_v4 } from '@googleapis/sheets';
 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<{

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

@@ -1 +1 @@
-{"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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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3 } from '@googleapis/drive';\nimport type { sheets_v4 } from '@googleapis/sheets';\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/lib/google-auth.js

@@ -1,5 +1,5 @@
+import { auth as googleAuthPlus } from '@googleapis/sheets';
 import { attachTokenProvider } from '@mcp-z/oauth-google';
-import { google } from 'googleapis';
 /**
  * A Google API client bound to this request's token provider.
  *
@@ -7,5 +7,5 @@ import { google } from 'googleapis';
  * is built here, from this package's own `googleapis`. That keeps one copy of
  * `google-auth-library` in the tree by construction rather than by matching pins.
  */ export function googleAuth(auth) {
-    return attachTokenProvider(new google.auth.OAuth2(), auth);
+    return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);
 }

package/dist/esm/lib/google-auth.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\nimport { google } from 'googleapis';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new google.auth.OAuth2(), auth);\n}\n"],"names":["attachTokenProvider","google","googleAuth","auth","OAuth2"],"mappings":"AAAA,SAASA,mBAAmB,QAAiC,sBAAsB;AACnF,SAASC,MAAM,QAAQ,aAAa;AAEpC;;;;;;CAMC,GACD,OAAO,SAASC,WAAWC,IAAwB;IACjD,OAAOH,oBAAoB,IAAIC,OAAOE,IAAI,CAACC,MAAM,IAAID;AACvD"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { auth as googleAuthPlus } from '@googleapis/sheets';\nimport { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);\n}\n"],"names":["auth","googleAuthPlus","attachTokenProvider","googleAuth","OAuth2"],"mappings":"AAAA,SAASA,QAAQC,cAAc,QAAQ,qBAAqB;AAC5D,SAASC,mBAAmB,QAAiC,sBAAsB;AAEnF;;;;;;CAMC,GACD,OAAO,SAASC,WAAWH,IAAwB;IACjD,OAAOE,oBAAoB,IAAID,eAAeG,MAAM,IAAIJ;AAC1D"}

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

@@ -1,5 +1,5 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { ResourceTemplate } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { googleAuth } from '../../lib/google-auth.js';
 export default function createResource() {
     const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {
@@ -28,7 +28,7 @@ export default function createResource() {
             var _data_properties, _data_properties1;
             // Safe type guard to access middleware-enriched extra
             const { logger, authContext } = extra;
-            const sheets = google.sheets({
+            const sheets = sheetsApi({
                 version: 'v4',
                 auth: googleAuth(authContext.auth)
             });

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

@@ -1 +1 @@
-{"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 { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { googleAuth } from '../../lib/google-auth.ts';\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: ServerContext): 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: googleAuth(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","googleAuth","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 sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { googleAuth } from '../../lib/google-auth.ts';\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: ServerContext): 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","ResourceTemplate","googleAuth","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","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

@@ -1,7 +1,7 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -86,7 +86,7 @@ async function handler({ id, gid, requests }, extra) {
     try {
         var _sheet_properties_title, _sheet_properties_sheetId;
         var _spreadsheetResponse_data_sheets;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
             auth: googleAuth(extra.authContext.auth)
         });

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/chart-create.js

@@ -1,7 +1,7 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -92,7 +92,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
     try {
         var _sheet_properties_title, _sheet_properties_sheetId, _dataGridRange_sheetId;
         var _spreadsheetResponse_data_sheets, _replies__addChart_chart, _replies__addChart, _replies_;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/chart-create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n  anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n  offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n  offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n  dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n  title: z.string().optional().describe('Chart title displayed at top'),\n  position: ChartPositionSchema,\n  legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n  is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n  sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n  chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n  anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n  // Simple A1 notation parser for single cells\n  const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n  }\n\n  const colLetters = match[1];\n  const rowNumber = match[2];\n\n  // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n  let columnIndex = 0;\n  for (let i = 0; i < colLetters.length; i++) {\n    columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n  }\n  columnIndex--; // Convert to 0-based\n\n  // Convert row number to index (1-based to 0-based)\n  const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n  return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.chart.create called', {\n    id,\n    gid,\n    chartType,\n    dataRange,\n    title,\n    position,\n    legend,\n    is3D,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for chart create', { id, gid, chartType });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Validate 3D only for PIE charts\n    // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n    if (is3D && chartType !== 'PIE') {\n      logger.info('3D mode not supported for this chart type', {\n        chartType,\n        is3D,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n    }\n\n    // Parse anchor cell to row/column indices\n    let anchorRowIndex: number;\n    let anchorColumnIndex: number;\n    try {\n      const anchorIndices = parseAnchorCell(position.anchorCell);\n      anchorRowIndex = anchorIndices.rowIndex;\n      anchorColumnIndex = anchorIndices.columnIndex;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse anchor cell', {\n        anchorCell: position.anchorCell,\n        error: message,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n    }\n\n    // Parse data range to grid range\n    let dataGridRange: sheets_v4.Schema$GridRange;\n    try {\n      const rangeRef = parseA1Notation(dataRange);\n      dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n      // Validate that required properties are defined for chart creation\n      if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n      if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse data range', {\n        dataRange,\n        error: message,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n    }\n\n    // Extract validated properties with defined types\n    const dataStartRowIndex = dataGridRange.startRowIndex as number;\n    const dataEndRowIndex = dataGridRange.endRowIndex as number;\n    const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n    const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n    const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n    // Build chart spec with properly split domain and series ranges\n    let chartSpec: sheets_v4.Schema$ChartSpec;\n\n    logger.info('Building chart spec', {\n      chartType,\n      dataGridRange,\n      sheetId,\n    });\n\n    // Map legend position to API format (add _LEGEND suffix)\n    const legendPositionMap: Record<string, string> = {\n      BOTTOM: 'BOTTOM_LEGEND',\n      RIGHT: 'RIGHT_LEGEND',\n      TOP: 'TOP_LEGEND',\n      LEFT: 'LEFT_LEGEND',\n      NONE: 'NO_LEGEND',\n    };\n    const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n    if (chartType === 'PIE') {\n      // PIE charts use a separate pieChart property, not basicChart\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n      };\n\n      const seriesRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n        endColumnIndex: dataStartColumnIndex + 2,\n      };\n\n      logger.info('PIE chart ranges', {\n        dataGridRange,\n        domainRange,\n        seriesRange,\n        apiLegendPosition,\n      });\n\n      chartSpec = {\n        pieChart: {\n          // Use pieChart for PIE charts\n          legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n          domain: {\n            // Note: domain/series are direct objects, not arrays\n            sourceRange: {\n              sources: [domainRange],\n            },\n          },\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n          threeDimensional: is3D, // 3D is directly on pieChart\n        },\n      };\n      if (title) {\n        chartSpec.title = title;\n      }\n    } else {\n      // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only\n      };\n\n      // Calculate number of data columns (excluding the first domain column)\n      const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n      const series = [];\n\n      // Create a series for each data column\n      for (let i = 0; i < numDataColumns; i++) {\n        const seriesRange = {\n          sheetId: baseSheetId,\n          startRowIndex: dataStartRowIndex,\n          endRowIndex: dataEndRowIndex,\n          startColumnIndex: dataStartColumnIndex + 1 + i,\n          endColumnIndex: dataStartColumnIndex + 2 + i,\n        };\n\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n        });\n      }\n\n      // If no data columns were found, default to using the entire range as a fallback\n      if (series.length === 0) {\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [dataGridRange],\n            },\n          },\n        });\n      }\n\n      const basicChart: sheets_v4.Schema$BasicChartSpec = {\n        chartType, // BAR, COLUMN, LINE are valid for basicChart\n        headerCount: 1, // First row is headers\n        // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n        // threeDimensional is only supported for pieChart\n        domains: [\n          {\n            domain: {\n              sourceRange: {\n                sources: [domainRange],\n              },\n            },\n          },\n        ],\n        series,\n      };\n      if (legend !== 'NONE') {\n        basicChart.legendPosition = apiLegendPosition;\n      }\n\n      chartSpec = { basicChart };\n      if (title) {\n        chartSpec.title = title;\n      }\n    }\n\n    // Build embedded object position\n    const embeddedObjectPosition = {\n      overlayPosition: {\n        anchorCell: {\n          sheetId,\n          rowIndex: anchorRowIndex,\n          columnIndex: anchorColumnIndex,\n        },\n        offsetXPixels: position.offsetX,\n        offsetYPixels: position.offsetY,\n      },\n    };\n\n    const requestBody = {\n      requests: [\n        {\n          addChart: {\n            chart: {\n              spec: chartSpec,\n              position: embeddedObjectPosition,\n            },\n          },\n        },\n      ],\n    };\n\n    logger.info('sheets.chart.create executing addChart request', {\n      spreadsheetId: id,\n      sheetTitle,\n      chartType,\n      dataRange,\n      anchorCell: position.anchorCell,\n      requestBody: JSON.stringify(requestBody),\n    });\n\n    // Execute the addChart request\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody,\n    });\n\n    // Extract chart ID from response\n    const replies = response.data.replies || [];\n    if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n      logger.error('Chart creation failed - no chart ID returned', {\n        spreadsheetId: id,\n        sheetTitle,\n        chartType,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n    }\n\n    const chartId = replies[0].addChart.chart.chartId;\n\n    logger.info('sheets.chart.create completed successfully', {\n      chartId,\n      chartType,\n      anchorCell: position.anchorCell,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      chartId,\n      anchorCell: position.anchorCell,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (e) {\n    const error = e as Error & { response?: { data?: unknown; status?: number } };\n    const message = error.message || String(e);\n    logger.error('Chart create operation failed', {\n      id,\n      gid,\n      chartType,\n      dataRange,\n      error: message,\n      response: error.response?.data,\n      status: error.response?.status,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n      stack: e instanceof Error ? e.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'chart-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-create.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n  anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n  offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n  offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n  dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n  title: z.string().optional().describe('Chart title displayed at top'),\n  position: ChartPositionSchema,\n  legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n  is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n  sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n  chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n  anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n  // Simple A1 notation parser for single cells\n  const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n  }\n\n  const colLetters = match[1];\n  const rowNumber = match[2];\n\n  // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n  let columnIndex = 0;\n  for (let i = 0; i < colLetters.length; i++) {\n    columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n  }\n  columnIndex--; // Convert to 0-based\n\n  // Convert row number to index (1-based to 0-based)\n  const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n  return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.chart.create called', {\n    id,\n    gid,\n    chartType,\n    dataRange,\n    title,\n    position,\n    legend,\n    is3D,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for chart create', { id, gid, chartType });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Validate 3D only for PIE charts\n    // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n    if (is3D && chartType !== 'PIE') {\n      logger.info('3D mode not supported for this chart type', {\n        chartType,\n        is3D,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n    }\n\n    // Parse anchor cell to row/column indices\n    let anchorRowIndex: number;\n    let anchorColumnIndex: number;\n    try {\n      const anchorIndices = parseAnchorCell(position.anchorCell);\n      anchorRowIndex = anchorIndices.rowIndex;\n      anchorColumnIndex = anchorIndices.columnIndex;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse anchor cell', {\n        anchorCell: position.anchorCell,\n        error: message,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n    }\n\n    // Parse data range to grid range\n    let dataGridRange: sheets_v4.Schema$GridRange;\n    try {\n      const rangeRef = parseA1Notation(dataRange);\n      dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n      // Validate that required properties are defined for chart creation\n      if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n      if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse data range', {\n        dataRange,\n        error: message,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n    }\n\n    // Extract validated properties with defined types\n    const dataStartRowIndex = dataGridRange.startRowIndex as number;\n    const dataEndRowIndex = dataGridRange.endRowIndex as number;\n    const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n    const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n    const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n    // Build chart spec with properly split domain and series ranges\n    let chartSpec: sheets_v4.Schema$ChartSpec;\n\n    logger.info('Building chart spec', {\n      chartType,\n      dataGridRange,\n      sheetId,\n    });\n\n    // Map legend position to API format (add _LEGEND suffix)\n    const legendPositionMap: Record<string, string> = {\n      BOTTOM: 'BOTTOM_LEGEND',\n      RIGHT: 'RIGHT_LEGEND',\n      TOP: 'TOP_LEGEND',\n      LEFT: 'LEFT_LEGEND',\n      NONE: 'NO_LEGEND',\n    };\n    const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n    if (chartType === 'PIE') {\n      // PIE charts use a separate pieChart property, not basicChart\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n      };\n\n      const seriesRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n        endColumnIndex: dataStartColumnIndex + 2,\n      };\n\n      logger.info('PIE chart ranges', {\n        dataGridRange,\n        domainRange,\n        seriesRange,\n        apiLegendPosition,\n      });\n\n      chartSpec = {\n        pieChart: {\n          // Use pieChart for PIE charts\n          legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n          domain: {\n            // Note: domain/series are direct objects, not arrays\n            sourceRange: {\n              sources: [domainRange],\n            },\n          },\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n          threeDimensional: is3D, // 3D is directly on pieChart\n        },\n      };\n      if (title) {\n        chartSpec.title = title;\n      }\n    } else {\n      // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only\n      };\n\n      // Calculate number of data columns (excluding the first domain column)\n      const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n      const series = [];\n\n      // Create a series for each data column\n      for (let i = 0; i < numDataColumns; i++) {\n        const seriesRange = {\n          sheetId: baseSheetId,\n          startRowIndex: dataStartRowIndex,\n          endRowIndex: dataEndRowIndex,\n          startColumnIndex: dataStartColumnIndex + 1 + i,\n          endColumnIndex: dataStartColumnIndex + 2 + i,\n        };\n\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n        });\n      }\n\n      // If no data columns were found, default to using the entire range as a fallback\n      if (series.length === 0) {\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [dataGridRange],\n            },\n          },\n        });\n      }\n\n      const basicChart: sheets_v4.Schema$BasicChartSpec = {\n        chartType, // BAR, COLUMN, LINE are valid for basicChart\n        headerCount: 1, // First row is headers\n        // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n        // threeDimensional is only supported for pieChart\n        domains: [\n          {\n            domain: {\n              sourceRange: {\n                sources: [domainRange],\n              },\n            },\n          },\n        ],\n        series,\n      };\n      if (legend !== 'NONE') {\n        basicChart.legendPosition = apiLegendPosition;\n      }\n\n      chartSpec = { basicChart };\n      if (title) {\n        chartSpec.title = title;\n      }\n    }\n\n    // Build embedded object position\n    const embeddedObjectPosition = {\n      overlayPosition: {\n        anchorCell: {\n          sheetId,\n          rowIndex: anchorRowIndex,\n          columnIndex: anchorColumnIndex,\n        },\n        offsetXPixels: position.offsetX,\n        offsetYPixels: position.offsetY,\n      },\n    };\n\n    const requestBody = {\n      requests: [\n        {\n          addChart: {\n            chart: {\n              spec: chartSpec,\n              position: embeddedObjectPosition,\n            },\n          },\n        },\n      ],\n    };\n\n    logger.info('sheets.chart.create executing addChart request', {\n      spreadsheetId: id,\n      sheetTitle,\n      chartType,\n      dataRange,\n      anchorCell: position.anchorCell,\n      requestBody: JSON.stringify(requestBody),\n    });\n\n    // Execute the addChart request\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody,\n    });\n\n    // Extract chart ID from response\n    const replies = response.data.replies || [];\n    if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n      logger.error('Chart creation failed - no chart ID returned', {\n        spreadsheetId: id,\n        sheetTitle,\n        chartType,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n    }\n\n    const chartId = replies[0].addChart.chart.chartId;\n\n    logger.info('sheets.chart.create completed successfully', {\n      chartId,\n      chartType,\n      anchorCell: position.anchorCell,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      chartId,\n      anchorCell: position.anchorCell,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (e) {\n    const error = e as Error & { response?: { data?: unknown; status?: number } };\n    const message = error.message || String(e);\n    logger.error('Chart create operation failed', {\n      id,\n      gid,\n      chartType,\n      dataRange,\n      error: message,\n      response: error.response?.data,\n      status: error.response?.status,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n      stack: e instanceof Error ? e.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'chart-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/columns-get.js

@@ -1,7 +1,7 @@
-/** Get column names from Google Sheet (peek at first row only) */ import { schemas } from '@mcp-z/oauth-google';
+/** Get column names from Google Sheet (peek at first row only) */ import { sheets as sheetsApi } from '@googleapis/sheets';
+import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
 import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
-import { google } from 'googleapis';
 import { z } from 'zod';
 import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -42,7 +42,7 @@ async function handler({ id, gid, render }, extra) {
     try {
         var _sheet_properties_title;
         var _spreadsheetResponse_data_sheets, _logger_info;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
             auth: googleAuth(extra.authContext.auth)
         });

package/dist/esm/mcp/tools/columns-get.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}