@mcp-z/mcp-sheets 1.0.7 → 1.1.0

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

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

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

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

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

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

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.ts';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n\n  // File serving configuration for CSV exports\n  resourceStoreUri: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface StorageContext {\n  resourceStoreUri: string;\n  baseUrl?: string;\n  transport: BaseServerConfig['transport'];\n}\n\nexport interface StorageExtra {\n  storageContext: StorageContext;\n}\n\nexport interface GoogleApiError {\n  response?: { status?: number };\n  status?: number;\n  statusCode?: number;\n  code?: number | string;\n  message?: string;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n"],"names":[],"mappings":"AAsEA,WAGC"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.ts';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n\n  // File serving configuration for CSV exports\n  resourceStoreUri: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface StorageContext {\n  resourceStoreUri: string;\n  baseUrl?: string;\n  transport: BaseServerConfig['transport'];\n}\n\nexport interface StorageExtra {\n  storageContext: StorageContext;\n}\n\nexport interface GoogleApiError {\n  response?: { status?: number };\n  status?: number;\n  statusCode?: number;\n  code?: number | string;\n  message?: string;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n"],"names":[],"mappings":"AAsEA,WAGC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-z/mcp-sheets",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
   "keywords": [
     "sheets",
@@ -75,10 +75,10 @@
     "@mcp-z/server": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "cors": "^2.0.0",
-    "csv-parse": "^6.0.0",
+    "csv-parse": "^7.0.2",
     "express": "^5.0.0",
-    "google-auth-library": "^10.0.0",
-    "googleapis": "^169.0.0",
+    "google-auth-library": "10.5.0",
+    "googleapis": "^174.0.1",
     "keyv-registry": "^1.0.0",
     "module-root-sync": "^2.0.0",
     "pino": "^10.0.0",
@@ -89,7 +89,7 @@
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.0.3",
+    "@types/node": "^26.2.0",
     "dotenv": "^17.2.3",
     "get-port": "^7.1.0",
     "keyv": "^5.0.0",