@mcp-z/mcp-sheets 1.2.4 → 1.3.0

package/dist/cjs/mcp/tools/dimensions-move.js

@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _sheets = require("@googleapis/sheets");
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
-var _googleapis = require("googleapis");
+var _server = require("@mcp-z/server");
 var _zod = require("zod");
+var _googleauthts = require("../../lib/google-auth.js");
 var _indexts = require("../../schemas/index.js");
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -204,11 +205,11 @@ function handler(_0, _1) {
                     });
                     // Validate indices
                     if (startIndex >= endIndex) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "startIndex (".concat(startIndex, ") must be less than endIndex (").concat(endIndex, ")"));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "startIndex (".concat(startIndex, ") must be less than endIndex (").concat(endIndex, ")"));
                     }
                     // Check if destination is within source range (invalid move)
                     if (destinationIndex > startIndex && destinationIndex < endIndex) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "destinationIndex (".concat(destinationIndex, ") cannot be within the source range (").concat(startIndex, "-").concat(endIndex, ")"));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "destinationIndex (".concat(destinationIndex, ") cannot be within the source range (").concat(startIndex, "-").concat(endIndex, ")"));
                     }
                     _state.label = 1;
                 case 1:
@@ -218,9 +219,9 @@ function handler(_0, _1) {
                         ,
                         5
                     ]);
-                    sheets = _googleapis.google.sheets({
+                    sheets = (0, _sheets.sheets)({
                         version: 'v4',
-                        auth: extra.authContext.auth
+                        auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });
                     return [
                         4,
@@ -245,7 +246,7 @@ function handler(_0, _1) {
                             gid: gid,
                             dimension: dimension
                         });
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
                     sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
@@ -321,7 +322,7 @@ function handler(_0, _1) {
                     ];
                 case 4:
                     error = _state.sent();
-                    if (_instanceof(error, _types.McpError)) {
+                    if (_instanceof(error, _server.ProtocolError)) {
                         throw error;
                     }
                     message = _instanceof(error, Error) ? error.message : String(error);
@@ -334,7 +335,7 @@ function handler(_0, _1) {
                         destinationIndex: destinationIndex,
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error moving ".concat(dimension.toLowerCase(), ": ").concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error moving ".concat(dimension.toLowerCase(), ": ").concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 5:

package/dist/cjs/mcp/tools/dimensions-move.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.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, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\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  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\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 move', { id, gid, dimension });\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    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\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      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\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('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetData","sheet","sheets","spreadsheetResponse","sheetGid","error","message","info","McpError","ErrorCode","InvalidParams","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","Error","InternalError","toLowerCase","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\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  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\n  }\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: '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 move', { id, gid, dimension });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\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      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetData","sheet","sheets","spreadsheetResponse","sheetGid","error","message","info","ProtocolError","ProtocolErrorCode","InvalidParams","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","Error","InternalError","toLowerCase","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/rows-append.d.cts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-append.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-append.js

@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _sheets = require("@googleapis/sheets");
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
-var _googleapis = require("googleapis");
+var _server = require("@mcp-z/server");
 var _zod = require("zod");
+var _googleauthts = require("../../lib/google-auth.js");
 var _indexts = require("../../schemas/index.js");
 var _dataoperationsts = require("../../spreadsheet/data-operations.js");
 var _sheetoperationsts = require("../../spreadsheet/sheet-operations.js");
@@ -202,9 +203,9 @@ function handler(_0, _1) {
                         ,
                         7
                     ]);
-                    sheets = _googleapis.google.sheets({
+                    sheets = (0, _sheets.sheets)({
                         version: 'v4',
-                        auth: extra.authContext.auth
+                        auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });
                     return [
                         4,
@@ -220,7 +221,7 @@ function handler(_0, _1) {
                         return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
                     });
                     if (!sheet) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Sheet not found');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'Sheet not found');
                     }
                     sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
                     // Smart header handling and data processing
@@ -310,7 +311,7 @@ function handler(_0, _1) {
                     logger.error('sheets.rows.append error', {
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error appending rows: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error appending rows: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 7:

package/dist/cjs/mcp/tools/rows-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.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, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  rows: z\n    .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n    .min(1)\n    .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n  headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n  deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',\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, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Smart header handling and data processing\n    let processedRows = rows;\n    let currentHeaders: string[] = [];\n    let rowsSkipped = 0;\n    let existingKeySet: Set<string> = new Set();\n\n    if (headers && headers.length > 0) {\n      // Use ensureTabAndHeaders to handle header logic\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: headers,\n        keyColumns: deduplicateBy || [],\n        logger,\n      });\n\n      currentHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n\n      // Map data rows to match current header order\n      processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n    }\n\n    // Append rows with optional deduplication\n    // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n    const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n    const appendResult = await appendRows(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      keySet: existingKeySet,\n      keyColumns: effectiveKeyColumns,\n      header: currentHeaders,\n      logger,\n    });\n\n    rowsSkipped = appendResult.rowsSkipped || 0;\n    // Only count data rows, not headers - headers are metadata, not items\n    const updatedRows = appendResult.updatedRows || 0;\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n    logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped, // Always include rowsSkipped, even when 0\n      sheetUrl,\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.rows.append error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error appending rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","processedRows","currentHeaders","existingKeySet","headerResult","effectiveKeyColumns","appendResult","error","message","info","rowCount","length","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","Set","ensureTabAndHeaders","requiredHeader","keyColumns","header","keySet","mapRowsToHeader","canonical","appendRows","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  rows: z\n    .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n    .min(1)\n    .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n  headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n  deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',\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, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Smart header handling and data processing\n    let processedRows = rows;\n    let currentHeaders: string[] = [];\n    let rowsSkipped = 0;\n    let existingKeySet: Set<string> = new Set();\n\n    if (headers && headers.length > 0) {\n      // Use ensureTabAndHeaders to handle header logic\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: headers,\n        keyColumns: deduplicateBy || [],\n        logger,\n      });\n\n      currentHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n\n      // Map data rows to match current header order\n      processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n    }\n\n    // Append rows with optional deduplication\n    // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n    const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n    const appendResult = await appendRows(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      keySet: existingKeySet,\n      keyColumns: effectiveKeyColumns,\n      header: currentHeaders,\n      logger,\n    });\n\n    rowsSkipped = appendResult.rowsSkipped || 0;\n    // Only count data rows, not headers - headers are metadata, not items\n    const updatedRows = appendResult.updatedRows || 0;\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n    logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped, // Always include rowsSkipped, even when 0\n      sheetUrl,\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.rows.append error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","processedRows","currentHeaders","existingKeySet","headerResult","effectiveKeyColumns","appendResult","error","message","info","rowCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","Set","ensureTabAndHeaders","requiredHeader","keyColumns","header","keySet","mapRowsToHeader","canonical","appendRows","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/rows-csv-append.d.cts

@@ -1,6 +1,6 @@
 /** Import CSV data to Google Sheets with database-style row append and deduplication */
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-csv-append.d.ts

@@ -1,6 +1,6 @@
 /** Import CSV data to Google Sheets with database-style row append and deduplication */
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-csv-append.js

@@ -8,11 +8,12 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _sheets = require("@googleapis/sheets");
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
+var _server = require("@mcp-z/server");
 var _csvparse = require("csv-parse");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
+var _googleauthts = require("../../lib/google-auth.js");
 var _indexts = require("../../schemas/index.js");
 var _csvstreamingts = require("../../spreadsheet/csv-streaming.js");
 var _deduplicationutilsts = require("../../spreadsheet/deduplication-utils.js");
@@ -329,7 +330,7 @@ function handler(_0, _1) {
                         26
                     ]);
                     if (headerMap.length === 0) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'headerMap cannot be empty');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');
                     }
                     // Validate: if sourceHasHeaders=false, all references must be numeric
                     if (!sourceHasHeaders) {
@@ -338,10 +339,10 @@ function handler(_0, _1) {
                             for(_iterator = headerMap[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
                                 _step_value = _step.value, source = _step_value.source, target = _step_value.target;
                                 if (typeof source === 'string') {
-                                    throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string source: "'.concat(source, '"'));
+                                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string source: "'.concat(source, '"'));
                                 }
                                 if (typeof target === 'string') {
-                                    throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string target: "'.concat(target, '"'));
+                                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices. Got string target: "'.concat(target, '"'));
                                 }
                             }
                         } catch (err) {
@@ -364,7 +365,7 @@ function handler(_0, _1) {
                                 for(_iterator1 = deduplicateBy[Symbol.iterator](); !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
                                     colRef = _step1.value;
                                     if (typeof colRef === 'string') {
-                                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "'.concat(colRef, '"'));
+                                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "'.concat(colRef, '"'));
                                     }
                                 }
                             } catch (err) {
@@ -383,9 +384,9 @@ function handler(_0, _1) {
                             }
                         }
                     }
-                    sheets = _googleapis.google.sheets({
+                    sheets = (0, _sheets.sheets)({
                         version: 'v4',
-                        auth: extra.authContext.auth
+                        auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });
                     return [
                         4,
@@ -401,7 +402,7 @@ function handler(_0, _1) {
                         return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
                     });
                     if (!sheet) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Sheet not found');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'Sheet not found');
                     }
                     sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
                     // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)
@@ -842,7 +843,7 @@ function handler(_0, _1) {
                     logger.error('sheets.rows.csv-append error', {
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error appending CSV rows: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error appending CSV rows: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 26:

package/dist/cjs/mcp/tools/rows-csv-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and 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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n  source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n  target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\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  sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n  headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n  deduplicateBy: z\n    .array(z.union([z.string(), z.number().int().min(0)]))\n    .optional()\n    .describe('Sheet columns for deduplication (names or indices)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\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/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n  // If number, use directly as 0-based index\n  if (typeof ref === 'number') {\n    if (ref < 0) {\n      throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n    }\n    return ref;\n  }\n\n  // If string, must be header name\n  if (!sourceHasHeaders || !headers) {\n    throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n  }\n\n  const index = headers.indexOf(ref);\n  if (index === -1) {\n    throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n  }\n\n  return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n  try {\n    if (headerMap.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');\n    }\n\n    // Validate: if sourceHasHeaders=false, all references must be numeric\n    if (!sourceHasHeaders) {\n      for (const { source, target } of headerMap) {\n        if (typeof source === 'string') {\n          throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n        }\n        if (typeof target === 'string') {\n          throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n        }\n      }\n      if (deduplicateBy) {\n        for (const colRef of deduplicateBy) {\n          if (typeof colRef === 'string') {\n            throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n          }\n        }\n      }\n    }\n\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n    let sheetHeaders: string[] | null = null;\n    let existingKeySet: Set<string> = new Set();\n    const keyColumns: (string | number)[] = deduplicateBy || [];\n\n    if (sourceHasHeaders) {\n      // Extract target header names from headerMap\n      const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n      // Use ensureTabAndHeaders to setup headers and fetch existing keys\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n        keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n        logger,\n      });\n\n      sheetHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n    } else {\n      // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n      if (deduplicateBy && deduplicateBy.length > 0) {\n        // Read data in chunks for memory efficiency with large sheets\n        const CHUNK_SIZE = 1000;\n        let startRow = 1;\n        let hasMore = true;\n\n        while (hasMore) {\n          const endRow = startRow + CHUNK_SIZE - 1;\n          const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n          const response = await sheets.spreadsheets.values.get({\n            spreadsheetId: id,\n            range: chunkRange,\n          });\n\n          const rows = response.data.values || [];\n\n          for (const row of rows) {\n            const key = buildDeduplicationKey(row, keyColumns, null, false);\n            if (key.replace(/::/g, '') !== '') {\n              existingKeySet.add(key);\n            }\n          }\n\n          // Check if there are more rows to read\n          if (rows.length < CHUNK_SIZE) {\n            hasMore = false;\n          } else {\n            startRow += CHUNK_SIZE;\n          }\n        }\n\n        logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n      }\n    }\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] | null = null;\n    let batch: (string | number | boolean | null)[][] = [];\n    let totalRows = 0;\n    let rowsSkipped = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser\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    // Helper to append batch to Sheets\n    const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n      if (rows.length === 0) return;\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId: id,\n        range: `${sheetTitle}!A:A`,\n        valueInputOption: 'USER_ENTERED',\n        requestBody: { values: rows, majorDimension: 'ROWS' },\n      });\n\n      logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n    };\n\n    // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n    let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n    // Stream and process records\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders === null) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n          // Resolve headerMap now that we have both source and sheet headers\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        // Map source record to sheet row\n        const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceRow) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key); // Add to set for future deduplication\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      } else {\n        // sourceHasHeaders=false: record is an array (not an object)\n        // Resolve map on first row\n        if (resolvedMap.length === 0) {\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        const sourceRow = record as unknown[];\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceIdx < sourceRow.length) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key);\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      }\n\n      // Append batch when full\n      if (batch.length >= BATCH_SIZE) {\n        await appendBatch(batch);\n        batch = []; // Clear batch\n      }\n    }\n\n    // Flush remaining rows\n    if (batch.length > 0) {\n      await appendBatch(batch);\n    }\n\n    logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n    const updatedRows = totalRows;\n\n    logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.rows.csv-append error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-csv-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","HeaderMapItemSchema","z","object","source","union","string","number","int","min","describe","target","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","spreadsheetResponse","sheet","colRef","sheets","sheetHeaders","existingKeySet","keyColumns","targetHeaderNames","headerResult","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","rows","row","key","sourceHeaders","batch","totalRows","readStream","parser","appendBatch","resolvedMap","error","message","info","length","McpError","ErrorCode","InvalidParams","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","Set","map","filter","t","ensureTabAndHeaders","requiredHeader","k","header","keySet","values","range","buildDeduplicationKey","replace","add","keyCount","size","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","append","valueInputOption","requestBody","majorDimension","batchSize","record","Math","sourceRow","maxTargetIdx","sheetRow","sourceIdx","targetIdx","Object","keys","h","max","m","Array","fill","has","push","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and deduplication */\n\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n  source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n  target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\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  sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n  headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n  deduplicateBy: z\n    .array(z.union([z.string(), z.number().int().min(0)]))\n    .optional()\n    .describe('Sheet columns for deduplication (names or indices)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\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/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n  // If number, use directly as 0-based index\n  if (typeof ref === 'number') {\n    if (ref < 0) {\n      throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n    }\n    return ref;\n  }\n\n  // If string, must be header name\n  if (!sourceHasHeaders || !headers) {\n    throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n  }\n\n  const index = headers.indexOf(ref);\n  if (index === -1) {\n    throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n  }\n\n  return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n  try {\n    if (headerMap.length === 0) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');\n    }\n\n    // Validate: if sourceHasHeaders=false, all references must be numeric\n    if (!sourceHasHeaders) {\n      for (const { source, target } of headerMap) {\n        if (typeof source === 'string') {\n          throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n        }\n        if (typeof target === 'string') {\n          throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n        }\n      }\n      if (deduplicateBy) {\n        for (const colRef of deduplicateBy) {\n          if (typeof colRef === 'string') {\n            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n          }\n        }\n      }\n    }\n\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n    let sheetHeaders: string[] | null = null;\n    let existingKeySet: Set<string> = new Set();\n    const keyColumns: (string | number)[] = deduplicateBy || [];\n\n    if (sourceHasHeaders) {\n      // Extract target header names from headerMap\n      const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n      // Use ensureTabAndHeaders to setup headers and fetch existing keys\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n        keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n        logger,\n      });\n\n      sheetHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n    } else {\n      // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n      if (deduplicateBy && deduplicateBy.length > 0) {\n        // Read data in chunks for memory efficiency with large sheets\n        const CHUNK_SIZE = 1000;\n        let startRow = 1;\n        let hasMore = true;\n\n        while (hasMore) {\n          const endRow = startRow + CHUNK_SIZE - 1;\n          const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n          const response = await sheets.spreadsheets.values.get({\n            spreadsheetId: id,\n            range: chunkRange,\n          });\n\n          const rows = response.data.values || [];\n\n          for (const row of rows) {\n            const key = buildDeduplicationKey(row, keyColumns, null, false);\n            if (key.replace(/::/g, '') !== '') {\n              existingKeySet.add(key);\n            }\n          }\n\n          // Check if there are more rows to read\n          if (rows.length < CHUNK_SIZE) {\n            hasMore = false;\n          } else {\n            startRow += CHUNK_SIZE;\n          }\n        }\n\n        logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n      }\n    }\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] | null = null;\n    let batch: (string | number | boolean | null)[][] = [];\n    let totalRows = 0;\n    let rowsSkipped = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser\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    // Helper to append batch to Sheets\n    const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n      if (rows.length === 0) return;\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId: id,\n        range: `${sheetTitle}!A:A`,\n        valueInputOption: 'USER_ENTERED',\n        requestBody: { values: rows, majorDimension: 'ROWS' },\n      });\n\n      logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n    };\n\n    // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n    let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n    // Stream and process records\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders === null) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n          // Resolve headerMap now that we have both source and sheet headers\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        // Map source record to sheet row\n        const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceRow) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key); // Add to set for future deduplication\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      } else {\n        // sourceHasHeaders=false: record is an array (not an object)\n        // Resolve map on first row\n        if (resolvedMap.length === 0) {\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        const sourceRow = record as unknown[];\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceIdx < sourceRow.length) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key);\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      }\n\n      // Append batch when full\n      if (batch.length >= BATCH_SIZE) {\n        await appendBatch(batch);\n        batch = []; // Clear batch\n      }\n    }\n\n    // Flush remaining rows\n    if (batch.length > 0) {\n      await appendBatch(batch);\n    }\n\n    logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n    const updatedRows = totalRows;\n\n    logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.rows.csv-append error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-csv-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","HeaderMapItemSchema","z","object","source","union","string","number","int","min","describe","target","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","spreadsheetResponse","sheet","colRef","sheets","sheetHeaders","existingKeySet","keyColumns","targetHeaderNames","headerResult","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","rows","row","key","sourceHeaders","batch","totalRows","readStream","parser","appendBatch","resolvedMap","error","message","info","length","ProtocolError","ProtocolErrorCode","InvalidParams","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","Set","map","filter","t","ensureTabAndHeaders","requiredHeader","k","header","keySet","values","range","buildDeduplicationKey","replace","add","keyCount","size","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","append","valueInputOption","requestBody","majorDimension","batchSize","record","Math","sourceRow","maxTargetIdx","sheetRow","sourceIdx","targetIdx","Object","keys","h","max","m","Array","fill","has","push","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/rows-get.d.cts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-get.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/cjs/mcp/tools/rows-get.js

@@ -8,10 +8,11 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _sheets = require("@googleapis/sheets");
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
-var _googleapis = require("googleapis");
+var _server = require("@mcp-z/server");
 var _zod = require("zod");
+var _googleauthts = require("../../lib/google-auth.js");
 var _indexts = require("../../schemas/index.js");
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -195,9 +196,9 @@ function handler(_0, _1) {
                         ,
                         5
                     ]);
-                    sheets = _googleapis.google.sheets({
+                    sheets = (0, _sheets.sheets)({
                         version: 'v4',
-                        auth: extra.authContext.auth
+                        auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });
                     return [
                         4,
@@ -218,7 +219,7 @@ function handler(_0, _1) {
                             gid: gid,
                             range: range
                         });
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
                     // Construct full range with sheet title
@@ -266,8 +267,8 @@ function handler(_0, _1) {
                     logger.error('sheets.rows.get error', {
                         error: message
                     });
-                    // Throw McpError for proper MCP error handling
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error getting rows: ".concat(message), {
+                    // Throw ProtocolError for proper MCP error handling
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error getting rows: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 5:

package/dist/cjs/mcp/tools/rows-get.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-get.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 { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  range: z.string().describe('The A1 notation range that was retrieved'),\n  rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.get called', { id, gid, range, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid to get sheet title\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\n    if (!sheet) {\n      logger.info('sheets.rows.get sheet not found', { id, gid, range });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Construct full range with sheet title\n    const fullRange = `${sheetTitle}!${range}`;\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const res = response.data;\n    const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      range: res.range || fullRange,\n      rows,\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.rows.get error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","fullRange","response","res","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","values","valueRenderOption","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-get.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  range: z.string().describe('The A1 notation range that was retrieved'),\n  rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.get called', { id, gid, range, render });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get sheet details using the gid to get sheet title\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\n    if (!sheet) {\n      logger.info('sheets.rows.get sheet not found', { id, gid, range });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Construct full range with sheet title\n    const fullRange = `${sheetTitle}!${range}`;\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const res = response.data;\n    const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      range: res.range || fullRange,\n      rows,\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.rows.get error', { error: message });\n\n    // Throw ProtocolError for proper MCP error handling\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","fullRange","response","res","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","values","valueRenderOption","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/sheet-copy-to.d.cts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     sourceId: z.ZodString;

package/dist/cjs/mcp/tools/sheet-copy-to.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     sourceId: z.ZodString;