@mcp-z/mcp-sheets 2.4.1 → 2.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -29
- package/dist/cjs/constants.d.cts +2 -0
- package/dist/cjs/constants.d.ts +2 -0
- package/dist/cjs/constants.js +27 -3
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/mcp/tools/cells-copy.d.cts +165 -0
- package/dist/cjs/mcp/tools/cells-copy.d.ts +165 -0
- package/dist/cjs/mcp/tools/cells-copy.js +388 -0
- package/dist/cjs/mcp/tools/cells-copy.js.map +1 -0
- package/dist/cjs/mcp/tools/csv-get-columns.js +107 -29
- package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
- package/dist/cjs/mcp/tools/index.d.cts +1 -0
- package/dist/cjs/mcp/tools/index.d.ts +1 -0
- package/dist/cjs/mcp/tools/index.js +4 -0
- package/dist/cjs/mcp/tools/index.js.map +1 -1
- package/dist/cjs/schemas/index.d.cts +1 -0
- package/dist/cjs/schemas/index.d.ts +1 -0
- package/dist/cjs/schemas/index.js +16 -0
- package/dist/cjs/schemas/index.js.map +1 -1
- package/dist/cjs/setup/config.js +26 -14
- package/dist/cjs/setup/config.js.map +1 -1
- package/dist/cjs/setup/version-help.js +1 -1
- package/dist/cjs/setup/version-help.js.map +1 -1
- package/dist/cjs/spreadsheet/data-operations.js +59 -164
- package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/range-operations.d.cts +26 -0
- package/dist/cjs/spreadsheet/range-operations.d.ts +26 -0
- package/dist/cjs/spreadsheet/range-operations.js +48 -0
- package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
- package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
- package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
- package/dist/cjs/spreadsheet/sheet-operations.js +92 -52
- package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
- package/dist/esm/constants.d.ts +2 -0
- package/dist/esm/constants.js +14 -0
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
- package/dist/esm/mcp/tools/cells-copy.js +190 -0
- package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
- package/dist/esm/mcp/tools/csv-get-columns.js +44 -6
- package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
- package/dist/esm/mcp/tools/index.d.ts +1 -0
- package/dist/esm/mcp/tools/index.js +1 -0
- package/dist/esm/mcp/tools/index.js.map +1 -1
- package/dist/esm/schemas/index.d.ts +1 -0
- package/dist/esm/schemas/index.js +9 -0
- package/dist/esm/schemas/index.js.map +1 -1
- package/dist/esm/setup/config.js +26 -14
- package/dist/esm/setup/config.js.map +1 -1
- package/dist/esm/setup/version-help.js +7 -0
- package/dist/esm/setup/version-help.js.map +1 -1
- package/dist/esm/spreadsheet/data-operations.js +40 -84
- package/dist/esm/spreadsheet/data-operations.js.map +1 -1
- package/dist/esm/spreadsheet/range-operations.d.ts +26 -0
- package/dist/esm/spreadsheet/range-operations.js +50 -0
- package/dist/esm/spreadsheet/range-operations.js.map +1 -1
- package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
- package/dist/esm/spreadsheet/sheet-operations.js +69 -43
- package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
- package/package.json +3 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/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":";;;;;;;;;;;QAMsBA;eAAAA;;QA+GAC;eAAAA;;QA3EAC;eAAAA;;;iCAxCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIf,SAAeF,oBAAoBG,MAAwB,EAAEC,EAAU,EAAEC,UAAkB,EAAEC,WAAoB,EAAEC,OAA6B,EAAEC,MAAc;;YAsBnJC,wCAAAA,6BAAAA,oBAAAA,mBAAAA,WApBZC,QACAC,IACAC,KAEQD,4BAAAA,iBAAAA,YAANE,KACAC,QAIyB,MAAXC,QAETC,GACPR,cAOAC,KACAQ,WACAH,SAIyB,OAAXC,SAETC,IACPR;;;;oBA7BJ,IAAI,CAACH,YAAY;;wBAAO;4BAAEa,cAAc;wBAAM;;oBAC/B;;wBAAMf,OAAOgB,YAAY,CAACC,GAAG,CAAC;4BAAEC,eAAejB;wBAAG;;;oBAA3DM,SAAS;oBACTC,KAAKD,OAAOY,IAAI;oBAChBV,MAAMW,MAAMC,OAAO,CAACb,eAAAA,yBAAAA,GAAIR,MAAM,KAAKQ,GAAGR,MAAM,CAACsB,IAAI,CAAC,SAACC;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKvB;;yBACpFO,KAAAA;;;;oBACIC,OAAMF,aAAAA,GAAGR,MAAM,cAATQ,kCAAAA,kBAAAA,WAAWkB,IAAI,CAAC,SAACH;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKvB;oCAAhDM,uCAAAA,6BAAAA,gBAA6DgB,UAAU,cAAvEhB,iDAAAA,2BAAyEmB,OAAO;oBACtFhB,SAAkF;wBAAEI,cAAc;oBAAM;oBAC9G,IAAIL,OAAO,MAAMC,OAAOiB,SAAS,GAAGC,OAAOnB;yBACvCN,SAAAA;;;;;;;;;;;;oBAE2B;;wBAAMN,oBAAoBE,QAAQ;4BAAEkB,eAAejB;4BAAIC,YAAAA;4BAAY4B,gBAAgB1B;4BAASC,QAAAA;wBAAO;;;oBAAnG,OAAA,eAAXO,SAAW,KAAnBmB;oBACR,IAAInB,QAAQD,OAAOqB,cAAc,GAAG;;;;;;oBAC7BnB;qBACPR,eAAAA,OAAO4B,IAAI,cAAX5B,mCAAAA,kBAAAA,QAAc,mDAAmDQ;;;;;;oBAGrE;;wBAAOF;;;oBAET,IAAI,CAACR,aAAa;;wBAAO;4BAAEY,cAAc;wBAAM;;oBAEnC;;wBAAMf,OAAOgB,YAAY,CAACkB,WAAW,CAAC;4BAAEhB,eAAejB;4BAAIkC,aAAa;gCAAEC,QAAQ;oCAAG;wCAAEC,UAAU;4CAAEb,YAAY;gDAAEC,OAAOvB;4CAAW;wCAAE;oCAAE;;4BAAG;wBAAE;;;oBAAlJI,MAAM;oBACNQ,aAAYR,YAAAA,IAAIa,IAAI,cAARb,iCAAAA,oBAAAA,UAAUgC,OAAO,cAAjBhC,yCAAAA,qBAAAA,iBAAmB,CAAC,EAAE,cAAtBA,0CAAAA,8BAAAA,mBAAwB+B,QAAQ,cAAhC/B,mDAAAA,yCAAAA,4BAAkCkB,UAAU,cAA5ClB,6DAAAA,uCAA8CqB,OAAO;oBACjEhB,UAAkF;wBAAEI,cAAc,CAAC,CAACD;oBAAU;oBACpH,IAAIA,aAAa,MAAMH,QAAOiB,SAAS,GAAGC,OAAOf;yBAC7CA,CAAAA,aAAaV,OAAM,GAAnBU;;;;;;;;;;;;oBAE2B;;wBAAMhB,oBAAoBE,QAAQ;4BAAEkB,eAAejB;4BAAIC,YAAAA;4BAAY4B,gBAAgB1B;4BAASC,QAAAA;wBAAO;;;oBAAnG,QAAA,eAAXO,UAAW,MAAnBmB;oBACR,IAAInB,SAAQD,QAAOqB,cAAc,GAAG;;;;;;oBAC7BnB;qBACPR,gBAAAA,OAAO4B,IAAI,cAAX5B,oCAAAA,mBAAAA,QAAc,mDAAmDQ;;;;;;oBAGrE;;wBAAOF;;;;IACT;;AAEO,SAAeZ,eAAewC,MAAwB,EAAErB,aAAqB,EAAEsB,QAAgB,EAAEnC,MAAc;;YAErGE,cAGfF,eAyDAA,cA7DME,QACAP,QACAyC,YAaJpC,eAKIqC,iBAEJrC,gBAKIsC,gBAEJtC,gBAKIuC,sBAEJvC,gBAKIwC,mBAEJxC,gBAKIyC,6BAEJzC,gBAKI0C,cAEJ1C;;;;oBAzDa;;wBAAMkC,OAAOvB,YAAY,CAACC,GAAG,CAAC;4BAAEC,eAAAA;wBAAc;;;oBAAvDX,SAAS;oBACTP,SAASO,EAAAA,eAAAA,OAAOY,IAAI,cAAXZ,mCAAAA,aAAaP,MAAM;oBAC5ByC,aAAaD,qBAAAA,+BAAAA,SAAUQ,IAAI;qBAEjC3C,gBAAAA,OAAO4C,KAAK,cAAZ5C,oCAAAA,mBAAAA,QAAe,yBAAyB;wBACtCa,eAAAA;wBACAsB,UAAAA;wBACAC,YAAAA;wBACAS,iBAAiBlD,OAAOmD,GAAG,CAAC,SAAC5B;gCACpBA,eACHA;mCAF8B;gCAClCE,KAAK,EAAEF,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK;gCAC3BxB,EAAE,EAAEsB,cAAAA,yBAAAA,iBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,eAAeI,OAAO;4BAC5B;;oBACF;oBAEA,IAAI,CAACc,YAAY;;yBACfpC,gBAAAA,OAAO4B,IAAI,cAAX5B,oCAAAA,mBAAAA,QAAc;wBACd;;4BAAO;;oBACT;oBAEA,6DAA6D;oBACvDqC,kBAAkB1C,OAAO0B,IAAI,CAAC,SAACH;4BAAMA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK,MAAKgB;;oBACpE,IAAIC,iBAAiB;;yBACnBrC,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAOqC;;oBACT;oBAEA,0EAA0E;oBACpEC,iBAAiB3C,OAAO0B,IAAI,CAAC,SAACH;4BAAaA;+BAAPM,OAAON,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeI,OAAO,MAAMc;;oBAC7E,IAAIE,gBAAgB;;yBAClBtC,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAOsC;;oBACT;oBAEA,2CAA2C;oBACrCC,uBAAuB5C,OAAO0B,IAAI,CAAC,SAACH;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsB6B,WAAW,QAAOX,WAAWW,WAAW;;oBAC9G,IAAIR,sBAAsB;;yBACxBvC,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAOuC;;oBACT;oBAEA,4EAA4E;oBACtEC,oBAAoB7C,OAAO0B,IAAI,CAAC,SAACH;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsByB,IAAI,QAAOP;;oBAC9E,IAAII,mBAAmB;;yBACrBxC,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAOwC;;oBACT;oBAEA,qDAAqD;oBAC/CC,8BAA8B9C,OAAO0B,IAAI,CAAC,SAACH;4BAAMA,qBAAAA;+BAAAA,CAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsByB,IAAI,GAAGI,WAAW,QAAOX,WAAWW,WAAW;;oBAC5H,IAAIN,6BAA6B;;yBAC/BzC,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAOyC;;oBACT;oBAEA,gDAAgD;oBAC1CC,eAAe/C,OAAO0B,IAAI,CAAC,SAACH;4BAAMA,qBAAAA;+BAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,qCAAAA,sBAAAA,cAAeE,KAAK,cAApBF,0CAAAA,oBAAsB6B,WAAW,GAAGC,QAAQ,CAACZ,WAAWW,WAAW;;oBAC3G,IAAIL,cAAc;;yBAChB1C,iBAAAA,OAAO4C,KAAK,cAAZ5C,qCAAAA,oBAAAA,QAAe;wBACf;;4BAAO0C;;oBACT;qBAEA1C,eAAAA,OAAO4B,IAAI,cAAX5B,mCAAAA,kBAAAA,QAAc,iCAAiC;wBAC7CiD,WAAWb;wBACXc,iBAAiBvD,OAAOmD,GAAG,CAAC,SAAC5B;gCAAMA;mCAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeE,KAAK;;wBACvD+B,cAAcxD,OAAOmD,GAAG,CAAC,SAAC5B;gCAAMA;mCAAAA,cAAAA,yBAAAA,gBAAAA,EAAGC,UAAU,cAAbD,oCAAAA,cAAeI,OAAO;;oBACxD;oBACA;;wBAAO;;;;IACT;;AAOO,SAAe7B;wCACpBE,MAAwB,EACxB,KAcC;YAbCkB,eACAhB,YACAsC,iCACAV,mCACA2B,YACApD,QAiFaqD,OACAA,QAnEXC,oBAEIC,OAEiBA,mBASnBC,eACA9B,QAEF+B,gBAEIC,MACAC,IACAC,QAECC,cAaHC,cACD,2BAAA,mBAAA,gBAAA,WAAA,OAAMC,KAGJ,4BAAA,oBAAA,iBAAA,YAAA,QAAMC,MAUPC,QACAC,WACFC,UAEEC,2BASAC,YACAC,cAGAC,QACAC,QACAC,UACAC,QAGEC,QACAC,OACAC,WACAC,SACAC,WAED,4BAAA,oBAAA,wBAAA,YAAA;;;;oBAlGLlE,gBADF,MACEA,eACAhB,aAFF,MAEEA,YACAsC,WAHF,MAGEA,kCAHF,MAIEV,gBAAAA,oDAAiB,kDAJnB,MAKE2B,YAAAA;wBAAc;2CACdpD,SANF,MAMEA;oBAUF,IAAI,CAACL,QAAQ,MAAM,IAAIqF,MAAM;oBAC7B,IAAI,CAACnE,eAAe,MAAM,IAAImE,MAAM;oBACpC,IAAI,CAACnF,cAAc,CAACsC,UAAU,MAAM,IAAI6C,MAAM;oBAE9C,2DAA2D;oBACvD1B,qBAAqBzD;yBACrBsC,UAAAA;;;;oBACY;;wBAAMzC,eAAeC,QAAQkB,eAAesB,UAAUnC;;;oBAA9DuD,QAAQ;oBACd,IAAIA,OAAO;;wBACTD,qBAAqBC,EAAAA,oBAAAA,MAAMpC,UAAU,cAAhBoC,wCAAAA,kBAAkBnC,KAAK,KAAIe;oBAClD,OAAO;wBACL,kEAAkE;wBAClEmB,qBAAqBnB;oBACvB;;;oBAGF,IAAI,CAACmB,oBAAoB,MAAM,IAAI0B,MAAM;oBAEnCxB;wBAAiB;wBAAM;wBAAY;wBAAY;wBAAM;wBAAQ;wBAAM;wBAAO;wBAAQ;wBAAW;wBAAU;wBAAW;;oBAClH9B,SAASX,MAAMC,OAAO,CAACS,mBAAmBA,eAAewD,MAAM,GAAGxD,iBAAiB+B;oBAErFC,iBAAkC;;;;;;;;;oBAEvB;;wBAAM9D,OAAOgB,YAAY,CAACiD,MAAM,CAAChD,GAAG,CAAC;4BAAEC,eAAAA;4BAAe+D,OAAO,AAAC,GAAqB,OAAnBtB,oBAAmB;4BAAO4B,gBAAgB;wBAAO;;;oBAAxHxB,OAAO;oBACPC,KAAKD,KAAK5C,IAAI;oBACd8C,SAAU,AAACD,CAAAA,CAAAA,eAAAA,yBAAAA,GAAIC,MAAM,OAAK,CAAE,CAAC,EAAE;oBACrCH,iBAAiBG,OAAOqB,MAAM,GAAGrB,SAAS;;;;;;oBACnCC;;;;;;;;;oBAEL;;wBAAMlE,OAAOgB,YAAY,CAACkB,WAAW,CAAC;4BAAEhB,eAAAA;4BAAeiB,aAAa;gCAAEC,QAAQ;oCAAG;wCAAEC,UAAU;4CAAEb,YAAY;gDAAEC,OAAOkC;4CAAmB;wCAAE;oCAAE;;4BAAG;wBAAE;;;oBAAhJ;;;;;;;;;;;;oBAEF;;wBAAM3D,OAAOgB,YAAY,CAACiD,MAAM,CAACuB,MAAM,CAAC;4BAAEtE,eAAAA;4BAAe+D,OAAO,AAAC,GAAqB,OAAnBtB,oBAAmB;4BAAM8B,kBAAkB;4BAAOC,kBAAkB;4BAAevD,aAAa;gCAAE8B,MAAM;oCAAGlC;;4BAAQ;wBAAE;;;oBAAxL;oBACA;;wBAAO;4BAAEA,QAAAA;4BAAQuC,QAAQ,IAAIqB;wBAAc;;;yBAGzC,CAAC7B,gBAAD;;;;oBACF;;wBAAM9D,OAAOgB,YAAY,CAACiD,MAAM,CAACuB,MAAM,CAAC;4BAAEtE,eAAAA;4BAAe+D,OAAO,AAAC,GAAqB,OAAnBtB,oBAAmB;4BAAM8B,kBAAkB;4BAAOC,kBAAkB;4BAAevD,aAAa;gCAAE8B,MAAM;oCAAGlC;;4BAAQ;wBAAE;;;oBAAxL;oBACA;;wBAAO;4BAAEA,QAAAA;4BAAQuC,QAAQ,IAAIqB;wBAAc;;;oBAGvCxB,eAAeL,eAAe8B,KAAK;oBACpC,kCAAA,2BAAA;;wBAAL,IAAK,YAAa7D,6BAAb,6BAAA,QAAA,yBAAA;4BAAMqC,MAAN;4BAAqB,IAAI,CAACD,aAAad,QAAQ,CAACe,MAAMD,aAAa0B,IAAI,CAACzB;;;wBAAxE;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBAEL,IAAIhD,MAAMC,OAAO,CAACoC,aAAa;wBACxB,mCAAA,4BAAA;;4BAAL,IAAK,aAAcA,iCAAd,8BAAA,SAAA,0BAAA,kCAA0B;gCAApBY,OAAN;gCACH,IAAI,OAAOA,SAAS,YAAYA,KAAKiB,MAAM,KAAK,GAAG,MAAM,IAAID,MAAM;gCACnE,IAAI,CAAClB,aAAad,QAAQ,CAACgB,OAAOF,aAAa0B,IAAI,CAACxB;4BACtD;;4BAHK;4BAAA;;;qCAAA,8BAAA;oCAAA;;;oCAAA;0CAAA;;;;oBAIP;yBAEIF,CAAAA,aAAamB,MAAM,KAAKxB,eAAewB,MAAM,AAAD,GAA5CnB;;;;oBACF;;wBAAMnE,OAAOgB,YAAY,CAACiD,MAAM,CAAC6B,MAAM,CAAC;4BAAE5E,eAAAA;4BAAe+D,OAAO,AAAC,GAAqB,OAAnBtB,oBAAmB;4BAAO8B,kBAAkB;4BAAOtD,aAAa;gCAAE8B,MAAM;oCAAGE;;4BAAc;wBAAE;;;oBAA9J;;;oBAGIG,SAAS,IAAIqB;oBACbpB,YAAY;oBACdC,WAAW;oBAETC,4BAA4B,mCAACsB,IAAcC;wBAC/C,IAAI,CAAC5E,MAAMC,OAAO,CAAC0E,OAAOA,GAAGT,MAAM,KAAK,GAAG,OAAO,EAAE;wBACpD,OAAOS,GAAG5C,GAAG,CAAC,SAACkB;4BACb,IAAI,OAAOA,SAAS,YAAYA,KAAKiB,MAAM,KAAK,GAAG,OAAO,CAAC;4BAC3D,IAAMW,MAAMD,IAAIE,OAAO,CAAC7B;4BACxB,OAAO8B,OAAOC,SAAS,CAACH,QAAQA,OAAO,IAAIA,MAAM,CAAC;wBACpD;oBACF;oBAEMvB,aAAaD,0BAA0BhB,YAAYU;oBACnDQ,eAAeD,WAAW2B,MAAM,CAAC,SAACC;+BAAMA,KAAK;;oBACnD,IAAI3B,aAAaW,MAAM,KAAK,GAAG;;wBAAO;4BAAEvD,QAAQoC;4BAAcG,QAAQ,IAAIqB;4BAAeY,eAAe7B;wBAAW;;oBAE7GE,SAASlB,CAAAA,QAAAA,MAAK8C,GAAG,OAAR9C,OAAS,qBAAGiB;oBACrBE,SAASnB,CAAAA,SAAAA,MAAK+C,GAAG,OAAR/C,QAAS,qBAAGiB;oBACrBG,WAAW4B,IAAAA,wBAAK,EAAC9B,SAAS;oBAC1BG,SAAS2B,IAAAA,wBAAK,EAAC7B,SAAS;;;yBAEvB;;;;oBACCG,SAASR,WAAWD,YAAY;oBAChCU,QAAQ,AAAC,GAAwBH,OAAtBnB,oBAAmB,KAAca,OAAXM,UAAuBC,OAAZP,UAAS,KAAYQ,OAATD,QAAgB,OAAPC;oBACrD;;wBAAMhF,OAAOgB,YAAY,CAACiD,MAAM,CAAChD,GAAG,CAAC;4BAAEC,eAAAA;4BAAe+D,OAAAA;4BAAOM,gBAAgB;wBAAO;;;oBAAhGL,YAAY;oBACZC,UAAUD,UAAU/D,IAAI;oBACxBiE,YAAaD,CAAAA,oBAAAA,8BAAAA,QAASlB,MAAM;oBAClC,IAAI,CAACmB,aAAaA,UAAUE,MAAM,KAAK,GAAG;;;;oBACrC,mCAAA,4BAAA;;;4BAAA,IAAMqB,IAAN;4BACH,IAAMC,MAAMxF,MAAMC,OAAO,CAACsF,KAAKA,IAAI,EAAE;4BAErC,kEAAkE;4BAClE,IAAME,QAAQ1C,aAAahB,GAAG,CAAC,SAAC2D;uCAAMjF,OAAOiF,cAAAA,eAAAA,IAAK,IAAI1D,WAAW;;4BACjE,IAAM2D,gBAAgBF,MAAMX,OAAO,CAAC;4BACpC,IAAIc,cAAcH,MAAMX,OAAO,CAAC;4BAChC,IAAIc,gBAAgB,CAAC,GAAGA,cAAcH,MAAMX,OAAO,CAAC;4BAEpD,IAAIe,eAAAA,KAAAA;4BAEJ,IAAIF,iBAAiB,KAAKC,eAAe,GAAG;oCAIOJ,qBACPA;gCAJ1C,gEAAgE;gCAChE,IAAMM,iBAAiBH,gBAAgBnC;gCACvC,IAAMuC,WAAWH,cAAcpC;gCAC/B,IAAMwC,cAAcF,kBAAkB,IAAIrF,QAAO+E,sBAAAA,GAAG,CAACM,eAAe,cAAnBN,iCAAAA,sBAAuB,IAAI5D,IAAI,KAAK;gCACrF,IAAMqE,aAAaF,YAAY,IAAItF,QAAO+E,gBAAAA,GAAG,CAACO,SAAS,cAAbP,2BAAAA,gBAAiB,IAAI5D,IAAI,KAAK;gCACxEiE,eAAe;oCAACG;oCAAaC;iCAAW,CAACC,IAAI,CAAC;4BAChD,OAAO;gCACL,8CAA8C;gCAC9C,IAAMC,QAAQ7C,WAAWvB,GAAG,CAAC,SAACmD;wCAA2BM;2CAApBN,IAAI,IAAI,KAAKzE,QAAO+E,QAAAA,GAAG,CAACN,IAAI1B,OAAO,cAAfgC,mBAAAA,QAAmB,IAAI5D,IAAI;;gCACpFiE,eAAeM,MAAMD,IAAI,CAAC;4BAC5B;4BAEA,IAAIL,aAAaO,OAAO,CAAC,QAAQ,QAAQ,IAAIlD,OAAOmD,GAAG,CAACR;wBAC1D;wBAzBA,IAAK,aAAW7B,gCAAX,8BAAA,SAAA,0BAAA;;wBAAA;wBAAA;;;iCAAA,8BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBA0BLZ,YAAYY,UAAUE,MAAM;;;;;;oBAE9B;;wBAAO;4BAAEvD,QAAQoC;4BAAcG,QAAAA;4BAAQiC,eAAe7B;wBAAW;;;;IACnE"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/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\n/**\n * Reads data rows (row 2 to the grid's last row) of one column span in chunks and calls onRow with each row's cells and 1-indexed row number.\n * The scan is bounded by the sheet's row count, advances by the requested chunk (Sheets omits trailing empty rows, so a short chunk says nothing about the next one),\n * and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.\n */\nexport async function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void> {\n const chunkSize = 1000;\n let startRow = 2; // Start from row 2 (after header)\n\n // Bound the scan by the grid so a read error is never mistaken for end of data\n const meta = await sheets.spreadsheets.get({ spreadsheetId, fields: 'sheets.properties(title,gridProperties.rowCount)' });\n const rowCount = meta.data?.sheets?.find((s) => s.properties?.title === sheetTitle)?.properties?.gridProperties?.rowCount;\n if (typeof rowCount !== 'number') {\n throw new Error(`Could not read the row count of sheet \"${sheetTitle}\"`);\n }\n\n while (startRow <= rowCount) {\n const endRow = Math.min(startRow + chunkSize - 1, rowCount);\n const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n let rows: string[][];\n try {\n const response = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n rows = (response.data?.values || []) as string[][];\n } catch (error) {\n // The build target's Error constructor has no options argument, so set cause directly\n const wrapped = new Error(`Failed to read key columns from ${range}: ${error instanceof Error ? error.message : String(error)}`) as Error & { cause?: unknown };\n wrapped.cause = error;\n throw wrapped;\n }\n\n for (let i = 0; i < rows.length; i++) onRow(Array.isArray(rows[i]) ? rows[i] : [], startRow + i);\n\n startRow = endRow + 1;\n }\n}\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\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 await scanKeyColumnRows(sheets, spreadsheetId, resolvedSheetTitle, startCol, endCol, (row) => {\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 return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","scanKeyColumnRows","sheets","spreadsheetId","sheetTitle","startCol","endCol","onRow","meta","chunkSize","startRow","rowCount","endRow","range","rows","response","error","wrapped","i","spreadsheets","get","fields","data","find","s","properties","title","gridProperties","Error","Math","min","values","majorDimension","message","String","cause","length","Array","isArray","id","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","some","sheetId","sheetGUID","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","resolvedSheetTitle","sheet","defaultHeader","existingHeader","resp","vr","_err","mergedHeader","col","name","keySet","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","keyColumnsIdx","max","a1Col","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
|
package/dist/esm/constants.d.ts
CHANGED
|
@@ -5,3 +5,5 @@
|
|
|
5
5
|
* rather than externally configured since this server knows its own requirements.
|
|
6
6
|
*/
|
|
7
7
|
export declare const GOOGLE_SCOPE = "openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive";
|
|
8
|
+
export declare const PASTE_TYPES: readonly ["PASTE_NORMAL", "PASTE_VALUES", "PASTE_FORMAT", "PASTE_NO_BORDERS", "PASTE_FORMULA", "PASTE_DATA_VALIDATION", "PASTE_CONDITIONAL_FORMATTING"];
|
|
9
|
+
export declare const PASTE_ORIENTATIONS: readonly ["NORMAL", "TRANSPOSE"];
|
package/dist/esm/constants.js
CHANGED
|
@@ -5,3 +5,17 @@
|
|
|
5
5
|
* rather than externally configured since this server knows its own requirements.
|
|
6
6
|
*/ // Google OAuth scopes required for Sheets and Drive operations
|
|
7
7
|
export const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';
|
|
8
|
+
// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)
|
|
9
|
+
export const PASTE_TYPES = [
|
|
10
|
+
'PASTE_NORMAL',
|
|
11
|
+
'PASTE_VALUES',
|
|
12
|
+
'PASTE_FORMAT',
|
|
13
|
+
'PASTE_NO_BORDERS',
|
|
14
|
+
'PASTE_FORMULA',
|
|
15
|
+
'PASTE_DATA_VALIDATION',
|
|
16
|
+
'PASTE_CONDITIONAL_FORMATTING'
|
|
17
|
+
];
|
|
18
|
+
export const PASTE_ORIENTATIONS = [
|
|
19
|
+
'NORMAL',
|
|
20
|
+
'TRANSPOSE'
|
|
21
|
+
];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n"],"names":["GOOGLE_SCOPE"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n\n// Native paste-special modes of the Sheets API CopyPasteRequest (PasteType / PasteOrientation)\nexport const PASTE_TYPES = ['PASTE_NORMAL', 'PASTE_VALUES', 'PASTE_FORMAT', 'PASTE_NO_BORDERS', 'PASTE_FORMULA', 'PASTE_DATA_VALIDATION', 'PASTE_CONDITIONAL_FORMATTING'] as const;\nexport const PASTE_ORIENTATIONS = ['NORMAL', 'TRANSPOSE'] as const;\n"],"names":["GOOGLE_SCOPE","PASTE_TYPES","PASTE_ORIENTATIONS"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;AAC/D,OAAO,MAAMA,eAAe,4LAA4L;AAExN,+FAA+F;AAC/F,OAAO,MAAMC,cAAc;IAAC;IAAgB;IAAgB;IAAgB;IAAoB;IAAiB;IAAyB;CAA+B,CAAU;AACnL,OAAO,MAAMC,qBAAqB;IAAC;IAAU;CAAY,CAAU"}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import type { sheets_v4 } from '@googleapis/sheets';
|
|
2
|
+
import type { EnrichedExtra } from '@mcp-z/oauth-google';
|
|
3
|
+
import type { CallToolResult } from '@mcp-z/server';
|
|
4
|
+
import { z } from 'zod';
|
|
5
|
+
declare const inputSchema: z.ZodObject<{
|
|
6
|
+
id: z.ZodString;
|
|
7
|
+
sourceGid: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
|
|
8
|
+
sourceRange: z.ZodString;
|
|
9
|
+
destinationGid: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
|
|
10
|
+
destinationRange: z.ZodString;
|
|
11
|
+
pasteType: z.ZodDefault<z.ZodEnum<{
|
|
12
|
+
PASTE_NORMAL: "PASTE_NORMAL";
|
|
13
|
+
PASTE_VALUES: "PASTE_VALUES";
|
|
14
|
+
PASTE_FORMAT: "PASTE_FORMAT";
|
|
15
|
+
PASTE_NO_BORDERS: "PASTE_NO_BORDERS";
|
|
16
|
+
PASTE_FORMULA: "PASTE_FORMULA";
|
|
17
|
+
PASTE_DATA_VALIDATION: "PASTE_DATA_VALIDATION";
|
|
18
|
+
PASTE_CONDITIONAL_FORMATTING: "PASTE_CONDITIONAL_FORMATTING";
|
|
19
|
+
}>>;
|
|
20
|
+
pasteOrientation: z.ZodDefault<z.ZodEnum<{
|
|
21
|
+
NORMAL: "NORMAL";
|
|
22
|
+
TRANSPOSE: "TRANSPOSE";
|
|
23
|
+
}>>;
|
|
24
|
+
}, z.core.$strip>;
|
|
25
|
+
declare const successBranchSchema: z.ZodObject<{
|
|
26
|
+
type: z.ZodLiteral<"success">;
|
|
27
|
+
id: z.ZodString;
|
|
28
|
+
spreadsheetTitle: z.ZodString;
|
|
29
|
+
spreadsheetUrl: z.ZodString;
|
|
30
|
+
sourceGid: z.ZodString;
|
|
31
|
+
sourceSheetTitle: z.ZodString;
|
|
32
|
+
sourceRange: z.ZodString;
|
|
33
|
+
destinationGid: z.ZodString;
|
|
34
|
+
destinationSheetTitle: z.ZodString;
|
|
35
|
+
destinationRange: z.ZodString;
|
|
36
|
+
pastedRange: z.ZodString;
|
|
37
|
+
pasteType: z.ZodEnum<{
|
|
38
|
+
PASTE_NORMAL: "PASTE_NORMAL";
|
|
39
|
+
PASTE_VALUES: "PASTE_VALUES";
|
|
40
|
+
PASTE_FORMAT: "PASTE_FORMAT";
|
|
41
|
+
PASTE_NO_BORDERS: "PASTE_NO_BORDERS";
|
|
42
|
+
PASTE_FORMULA: "PASTE_FORMULA";
|
|
43
|
+
PASTE_DATA_VALIDATION: "PASTE_DATA_VALIDATION";
|
|
44
|
+
PASTE_CONDITIONAL_FORMATTING: "PASTE_CONDITIONAL_FORMATTING";
|
|
45
|
+
}>;
|
|
46
|
+
pasteOrientation: z.ZodEnum<{
|
|
47
|
+
NORMAL: "NORMAL";
|
|
48
|
+
TRANSPOSE: "TRANSPOSE";
|
|
49
|
+
}>;
|
|
50
|
+
sheetUrl: z.ZodString;
|
|
51
|
+
}, z.core.$strip>;
|
|
52
|
+
declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
53
|
+
type: z.ZodLiteral<"success">;
|
|
54
|
+
id: z.ZodString;
|
|
55
|
+
spreadsheetTitle: z.ZodString;
|
|
56
|
+
spreadsheetUrl: z.ZodString;
|
|
57
|
+
sourceGid: z.ZodString;
|
|
58
|
+
sourceSheetTitle: z.ZodString;
|
|
59
|
+
sourceRange: z.ZodString;
|
|
60
|
+
destinationGid: z.ZodString;
|
|
61
|
+
destinationSheetTitle: z.ZodString;
|
|
62
|
+
destinationRange: z.ZodString;
|
|
63
|
+
pastedRange: z.ZodString;
|
|
64
|
+
pasteType: z.ZodEnum<{
|
|
65
|
+
PASTE_NORMAL: "PASTE_NORMAL";
|
|
66
|
+
PASTE_VALUES: "PASTE_VALUES";
|
|
67
|
+
PASTE_FORMAT: "PASTE_FORMAT";
|
|
68
|
+
PASTE_NO_BORDERS: "PASTE_NO_BORDERS";
|
|
69
|
+
PASTE_FORMULA: "PASTE_FORMULA";
|
|
70
|
+
PASTE_DATA_VALIDATION: "PASTE_DATA_VALIDATION";
|
|
71
|
+
PASTE_CONDITIONAL_FORMATTING: "PASTE_CONDITIONAL_FORMATTING";
|
|
72
|
+
}>;
|
|
73
|
+
pasteOrientation: z.ZodEnum<{
|
|
74
|
+
NORMAL: "NORMAL";
|
|
75
|
+
TRANSPOSE: "TRANSPOSE";
|
|
76
|
+
}>;
|
|
77
|
+
sheetUrl: z.ZodString;
|
|
78
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
79
|
+
type: z.ZodLiteral<"auth_required">;
|
|
80
|
+
provider: z.ZodString;
|
|
81
|
+
message: z.ZodString;
|
|
82
|
+
url: z.ZodOptional<z.ZodString>;
|
|
83
|
+
}, z.core.$strip>], "type">;
|
|
84
|
+
export type Input = z.infer<typeof inputSchema>;
|
|
85
|
+
export type Output = z.infer<typeof outputSchema>;
|
|
86
|
+
type SuccessOutput = z.infer<typeof successBranchSchema>;
|
|
87
|
+
/** The slice of the Sheets client this tool uses; tests pass a plain fake. */
|
|
88
|
+
export interface CellsCopySheets {
|
|
89
|
+
spreadsheets: {
|
|
90
|
+
get(params: {
|
|
91
|
+
spreadsheetId: string;
|
|
92
|
+
fields: string;
|
|
93
|
+
}): Promise<{
|
|
94
|
+
data: sheets_v4.Schema$Spreadsheet;
|
|
95
|
+
}>;
|
|
96
|
+
batchUpdate(params: {
|
|
97
|
+
spreadsheetId: string;
|
|
98
|
+
requestBody: sheets_v4.Schema$BatchUpdateSpreadsheetRequest;
|
|
99
|
+
}): Promise<unknown>;
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
export declare function copyCells(sheets: CellsCopySheets, { id, sourceGid, sourceRange, destinationGid, destinationRange, pasteType, pasteOrientation }: Input): Promise<SuccessOutput>;
|
|
103
|
+
declare function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult>;
|
|
104
|
+
export default function createTool(): {
|
|
105
|
+
name: string;
|
|
106
|
+
config: {
|
|
107
|
+
readonly description: "Copy a cell range to another range in the same spreadsheet (same or different tab), like Google Sheets copy and paste-special. Default PASTE_NORMAL copies values, formulas (relative references adjust), formats and merges; pasteType selects one native paste-special mode. Cannot copy between spreadsheets: use sheet-copy-to first. To duplicate a whole tab or workbook use sheet-copy, sheet-copy-to or spreadsheet-copy. Use a1-notation prompt for range syntax.";
|
|
108
|
+
readonly inputSchema: z.ZodObject<{
|
|
109
|
+
id: z.ZodString;
|
|
110
|
+
sourceGid: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
|
|
111
|
+
sourceRange: z.ZodString;
|
|
112
|
+
destinationGid: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<string, string | number>>;
|
|
113
|
+
destinationRange: z.ZodString;
|
|
114
|
+
pasteType: z.ZodDefault<z.ZodEnum<{
|
|
115
|
+
PASTE_NORMAL: "PASTE_NORMAL";
|
|
116
|
+
PASTE_VALUES: "PASTE_VALUES";
|
|
117
|
+
PASTE_FORMAT: "PASTE_FORMAT";
|
|
118
|
+
PASTE_NO_BORDERS: "PASTE_NO_BORDERS";
|
|
119
|
+
PASTE_FORMULA: "PASTE_FORMULA";
|
|
120
|
+
PASTE_DATA_VALIDATION: "PASTE_DATA_VALIDATION";
|
|
121
|
+
PASTE_CONDITIONAL_FORMATTING: "PASTE_CONDITIONAL_FORMATTING";
|
|
122
|
+
}>>;
|
|
123
|
+
pasteOrientation: z.ZodDefault<z.ZodEnum<{
|
|
124
|
+
NORMAL: "NORMAL";
|
|
125
|
+
TRANSPOSE: "TRANSPOSE";
|
|
126
|
+
}>>;
|
|
127
|
+
}, z.core.$strip>;
|
|
128
|
+
readonly outputSchema: z.ZodObject<{
|
|
129
|
+
result: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
130
|
+
type: z.ZodLiteral<"success">;
|
|
131
|
+
id: z.ZodString;
|
|
132
|
+
spreadsheetTitle: z.ZodString;
|
|
133
|
+
spreadsheetUrl: z.ZodString;
|
|
134
|
+
sourceGid: z.ZodString;
|
|
135
|
+
sourceSheetTitle: z.ZodString;
|
|
136
|
+
sourceRange: z.ZodString;
|
|
137
|
+
destinationGid: z.ZodString;
|
|
138
|
+
destinationSheetTitle: z.ZodString;
|
|
139
|
+
destinationRange: z.ZodString;
|
|
140
|
+
pastedRange: z.ZodString;
|
|
141
|
+
pasteType: z.ZodEnum<{
|
|
142
|
+
PASTE_NORMAL: "PASTE_NORMAL";
|
|
143
|
+
PASTE_VALUES: "PASTE_VALUES";
|
|
144
|
+
PASTE_FORMAT: "PASTE_FORMAT";
|
|
145
|
+
PASTE_NO_BORDERS: "PASTE_NO_BORDERS";
|
|
146
|
+
PASTE_FORMULA: "PASTE_FORMULA";
|
|
147
|
+
PASTE_DATA_VALIDATION: "PASTE_DATA_VALIDATION";
|
|
148
|
+
PASTE_CONDITIONAL_FORMATTING: "PASTE_CONDITIONAL_FORMATTING";
|
|
149
|
+
}>;
|
|
150
|
+
pasteOrientation: z.ZodEnum<{
|
|
151
|
+
NORMAL: "NORMAL";
|
|
152
|
+
TRANSPOSE: "TRANSPOSE";
|
|
153
|
+
}>;
|
|
154
|
+
sheetUrl: z.ZodString;
|
|
155
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
156
|
+
type: z.ZodLiteral<"auth_required">;
|
|
157
|
+
provider: z.ZodString;
|
|
158
|
+
message: z.ZodString;
|
|
159
|
+
url: z.ZodOptional<z.ZodString>;
|
|
160
|
+
}, z.core.$strip>], "type">;
|
|
161
|
+
}, z.core.$strip>;
|
|
162
|
+
};
|
|
163
|
+
handler: typeof handler;
|
|
164
|
+
};
|
|
165
|
+
export {};
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
import { sheets as sheetsApi } from '@googleapis/sheets';
|
|
2
|
+
import { schemas } from '@mcp-z/oauth-google';
|
|
3
|
+
const { AuthRequiredBranchSchema } = schemas;
|
|
4
|
+
import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
|
|
5
|
+
import { z } from 'zod';
|
|
6
|
+
import { PASTE_ORIENTATIONS, PASTE_TYPES } from '../../constants.js';
|
|
7
|
+
import { googleAuth } from '../../lib/google-auth.js';
|
|
8
|
+
import { A1NotationSchema, SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema, StrictSheetGidSchema } from '../../schemas/index.js';
|
|
9
|
+
import { calculatePasteRange, cellBlockToA1, parseA1Notation, parseFiniteCellBlock, rangeReferenceToGridRange, validateA1Notation } from '../../spreadsheet/range-operations.js';
|
|
10
|
+
const inputSchema = z.object({
|
|
11
|
+
id: SpreadsheetIdSchema,
|
|
12
|
+
sourceGid: StrictSheetGidSchema.describe('Source sheet ID (from URL gid={gid})'),
|
|
13
|
+
sourceRange: A1NotationSchema.describe('Finite sheet-local A1 range to copy (e.g., "A1:C10"; no sheet prefix, no whole rows/columns)'),
|
|
14
|
+
destinationGid: StrictSheetGidSchema.describe('Destination sheet ID in the same spreadsheet; may equal sourceGid'),
|
|
15
|
+
destinationRange: A1NotationSchema.describe('Top-left cell (e.g., "E1") or a finite range whose height and width are whole multiples of the (oriented) source; a larger range repeats the source to fill it'),
|
|
16
|
+
pasteType: z.enum(PASTE_TYPES).default('PASTE_NORMAL').describe('What to paste. PASTE_NORMAL (default) = values, formulas, formats and merges; PASTE_VALUES = values only, no formats/formulas/merges; PASTE_FORMAT = format only, excluding data validation; PASTE_NO_BORDERS = like PASTE_NORMAL without borders; PASTE_FORMULA = formulas only; PASTE_DATA_VALIDATION = data validation only; PASTE_CONDITIONAL_FORMATTING = conditional formatting rules only'),
|
|
17
|
+
pasteOrientation: z.enum(PASTE_ORIENTATIONS).default('NORMAL').describe('NORMAL, or TRANSPOSE (rows become columns and vice versa)')
|
|
18
|
+
});
|
|
19
|
+
const successBranchSchema = z.object({
|
|
20
|
+
type: z.literal('success'),
|
|
21
|
+
id: SpreadsheetIdOutput,
|
|
22
|
+
spreadsheetTitle: z.string().describe('Title of the spreadsheet'),
|
|
23
|
+
spreadsheetUrl: z.string().describe('URL of the spreadsheet'),
|
|
24
|
+
sourceGid: SheetGidOutput,
|
|
25
|
+
sourceSheetTitle: z.string().describe('Title of the source sheet'),
|
|
26
|
+
sourceRange: z.string().describe('A1 range that was copied'),
|
|
27
|
+
destinationGid: SheetGidOutput,
|
|
28
|
+
destinationSheetTitle: z.string().describe('Title of the destination sheet'),
|
|
29
|
+
destinationRange: z.string().describe('Destination range as requested'),
|
|
30
|
+
pastedRange: z.string().describe('A1 range of cells written in the destination sheet'),
|
|
31
|
+
pasteType: z.enum(PASTE_TYPES).describe('Paste type applied'),
|
|
32
|
+
pasteOrientation: z.enum(PASTE_ORIENTATIONS).describe('Orientation applied'),
|
|
33
|
+
sheetUrl: z.string().describe('URL of the destination sheet')
|
|
34
|
+
});
|
|
35
|
+
const outputSchema = z.discriminatedUnion('type', [
|
|
36
|
+
successBranchSchema,
|
|
37
|
+
AuthRequiredBranchSchema
|
|
38
|
+
]);
|
|
39
|
+
const config = {
|
|
40
|
+
description: 'Copy a cell range to another range in the same spreadsheet (same or different tab), like Google Sheets copy and paste-special. Default PASTE_NORMAL copies values, formulas (relative references adjust), formats and merges; pasteType selects one native paste-special mode. Cannot copy between spreadsheets: use sheet-copy-to first. To duplicate a whole tab or workbook use sheet-copy, sheet-copy-to or spreadsheet-copy. Use a1-notation prompt for range syntax.',
|
|
41
|
+
inputSchema,
|
|
42
|
+
outputSchema: z.object({
|
|
43
|
+
result: outputSchema
|
|
44
|
+
})
|
|
45
|
+
};
|
|
46
|
+
function invalid(message) {
|
|
47
|
+
return new ProtocolError(ProtocolErrorCode.InvalidParams, message);
|
|
48
|
+
}
|
|
49
|
+
/** Validates a finite sheet-local A1 range, converting any failure to InvalidParams. */ function checkRange(label, notation) {
|
|
50
|
+
try {
|
|
51
|
+
validateA1Notation(notation);
|
|
52
|
+
return parseFiniteCellBlock(notation);
|
|
53
|
+
} catch (error) {
|
|
54
|
+
throw invalid(`Invalid ${label}: ${error instanceof Error ? error.message : String(error)}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
export async function copyCells(sheets, { id, sourceGid, sourceRange, destinationGid, destinationRange, pasteType, pasteOrientation }) {
|
|
58
|
+
var _destinationSheet_sheetId, _ref, _spreadsheetData_spreadsheetUrl, _sourceSheet_title, _destinationSheet_title;
|
|
59
|
+
var _spreadsheetData_properties;
|
|
60
|
+
// All range checks happen before any network call
|
|
61
|
+
const source = checkRange('sourceRange', sourceRange);
|
|
62
|
+
checkRange('destinationRange', destinationRange);
|
|
63
|
+
let pasted;
|
|
64
|
+
try {
|
|
65
|
+
pasted = calculatePasteRange(sourceRange, destinationRange, pasteOrientation);
|
|
66
|
+
} catch (error) {
|
|
67
|
+
throw invalid(error instanceof Error ? error.message : String(error));
|
|
68
|
+
}
|
|
69
|
+
const spreadsheetResponse = await sheets.spreadsheets.get({
|
|
70
|
+
spreadsheetId: id,
|
|
71
|
+
fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties'
|
|
72
|
+
});
|
|
73
|
+
const spreadsheetData = spreadsheetResponse.data;
|
|
74
|
+
const findSheet = (gid)=>{
|
|
75
|
+
var _spreadsheetData_sheets_find, _spreadsheetData_sheets;
|
|
76
|
+
return (_spreadsheetData_sheets = spreadsheetData.sheets) === null || _spreadsheetData_sheets === void 0 ? void 0 : (_spreadsheetData_sheets_find = _spreadsheetData_sheets.find((s)=>{
|
|
77
|
+
var _s_properties;
|
|
78
|
+
return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
|
|
79
|
+
})) === null || _spreadsheetData_sheets_find === void 0 ? void 0 : _spreadsheetData_sheets_find.properties;
|
|
80
|
+
};
|
|
81
|
+
const sourceSheet = findSheet(sourceGid);
|
|
82
|
+
if (!sourceSheet) throw invalid(`Sheet not found: ${sourceGid}`);
|
|
83
|
+
const destinationSheet = findSheet(destinationGid);
|
|
84
|
+
if (!destinationSheet) throw invalid(`Sheet not found: ${destinationGid}`);
|
|
85
|
+
const gridSize = (sheet)=>{
|
|
86
|
+
var _sheet_title;
|
|
87
|
+
var _sheet_gridProperties, _sheet_gridProperties1;
|
|
88
|
+
const rows = (_sheet_gridProperties = sheet.gridProperties) === null || _sheet_gridProperties === void 0 ? void 0 : _sheet_gridProperties.rowCount;
|
|
89
|
+
const columns = (_sheet_gridProperties1 = sheet.gridProperties) === null || _sheet_gridProperties1 === void 0 ? void 0 : _sheet_gridProperties1.columnCount;
|
|
90
|
+
if (typeof rows !== 'number' || typeof columns !== 'number') throw new Error(`Could not read the grid size of sheet "${(_sheet_title = sheet.title) !== null && _sheet_title !== void 0 ? _sheet_title : sheet.sheetId}"`);
|
|
91
|
+
return {
|
|
92
|
+
rows,
|
|
93
|
+
columns
|
|
94
|
+
};
|
|
95
|
+
};
|
|
96
|
+
const sourceGrid = gridSize(sourceSheet);
|
|
97
|
+
const destinationGrid = gridSize(destinationSheet);
|
|
98
|
+
const fits = (grid, endRow, endColumn)=>endRow <= grid.rows && endColumn <= grid.columns;
|
|
99
|
+
if (!fits(sourceGrid, source.endRow, source.endColumn)) {
|
|
100
|
+
throw invalid(`Source range ${sourceRange} is outside the grid of "${sourceSheet.title}" (${sourceGrid.rows} rows x ${sourceGrid.columns} columns)`);
|
|
101
|
+
}
|
|
102
|
+
if (!fits(destinationGrid, pasted.endRow, pasted.endColumn)) {
|
|
103
|
+
throw invalid(`Pasting ${sourceRange} at ${destinationRange} would write ${cellBlockToA1(pasted)}, outside the grid of "${destinationSheet.title}" (${destinationGrid.rows} rows x ${destinationGrid.columns} columns)`);
|
|
104
|
+
}
|
|
105
|
+
// pasteType is always sent explicitly; there is no fallback path
|
|
106
|
+
await sheets.spreadsheets.batchUpdate({
|
|
107
|
+
spreadsheetId: id,
|
|
108
|
+
requestBody: {
|
|
109
|
+
requests: [
|
|
110
|
+
{
|
|
111
|
+
copyPaste: {
|
|
112
|
+
source: rangeReferenceToGridRange(parseA1Notation(sourceRange), Number(sourceGid)),
|
|
113
|
+
destination: rangeReferenceToGridRange(parseA1Notation(destinationRange), Number(destinationGid)),
|
|
114
|
+
pasteType,
|
|
115
|
+
pasteOrientation
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
});
|
|
121
|
+
const destinationSheetId = (_destinationSheet_sheetId = destinationSheet.sheetId) !== null && _destinationSheet_sheetId !== void 0 ? _destinationSheet_sheetId : Number(destinationGid);
|
|
122
|
+
return {
|
|
123
|
+
type: 'success',
|
|
124
|
+
id,
|
|
125
|
+
spreadsheetTitle: (_ref = (_spreadsheetData_properties = spreadsheetData.properties) === null || _spreadsheetData_properties === void 0 ? void 0 : _spreadsheetData_properties.title) !== null && _ref !== void 0 ? _ref : '',
|
|
126
|
+
spreadsheetUrl: (_spreadsheetData_spreadsheetUrl = spreadsheetData.spreadsheetUrl) !== null && _spreadsheetData_spreadsheetUrl !== void 0 ? _spreadsheetData_spreadsheetUrl : '',
|
|
127
|
+
sourceGid,
|
|
128
|
+
sourceSheetTitle: (_sourceSheet_title = sourceSheet.title) !== null && _sourceSheet_title !== void 0 ? _sourceSheet_title : sourceGid,
|
|
129
|
+
sourceRange,
|
|
130
|
+
destinationGid,
|
|
131
|
+
destinationSheetTitle: (_destinationSheet_title = destinationSheet.title) !== null && _destinationSheet_title !== void 0 ? _destinationSheet_title : destinationGid,
|
|
132
|
+
destinationRange,
|
|
133
|
+
pastedRange: cellBlockToA1(pasted),
|
|
134
|
+
pasteType,
|
|
135
|
+
pasteOrientation,
|
|
136
|
+
sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${destinationSheetId}`
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
async function handler(input, extra) {
|
|
140
|
+
const logger = extra.logger;
|
|
141
|
+
const { id, sourceGid, destinationGid, pasteType, pasteOrientation } = input;
|
|
142
|
+
logger.info('sheets.cells.copy called', {
|
|
143
|
+
id,
|
|
144
|
+
sourceGid,
|
|
145
|
+
destinationGid,
|
|
146
|
+
pasteType,
|
|
147
|
+
pasteOrientation
|
|
148
|
+
});
|
|
149
|
+
try {
|
|
150
|
+
const sheets = sheetsApi({
|
|
151
|
+
version: 'v4',
|
|
152
|
+
auth: googleAuth(extra.authContext.auth)
|
|
153
|
+
});
|
|
154
|
+
const result = await copyCells(sheets, input);
|
|
155
|
+
logger.info('sheets.cells.copy completed successfully', {
|
|
156
|
+
id,
|
|
157
|
+
pastedRange: result.type === 'success' ? result.pastedRange : undefined
|
|
158
|
+
});
|
|
159
|
+
return {
|
|
160
|
+
content: [
|
|
161
|
+
{
|
|
162
|
+
type: 'text',
|
|
163
|
+
text: JSON.stringify(result)
|
|
164
|
+
}
|
|
165
|
+
],
|
|
166
|
+
structuredContent: {
|
|
167
|
+
result
|
|
168
|
+
}
|
|
169
|
+
};
|
|
170
|
+
} catch (error) {
|
|
171
|
+
if (error instanceof ProtocolError) throw error;
|
|
172
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
173
|
+
logger.error('Copy cells failed', {
|
|
174
|
+
id,
|
|
175
|
+
sourceGid,
|
|
176
|
+
destinationGid,
|
|
177
|
+
error: message
|
|
178
|
+
});
|
|
179
|
+
throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying cells: ${message}`, {
|
|
180
|
+
stack: error instanceof Error ? error.stack : undefined
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
export default function createTool() {
|
|
185
|
+
return {
|
|
186
|
+
name: 'cells-copy',
|
|
187
|
+
config,
|
|
188
|
+
handler
|
|
189
|
+
};
|
|
190
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-copy.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\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 { PASTE_ORIENTATIONS, PASTE_TYPES } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema, StrictSheetGidSchema } from '../../schemas/index.ts';\nimport { calculatePasteRange, cellBlockToA1, parseA1Notation, parseFiniteCellBlock, rangeReferenceToGridRange, validateA1Notation } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n sourceGid: StrictSheetGidSchema.describe('Source sheet ID (from URL gid={gid})'),\n sourceRange: A1NotationSchema.describe('Finite sheet-local A1 range to copy (e.g., \"A1:C10\"; no sheet prefix, no whole rows/columns)'),\n destinationGid: StrictSheetGidSchema.describe('Destination sheet ID in the same spreadsheet; may equal sourceGid'),\n destinationRange: A1NotationSchema.describe('Top-left cell (e.g., \"E1\") or a finite range whose height and width are whole multiples of the (oriented) source; a larger range repeats the source to fill it'),\n pasteType: z\n .enum(PASTE_TYPES)\n .default('PASTE_NORMAL')\n .describe(\n 'What to paste. PASTE_NORMAL (default) = values, formulas, formats and merges; PASTE_VALUES = values only, no formats/formulas/merges; PASTE_FORMAT = format only, excluding data validation; PASTE_NO_BORDERS = like PASTE_NORMAL without borders; PASTE_FORMULA = formulas only; PASTE_DATA_VALIDATION = data validation only; PASTE_CONDITIONAL_FORMATTING = conditional formatting rules only'\n ),\n pasteOrientation: z.enum(PASTE_ORIENTATIONS).default('NORMAL').describe('NORMAL, or TRANSPOSE (rows become columns and vice versa)'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n sourceGid: SheetGidOutput,\n sourceSheetTitle: z.string().describe('Title of the source sheet'),\n sourceRange: z.string().describe('A1 range that was copied'),\n destinationGid: SheetGidOutput,\n destinationSheetTitle: z.string().describe('Title of the destination sheet'),\n destinationRange: z.string().describe('Destination range as requested'),\n pastedRange: z.string().describe('A1 range of cells written in the destination sheet'),\n pasteType: z.enum(PASTE_TYPES).describe('Paste type applied'),\n pasteOrientation: z.enum(PASTE_ORIENTATIONS).describe('Orientation applied'),\n sheetUrl: z.string().describe('URL of the destination sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description:\n 'Copy a cell range to another range in the same spreadsheet (same or different tab), like Google Sheets copy and paste-special. Default PASTE_NORMAL copies values, formulas (relative references adjust), formats and merges; pasteType selects one native paste-special mode. Cannot copy between spreadsheets: use sheet-copy-to first. To duplicate a whole tab or workbook use sheet-copy, sheet-copy-to or spreadsheet-copy. Use a1-notation prompt for range syntax.',\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>;\ntype SuccessOutput = z.infer<typeof successBranchSchema>;\n\n/** The slice of the Sheets client this tool uses; tests pass a plain fake. */\nexport interface CellsCopySheets {\n spreadsheets: {\n get(params: { spreadsheetId: string; fields: string }): Promise<{ data: sheets_v4.Schema$Spreadsheet }>;\n batchUpdate(params: { spreadsheetId: string; requestBody: sheets_v4.Schema$BatchUpdateSpreadsheetRequest }): Promise<unknown>;\n };\n}\n\nfunction invalid(message: string): ProtocolError {\n return new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n}\n\n/** Validates a finite sheet-local A1 range, converting any failure to InvalidParams. */\nfunction checkRange(label: string, notation: string) {\n try {\n validateA1Notation(notation);\n return parseFiniteCellBlock(notation);\n } catch (error) {\n throw invalid(`Invalid ${label}: ${error instanceof Error ? error.message : String(error)}`);\n }\n}\n\nexport async function copyCells(sheets: CellsCopySheets, { id, sourceGid, sourceRange, destinationGid, destinationRange, pasteType, pasteOrientation }: Input): Promise<SuccessOutput> {\n // All range checks happen before any network call\n const source = checkRange('sourceRange', sourceRange);\n checkRange('destinationRange', destinationRange);\n let pasted: ReturnType<typeof calculatePasteRange>;\n try {\n pasted = calculatePasteRange(sourceRange, destinationRange, pasteOrientation);\n } catch (error) {\n throw invalid(error instanceof Error ? error.message : String(error));\n }\n\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n });\n const spreadsheetData = spreadsheetResponse.data;\n const findSheet = (gid: string) => spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid)?.properties;\n const sourceSheet = findSheet(sourceGid);\n if (!sourceSheet) throw invalid(`Sheet not found: ${sourceGid}`);\n const destinationSheet = findSheet(destinationGid);\n if (!destinationSheet) throw invalid(`Sheet not found: ${destinationGid}`);\n\n const gridSize = (sheet: sheets_v4.Schema$SheetProperties) => {\n const rows = sheet.gridProperties?.rowCount;\n const columns = sheet.gridProperties?.columnCount;\n if (typeof rows !== 'number' || typeof columns !== 'number') throw new Error(`Could not read the grid size of sheet \"${sheet.title ?? sheet.sheetId}\"`);\n return { rows, columns };\n };\n const sourceGrid = gridSize(sourceSheet);\n const destinationGrid = gridSize(destinationSheet);\n const fits = (grid: { rows: number; columns: number }, endRow: number, endColumn: number) => endRow <= grid.rows && endColumn <= grid.columns;\n if (!fits(sourceGrid, source.endRow, source.endColumn)) {\n throw invalid(`Source range ${sourceRange} is outside the grid of \"${sourceSheet.title}\" (${sourceGrid.rows} rows x ${sourceGrid.columns} columns)`);\n }\n if (!fits(destinationGrid, pasted.endRow, pasted.endColumn)) {\n throw invalid(`Pasting ${sourceRange} at ${destinationRange} would write ${cellBlockToA1(pasted)}, outside the grid of \"${destinationSheet.title}\" (${destinationGrid.rows} rows x ${destinationGrid.columns} columns)`);\n }\n\n // pasteType is always sent explicitly; there is no fallback path\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n copyPaste: {\n source: rangeReferenceToGridRange(parseA1Notation(sourceRange), Number(sourceGid)),\n destination: rangeReferenceToGridRange(parseA1Notation(destinationRange), Number(destinationGid)),\n pasteType,\n pasteOrientation,\n },\n },\n ],\n },\n });\n\n const destinationSheetId = destinationSheet.sheetId ?? Number(destinationGid);\n return {\n type: 'success' as const,\n id,\n spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? '',\n sourceGid,\n sourceSheetTitle: sourceSheet.title ?? sourceGid,\n sourceRange,\n destinationGid,\n destinationSheetTitle: destinationSheet.title ?? destinationGid,\n destinationRange,\n pastedRange: cellBlockToA1(pasted),\n pasteType,\n pasteOrientation,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${destinationSheetId}`,\n };\n}\n\nasync function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n const { id, sourceGid, destinationGid, pasteType, pasteOrientation } = input;\n logger.info('sheets.cells.copy called', { id, sourceGid, destinationGid, pasteType, pasteOrientation });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n const result: Output = await copyCells(sheets as unknown as CellsCopySheets, input);\n logger.info('sheets.cells.copy completed successfully', { id, pastedRange: result.type === 'success' ? result.pastedRange : undefined });\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) throw error;\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Copy cells failed', { id, sourceGid, destinationGid, error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-copy',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","PASTE_ORIENTATIONS","PASTE_TYPES","googleAuth","A1NotationSchema","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetIdSchema","StrictSheetGidSchema","calculatePasteRange","cellBlockToA1","parseA1Notation","parseFiniteCellBlock","rangeReferenceToGridRange","validateA1Notation","inputSchema","object","id","sourceGid","describe","sourceRange","destinationGid","destinationRange","pasteType","enum","default","pasteOrientation","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sourceSheetTitle","destinationSheetTitle","pastedRange","sheetUrl","outputSchema","discriminatedUnion","config","description","result","invalid","message","InvalidParams","checkRange","label","notation","error","Error","String","copyCells","destinationSheet","spreadsheetData","sourceSheet","source","pasted","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","findSheet","gid","find","s","properties","sheetId","gridSize","sheet","rows","gridProperties","rowCount","columns","columnCount","title","sourceGrid","destinationGrid","fits","grid","endRow","endColumn","batchUpdate","requestBody","requests","copyPaste","Number","destination","destinationSheetId","handler","input","extra","logger","info","version","auth","authContext","undefined","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}
|
|
@@ -40,24 +40,62 @@ async function handler({ sourceUri }, extra) {
|
|
|
40
40
|
cast: true,
|
|
41
41
|
relax_column_count: true
|
|
42
42
|
});
|
|
43
|
-
const readStream = await getCsvReadStream(sourceUri);
|
|
44
43
|
const firstRowRead = new Error('First CSV row read');
|
|
45
|
-
const
|
|
44
|
+
const streamErrors = [];
|
|
45
|
+
const onError = (error)=>streamErrors.push(error);
|
|
46
|
+
parser.on('error', onError);
|
|
47
|
+
const parserClosed = new Promise((resolve)=>parser.once('close', resolve));
|
|
48
|
+
let readStream;
|
|
49
|
+
let sourceClosed;
|
|
50
|
+
let completed;
|
|
51
|
+
let failed = false;
|
|
52
|
+
let primaryError;
|
|
46
53
|
let firstRow = [];
|
|
47
54
|
let rowCount = 0;
|
|
48
55
|
try {
|
|
56
|
+
readStream = await getCsvReadStream(sourceUri);
|
|
57
|
+
readStream.on('error', onError);
|
|
58
|
+
sourceClosed = readStream.closed ? Promise.resolve() : new Promise((resolve)=>readStream === null || readStream === void 0 ? void 0 : readStream.once('close', resolve));
|
|
59
|
+
completed = pipeline(readStream, parser).then(()=>undefined, (error)=>error);
|
|
49
60
|
const record = await parser[Symbol.asyncIterator]().next();
|
|
50
61
|
if (!record.done) {
|
|
51
62
|
firstRow = record.value;
|
|
52
63
|
rowCount = 1;
|
|
53
64
|
parser.destroy(firstRowRead);
|
|
54
65
|
}
|
|
66
|
+
const pipelineError = await completed;
|
|
67
|
+
if (pipelineError !== undefined && pipelineError !== firstRowRead) throw pipelineError;
|
|
55
68
|
} catch (error) {
|
|
56
|
-
|
|
57
|
-
|
|
69
|
+
failed = true;
|
|
70
|
+
primaryError = error;
|
|
71
|
+
} finally{
|
|
72
|
+
readStream === null || readStream === void 0 ? void 0 : readStream.destroy();
|
|
73
|
+
parser.destroy();
|
|
74
|
+
const pipelineError = await completed;
|
|
75
|
+
if (pipelineError !== undefined && pipelineError !== firstRowRead) streamErrors.push(pipelineError);
|
|
76
|
+
await Promise.all([
|
|
77
|
+
sourceClosed,
|
|
78
|
+
parserClosed
|
|
79
|
+
]);
|
|
80
|
+
readStream === null || readStream === void 0 ? void 0 : readStream.removeListener('error', onError);
|
|
81
|
+
parser.removeListener('error', onError);
|
|
82
|
+
}
|
|
83
|
+
const failures = [
|
|
84
|
+
...new Set([
|
|
85
|
+
...failed ? [
|
|
86
|
+
primaryError
|
|
87
|
+
] : [],
|
|
88
|
+
...streamErrors.filter((error)=>error !== firstRowRead)
|
|
89
|
+
])
|
|
90
|
+
];
|
|
91
|
+
if (failures.length === 1) throw failures[0];
|
|
92
|
+
if (failures.length > 1) {
|
|
93
|
+
const message = failures.map((error)=>error instanceof Error ? error.message : String(error)).join('; ');
|
|
94
|
+
throw Object.assign(new Error(message), {
|
|
95
|
+
errors: failures,
|
|
96
|
+
primaryError: failures[0]
|
|
97
|
+
});
|
|
58
98
|
}
|
|
59
|
-
const pipelineError = await completed;
|
|
60
|
-
if (pipelineError !== undefined && pipelineError !== firstRowRead) throw pipelineError;
|
|
61
99
|
// Convert first row to strings (column names)
|
|
62
100
|
const columns = firstRow.map((value)=>String(value !== null && value !== void 0 ? value : ''));
|
|
63
101
|
const isEmpty = rowCount === 0;
|