@mcp-z/mcp-sheets 1.0.0

package/dist/esm/mcp/tools/validation-set.js

@@ -0,0 +1,366 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
+// Discriminated union for validation rule types
+const ValidationRuleSchema = z.discriminatedUnion('conditionType', [
+    // Dropdown with hardcoded list
+    z.object({
+        conditionType: z.literal('ONE_OF_LIST'),
+        values: z.array(z.string()).min(1).describe('Hardcoded dropdown options'),
+        showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    }),
+    // Dropdown from range
+    z.object({
+        conditionType: z.literal('ONE_OF_RANGE'),
+        sourceRange: z.string().min(1).describe('A1 notation range containing dropdown options (e.g., "Options!A1:A10")'),
+        showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    }),
+    // Numeric constraints
+    z.object({
+        conditionType: z.enum([
+            'NUMBER_GREATER',
+            'NUMBER_LESS',
+            'NUMBER_BETWEEN'
+        ]),
+        values: z.array(z.number()).min(1).max(2).describe('1 value for GREATER/LESS, 2 values for BETWEEN'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    }),
+    // Text constraints
+    z.object({
+        conditionType: z.enum([
+            'TEXT_CONTAINS',
+            'TEXT_IS_EMAIL',
+            'TEXT_IS_URL'
+        ]),
+        values: z.array(z.string()).optional().describe('Text to match (for TEXT_CONTAINS only)'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    }),
+    // Date constraints
+    z.object({
+        conditionType: z.enum([
+            'DATE_AFTER',
+            'DATE_BEFORE',
+            'DATE_BETWEEN'
+        ]),
+        values: z.array(z.string()).min(1).max(2).describe('ISO date strings (YYYY-MM-DD)'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    }),
+    // Custom formula
+    z.object({
+        conditionType: z.literal('CUSTOM_FORMULA'),
+        formula: z.string().min(1).describe('Custom validation formula (e.g., "=A1>0")'),
+        strict: z.boolean().default(true).describe('Reject invalid entries')
+    })
+]);
+// Input schema for validation requests
+const ValidationRequestSchema = z.object({
+    range: z.string().min(1).describe('A1 notation range for validation (e.g., "B2:B100")'),
+    rule: ValidationRuleSchema,
+    inputMessage: z.string().optional().describe('Help text shown when cell is selected')
+});
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    requests: z.array(ValidationRequestSchema).min(1).max(50).describe('Array of validation rules. Batch multiple ranges for efficiency.')
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    sheetTitle: z.string().describe('Title of the sheet with validation'),
+    sheetUrl: z.string().describe('URL of the sheet with validation'),
+    successCount: z.number().int().nonnegative().describe('Number of validation rules successfully applied'),
+    failedRanges: z.array(z.object({
+        range: z.string().describe('A1 notation of range that failed validation setup'),
+        error: z.string().describe('Why validation failed for this range')
+    })).optional().describe('Only populated if some validation rules failed')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    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.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+// Map condition types to Google Sheets API format
+function buildCondition(rule) {
+    switch(rule.conditionType){
+        case 'ONE_OF_LIST':
+            return {
+                type: 'ONE_OF_LIST',
+                values: rule.values.map((value)=>({
+                        userEnteredValue: value
+                    }))
+            };
+        case 'ONE_OF_RANGE':
+            return {
+                type: 'ONE_OF_RANGE',
+                values: [
+                    {
+                        userEnteredValue: `=${rule.sourceRange}`
+                    }
+                ]
+            };
+        case 'NUMBER_GREATER':
+            return {
+                type: 'NUMBER_GREATER',
+                values: [
+                    {
+                        userEnteredValue: String(rule.values[0])
+                    }
+                ]
+            };
+        case 'NUMBER_LESS':
+            return {
+                type: 'NUMBER_LESS',
+                values: [
+                    {
+                        userEnteredValue: String(rule.values[0])
+                    }
+                ]
+            };
+        case 'NUMBER_BETWEEN':
+            return {
+                type: 'NUMBER_BETWEEN',
+                values: [
+                    {
+                        userEnteredValue: String(rule.values[0])
+                    },
+                    {
+                        userEnteredValue: String(rule.values[1])
+                    }
+                ]
+            };
+        case 'TEXT_CONTAINS':
+            return {
+                type: 'TEXT_CONTAINS',
+                values: rule.values ? [
+                    {
+                        userEnteredValue: rule.values[0]
+                    }
+                ] : []
+            };
+        case 'TEXT_IS_EMAIL':
+            return {
+                type: 'TEXT_IS_EMAIL',
+                values: []
+            };
+        case 'TEXT_IS_URL':
+            return {
+                type: 'TEXT_IS_URL',
+                values: []
+            };
+        case 'DATE_AFTER':
+            return {
+                type: 'DATE_AFTER',
+                values: [
+                    {
+                        userEnteredValue: rule.values[0]
+                    }
+                ]
+            };
+        case 'DATE_BEFORE':
+            return {
+                type: 'DATE_BEFORE',
+                values: [
+                    {
+                        userEnteredValue: rule.values[0]
+                    }
+                ]
+            };
+        case 'DATE_BETWEEN':
+            return {
+                type: 'DATE_BETWEEN',
+                values: [
+                    {
+                        userEnteredValue: rule.values[0]
+                    },
+                    {
+                        userEnteredValue: rule.values[1]
+                    }
+                ]
+            };
+        case 'CUSTOM_FORMULA':
+            return {
+                type: 'CUSTOM_FORMULA',
+                values: [
+                    {
+                        userEnteredValue: rule.formula.startsWith('=') ? rule.formula : `=${rule.formula}`
+                    }
+                ]
+            };
+        default:
+            // Exhaustive check - all valid conditionType values should be handled above
+            throw new Error(`Unknown condition type: ${rule.conditionType}`);
+    }
+}
+async function handler({ id, gid, requests }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.validation.set called', {
+        id,
+        gid,
+        requestCount: requests.length
+    });
+    try {
+        var _sheet_properties_title;
+        var _spreadsheetResponse_data_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get spreadsheet and sheet info in single API call
+        const spreadsheetResponse = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'sheets.properties.sheetId,sheets.properties.title'
+        });
+        // Find sheet by gid
+        const sheet = (_spreadsheetResponse_data_sheets = spreadsheetResponse.data.sheets) === null || _spreadsheetResponse_data_sheets === void 0 ? void 0 : _spreadsheetResponse_data_sheets.find((s)=>{
+            var _s_properties;
+            return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
+        });
+        if (!(sheet === null || sheet === void 0 ? void 0 : sheet.properties)) {
+            logger.info('Sheet not found for validation set', {
+                id,
+                gid,
+                requestCount: requests.length
+            });
+            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+        }
+        const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
+        const sheetId = sheet.properties.sheetId;
+        const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;
+        // Validate sheetId exists
+        if (sheetId === undefined || sheetId === null) {
+            logger.error('Sheet ID not available for validation set', {
+                id,
+                gid,
+                sheetTitle
+            });
+            throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);
+        }
+        // Build batch update requests
+        const batchRequests = [];
+        const failedRanges = [];
+        for (const request of requests){
+            try {
+                // Parse A1 notation to range reference
+                const rangeRef = parseA1Notation(request.range);
+                // Build grid range from range reference using helper function
+                const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);
+                // Build validation rule
+                const condition = buildCondition(request.rule);
+                // Build data validation rule - structure matches Schema$DataValidationRule
+                const dataValidationRule = {
+                    condition,
+                    strict: request.rule.strict,
+                    showCustomUi: 'showDropdown' in request.rule ? request.rule.showDropdown : undefined,
+                    inputMessage: request.inputMessage
+                };
+                // Add setDataValidation request
+                batchRequests.push({
+                    setDataValidation: {
+                        range: gridRange,
+                        rule: dataValidationRule
+                    }
+                });
+            } catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.info('Failed to build validation rule', {
+                    range: request.range,
+                    error: message
+                });
+                failedRanges.push({
+                    range: request.range,
+                    error: `Failed to build validation rule: ${message}`
+                });
+            }
+        }
+        // Early return if all ranges failed
+        if (batchRequests.length === 0) {
+            const result = {
+                type: 'success',
+                id,
+                gid: String(sheetId),
+                sheetTitle,
+                sheetUrl,
+                successCount: 0,
+                failedRanges: failedRanges.length > 0 ? failedRanges : undefined
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result)
+                    }
+                ],
+                structuredContent: {
+                    result
+                }
+            };
+        }
+        logger.info('sheets.validation.set executing batch request', {
+            spreadsheetId: id,
+            sheetTitle,
+            batchRequestsCount: batchRequests.length
+        });
+        // Execute the batch update
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                requests: batchRequests
+            }
+        });
+        logger.info('sheets.validation.set completed successfully', {
+            successCount: requests.length - failedRanges.length,
+            failedCount: failedRanges.length
+        });
+        const result = {
+            type: 'success',
+            id,
+            gid: String(sheetId),
+            sheetTitle,
+            sheetUrl,
+            successCount: requests.length - failedRanges.length,
+            failedRanges: failedRanges.length > 0 ? failedRanges : undefined
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('Validation set operation failed', {
+            id,
+            gid,
+            requestCount: requests.length,
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error setting validation: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'validation-set',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/validation-set.js.map

@@ -0,0 +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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"}

package/dist/esm/mcp/tools/values-batch-update.d.ts

@@ -0,0 +1,102 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    requests: z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        values: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+        majorDimension: z.ZodEnum<{
+            ROWS: "ROWS";
+            COLUMNS: "COLUMNS";
+        }>;
+    }, z.core.$strip>>;
+    valueInputOption: z.ZodEnum<{
+        RAW: "RAW";
+        USER_ENTERED: "USER_ENTERED";
+    }>;
+    includeData: z.ZodBoolean;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    spreadsheetTitle: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    totalUpdatedRows: z.ZodNumber;
+    totalUpdatedColumns: z.ZodNumber;
+    totalUpdatedCells: z.ZodNumber;
+    updatedRanges: z.ZodArray<z.ZodString>;
+    updatedData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        majorDimension: z.ZodEnum<{
+            ROWS: "ROWS";
+            COLUMNS: "COLUMNS";
+        }>;
+        values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, requests, valueInputOption, includeData }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Batch update multiple cell ranges. RAW=exact values, USER_ENTERED=parsed like user input. Use a1-notation prompt for range syntax.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            requests: z.ZodArray<z.ZodObject<{
+                range: z.ZodString;
+                values: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+                majorDimension: z.ZodEnum<{
+                    ROWS: "ROWS";
+                    COLUMNS: "COLUMNS";
+                }>;
+            }, z.core.$strip>>;
+            valueInputOption: z.ZodEnum<{
+                RAW: "RAW";
+                USER_ENTERED: "USER_ENTERED";
+            }>;
+            includeData: z.ZodBoolean;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                spreadsheetTitle: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                totalUpdatedRows: z.ZodNumber;
+                totalUpdatedColumns: z.ZodNumber;
+                totalUpdatedCells: z.ZodNumber;
+                updatedRanges: z.ZodArray<z.ZodString>;
+                updatedData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    range: z.ZodString;
+                    majorDimension: z.ZodEnum<{
+                        ROWS: "ROWS";
+                        COLUMNS: "COLUMNS";
+                    }>;
+                    values: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};