@mcp-z/mcp-sheets 2.0.0 → 2.1.1

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.
Files changed (137) hide show
  1. package/dist/cjs/lib/google-auth.d.cts +9 -0
  2. package/dist/cjs/lib/google-auth.d.ts +9 -0
  3. package/dist/cjs/lib/google-auth.js +16 -0
  4. package/dist/cjs/lib/google-auth.js.map +1 -0
  5. package/dist/cjs/mcp/resources/spreadsheet.js +4 -3
  6. package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
  7. package/dist/cjs/mcp/tools/cells-format.js +4 -3
  8. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  9. package/dist/cjs/mcp/tools/chart-create.js +4 -3
  10. package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
  11. package/dist/cjs/mcp/tools/columns-get.js +4 -3
  12. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  13. package/dist/cjs/mcp/tools/columns-update.js +4 -3
  14. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  15. package/dist/cjs/mcp/tools/dimensions-batch-update.js +4 -3
  16. package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
  17. package/dist/cjs/mcp/tools/dimensions-move.js +4 -3
  18. package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
  19. package/dist/cjs/mcp/tools/rows-append.js +4 -3
  20. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  21. package/dist/cjs/mcp/tools/rows-csv-append.js +4 -3
  22. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  23. package/dist/cjs/mcp/tools/rows-get.js +4 -3
  24. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  25. package/dist/cjs/mcp/tools/sheet-copy-to.js +4 -3
  26. package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
  27. package/dist/cjs/mcp/tools/sheet-copy.js +4 -3
  28. package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
  29. package/dist/cjs/mcp/tools/sheet-create.js +4 -3
  30. package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
  31. package/dist/cjs/mcp/tools/sheet-delete.js +4 -3
  32. package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
  33. package/dist/cjs/mcp/tools/sheet-find.js +4 -3
  34. package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
  35. package/dist/cjs/mcp/tools/sheet-rename.js +4 -3
  36. package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
  37. package/dist/cjs/mcp/tools/spreadsheet-copy.js +7 -5
  38. package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
  39. package/dist/cjs/mcp/tools/spreadsheet-create.js +4 -3
  40. package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
  41. package/dist/cjs/mcp/tools/spreadsheet-find.js +7 -5
  42. package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
  43. package/dist/cjs/mcp/tools/spreadsheet-rename.js +4 -3
  44. package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
  45. package/dist/cjs/mcp/tools/validation-set.js +4 -3
  46. package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
  47. package/dist/cjs/mcp/tools/values-batch-update.js +4 -3
  48. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  49. package/dist/cjs/mcp/tools/values-clear.js +4 -3
  50. package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
  51. package/dist/cjs/mcp/tools/values-csv-update.js +4 -3
  52. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  53. package/dist/cjs/mcp/tools/values-markdown-update.js +4 -3
  54. package/dist/cjs/mcp/tools/values-markdown-update.js.map +1 -1
  55. package/dist/cjs/mcp/tools/values-replace.js +4 -3
  56. package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
  57. package/dist/cjs/mcp/tools/values-search.js +4 -3
  58. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  59. package/dist/cjs/spreadsheet/data-operations.d.cts +1 -1
  60. package/dist/cjs/spreadsheet/data-operations.d.ts +1 -1
  61. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  62. package/dist/cjs/spreadsheet/markdown-runs.d.cts +1 -31
  63. package/dist/cjs/spreadsheet/markdown-runs.d.ts +1 -31
  64. package/dist/cjs/spreadsheet/markdown-runs.js +31 -31
  65. package/dist/cjs/spreadsheet/markdown-runs.js.map +1 -1
  66. package/dist/cjs/spreadsheet/sheet-operations.d.cts +1 -1
  67. package/dist/cjs/spreadsheet/sheet-operations.d.ts +1 -1
  68. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  69. package/dist/cjs/spreadsheet/spreadsheet-management.d.cts +2 -1
  70. package/dist/cjs/spreadsheet/spreadsheet-management.d.ts +2 -1
  71. package/dist/cjs/spreadsheet/spreadsheet-management.js.map +1 -1
  72. package/dist/esm/lib/google-auth.d.ts +9 -0
  73. package/dist/esm/lib/google-auth.js +11 -0
  74. package/dist/esm/lib/google-auth.js.map +1 -0
  75. package/dist/esm/mcp/resources/spreadsheet.js +4 -3
  76. package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
  77. package/dist/esm/mcp/tools/cells-format.js +4 -3
  78. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  79. package/dist/esm/mcp/tools/chart-create.js +4 -3
  80. package/dist/esm/mcp/tools/chart-create.js.map +1 -1
  81. package/dist/esm/mcp/tools/columns-get.js +5 -4
  82. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  83. package/dist/esm/mcp/tools/columns-update.js +4 -3
  84. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  85. package/dist/esm/mcp/tools/dimensions-batch-update.js +4 -3
  86. package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
  87. package/dist/esm/mcp/tools/dimensions-move.js +4 -3
  88. package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
  89. package/dist/esm/mcp/tools/rows-append.js +4 -3
  90. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  91. package/dist/esm/mcp/tools/rows-csv-append.js +5 -4
  92. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  93. package/dist/esm/mcp/tools/rows-get.js +4 -3
  94. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  95. package/dist/esm/mcp/tools/sheet-copy-to.js +4 -3
  96. package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
  97. package/dist/esm/mcp/tools/sheet-copy.js +4 -3
  98. package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
  99. package/dist/esm/mcp/tools/sheet-create.js +4 -3
  100. package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
  101. package/dist/esm/mcp/tools/sheet-delete.js +4 -3
  102. package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
  103. package/dist/esm/mcp/tools/sheet-find.js +4 -3
  104. package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
  105. package/dist/esm/mcp/tools/sheet-rename.js +4 -3
  106. package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
  107. package/dist/esm/mcp/tools/spreadsheet-copy.js +7 -5
  108. package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
  109. package/dist/esm/mcp/tools/spreadsheet-create.js +4 -3
  110. package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
  111. package/dist/esm/mcp/tools/spreadsheet-find.js +7 -5
  112. package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
  113. package/dist/esm/mcp/tools/spreadsheet-rename.js +4 -3
  114. package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
  115. package/dist/esm/mcp/tools/validation-set.js +4 -3
  116. package/dist/esm/mcp/tools/validation-set.js.map +1 -1
  117. package/dist/esm/mcp/tools/values-batch-update.js +4 -3
  118. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  119. package/dist/esm/mcp/tools/values-clear.js +4 -3
  120. package/dist/esm/mcp/tools/values-clear.js.map +1 -1
  121. package/dist/esm/mcp/tools/values-csv-update.js +5 -4
  122. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  123. package/dist/esm/mcp/tools/values-markdown-update.js +4 -3
  124. package/dist/esm/mcp/tools/values-markdown-update.js.map +1 -1
  125. package/dist/esm/mcp/tools/values-replace.js +4 -3
  126. package/dist/esm/mcp/tools/values-replace.js.map +1 -1
  127. package/dist/esm/mcp/tools/values-search.js +4 -3
  128. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  129. package/dist/esm/spreadsheet/data-operations.d.ts +1 -1
  130. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  131. package/dist/esm/spreadsheet/markdown-runs.d.ts +1 -31
  132. package/dist/esm/spreadsheet/markdown-runs.js.map +1 -1
  133. package/dist/esm/spreadsheet/sheet-operations.d.ts +1 -1
  134. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  135. package/dist/esm/spreadsheet/spreadsheet-management.d.ts +2 -1
  136. package/dist/esm/spreadsheet/spreadsheet-management.js.map +1 -1
  137. package/package.json +5 -5
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-clear.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n ranges: z.array(A1NotationSchema).min(1).describe('A1 notation ranges to clear (e.g., [\"A1:B5\", \"D3:D10\"]). Clears values only, preserves formatting.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n sheetTitle: z.string().describe('Title of the sheet'),\n sheetUrl: z.string().describe('URL of the sheet'),\n clearedRanges: z.array(z.string()).describe('A1 notation ranges that were cleared'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Clear cell values from one or more ranges. Clears values only - preserves formatting, validation, and other cell properties. 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>;\n\nasync function handler({ id, gid, ranges }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.clear called', { id, gid, rangeCount: ranges.length });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for clear', { id, gid, rangeCount: ranges.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Prefix ranges with sheet title\n const prefixedRanges = ranges.map((range) => `${sheetTitle}!${range}`);\n\n logger.info('sheets.values.clear executing', { spreadsheetId: id, sheetTitle, prefixedRanges });\n\n // Use batchClear for efficiency (works for single or multiple ranges)\n const clearResponse = await sheets.spreadsheets.values.batchClear({\n spreadsheetId: id,\n requestBody: {\n ranges: prefixedRanges,\n },\n });\n\n const clearedRanges = clearResponse.data.clearedRanges || [];\n\n logger.info('sheets.values.clear completed successfully', {\n spreadsheetId: id,\n sheetTitle,\n clearedRangesCount: clearedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n clearedRanges,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Clear operation failed', { id, gid, rangeCount: ranges.length, error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error clearing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-clear',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","ranges","array","A1NotationSchema","min","describe","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","clearedRanges","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetData","sheet","sheets","spreadsheetResponse","sheetGid","prefixedRanges","clearResponse","error","message","info","rangeCount","length","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","map","range","values","batchClear","requestBody","clearedRangesCount","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":";;;;+BAmHA;;;eAAwBA;;;2BAlHA;sBAKyB;0BAC1B;mBACL;uBACyF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAN3G,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAQR,IAAME,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,IAAIC,4BAAmB;IACvBC,KAAKC,uBAAc;IACnBC,QAAQN,MAAC,CAACO,KAAK,CAACC,yBAAgB,EAAEC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AACpD;AAEA,IAAMC,sBAAsBX,MAAC,CAACC,MAAM,CAAC;IACnCW,MAAMZ,MAAC,CAACa,OAAO,CAAC;IAChBX,IAAIY,4BAAmB;IACvBV,KAAKW,uBAAc;IACnBC,kBAAkBhB,MAAC,CAACiB,MAAM,GAAGP,QAAQ,CAAC;IACtCQ,gBAAgBlB,MAAC,CAACiB,MAAM,GAAGP,QAAQ,CAAC;IACpCS,YAAYnB,MAAC,CAACiB,MAAM,GAAGP,QAAQ,CAAC;IAChCU,UAAUpB,MAAC,CAACiB,MAAM,GAAGP,QAAQ,CAAC;IAC9BW,eAAerB,MAAC,CAACO,KAAK,CAACP,MAAC,CAACiB,MAAM,IAAIP,QAAQ,CAAC;AAC9C;AAEA,IAAMY,eAAetB,MAAC,CAACuB,kBAAkB,CAAC,QAAQ;IAACZ;IAAqBd;CAAyB;AAEjG,IAAM2B,SAAS;IACbC,aAAa;IACb1B,aAAAA;IACAuB,cAActB,MAAC,CAACC,MAAM,CAAC;QACrByB,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAA0B,EAAEC,KAAoB;YAA9C1B,IAAIE,KAAKE,QAC1BuB,cAcmBC,iCASJC,yBACFA,2BAXQD,6BAIXA,yBAbRE,QAGAC,qBAKAH,iBACAd,kBACAE,gBAGAa,OAMAZ,YACAe,UACAd,UAGAe,gBAKAC,eAOAf,eAQAK,QAeCW,OACDC;;;;oBAjEepC,KAAF,MAAEA,IAAIE,MAAN,MAAMA,KAAKE,SAAX,MAAWA;oBAC1BuB,SAASD,MAAMC,MAAM;oBAC3BA,OAAOU,IAAI,CAAC,8BAA8B;wBAAErC,IAAAA;wBAAIE,KAAAA;wBAAKoC,YAAYlC,OAAOmC,MAAM;oBAAC;;;;;;;;;oBAGvET,SAASU,kBAAM,CAACV,MAAM,CAAC;wBAAEW,SAAS;wBAAMC,MAAMhB,MAAMiB,WAAW,CAACD,IAAI;oBAAC;oBAG/C;;wBAAMZ,OAAOc,YAAY,CAACC,GAAG,CAAC;4BACxDC,eAAe9C;4BACf+C,QAAQ;wBACV;;;oBAHMhB,sBAAsB;oBAKtBH,kBAAkBG,oBAAoBiB,IAAI;oBAC1ClC,4BAAmBc,8BAAAA,gBAAgBqB,UAAU,cAA1BrB,kDAAAA,4BAA4BsB,KAAK,uCAAI;oBACxDlC,kBAAiBY,kCAAAA,gBAAgBZ,cAAc,cAA9BY,6CAAAA,kCAAkC;oBAEzD,oBAAoB;oBACdC,SAAQD,0BAAAA,gBAAgBE,MAAM,cAAtBF,8CAAAA,wBAAwBuB,IAAI,CAAC,SAACC;4BAAaA;+BAAPC,QAAOD,gBAAAA,EAAEH,UAAU,cAAZG,oCAAAA,cAAcE,OAAO,MAAMpD;;oBACpF,IAAI,EAAC2B,kBAAAA,4BAAAA,MAAOoB,UAAU,GAAE;wBACtBtB,OAAOU,IAAI,CAAC,6BAA6B;4BAAErC,IAAAA;4BAAIE,KAAAA;4BAAKoC,YAAYlC,OAAOmC,MAAM;wBAAC;wBAC9E,MAAM,IAAIgB,qBAAa,CAACC,yBAAiB,CAACC,aAAa,EAAE,AAAC,oBAAuB,OAAJvD;oBAC/E;oBAEMe,cAAaY,0BAAAA,MAAMoB,UAAU,CAACC,KAAK,cAAtBrB,qCAAAA,0BAA0B3B;oBACvC8B,YAAWH,4BAAAA,MAAMoB,UAAU,CAACK,OAAO,cAAxBzB,uCAAAA,4BAA4B;oBACvCX,WAAW,AAAC,0CAAwDc,OAAfhC,IAAG,cAAqB,OAATgC;oBAE1E,iCAAiC;oBAC3BC,iBAAiB7B,OAAOsD,GAAG,CAAC,SAACC;+BAAU,AAAC,GAAgBA,OAAd1C,YAAW,KAAS,OAAN0C;;oBAE9DhC,OAAOU,IAAI,CAAC,iCAAiC;wBAAES,eAAe9C;wBAAIiB,YAAAA;wBAAYgB,gBAAAA;oBAAe;oBAGvE;;wBAAMH,OAAOc,YAAY,CAACgB,MAAM,CAACC,UAAU,CAAC;4BAChEf,eAAe9C;4BACf8D,aAAa;gCACX1D,QAAQ6B;4BACV;wBACF;;;oBALMC,gBAAgB;oBAOhBf,gBAAgBe,cAAcc,IAAI,CAAC7B,aAAa;oBAEtDQ,OAAOU,IAAI,CAAC,8CAA8C;wBACxDS,eAAe9C;wBACfiB,YAAAA;wBACA8C,oBAAoB5C,cAAcoB,MAAM;oBAC1C;oBAEMf,SAAiB;wBACrBd,MAAM;wBACNV,IAAAA;wBACAE,KAAKmD,OAAOrB;wBACZlB,kBAAkBA,oBAAoB;wBACtCE,gBAAgBA,kBAAkB;wBAClCC,YAAAA;wBACAC,UAAAA;wBACAC,eAAAA;oBACF;oBAEA;;wBAAO;4BACL6C,OAAO;gCAAG;oCAAEtD,MAAM;oCAAiBuD,MAAMC,KAAKC,SAAS,CAAC3C;gCAAQ;;4BAChE4C,mBAAmB;gCAAE5C,QAAAA;4BAAO;wBAC9B;;;oBACOW;oBACDC,UAAUD,AAAK,YAALA,OAAiBkC,SAAQlC,MAAMC,OAAO,GAAGiB,OAAOlB;oBAChER,OAAOQ,KAAK,CAAC,0BAA0B;wBAAEnC,IAAAA;wBAAIE,KAAAA;wBAAKoC,YAAYlC,OAAOmC,MAAM;wBAAEJ,OAAOC;oBAAQ;oBAE5F,MAAM,IAAImB,qBAAa,CAACC,yBAAiB,CAACc,aAAa,EAAE,AAAC,0BAAiC,OAARlC,UAAW;wBAC5FmC,OAAOpC,AAAK,YAALA,OAAiBkC,SAAQlC,MAAMoC,KAAK,GAAGC;oBAChD;;;;;;;IAEJ;;AAEe,SAAS9E;IACtB,OAAO;QACL+E,MAAM;QACNnD,QAAAA;QACAG,SAAAA;IACF;AACF"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-clear.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n ranges: z.array(A1NotationSchema).min(1).describe('A1 notation ranges to clear (e.g., [\"A1:B5\", \"D3:D10\"]). Clears values only, preserves formatting.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n sheetTitle: z.string().describe('Title of the sheet'),\n sheetUrl: z.string().describe('URL of the sheet'),\n clearedRanges: z.array(z.string()).describe('A1 notation ranges that were cleared'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Clear cell values from one or more ranges. Clears values only - preserves formatting, validation, and other cell properties. 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>;\n\nasync function handler({ id, gid, ranges }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.clear called', { id, gid, rangeCount: ranges.length });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for clear', { id, gid, rangeCount: ranges.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Prefix ranges with sheet title\n const prefixedRanges = ranges.map((range) => `${sheetTitle}!${range}`);\n\n logger.info('sheets.values.clear executing', { spreadsheetId: id, sheetTitle, prefixedRanges });\n\n // Use batchClear for efficiency (works for single or multiple ranges)\n const clearResponse = await sheets.spreadsheets.values.batchClear({\n spreadsheetId: id,\n requestBody: {\n ranges: prefixedRanges,\n },\n });\n\n const clearedRanges = clearResponse.data.clearedRanges || [];\n\n logger.info('sheets.values.clear completed successfully', {\n spreadsheetId: id,\n sheetTitle,\n clearedRangesCount: clearedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n clearedRanges,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Clear operation failed', { id, gid, rangeCount: ranges.length, error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error clearing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-clear',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","ranges","array","A1NotationSchema","min","describe","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","clearedRanges","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetData","sheet","sheets","spreadsheetResponse","sheetGid","prefixedRanges","clearResponse","error","message","info","rangeCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","map","range","values","batchClear","requestBody","clearedRangesCount","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
@@ -8,11 +8,12 @@ Object.defineProperty(exports, "default", {
8
8
  return createTool;
9
9
  }
10
10
  });
11
+ var _sheets = require("@googleapis/sheets");
11
12
  var _oauthgoogle = require("@mcp-z/oauth-google");
12
13
  var _server = require("@mcp-z/server");
13
14
  var _csvparse = require("csv-parse");
14
- var _googleapis = require("googleapis");
15
15
  var _zod = require("zod");
16
+ var _googleauthts = require("../../lib/google-auth.js");
16
17
  var _indexts = require("../../schemas/index.js");
17
18
  var _csvstreamingts = require("../../spreadsheet/csv-streaming.js");
18
19
  function _async_iterator(iterable) {
@@ -248,9 +249,9 @@ function handler(_0, _1) {
248
249
  ,
249
250
  18
250
251
  ]);
251
- sheets = _googleapis.google.sheets({
252
+ sheets = (0, _sheets.sheets)({
252
253
  version: 'v4',
253
- auth: extra.authContext.auth
254
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
254
255
  });
255
256
  return [
256
257
  4,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no deduplication) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Spreadsheet title'),\n spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n sheetTitle: z.string().describe('Sheet title'),\n sheetUrl: z.string().describe('Sheet URL'),\n updatedRange: z.string().describe('A1 notation range that was updated'),\n updatedRows: z.number().describe('Number of rows updated'),\n updatedColumns: z.number().describe('Number of columns updated'),\n updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n\n // Find the sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? '';\n\n // Streaming CSV processing state\n let sourceHeaders: string[] = [];\n const allRows: (string | number | boolean | null)[][] = [];\n let totalCols = 0;\n\n // Get readable stream from CSV URI (no temp files!)\n const readStream = await getCsvReadStream(sourceUri);\n\n // Create CSV parser with native streaming\n const parser = readStream.pipe(\n parse({\n columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n skip_empty_lines: true,\n trim: true,\n cast: true, // Auto-convert numbers/booleans\n relax_column_count: true,\n })\n );\n\n // Stream and collect all rows (with batching for very large files)\n for await (const record of parser) {\n if (sourceHasHeaders) {\n // Extract source headers from first record\n if (sourceHeaders.length === 0) {\n sourceHeaders = Object.keys(record as Record<string, unknown>);\n totalCols = sourceHeaders.length;\n logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n }\n\n // Convert record to row array (exclude source headers from data range)\n // CSV values are strings/numbers/booleans/nulls from the parser\n const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n allRows.push(row);\n } else {\n // sourceHasHeaders=false: record is an array, include all rows (including first row)\n const row = record as (string | number | boolean | null)[];\n allRows.push(row);\n\n if (totalCols === 0) {\n totalCols = row.length;\n }\n }\n }\n\n if (allRows.length === 0) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'CSV file is empty');\n }\n\n // Prepare data for update (all rows)\n const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n // For large datasets, use batchUpdate to write in chunks\n // This respects the 40K cell limit per request\n const batchRequests = [];\n const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n let currentRowNum = Number.parseInt(currentRow, 10);\n\n for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n batchRequests.push({\n range: batchRange,\n values: batchData,\n });\n\n currentRowNum += batchData.length;\n }\n\n logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n // Execute batch update\n const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n valueInputOption,\n data: batchRequests,\n },\n });\n\n const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheet.properties.sheetId ?? ''),\n spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n sheetTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n updatedRange: firstUpdatedRange,\n updatedRows: totalUpdatedRows,\n updatedColumns: totalUpdatedColumns,\n updatedCells: totalUpdatedCells,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.values.csv-update error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-csv-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no deduplication) */\n\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Spreadsheet title'),\n spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n sheetTitle: z.string().describe('Sheet title'),\n sheetUrl: z.string().describe('Sheet URL'),\n updatedRange: z.string().describe('A1 notation range that was updated'),\n updatedRows: z.number().describe('Number of rows updated'),\n updatedColumns: z.number().describe('Number of columns updated'),\n updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n\n // Find the sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? '';\n\n // Streaming CSV processing state\n let sourceHeaders: string[] = [];\n const allRows: (string | number | boolean | null)[][] = [];\n let totalCols = 0;\n\n // Get readable stream from CSV URI (no temp files!)\n const readStream = await getCsvReadStream(sourceUri);\n\n // Create CSV parser with native streaming\n const parser = readStream.pipe(\n parse({\n columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n skip_empty_lines: true,\n trim: true,\n cast: true, // Auto-convert numbers/booleans\n relax_column_count: true,\n })\n );\n\n // Stream and collect all rows (with batching for very large files)\n for await (const record of parser) {\n if (sourceHasHeaders) {\n // Extract source headers from first record\n if (sourceHeaders.length === 0) {\n sourceHeaders = Object.keys(record as Record<string, unknown>);\n totalCols = sourceHeaders.length;\n logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n }\n\n // Convert record to row array (exclude source headers from data range)\n // CSV values are strings/numbers/booleans/nulls from the parser\n const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n allRows.push(row);\n } else {\n // sourceHasHeaders=false: record is an array, include all rows (including first row)\n const row = record as (string | number | boolean | null)[];\n allRows.push(row);\n\n if (totalCols === 0) {\n totalCols = row.length;\n }\n }\n }\n\n if (allRows.length === 0) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'CSV file is empty');\n }\n\n // Prepare data for update (all rows)\n const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n // For large datasets, use batchUpdate to write in chunks\n // This respects the 40K cell limit per request\n const batchRequests = [];\n const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n let currentRowNum = Number.parseInt(currentRow, 10);\n\n for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n batchRequests.push({\n range: batchRange,\n values: batchData,\n });\n\n currentRowNum += batchData.length;\n }\n\n logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n // Execute batch update\n const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n valueInputOption,\n data: batchRequests,\n },\n });\n\n const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheet.properties.sheetId ?? ''),\n spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n sheetTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n updatedRange: firstUpdatedRange,\n updatedRows: totalUpdatedRows,\n updatedColumns: totalUpdatedColumns,\n updatedCells: totalUpdatedCells,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.values.csv-update error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-csv-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
8
8
  return createTool;
9
9
  }
10
10
  });
11
+ var _sheets = require("@googleapis/sheets");
11
12
  var _oauthgoogle = require("@mcp-z/oauth-google");
12
13
  var _server = require("@mcp-z/server");
13
- var _googleapis = require("googleapis");
14
14
  var _zod = require("zod");
15
+ var _googleauthts = require("../../lib/google-auth.js");
15
16
  var _indexts = require("../../schemas/index.js");
16
17
  var _markdownrunsts = require("../../spreadsheet/markdown-runs.js");
17
18
  var _rangeoperationsts = require("../../spreadsheet/range-operations.js");
@@ -206,9 +207,9 @@ function handler(_0, _1) {
206
207
  ,
207
208
  5
208
209
  ]);
209
- sheets = _googleapis.google.sheets({
210
+ sheets = (0, _sheets.sheets)({
210
211
  version: 'v4',
211
- auth: extra.authContext.auth
212
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
212
213
  });
213
214
  return [
214
215
  4,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n cells: z\n .array(\n z.object({\n cell: z.string().describe('A1 reference of the cell that was written'),\n text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n })\n )\n .describe('Cells successfully written'),\n failedCells: z\n .array(\n z.object({\n cell: z.string().describe('A1 reference that failed'),\n error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n })\n )\n .optional()\n .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description:\n 'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.markdownUpdate called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for markdown update', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build one updateCells request per cell\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n const failedCells: Array<{ cell: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation and reject anything that isn't a single cell\n const rangeRef = parseA1Notation(request.cell);\n if (rangeRef.type !== 'cell') {\n throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n }\n\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n const parsed = parseInlineMarkdown(request.text);\n const runs = buildTextFormatRuns(parsed);\n\n batchRequests.push({\n updateCells: {\n range: gridRange,\n rows: [\n {\n values: [\n {\n userEnteredValue: { stringValue: parsed.text },\n textFormatRuns: runs,\n },\n ],\n },\n ],\n fields: 'userEnteredValue,textFormatRuns',\n },\n });\n cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse cell for markdown update', {\n cell: request.cell,\n error: message,\n });\n failedCells.push({\n cell: request.cell,\n error: `Failed to parse cell: ${message}`,\n });\n }\n }\n\n // Early return if all cells failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n cells: [],\n failedCells: failedCells.length > 0 ? failedCells : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.values.markdownUpdate executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.values.markdownUpdate completed successfully', {\n successCount: cells.length,\n failedCount: failedCells.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: cells.length,\n cells,\n failedCells: failedCells.length > 0 ? failedCells : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n // Re-throw ProtocolError as-is\n if (error instanceof ProtocolError) {\n throw error;\n }\n\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Markdown update operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-markdown-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","MarkdownCellRequestSchema","z","object","cell","string","min","describe","text","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","max","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","parsed","runs","message","info","requestCount","length","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","Error","rangeReferenceToGridRange","parseInlineMarkdown","buildTextFormatRuns","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n cells: z\n .array(\n z.object({\n cell: z.string().describe('A1 reference of the cell that was written'),\n text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n })\n )\n .describe('Cells successfully written'),\n failedCells: z\n .array(\n z.object({\n cell: z.string().describe('A1 reference that failed'),\n error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n })\n )\n .optional()\n .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description:\n 'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.markdownUpdate called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for markdown update', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build one updateCells request per cell\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n const failedCells: Array<{ cell: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation and reject anything that isn't a single cell\n const rangeRef = parseA1Notation(request.cell);\n if (rangeRef.type !== 'cell') {\n throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n }\n\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n const parsed = parseInlineMarkdown(request.text);\n const runs = buildTextFormatRuns(parsed);\n\n batchRequests.push({\n updateCells: {\n range: gridRange,\n rows: [\n {\n values: [\n {\n userEnteredValue: { stringValue: parsed.text },\n textFormatRuns: runs,\n },\n ],\n },\n ],\n fields: 'userEnteredValue,textFormatRuns',\n },\n });\n cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse cell for markdown update', {\n cell: request.cell,\n error: message,\n });\n failedCells.push({\n cell: request.cell,\n error: `Failed to parse cell: ${message}`,\n });\n }\n }\n\n // Early return if all cells failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n cells: [],\n failedCells: failedCells.length > 0 ? failedCells : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.values.markdownUpdate executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.values.markdownUpdate completed successfully', {\n successCount: cells.length,\n failedCount: failedCells.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: cells.length,\n cells,\n failedCells: failedCells.length > 0 ? failedCells : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n // Re-throw ProtocolError as-is\n if (error instanceof ProtocolError) {\n throw error;\n }\n\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Markdown update operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-markdown-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","MarkdownCellRequestSchema","z","object","cell","string","min","describe","text","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","max","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","parsed","runs","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","Error","rangeReferenceToGridRange","parseInlineMarkdown","buildTextFormatRuns","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}
@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
8
8
  return createTool;
9
9
  }
10
10
  });
11
+ var _sheets = require("@googleapis/sheets");
11
12
  var _oauthgoogle = require("@mcp-z/oauth-google");
12
13
  var _server = require("@mcp-z/server");
13
- var _googleapis = require("googleapis");
14
14
  var _zod = require("zod");
15
+ var _googleauthts = require("../../lib/google-auth.js");
15
16
  var _indexts = require("../../schemas/index.js");
16
17
  var _rangeoperationsts = require("../../spreadsheet/range-operations.js");
17
18
  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -233,9 +234,9 @@ function handler(_0, _1) {
233
234
  ,
234
235
  7
235
236
  ]);
236
- sheets = _googleapis.google.sheets({
237
+ sheets = (0, _sheets.sheets)({
237
238
  version: 'v4',
238
- auth: extra.authContext.auth
239
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
239
240
  });
240
241
  // Build FindReplaceRequest - only include defined options
241
242
  findReplaceRequest = _object_spread({
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n find: z.string().min(1).describe('Text or regex pattern to find'),\n replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n // Scope - defaults to all sheets if neither specified\n gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n // Match options\n matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n includeFormulas: z.boolean().optional().describe('Search within formula text'),\n })\n .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Build FindReplaceRequest - only include defined options\n const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n find,\n replacement,\n ...(matchCase !== undefined && { matchCase }),\n ...(matchEntireCell !== undefined && { matchEntireCell }),\n ...(searchByRegex !== undefined && { searchByRegex }),\n ...(includeFormulas !== undefined && { includeFormulas }),\n };\n\n // Set scope based on gid/range\n if (!gid) {\n // No gid = search all sheets\n findReplaceRequest.allSheets = true;\n } else {\n // Need to resolve sheet to get numeric sheetId\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n const sheetId = sheet.properties?.sheetId;\n if (sheetId === undefined || sheetId === null) {\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n }\n\n if (!range) {\n // gid but no range = search specific sheet\n findReplaceRequest.sheetId = sheetId;\n } else {\n // gid + range = search specific range\n const rangeRef = parseA1Notation(range);\n findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n }\n }\n\n // Execute batchUpdate\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [{ findReplace: findReplaceRequest }],\n },\n });\n\n const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n logger.info('sheets.values-replace completed', {\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n spreadsheetUrl,\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Replace operation failed', {\n id,\n find,\n replacement,\n gid,\n range,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-replace',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n find: z.string().min(1).describe('Text or regex pattern to find'),\n replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n // Scope - defaults to all sheets if neither specified\n gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n // Match options\n matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n includeFormulas: z.boolean().optional().describe('Search within formula text'),\n })\n .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Build FindReplaceRequest - only include defined options\n const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n find,\n replacement,\n ...(matchCase !== undefined && { matchCase }),\n ...(matchEntireCell !== undefined && { matchEntireCell }),\n ...(searchByRegex !== undefined && { searchByRegex }),\n ...(includeFormulas !== undefined && { includeFormulas }),\n };\n\n // Set scope based on gid/range\n if (!gid) {\n // No gid = search all sheets\n findReplaceRequest.allSheets = true;\n } else {\n // Need to resolve sheet to get numeric sheetId\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n const sheetId = sheet.properties?.sheetId;\n if (sheetId === undefined || sheetId === null) {\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n }\n\n if (!range) {\n // gid but no range = search specific sheet\n findReplaceRequest.sheetId = sheetId;\n } else {\n // gid + range = search specific range\n const rangeRef = parseA1Notation(range);\n findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n }\n }\n\n // Execute batchUpdate\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [{ findReplace: findReplaceRequest }],\n },\n });\n\n const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n logger.info('sheets.values-replace completed', {\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n spreadsheetUrl,\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Replace operation failed', {\n id,\n find,\n replacement,\n gid,\n range,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-replace',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","sheetsApi","version","auth","googleAuth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
8
8
  return createTool;
9
9
  }
10
10
  });
11
+ var _sheets = require("@googleapis/sheets");
11
12
  var _oauthgoogle = require("@mcp-z/oauth-google");
12
13
  var _server = require("@mcp-z/server");
13
- var _googleapis = require("googleapis");
14
14
  var _zod = require("zod");
15
+ var _googleauthts = require("../../lib/google-auth.js");
15
16
  var _indexts = require("../../schemas/index.js");
16
17
  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
17
18
  try {
@@ -246,9 +247,9 @@ function handler(_0, _1) {
246
247
  ,
247
248
  5
248
249
  ]);
249
- sheets = _googleapis.google.sheets({
250
+ sheets = (0, _sheets.sheets)({
250
251
  version: 'v4',
251
- auth: extra.authContext.auth
252
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
252
253
  });
253
254
  return [
254
255
  4,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n let letter = '';\n let num = index + 1;\n while (num > 0) {\n const remainder = (num - 1) % 26;\n letter = String.fromCharCode(65 + remainder) + letter;\n num = Math.floor((num - 1) / 26);\n }\n return letter;\n}\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n values: z.boolean().optional().describe('Include cell values in response'),\n a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n count: z.number().int().nonnegative().describe('Number of matches found'),\n a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n values: z\n .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n .optional()\n .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Search spreadsheet and return matches at cell, row, or column granularity. 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>;\n\nasync function handler({ id, gid, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get sheet details including grid dimensions\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n logger.info('sheets.values-search sheet not found', { id, gid, query });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Use actual sheet dimensions from gridProperties, with sensible defaults\n // Google Sheets default for new sheets is 1000 rows x 26 columns\n const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n const endColumn = columnIndexToLetter(columnCount - 1);\n const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n const res = response.data;\n const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n // Prepare query for matching (case-insensitive by default)\n const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n let count = 0;\n const a1Array: string[] = [];\n const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n // Helper to check if a cell matches the query\n const cellMatches = (cell: string | number | boolean | null): boolean => {\n if (!searchQuery) return true; // If no query, match all\n if (typeof cell !== 'string') return false;\n const cellValue = matchCase ? cell : cell.toLowerCase();\n return cellValue.includes(searchQuery);\n };\n\n if (select === 'cells') {\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n for (let colIdx = 0; colIdx < row.length; colIdx++) {\n const cell = row[colIdx];\n if (cellMatches(cell)) {\n count++;\n if (a1s) {\n const colLetter = columnIndexToLetter(colIdx);\n const rowNum = rowIdx + 1;\n a1Array.push(`${colLetter}${rowNum}`);\n }\n if (values) {\n valuesArray.push(cell ?? null);\n }\n }\n }\n }\n } else if (select === 'rows') {\n const matchingRows: number[] = [];\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n const matches = row.some((cell) => cellMatches(cell));\n if (matches) {\n matchingRows.push(rowIdx);\n }\n }\n\n count = matchingRows.length;\n for (const rowIdx of matchingRows) {\n const row = allRows[rowIdx];\n if (!row) continue; // Skip if row is undefined\n const rowNum = rowIdx + 1;\n\n if (a1s) {\n const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n }\n if (values) {\n valuesArray.push(row);\n }\n }\n } else if (select === 'columns') {\n const headerRow = allRows[0] || [];\n const matchingCols: number[] = [];\n\n for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n const header = headerRow[colIdx];\n if (cellMatches(header)) {\n matchingCols.push(colIdx);\n }\n }\n\n count = matchingCols.length;\n for (const colIdx of matchingCols) {\n const colLetter = columnIndexToLetter(colIdx);\n\n if (a1s) {\n a1Array.push(`${colLetter}:${colLetter}`);\n }\n if (values) {\n const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n valuesArray.push(columnValues);\n }\n }\n }\n\n logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n const result: Output = {\n type: 'success' as const,\n count,\n ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n ...(values && valuesArray.length > 0 && { values: valuesArray }),\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.values-search error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-search',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n let letter = '';\n let num = index + 1;\n while (num > 0) {\n const remainder = (num - 1) % 26;\n letter = String.fromCharCode(65 + remainder) + letter;\n num = Math.floor((num - 1) / 26);\n }\n return letter;\n}\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n values: z.boolean().optional().describe('Include cell values in response'),\n a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n count: z.number().int().nonnegative().describe('Number of matches found'),\n a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n values: z\n .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n .optional()\n .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Search spreadsheet and return matches at cell, row, or column granularity. 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>;\n\nasync function handler({ id, gid, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get sheet details including grid dimensions\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n logger.info('sheets.values-search sheet not found', { id, gid, query });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Use actual sheet dimensions from gridProperties, with sensible defaults\n // Google Sheets default for new sheets is 1000 rows x 26 columns\n const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n const endColumn = columnIndexToLetter(columnCount - 1);\n const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n const res = response.data;\n const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n // Prepare query for matching (case-insensitive by default)\n const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n let count = 0;\n const a1Array: string[] = [];\n const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n // Helper to check if a cell matches the query\n const cellMatches = (cell: string | number | boolean | null): boolean => {\n if (!searchQuery) return true; // If no query, match all\n if (typeof cell !== 'string') return false;\n const cellValue = matchCase ? cell : cell.toLowerCase();\n return cellValue.includes(searchQuery);\n };\n\n if (select === 'cells') {\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n for (let colIdx = 0; colIdx < row.length; colIdx++) {\n const cell = row[colIdx];\n if (cellMatches(cell)) {\n count++;\n if (a1s) {\n const colLetter = columnIndexToLetter(colIdx);\n const rowNum = rowIdx + 1;\n a1Array.push(`${colLetter}${rowNum}`);\n }\n if (values) {\n valuesArray.push(cell ?? null);\n }\n }\n }\n }\n } else if (select === 'rows') {\n const matchingRows: number[] = [];\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n const matches = row.some((cell) => cellMatches(cell));\n if (matches) {\n matchingRows.push(rowIdx);\n }\n }\n\n count = matchingRows.length;\n for (const rowIdx of matchingRows) {\n const row = allRows[rowIdx];\n if (!row) continue; // Skip if row is undefined\n const rowNum = rowIdx + 1;\n\n if (a1s) {\n const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n }\n if (values) {\n valuesArray.push(row);\n }\n }\n } else if (select === 'columns') {\n const headerRow = allRows[0] || [];\n const matchingCols: number[] = [];\n\n for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n const header = headerRow[colIdx];\n if (cellMatches(header)) {\n matchingCols.push(colIdx);\n }\n }\n\n count = matchingCols.length;\n for (const colIdx of matchingCols) {\n const colLetter = columnIndexToLetter(colIdx);\n\n if (a1s) {\n a1Array.push(`${colLetter}:${colLetter}`);\n }\n if (values) {\n const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n valuesArray.push(columnValues);\n }\n }\n }\n\n logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n const result: Output = {\n type: 'success' as const,\n count,\n ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n ...(values && valuesArray.length > 0 && { values: valuesArray }),\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.values-search error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-search',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { sheets_v4 } from 'googleapis';
1
+ import type { sheets_v4 } from '@googleapis/sheets';
2
2
  import type { Logger } from '../types.js';
3
3
  export type Cell = string | number | boolean | null | undefined;
4
4
  export type Row = Cell[];
@@ -1,4 +1,4 @@
1
- import type { sheets_v4 } from 'googleapis';
1
+ import type { sheets_v4 } from '@googleapis/sheets';
2
2
  import type { Logger } from '../types.js';
3
3
  export type Cell = string | number | boolean | null | undefined;
4
4
  export type Row = Cell[];