@mcp-z/mcp-sheets 1.0.0 → 1.0.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 (150) hide show
  1. package/README.md +32 -3
  2. package/bin/server.js +1 -1
  3. package/dist/cjs/constants.js.map +1 -1
  4. package/dist/cjs/index.js +13 -13
  5. package/dist/cjs/index.js.map +1 -1
  6. package/dist/cjs/lib/create-store.js.map +1 -1
  7. package/dist/cjs/mcp/index.js +6 -6
  8. package/dist/cjs/mcp/index.js.map +1 -1
  9. package/dist/cjs/mcp/prompts/a1-notation.js.map +1 -1
  10. package/dist/cjs/mcp/prompts/index.js +2 -2
  11. package/dist/cjs/mcp/prompts/index.js.map +1 -1
  12. package/dist/cjs/mcp/resources/index.js +2 -2
  13. package/dist/cjs/mcp/resources/index.js.map +1 -1
  14. package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
  15. package/dist/cjs/mcp/tools/cells-format.js +8 -8
  16. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  17. package/dist/cjs/mcp/tools/chart-create.js +8 -8
  18. package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
  19. package/dist/cjs/mcp/tools/columns-get.js +3 -3
  20. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  21. package/dist/cjs/mcp/tools/columns-update.js +10 -10
  22. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  23. package/dist/cjs/mcp/tools/csv-get-columns.js +2 -2
  24. package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
  25. package/dist/cjs/mcp/tools/dimensions-batch-update.js +16 -16
  26. package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
  27. package/dist/cjs/mcp/tools/dimensions-move.js +5 -5
  28. package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
  29. package/dist/cjs/mcp/tools/index.js +52 -52
  30. package/dist/cjs/mcp/tools/index.js.map +1 -1
  31. package/dist/cjs/mcp/tools/lib/dimension-operations.js.map +1 -1
  32. package/dist/cjs/mcp/tools/rows-append.js +10 -10
  33. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  34. package/dist/cjs/mcp/tools/rows-csv-append.js +13 -13
  35. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  36. package/dist/cjs/mcp/tools/rows-get.js +4 -4
  37. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  38. package/dist/cjs/mcp/tools/sheet-copy-to.js +4 -4
  39. package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
  40. package/dist/cjs/mcp/tools/sheet-copy.js +5 -5
  41. package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
  42. package/dist/cjs/mcp/tools/sheet-create.js +4 -4
  43. package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
  44. package/dist/cjs/mcp/tools/sheet-delete.js +4 -4
  45. package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
  46. package/dist/cjs/mcp/tools/sheet-find.js +7 -7
  47. package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
  48. package/dist/cjs/mcp/tools/sheet-rename.js +5 -5
  49. package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
  50. package/dist/cjs/mcp/tools/spreadsheet-copy.js +2 -2
  51. package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
  52. package/dist/cjs/mcp/tools/spreadsheet-create.js +2 -2
  53. package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
  54. package/dist/cjs/mcp/tools/spreadsheet-find.js +6 -6
  55. package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
  56. package/dist/cjs/mcp/tools/spreadsheet-rename.js +3 -3
  57. package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
  58. package/dist/cjs/mcp/tools/validation-set.js +8 -8
  59. package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
  60. package/dist/cjs/mcp/tools/values-batch-update.js +8 -8
  61. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  62. package/dist/cjs/mcp/tools/values-clear.js +6 -6
  63. package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
  64. package/dist/cjs/mcp/tools/values-csv-update.js +8 -8
  65. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  66. package/dist/cjs/mcp/tools/values-replace.js +8 -8
  67. package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
  68. package/dist/cjs/mcp/tools/values-search.js +5 -5
  69. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  70. package/dist/cjs/schemas/index.js.map +1 -1
  71. package/dist/cjs/setup/config.js +11 -1
  72. package/dist/cjs/setup/config.js.map +1 -1
  73. package/dist/cjs/setup/http.js +6 -2
  74. package/dist/cjs/setup/http.js.map +1 -1
  75. package/dist/cjs/setup/index.js +9 -9
  76. package/dist/cjs/setup/index.js.map +1 -1
  77. package/dist/cjs/setup/oauth-google.d.cts +3 -2
  78. package/dist/cjs/setup/oauth-google.d.ts +3 -2
  79. package/dist/cjs/setup/oauth-google.js +15 -12
  80. package/dist/cjs/setup/oauth-google.js.map +1 -1
  81. package/dist/cjs/setup/runtime.js +9 -9
  82. package/dist/cjs/setup/runtime.js.map +1 -1
  83. package/dist/cjs/setup/stdio.js +2 -2
  84. package/dist/cjs/setup/stdio.js.map +1 -1
  85. package/dist/cjs/spreadsheet/column-utilities.js.map +1 -1
  86. package/dist/cjs/spreadsheet/csv-streaming.js.map +1 -1
  87. package/dist/cjs/spreadsheet/data-operations.js +9 -9
  88. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  89. package/dist/cjs/spreadsheet/deduplication-utils.js.map +1 -1
  90. package/dist/cjs/spreadsheet/range-operations.js +2 -2
  91. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  92. package/dist/cjs/spreadsheet/sheet-operations.js +3 -3
  93. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  94. package/dist/cjs/spreadsheet/spreadsheet-management.js.map +1 -1
  95. package/dist/esm/constants.js.map +1 -1
  96. package/dist/esm/index.js.map +1 -1
  97. package/dist/esm/lib/create-store.js.map +1 -1
  98. package/dist/esm/mcp/index.js.map +1 -1
  99. package/dist/esm/mcp/prompts/a1-notation.js.map +1 -1
  100. package/dist/esm/mcp/prompts/index.js.map +1 -1
  101. package/dist/esm/mcp/resources/index.js.map +1 -1
  102. package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
  103. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  104. package/dist/esm/mcp/tools/chart-create.js.map +1 -1
  105. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  106. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  107. package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
  108. package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
  109. package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
  110. package/dist/esm/mcp/tools/index.js.map +1 -1
  111. package/dist/esm/mcp/tools/lib/dimension-operations.js.map +1 -1
  112. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  113. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  114. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  115. package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
  116. package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
  117. package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
  118. package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
  119. package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
  120. package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
  121. package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
  122. package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
  123. package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
  124. package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
  125. package/dist/esm/mcp/tools/validation-set.js.map +1 -1
  126. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  127. package/dist/esm/mcp/tools/values-clear.js.map +1 -1
  128. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  129. package/dist/esm/mcp/tools/values-replace.js.map +1 -1
  130. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  131. package/dist/esm/schemas/index.js.map +1 -1
  132. package/dist/esm/setup/config.js +12 -2
  133. package/dist/esm/setup/config.js.map +1 -1
  134. package/dist/esm/setup/http.js +4 -0
  135. package/dist/esm/setup/http.js.map +1 -1
  136. package/dist/esm/setup/index.js.map +1 -1
  137. package/dist/esm/setup/oauth-google.d.ts +3 -2
  138. package/dist/esm/setup/oauth-google.js +8 -11
  139. package/dist/esm/setup/oauth-google.js.map +1 -1
  140. package/dist/esm/setup/runtime.js.map +1 -1
  141. package/dist/esm/setup/stdio.js.map +1 -1
  142. package/dist/esm/spreadsheet/column-utilities.js.map +1 -1
  143. package/dist/esm/spreadsheet/csv-streaming.js.map +1 -1
  144. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  145. package/dist/esm/spreadsheet/deduplication-utils.js.map +1 -1
  146. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  147. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  148. package/dist/esm/spreadsheet/spreadsheet-management.js.map +1 -1
  149. package/dist/esm/types.js.map +1 -1
  150. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/spreadsheet-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdOutput } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the spreadsheet creation operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1 for single spreadsheet)'),\n itemsChanged: z.number().describe('Successfully created spreadsheets (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the created spreadsheet'),\n title: z.string().describe('Title of the created spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create a new spreadsheet',\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({ title }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.create called', { title });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n const response = await sheets.spreadsheets.create({\n requestBody: {\n properties: {\n title: title,\n },\n },\n });\n const res = response.data;\n const id = res.spreadsheetId ?? '';\n const url = res.spreadsheetUrl ?? '';\n\n logger.info('sheets.spreadsheet.create success', { id, title, url });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Created spreadsheet \"${title}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: url,\n title,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.create error', { error: message });\n\n // Throw McpError for proper MCP error handling\n throw new McpError(ErrorCode.InternalError, `Error creating spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","inputSchema","object","title","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","id","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","res","sheets","version","auth","authContext","response","spreadsheets","create","requestBody","properties","data","spreadsheetId","url","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,OAAOJ,EAAEK,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAMC,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBC,kBAAkBb,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACtCK,gBAAgBd,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IACpCO,cAAchB,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IAClCQ,aAAajB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACjCS,IAAIjB;IACJkB,gBAAgBnB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACpCL,OAAOJ,EAAEM,MAAM,GAAGG,QAAQ,CAAC;AAC7B;AAEA,2CAA2C;AAC3C,MAAMW,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACX;IAAqBd;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbrB;IACAkB,cAAcpB,EAAEG,MAAM,CAAC;QACrBqB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAErB,KAAK,EAAS,EAAEsB,KAAoB;IAC3D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,oCAAoC;QAAExB;IAAM;IAExD,IAAI;YAUSyB,oBACCA;QAVZ,MAAMC,SAAS/B,OAAO+B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAC3E,MAAME,WAAW,MAAMJ,OAAOK,YAAY,CAACC,MAAM,CAAC;YAChDC,aAAa;gBACXC,YAAY;oBACVlC,OAAOA;gBACT;YACF;QACF;QACA,MAAMyB,MAAMK,SAASK,IAAI;QACzB,MAAMrB,MAAKW,qBAAAA,IAAIW,aAAa,cAAjBX,gCAAAA,qBAAqB;QAChC,MAAMY,OAAMZ,sBAAAA,IAAIV,cAAc,cAAlBU,iCAAAA,sBAAsB;QAElCF,OAAOC,IAAI,CAAC,qCAAqC;YAAEV;YAAId;YAAOqC;QAAI;QAElE,MAAMjB,SAAiB;YACrBb,MAAM;YACNE,kBAAkB,CAAC,qBAAqB,EAAET,MAAM,CAAC,CAAC;YAClDU,gBAAgB;YAChBE,cAAc;YACdC,aAAa,IAAIyB,OAAOC,WAAW;YACnCzB;YACAC,gBAAgBsB;YAChBrC;QACF;QAEA,OAAO;YACLwC,SAAS;gBACP;oBACEjC,MAAM;oBACNkC,MAAMC,KAAKC,SAAS,CAACvB;gBACvB;aACD;YACDwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEtB,OAAOsB,KAAK,CAAC,mCAAmC;YAAEA,OAAOC;QAAQ;QAEjE,+CAA+C;QAC/C,MAAM,IAAIpD,SAASD,UAAUwD,aAAa,EAAE,CAAC,4BAA4B,EAAEH,SAAS,EAAE;YACpFI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNnC;QACAG;IACF;AACF"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdOutput } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the spreadsheet creation operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1 for single spreadsheet)'),\n itemsChanged: z.number().describe('Successfully created spreadsheets (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the created spreadsheet'),\n title: z.string().describe('Title of the created spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create a new spreadsheet',\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({ title }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.create called', { title });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n const response = await sheets.spreadsheets.create({\n requestBody: {\n properties: {\n title: title,\n },\n },\n });\n const res = response.data;\n const id = res.spreadsheetId ?? '';\n const url = res.spreadsheetUrl ?? '';\n\n logger.info('sheets.spreadsheet.create success', { id, title, url });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Created spreadsheet \"${title}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: url,\n title,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.create error', { error: message });\n\n // Throw McpError for proper MCP error handling\n throw new McpError(ErrorCode.InternalError, `Error creating spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","inputSchema","object","title","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","id","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","res","sheets","version","auth","authContext","response","spreadsheets","create","requestBody","properties","data","spreadsheetId","url","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,OAAOJ,EAAEK,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAMC,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBC,kBAAkBb,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACtCK,gBAAgBd,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IACpCO,cAAchB,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IAClCQ,aAAajB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACjCS,IAAIjB;IACJkB,gBAAgBnB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACpCL,OAAOJ,EAAEM,MAAM,GAAGG,QAAQ,CAAC;AAC7B;AAEA,2CAA2C;AAC3C,MAAMW,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACX;IAAqBd;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbrB;IACAkB,cAAcpB,EAAEG,MAAM,CAAC;QACrBqB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAErB,KAAK,EAAS,EAAEsB,KAAoB;IAC3D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,oCAAoC;QAAExB;IAAM;IAExD,IAAI;YAUSyB,oBACCA;QAVZ,MAAMC,SAAS/B,OAAO+B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAC3E,MAAME,WAAW,MAAMJ,OAAOK,YAAY,CAACC,MAAM,CAAC;YAChDC,aAAa;gBACXC,YAAY;oBACVlC,OAAOA;gBACT;YACF;QACF;QACA,MAAMyB,MAAMK,SAASK,IAAI;QACzB,MAAMrB,MAAKW,qBAAAA,IAAIW,aAAa,cAAjBX,gCAAAA,qBAAqB;QAChC,MAAMY,OAAMZ,sBAAAA,IAAIV,cAAc,cAAlBU,iCAAAA,sBAAsB;QAElCF,OAAOC,IAAI,CAAC,qCAAqC;YAAEV;YAAId;YAAOqC;QAAI;QAElE,MAAMjB,SAAiB;YACrBb,MAAM;YACNE,kBAAkB,CAAC,qBAAqB,EAAET,MAAM,CAAC,CAAC;YAClDU,gBAAgB;YAChBE,cAAc;YACdC,aAAa,IAAIyB,OAAOC,WAAW;YACnCzB;YACAC,gBAAgBsB;YAChBrC;QACF;QAEA,OAAO;YACLwC,SAAS;gBACP;oBACEjC,MAAM;oBACNkC,MAAMC,KAAKC,SAAS,CAACvB;gBACvB;aACD;YACDwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEtB,OAAOsB,KAAK,CAAC,mCAAmC;YAAEA,OAAOC;QAAQ;QAEjE,+CAA+C;QAC/C,MAAM,IAAIpD,SAASD,UAAUwD,aAAa,EAAE,CAAC,4BAA4B,EAAEH,SAAS,EAAE;YACpFI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNnC;QACAG;IACF;AACF"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/spreadsheet-find.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.js';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.js';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n id: string;\n spreadsheetTitle: string | undefined;\n url: string | undefined;\n modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n items: z\n .array(\n z.object({\n id: SpreadsheetIdOutput,\n spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n sheets: z\n .array(\n z.object({\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n })\n )\n .describe('All sheets/tabs in this spreadsheet'),\n })\n )\n .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\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({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n const items = await Promise.all(\n sorted.map(async (m: SpreadsheetMatch) => {\n // Fetch sheet metadata for each spreadsheet\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: m.id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n const gid = String(sheet.properties?.sheetId ?? '');\n return {\n gid,\n sheetTitle: sheet.properties?.title ?? '',\n };\n });\n\n return {\n id: m.id,\n spreadsheetTitle: m.spreadsheetTitle ?? '',\n sheets: sheetsData,\n ...(m.url && { spreadsheetUrl: m.url }),\n ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n };\n })\n );\n\n logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n const result: Output = {\n type: 'success' as const,\n items,\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.spreadsheet.find error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-find',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetRefSchema","findSpreadsheetsByRef","inputSchema","object","spreadsheetRef","successBranchSchema","type","literal","items","array","id","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","version","auth","authContext","drive","matches","sorted","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","sheetsData","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-find.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.ts';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.ts';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n id: string;\n spreadsheetTitle: string | undefined;\n url: string | undefined;\n modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n items: z\n .array(\n z.object({\n id: SpreadsheetIdOutput,\n spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n sheets: z\n .array(\n z.object({\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n })\n )\n .describe('All sheets/tabs in this spreadsheet'),\n })\n )\n .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\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({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n const items = await Promise.all(\n sorted.map(async (m: SpreadsheetMatch) => {\n // Fetch sheet metadata for each spreadsheet\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: m.id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n const gid = String(sheet.properties?.sheetId ?? '');\n return {\n gid,\n sheetTitle: sheet.properties?.title ?? '',\n };\n });\n\n return {\n id: m.id,\n spreadsheetTitle: m.spreadsheetTitle ?? '',\n sheets: sheetsData,\n ...(m.url && { spreadsheetUrl: m.url }),\n ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n };\n })\n );\n\n logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n const result: Output = {\n type: 'success' as const,\n items,\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.spreadsheet.find error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-find',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetRefSchema","findSpreadsheetsByRef","inputSchema","object","spreadsheetRef","successBranchSchema","type","literal","items","array","id","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","version","auth","authContext","drive","matches","sorted","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","sheetsData","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,mBAAmB,EAAEC,oBAAoB,QAAQ,yBAAyB;AACnG,SAASC,qBAAqB,QAAQ,8CAA8C;AAUpF,MAAMC,cAAcL,EAAEM,MAAM,CAAC;IAC3BC,gBAAgBJ;AAClB;AAEA,MAAMK,sBAAsBR,EAAEM,MAAM,CAAC;IACnCG,MAAMT,EAAEU,OAAO,CAAC;IAChBC,OAAOX,EACJY,KAAK,CACJZ,EAAEM,MAAM,CAAC;QACPO,IAAIX;QACJY,kBAAkBd,EAAEe,MAAM,GAAGC,QAAQ,CAAC;QACtCC,gBAAgBjB,EAAEe,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;QAC/CG,cAAcnB,EAAEe,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;QAC7CI,QAAQpB,EACLY,KAAK,CACJZ,EAAEM,MAAM,CAAC;YACPe,KAAKpB;YACLqB,YAAYtB,EAAEe,MAAM,GAAGC,QAAQ,CAAC;QAClC,IAEDA,QAAQ,CAAC;IACd,IAEDA,QAAQ,CAAC;AACd;AAEA,MAAMO,eAAevB,EAAEwB,kBAAkB,CAAC,QAAQ;IAAChB;IAAqBZ;CAAyB;AAEjG,MAAM6B,SAAS;IACbC,aAAa;IACbrB;IACAkB,cAAcvB,EAAEM,MAAM,CAAC;QACrBqB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAErB,cAAc,EAAS,EAAEsB,KAAoB;IACpE,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,kCAAkC;QAAExB;IAAe;IAE/D,IAAI;QACF,MAAMa,SAASrB,OAAOqB,MAAM,CAAC;YAAEY,SAAS;YAAMC,MAAMJ,MAAMK,WAAW,CAACD,IAAI;QAAC;QAC3E,MAAME,QAAQpC,OAAOoC,KAAK,CAAC;YAAEH,SAAS;YAAMC,MAAMJ,MAAMK,WAAW,CAACD,IAAI;QAAC;QAEzE,MAAMG,UAAW,MAAMhC,sBAAsBgB,QAAQe,OAAO5B;QAE5D,MAAM8B,SAAS,AAACD,CAAAA,WAAW,EAAE,AAAD,EAAGE,KAAK,GAAGC,IAAI,CAAC,CAACC,GAAqBC,IAAwB,AAACA,CAAAA,EAAEtB,YAAY,GAAG,IAAIuB,KAAKD,EAAEtB,YAAY,EAAEwB,OAAO,KAAK,CAAA,IAAMH,CAAAA,EAAErB,YAAY,GAAG,IAAIuB,KAAKF,EAAErB,YAAY,EAAEwB,OAAO,KAAK,CAAA;QAE7M,MAAMhC,QAAQ,MAAMiC,QAAQC,GAAG,CAC7BR,OAAOS,GAAG,CAAC,OAAOC;gBAiBIA;YAhBpB,4CAA4C;YAC5C,MAAMC,sBAAsB,MAAM5B,OAAO6B,YAAY,CAACC,GAAG,CAAC;gBACxDC,eAAeJ,EAAElC,EAAE;gBACnBuC,QAAQ;YACV;YAEA,MAAMC,aAAa,AAACL,CAAAA,oBAAoBM,IAAI,CAAClC,MAAM,IAAI,EAAE,AAAD,EAAG0B,GAAG,CAAC,CAACS;;oBAC3CA,mBAGLA;gBAHd,MAAMlC,MAAMmC,gBAAOD,oBAAAA,MAAME,UAAU,cAAhBF,wCAAAA,kBAAkBG,OAAO,uCAAI;gBAChD,OAAO;oBACLrC;oBACAC,UAAU,YAAEiC,qBAAAA,MAAME,UAAU,cAAhBF,yCAAAA,mBAAkBI,KAAK,yCAAI;gBACzC;YACF;YAEA,OAAO;gBACL9C,IAAIkC,EAAElC,EAAE;gBACRC,gBAAgB,GAAEiC,sBAAAA,EAAEjC,gBAAgB,cAAlBiC,iCAAAA,sBAAsB;gBACxC3B,QAAQiC;gBACR,GAAIN,EAAEa,GAAG,IAAI;oBAAE3C,gBAAgB8B,EAAEa,GAAG;gBAAC,CAAC;gBACtC,GAAIb,EAAE5B,YAAY,IAAI;oBAAEA,cAAc4B,EAAE5B,YAAY;gBAAC,CAAC;YACxD;QACF;QAGFW,OAAOC,IAAI,CAAC,mCAAmC;YAAE8B,OAAOlD,MAAMmD,MAAM;QAAC;QAErE,MAAMnC,SAAiB;YACrBlB,MAAM;YACNE;QACF;QAEA,OAAO;YACLoD,SAAS;gBAAC;oBAAEtD,MAAM;oBAAiBuD,MAAMC,KAAKC,SAAS,CAACvC;gBAAQ;aAAE;YAClEwC,mBAAmB;gBAAExC;YAAO;QAC9B;IACF,EAAE,OAAOyC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGb,OAAOY;QAChEtC,OAAOsC,KAAK,CAAC,iCAAiC;YAAEA,OAAOC;QAAQ;QAE/D,MAAM,IAAIvE,SAASD,UAAU0E,aAAa,EAAE,CAAC,2BAA2B,EAAEF,SAAS,EAAE;YACnFG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNlD;QACAG;IACF;AACF"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/spreadsheet-rename.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the rename operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n oldTitle: z.string().describe('Previous title of the spreadsheet'),\n newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // First, get the current spreadsheet title\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title',\n });\n\n const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n // Rename the spreadsheet\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n updateSpreadsheetProperties: {\n properties: { title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n\n logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n oldTitle,\n newTitle,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.rename error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-rename',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-rename.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the rename operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n oldTitle: z.string().describe('Previous title of the spreadsheet'),\n newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // First, get the current spreadsheet title\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title',\n });\n\n const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n // Rename the spreadsheet\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n updateSpreadsheetProperties: {\n properties: { title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n\n logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n oldTitle,\n newTitle,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.rename error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-rename',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/validation-set.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';\n\n// Discriminated union for validation rule types\nconst ValidationRuleSchema = z.discriminatedUnion('conditionType', [\n // Dropdown with hardcoded list\n z.object({\n conditionType: z.literal('ONE_OF_LIST'),\n values: z.array(z.string()).min(1).describe('Hardcoded dropdown options'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Dropdown from range\n z.object({\n conditionType: z.literal('ONE_OF_RANGE'),\n sourceRange: z.string().min(1).describe('A1 notation range containing dropdown options (e.g., \"Options!A1:A10\")'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Numeric constraints\n z.object({\n conditionType: z.enum(['NUMBER_GREATER', 'NUMBER_LESS', 'NUMBER_BETWEEN']),\n values: z.array(z.number()).min(1).max(2).describe('1 value for GREATER/LESS, 2 values for BETWEEN'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Text constraints\n z.object({\n conditionType: z.enum(['TEXT_CONTAINS', 'TEXT_IS_EMAIL', 'TEXT_IS_URL']),\n values: z.array(z.string()).optional().describe('Text to match (for TEXT_CONTAINS only)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Date constraints\n z.object({\n conditionType: z.enum(['DATE_AFTER', 'DATE_BEFORE', 'DATE_BETWEEN']),\n values: z.array(z.string()).min(1).max(2).describe('ISO date strings (YYYY-MM-DD)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Custom formula\n z.object({\n conditionType: z.literal('CUSTOM_FORMULA'),\n formula: z.string().min(1).describe('Custom validation formula (e.g., \"=A1>0\")'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n]);\n\n// Input schema for validation requests\nconst ValidationRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range for validation (e.g., \"B2:B100\")'),\n rule: ValidationRuleSchema,\n inputMessage: z.string().optional().describe('Help text shown when cell is selected'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValidationRequestSchema).min(1).max(50).describe('Array of validation rules. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet with validation'),\n sheetUrl: z.string().describe('URL of the sheet with validation'),\n successCount: z.number().int().nonnegative().describe('Number of validation rules successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed validation setup'),\n error: z.string().describe('Why validation failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some validation rules failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Add data validation rules including dropdowns, numeric constraints, text patterns, date ranges, custom formulas. Supports batch operations for efficiency. Use discriminated conditionType to specify rule type. Best for enforcing data integrity and providing user-friendly input controls.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Map condition types to Google Sheets API format\nfunction buildCondition(rule: z.infer<typeof ValidationRuleSchema>) {\n switch (rule.conditionType) {\n case 'ONE_OF_LIST':\n return {\n type: 'ONE_OF_LIST',\n values: rule.values.map((value) => ({ userEnteredValue: value })),\n };\n case 'ONE_OF_RANGE':\n return {\n type: 'ONE_OF_RANGE',\n values: [{ userEnteredValue: `=${rule.sourceRange}` }],\n };\n case 'NUMBER_GREATER':\n return {\n type: 'NUMBER_GREATER',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_LESS':\n return {\n type: 'NUMBER_LESS',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_BETWEEN':\n return {\n type: 'NUMBER_BETWEEN',\n values: [{ userEnteredValue: String(rule.values[0]) }, { userEnteredValue: String(rule.values[1]) }],\n };\n case 'TEXT_CONTAINS':\n return {\n type: 'TEXT_CONTAINS',\n values: rule.values ? [{ userEnteredValue: rule.values[0] }] : [],\n };\n case 'TEXT_IS_EMAIL':\n return {\n type: 'TEXT_IS_EMAIL',\n values: [],\n };\n case 'TEXT_IS_URL':\n return {\n type: 'TEXT_IS_URL',\n values: [],\n };\n case 'DATE_AFTER':\n return {\n type: 'DATE_AFTER',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BEFORE':\n return {\n type: 'DATE_BEFORE',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BETWEEN':\n return {\n type: 'DATE_BETWEEN',\n values: [{ userEnteredValue: rule.values[0] }, { userEnteredValue: rule.values[1] }],\n };\n case 'CUSTOM_FORMULA':\n return {\n type: 'CUSTOM_FORMULA',\n values: [{ userEnteredValue: rule.formula.startsWith('=') ? rule.formula : `=${rule.formula}` }],\n };\n default:\n // Exhaustive check - all valid conditionType values should be handled above\n throw new Error(`Unknown condition type: ${(rule as { conditionType: string }).conditionType}`);\n }\n}\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.validation.set 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 validation set', { id, gid, requestCount: requests.length });\n throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetId = sheet.properties.sheetId;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate sheetId exists\n if (sheetId === undefined || sheetId === null) {\n logger.error('Sheet ID not available for validation set', { id, gid, sheetTitle });\n throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);\n }\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build validation rule\n const condition = buildCondition(request.rule);\n\n // Build data validation rule - structure matches Schema$DataValidationRule\n const dataValidationRule = {\n condition,\n strict: request.rule.strict,\n showCustomUi: 'showDropdown' in request.rule ? request.rule.showDropdown : undefined,\n inputMessage: request.inputMessage,\n } as sheets_v4.Schema$DataValidationRule;\n\n // Add setDataValidation request\n batchRequests.push({\n setDataValidation: {\n range: gridRange,\n rule: dataValidationRule,\n },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to build validation rule', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to build validation rule: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.validation.set 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.validation.set completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Validation set operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new McpError(ErrorCode.InternalError, `Error setting validation: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'validation-set',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ValidationRuleSchema","discriminatedUnion","object","conditionType","literal","values","array","string","min","describe","showDropdown","boolean","default","strict","sourceRange","enum","number","max","optional","formula","ValidationRequestSchema","range","rule","inputMessage","inputSchema","id","gid","requests","successBranchSchema","type","sheetTitle","sheetUrl","successCount","int","nonnegative","failedRanges","error","outputSchema","config","description","result","buildCondition","map","value","userEnteredValue","String","startsWith","Error","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","title","undefined","InternalError","batchRequests","request","rangeRef","gridRange","condition","dataValidationRule","showCustomUi","push","setDataValidation","message","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/validation-set.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Discriminated union for validation rule types\nconst ValidationRuleSchema = z.discriminatedUnion('conditionType', [\n // Dropdown with hardcoded list\n z.object({\n conditionType: z.literal('ONE_OF_LIST'),\n values: z.array(z.string()).min(1).describe('Hardcoded dropdown options'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Dropdown from range\n z.object({\n conditionType: z.literal('ONE_OF_RANGE'),\n sourceRange: z.string().min(1).describe('A1 notation range containing dropdown options (e.g., \"Options!A1:A10\")'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Numeric constraints\n z.object({\n conditionType: z.enum(['NUMBER_GREATER', 'NUMBER_LESS', 'NUMBER_BETWEEN']),\n values: z.array(z.number()).min(1).max(2).describe('1 value for GREATER/LESS, 2 values for BETWEEN'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Text constraints\n z.object({\n conditionType: z.enum(['TEXT_CONTAINS', 'TEXT_IS_EMAIL', 'TEXT_IS_URL']),\n values: z.array(z.string()).optional().describe('Text to match (for TEXT_CONTAINS only)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Date constraints\n z.object({\n conditionType: z.enum(['DATE_AFTER', 'DATE_BEFORE', 'DATE_BETWEEN']),\n values: z.array(z.string()).min(1).max(2).describe('ISO date strings (YYYY-MM-DD)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Custom formula\n z.object({\n conditionType: z.literal('CUSTOM_FORMULA'),\n formula: z.string().min(1).describe('Custom validation formula (e.g., \"=A1>0\")'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n]);\n\n// Input schema for validation requests\nconst ValidationRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range for validation (e.g., \"B2:B100\")'),\n rule: ValidationRuleSchema,\n inputMessage: z.string().optional().describe('Help text shown when cell is selected'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValidationRequestSchema).min(1).max(50).describe('Array of validation rules. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet with validation'),\n sheetUrl: z.string().describe('URL of the sheet with validation'),\n successCount: z.number().int().nonnegative().describe('Number of validation rules successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed validation setup'),\n error: z.string().describe('Why validation failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some validation rules failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Add data validation rules including dropdowns, numeric constraints, text patterns, date ranges, custom formulas. Supports batch operations for efficiency. Use discriminated conditionType to specify rule type. Best for enforcing data integrity and providing user-friendly input controls.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Map condition types to Google Sheets API format\nfunction buildCondition(rule: z.infer<typeof ValidationRuleSchema>) {\n switch (rule.conditionType) {\n case 'ONE_OF_LIST':\n return {\n type: 'ONE_OF_LIST',\n values: rule.values.map((value) => ({ userEnteredValue: value })),\n };\n case 'ONE_OF_RANGE':\n return {\n type: 'ONE_OF_RANGE',\n values: [{ userEnteredValue: `=${rule.sourceRange}` }],\n };\n case 'NUMBER_GREATER':\n return {\n type: 'NUMBER_GREATER',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_LESS':\n return {\n type: 'NUMBER_LESS',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_BETWEEN':\n return {\n type: 'NUMBER_BETWEEN',\n values: [{ userEnteredValue: String(rule.values[0]) }, { userEnteredValue: String(rule.values[1]) }],\n };\n case 'TEXT_CONTAINS':\n return {\n type: 'TEXT_CONTAINS',\n values: rule.values ? [{ userEnteredValue: rule.values[0] }] : [],\n };\n case 'TEXT_IS_EMAIL':\n return {\n type: 'TEXT_IS_EMAIL',\n values: [],\n };\n case 'TEXT_IS_URL':\n return {\n type: 'TEXT_IS_URL',\n values: [],\n };\n case 'DATE_AFTER':\n return {\n type: 'DATE_AFTER',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BEFORE':\n return {\n type: 'DATE_BEFORE',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BETWEEN':\n return {\n type: 'DATE_BETWEEN',\n values: [{ userEnteredValue: rule.values[0] }, { userEnteredValue: rule.values[1] }],\n };\n case 'CUSTOM_FORMULA':\n return {\n type: 'CUSTOM_FORMULA',\n values: [{ userEnteredValue: rule.formula.startsWith('=') ? rule.formula : `=${rule.formula}` }],\n };\n default:\n // Exhaustive check - all valid conditionType values should be handled above\n throw new Error(`Unknown condition type: ${(rule as { conditionType: string }).conditionType}`);\n }\n}\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.validation.set 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 validation set', { id, gid, requestCount: requests.length });\n throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetId = sheet.properties.sheetId;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate sheetId exists\n if (sheetId === undefined || sheetId === null) {\n logger.error('Sheet ID not available for validation set', { id, gid, sheetTitle });\n throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);\n }\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build validation rule\n const condition = buildCondition(request.rule);\n\n // Build data validation rule - structure matches Schema$DataValidationRule\n const dataValidationRule = {\n condition,\n strict: request.rule.strict,\n showCustomUi: 'showDropdown' in request.rule ? request.rule.showDropdown : undefined,\n inputMessage: request.inputMessage,\n } as sheets_v4.Schema$DataValidationRule;\n\n // Add setDataValidation request\n batchRequests.push({\n setDataValidation: {\n range: gridRange,\n rule: dataValidationRule,\n },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to build validation rule', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to build validation rule: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.validation.set 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.validation.set completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Validation set operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new McpError(ErrorCode.InternalError, `Error setting validation: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'validation-set',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ValidationRuleSchema","discriminatedUnion","object","conditionType","literal","values","array","string","min","describe","showDropdown","boolean","default","strict","sourceRange","enum","number","max","optional","formula","ValidationRequestSchema","range","rule","inputMessage","inputSchema","id","gid","requests","successBranchSchema","type","sheetTitle","sheetUrl","successCount","int","nonnegative","failedRanges","error","outputSchema","config","description","result","buildCondition","map","value","userEnteredValue","String","startsWith","Error","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","title","undefined","InternalError","batchRequests","request","rangeRef","gridRange","condition","dataValidationRule","showCustomUi","push","setDataValidation","message","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","stack","createTool","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-batch-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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\n// Types for updated data response\ninterface UpdatedDataItem {\n range: string;\n majorDimension: 'ROWS' | 'COLUMNS';\n values?: (string | number | boolean | null)[][];\n}\n\n// Input schema for values batch update requests\nconst ValuesBatchUpdateRequestSchema = z.object({\n range: A1NotationSchema.describe('A1 notation range defining the bounded target area. Data dimensions must match range dimensions. Example: D1:D100 requires exactly 100 rows of data. Use open-ended ranges like D1:D to write any number of rows.'),\n values: z.array(z.array(SheetCellSchema)).min(1).describe('2D array of values. Row count must match range height, column count must match range width. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether values represent rows or columns'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValuesBatchUpdateRequestSchema).min(1).describe('Array of value update requests'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input)'),\n includeData: z.boolean().describe('Whether to include updated cell values in the response'),\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 updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n totalUpdatedRows: z.number().int().nonnegative().describe('Total number of rows updated across all requests'),\n totalUpdatedColumns: z.number().int().nonnegative().describe('Total number of columns updated across all requests'),\n totalUpdatedCells: z.number().int().nonnegative().describe('Total number of cells updated across all requests'),\n updatedRanges: z.array(z.string()).describe('A1 notation ranges that were updated'),\n updatedData: z\n .array(\n z.object({\n range: z.string().describe('A1 notation range that was updated'),\n majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension of the updated data'),\n values: z.array(z.array(SheetCellSchema)).optional().describe('Updated values (if includeData was true)'),\n })\n )\n .optional()\n .describe('Detailed information about updated data (if includeData was true)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Batch update multiple cell ranges. RAW=exact values, USER_ENTERED=parsed like user input. 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, requests, valueInputOption = 'USER_ENTERED', includeData = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.batchUpdate called', {\n id,\n gid,\n requestCount: requests.length,\n valueInputOption,\n includeData,\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: '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 batch update', { id, gid, requestCount: requests.length });\n throw new McpError(ErrorCode.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 // Build batch update request with prefixed ranges\n const batchUpdateData = requests.map((req) => ({\n range: `${sheetTitle}!${req.range}`,\n values: req.values,\n majorDimension: req.majorDimension || 'ROWS',\n }));\n\n logger.info('sheets.values.batchUpdate executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchUpdateDataCount: batchUpdateData.length,\n });\n\n // Execute the batch update\n const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n valueInputOption,\n data: batchUpdateData,\n includeValuesInResponse: includeData,\n responseDateTimeRenderOption: 'FORMATTED_STRING',\n responseValueRenderOption: 'FORMATTED_VALUE',\n },\n });\n\n const updateResult = batchUpdateResponse.data;\n\n // Validate batch operation results and detect partial failures\n const responses = updateResult.responses || [];\n const expectedCount = requests.length;\n const actualCount = responses.length;\n\n if (actualCount !== expectedCount) {\n logger.error('Partial batch failure detected', {\n expectedOperations: expectedCount,\n completedOperations: actualCount,\n spreadsheetId: id,\n sheetTitle,\n });\n\n throw new McpError(ErrorCode.InternalError, `Batch operation partially failed: ${actualCount}/${expectedCount} operations completed`);\n }\n\n // Check for any failed operations (empty or null responses)\n const failedOperations = responses.filter((response, index) => {\n if (!response || !response.updatedRange) {\n logger.error('Failed operation detected', {\n operationIndex: index,\n requestedRange: requests[index]?.range,\n spreadsheetId: id,\n sheetTitle,\n });\n return true;\n }\n return false;\n });\n\n if (failedOperations.length > 0) {\n throw new McpError(ErrorCode.InternalError, `${failedOperations.length} operations failed to update ranges`);\n }\n\n // Extract updated ranges and calculate totals\n const updatedRanges = responses.map((response) => response.updatedRange || '').filter((range) => range);\n const totalUpdatedRows = updateResult.totalUpdatedRows || 0;\n const totalUpdatedColumns = updateResult.totalUpdatedColumns || 0;\n const totalUpdatedCells = updateResult.totalUpdatedCells || 0;\n\n // Build updated data response if requested\n let updatedData: UpdatedDataItem[] | undefined;\n if (includeData && updateResult.responses) {\n updatedData = updateResult.responses\n .filter((response) => response.updatedData)\n .map((response) => {\n const item: UpdatedDataItem = {\n range: response.updatedRange || '',\n majorDimension: (response.updatedData?.majorDimension as 'ROWS' | 'COLUMNS' | undefined) || 'ROWS',\n };\n const values = response.updatedData?.values as (string | number | boolean | null | undefined)[][] | undefined;\n if (values !== undefined) {\n // Map undefined values to null for JSON Schema compatibility\n item.values = values.map((row) => row.map((cell) => (cell === undefined ? null : cell)));\n }\n return item;\n });\n }\n\n logger.info('sheets.values.batchUpdate completed successfully', {\n totalUpdatedRows,\n totalUpdatedColumns,\n totalUpdatedCells,\n updatedRangesCount: updatedRanges.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 totalUpdatedRows,\n totalUpdatedColumns,\n totalUpdatedCells,\n updatedRanges,\n updatedData,\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('Batch update operation failed', {\n id,\n gid,\n requestCount: requests.length,\n valueInputOption,\n error: message,\n });\n\n throw new McpError(ErrorCode.InternalError, `Error batch updating values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-batch-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","ValuesBatchUpdateRequestSchema","object","range","describe","values","array","min","majorDimension","enum","inputSchema","id","gid","requests","valueInputOption","includeData","boolean","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","totalUpdatedRows","number","int","nonnegative","totalUpdatedColumns","totalUpdatedCells","updatedRanges","updatedData","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","batchUpdateData","map","req","batchUpdateDataCount","batchUpdateResponse","batchUpdate","requestBody","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","updateResult","responses","expectedCount","actualCount","error","expectedOperations","completedOperations","InternalError","failedOperations","filter","response","index","updatedRange","operationIndex","requestedRange","item","undefined","row","cell","updatedRangesCount","content","text","JSON","stringify","structuredContent","message","Error","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/values-batch-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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Types for updated data response\ninterface UpdatedDataItem {\n range: string;\n majorDimension: 'ROWS' | 'COLUMNS';\n values?: (string | number | boolean | null)[][];\n}\n\n// Input schema for values batch update requests\nconst ValuesBatchUpdateRequestSchema = z.object({\n range: A1NotationSchema.describe('A1 notation range defining the bounded target area. Data dimensions must match range dimensions. Example: D1:D100 requires exactly 100 rows of data. Use open-ended ranges like D1:D to write any number of rows.'),\n values: z.array(z.array(SheetCellSchema)).min(1).describe('2D array of values. Row count must match range height, column count must match range width. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether values represent rows or columns'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValuesBatchUpdateRequestSchema).min(1).describe('Array of value update requests'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input)'),\n includeData: z.boolean().describe('Whether to include updated cell values in the response'),\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 updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n totalUpdatedRows: z.number().int().nonnegative().describe('Total number of rows updated across all requests'),\n totalUpdatedColumns: z.number().int().nonnegative().describe('Total number of columns updated across all requests'),\n totalUpdatedCells: z.number().int().nonnegative().describe('Total number of cells updated across all requests'),\n updatedRanges: z.array(z.string()).describe('A1 notation ranges that were updated'),\n updatedData: z\n .array(\n z.object({\n range: z.string().describe('A1 notation range that was updated'),\n majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension of the updated data'),\n values: z.array(z.array(SheetCellSchema)).optional().describe('Updated values (if includeData was true)'),\n })\n )\n .optional()\n .describe('Detailed information about updated data (if includeData was true)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Batch update multiple cell ranges. RAW=exact values, USER_ENTERED=parsed like user input. 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, requests, valueInputOption = 'USER_ENTERED', includeData = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values.batchUpdate called', {\n id,\n gid,\n requestCount: requests.length,\n valueInputOption,\n includeData,\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: '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 batch update', { id, gid, requestCount: requests.length });\n throw new McpError(ErrorCode.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 // Build batch update request with prefixed ranges\n const batchUpdateData = requests.map((req) => ({\n range: `${sheetTitle}!${req.range}`,\n values: req.values,\n majorDimension: req.majorDimension || 'ROWS',\n }));\n\n logger.info('sheets.values.batchUpdate executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchUpdateDataCount: batchUpdateData.length,\n });\n\n // Execute the batch update\n const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n valueInputOption,\n data: batchUpdateData,\n includeValuesInResponse: includeData,\n responseDateTimeRenderOption: 'FORMATTED_STRING',\n responseValueRenderOption: 'FORMATTED_VALUE',\n },\n });\n\n const updateResult = batchUpdateResponse.data;\n\n // Validate batch operation results and detect partial failures\n const responses = updateResult.responses || [];\n const expectedCount = requests.length;\n const actualCount = responses.length;\n\n if (actualCount !== expectedCount) {\n logger.error('Partial batch failure detected', {\n expectedOperations: expectedCount,\n completedOperations: actualCount,\n spreadsheetId: id,\n sheetTitle,\n });\n\n throw new McpError(ErrorCode.InternalError, `Batch operation partially failed: ${actualCount}/${expectedCount} operations completed`);\n }\n\n // Check for any failed operations (empty or null responses)\n const failedOperations = responses.filter((response, index) => {\n if (!response || !response.updatedRange) {\n logger.error('Failed operation detected', {\n operationIndex: index,\n requestedRange: requests[index]?.range,\n spreadsheetId: id,\n sheetTitle,\n });\n return true;\n }\n return false;\n });\n\n if (failedOperations.length > 0) {\n throw new McpError(ErrorCode.InternalError, `${failedOperations.length} operations failed to update ranges`);\n }\n\n // Extract updated ranges and calculate totals\n const updatedRanges = responses.map((response) => response.updatedRange || '').filter((range) => range);\n const totalUpdatedRows = updateResult.totalUpdatedRows || 0;\n const totalUpdatedColumns = updateResult.totalUpdatedColumns || 0;\n const totalUpdatedCells = updateResult.totalUpdatedCells || 0;\n\n // Build updated data response if requested\n let updatedData: UpdatedDataItem[] | undefined;\n if (includeData && updateResult.responses) {\n updatedData = updateResult.responses\n .filter((response) => response.updatedData)\n .map((response) => {\n const item: UpdatedDataItem = {\n range: response.updatedRange || '',\n majorDimension: (response.updatedData?.majorDimension as 'ROWS' | 'COLUMNS' | undefined) || 'ROWS',\n };\n const values = response.updatedData?.values as (string | number | boolean | null | undefined)[][] | undefined;\n if (values !== undefined) {\n // Map undefined values to null for JSON Schema compatibility\n item.values = values.map((row) => row.map((cell) => (cell === undefined ? null : cell)));\n }\n return item;\n });\n }\n\n logger.info('sheets.values.batchUpdate completed successfully', {\n totalUpdatedRows,\n totalUpdatedColumns,\n totalUpdatedCells,\n updatedRangesCount: updatedRanges.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 totalUpdatedRows,\n totalUpdatedColumns,\n totalUpdatedCells,\n updatedRanges,\n updatedData,\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('Batch update operation failed', {\n id,\n gid,\n requestCount: requests.length,\n valueInputOption,\n error: message,\n });\n\n throw new McpError(ErrorCode.InternalError, `Error batch updating values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-batch-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","ValuesBatchUpdateRequestSchema","object","range","describe","values","array","min","majorDimension","enum","inputSchema","id","gid","requests","valueInputOption","includeData","boolean","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","totalUpdatedRows","number","int","nonnegative","totalUpdatedColumns","totalUpdatedCells","updatedRanges","updatedData","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","batchUpdateData","map","req","batchUpdateDataCount","batchUpdateResponse","batchUpdate","requestBody","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","updateResult","responses","expectedCount","actualCount","error","expectedOperations","completedOperations","InternalError","failedOperations","filter","response","index","updatedRange","operationIndex","requestedRange","item","undefined","row","cell","updatedRangesCount","content","text","JSON","stringify","structuredContent","message","Error","stack","createTool","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","ranges","array","min","describe","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","clearedRanges","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rangeCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","prefixedRanges","map","range","clearResponse","values","batchClear","requestBody","clearedRangesCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","ranges","array","min","describe","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","clearedRanges","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rangeCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","prefixedRanges","map","range","clearResponse","values","batchClear","requestBody","clearedRangesCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","BATCH_SIZE","inputSchema","object","id","gid","sourceUri","string","trim","min","describe","startRange","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","spreadsheetData","batchUpdateResponse","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","sourceHeaders","allRows","totalCols","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","dataToWrite","batchRequests","currentRow","match","currentRowNum","Number","parseInt","i","batchData","slice","batchRange","range","values","totalBatches","batchSize","batchUpdate","requestBody","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","responses","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","BATCH_SIZE","inputSchema","object","id","gid","sourceUri","string","trim","min","describe","startRange","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","spreadsheetData","batchUpdateResponse","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","sourceHeaders","allRows","totalCols","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","dataToWrite","batchRequests","currentRow","match","currentRowNum","Number","parseInt","i","batchData","slice","batchRange","range","values","totalBatches","batchSize","batchUpdate","requestBody","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","responses","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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 McpError) {\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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","sheets","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/Projects/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 { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\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 McpError(ErrorCode.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 McpError(ErrorCode.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 McpError) {\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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","sheets","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}