@mcp-z/mcp-sheets 2.5.1 → 2.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/README.md +1 -1
  2. package/dist/cjs/lib/create-store.d.cts +2 -1
  3. package/dist/cjs/lib/create-store.d.ts +2 -1
  4. package/dist/cjs/lib/create-store.js +82 -7
  5. package/dist/cjs/lib/create-store.js.map +1 -1
  6. package/dist/cjs/mcp/tools/columns-update.js +5 -1
  7. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  8. package/dist/cjs/mcp/tools/csv-get-columns.js +1 -1
  9. package/dist/cjs/mcp/tools/lib/dimension-operations.js +1 -1
  10. package/dist/cjs/mcp/tools/rows-append.js +1 -2
  11. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  12. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -3
  13. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  14. package/dist/cjs/setup/http.js +1 -1
  15. package/dist/cjs/setup/runtime.d.cts +2 -2
  16. package/dist/cjs/setup/runtime.d.ts +2 -2
  17. package/dist/cjs/setup/runtime.js +6 -6
  18. package/dist/cjs/setup/runtime.js.map +1 -1
  19. package/dist/cjs/setup/stdio.js +1 -1
  20. package/dist/cjs/spreadsheet/data-operations.d.cts +8 -1
  21. package/dist/cjs/spreadsheet/data-operations.d.ts +8 -1
  22. package/dist/cjs/spreadsheet/data-operations.js +80 -102
  23. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  24. package/dist/cjs/spreadsheet/markdown-runs.js +1 -1
  25. package/dist/cjs/spreadsheet/range-operations.d.cts +0 -67
  26. package/dist/cjs/spreadsheet/range-operations.d.ts +0 -67
  27. package/dist/cjs/spreadsheet/range-operations.js +1 -237
  28. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  29. package/dist/cjs/spreadsheet/sheet-operations.d.cts +4 -17
  30. package/dist/cjs/spreadsheet/sheet-operations.d.ts +4 -17
  31. package/dist/cjs/spreadsheet/sheet-operations.js +18 -222
  32. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  33. package/dist/esm/lib/create-store.d.ts +2 -1
  34. package/dist/esm/lib/create-store.js +22 -4
  35. package/dist/esm/lib/create-store.js.map +1 -1
  36. package/dist/esm/mcp/tools/columns-update.js +5 -1
  37. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  38. package/dist/esm/mcp/tools/rows-append.js +1 -2
  39. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  40. package/dist/esm/mcp/tools/rows-csv-append.js +1 -2
  41. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  42. package/dist/esm/setup/runtime.d.ts +2 -2
  43. package/dist/esm/setup/runtime.js +6 -6
  44. package/dist/esm/setup/runtime.js.map +1 -1
  45. package/dist/esm/spreadsheet/data-operations.d.ts +8 -1
  46. package/dist/esm/spreadsheet/data-operations.js +27 -35
  47. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  48. package/dist/esm/spreadsheet/range-operations.d.ts +0 -67
  49. package/dist/esm/spreadsheet/range-operations.js +0 -227
  50. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  51. package/dist/esm/spreadsheet/sheet-operations.d.ts +4 -17
  52. package/dist/esm/spreadsheet/sheet-operations.js +7 -115
  53. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  54. package/package.json +7 -7
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.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 { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\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.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\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 updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\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 updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\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.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.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 { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { allWritesFailed, generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\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.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\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 updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n if (allWritesFailed(upsertResult)) {\n throw new Error(`every write failed: ${upsertResult.errors?.join('; ')}`);\n }\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\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 updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\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.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","allWritesFailed","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","Error","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -80,8 +80,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
80
80
  spreadsheetId: id,
81
81
  sheetTitle,
82
82
  requiredHeader: headers,
83
- keyColumns: deduplicateBy || [],
84
- logger
83
+ keyColumns: deduplicateBy || []
85
84
  });
86
85
  currentHeaders = headerResult.header;
87
86
  existingKeySet = headerResult.keySet;
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/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 { NATIVE_DATE_POINTER } from '../../constants.ts';\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. Values are always written RAW (no parsing), so a date string stays text; write numeric serials and then apply a date format with cells-format. ${NATIVE_DATE_POINTER}`,\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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/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 { NATIVE_DATE_POINTER } from '../../constants.ts';\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. Values are always written RAW (no parsing), so a date string stays text; write numeric serials and then apply a date format with cells-format. ${NATIVE_DATE_POINTER}`,\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 });\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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -140,8 +140,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
140
140
  spreadsheetId: id,
141
141
  sheetTitle,
142
142
  requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,
143
- keyColumns: keyColumns.filter((k)=>typeof k === 'string'),
144
- logger
143
+ keyColumns: keyColumns.filter((k)=>typeof k === 'string')
145
144
  });
146
145
  sheetHeaders = headerResult.header;
147
146
  existingKeySet = headerResult.keySet;
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/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 { NATIVE_DATE_POINTER } from '../../constants.ts';\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. Rows are always appended USER_ENTERED, so date-looking CSV text may be parsed as native dates per the workbook locale; read back with UNFORMATTED_VALUE to confirm. ${NATIVE_DATE_POINTER}`,\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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/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 { NATIVE_DATE_POINTER } from '../../constants.ts';\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. Rows are always appended USER_ENTERED, so date-looking CSV text may be parsed as native dates per the workbook locale; read back with UNFORMATTED_VALUE to confirm. ${NATIVE_DATE_POINTER}`,\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 });\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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -3,8 +3,8 @@ import type { Logger, MiddlewareLayer } from '@mcp-z/server';
3
3
  import type { CommonRuntime, RuntimeOverrides, ServerConfig } from '../types.js';
4
4
  import { type OAuthAdapters } from './oauth-google.js';
5
5
  export declare function createLogger(config: ServerConfig): Logger;
6
- export declare function createTokenStore(baseDir: string): Promise<import("keyv").Keyv<CachedToken>>;
7
- export declare function createDcrStore(baseDir: string, required: boolean): Promise<import("keyv").Keyv<unknown> | undefined>;
6
+ export declare function createTokenStore(baseDir: string, logger?: Logger): Promise<import("keyv").Keyv<CachedToken>>;
7
+ export declare function createDcrStore(baseDir: string, required: boolean, logger?: Logger): Promise<import("keyv").Keyv<unknown> | undefined>;
8
8
  export declare function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer;
9
9
  export declare function createLoggingLayer(logger: Logger): MiddlewareLayer;
10
10
  export declare function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime>;
@@ -22,14 +22,14 @@ export function createLogger(config) {
22
22
  sync: false
23
23
  }) : pino.destination(1));
24
24
  }
25
- export async function createTokenStore(baseDir) {
25
+ export async function createTokenStore(baseDir, logger) {
26
26
  const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;
27
- return createStore(tokenStoreUri);
27
+ return createStore(tokenStoreUri, logger);
28
28
  }
29
- export async function createDcrStore(baseDir, required) {
29
+ export async function createDcrStore(baseDir, required, logger) {
30
30
  if (!required) return undefined;
31
31
  const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;
32
- return createStore(dcrStoreUri);
32
+ return createStore(dcrStoreUri, logger);
33
33
  }
34
34
  export function createAuthLayer(authMiddleware) {
35
35
  return {
@@ -52,9 +52,9 @@ export async function createDefaultRuntime(config, overrides) {
52
52
  var _config_baseUrl, _ref, _ref1;
53
53
  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');
54
54
  const logger = createLogger(config);
55
- const tokenStore = await createTokenStore(config.baseDir);
55
+ const tokenStore = await createTokenStore(config.baseDir, logger);
56
56
  const baseUrl = (_config_baseUrl = config.baseUrl) !== null && _config_baseUrl !== void 0 ? _config_baseUrl : config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined;
57
- const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');
57
+ const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr', logger);
58
58
  const oauthAdapters = await createOAuthAdapters(config, {
59
59
  logger,
60
60
  tokenStore,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/runtime.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n const hasStdio = config.transport.type === 'stdio';\n const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;\n return createStore<CachedToken>(tokenStoreUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n if (!required) return undefined;\n const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;\n return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n return {\n withTool: authMiddleware.withToolAuth,\n withResource: authMiddleware.withResourceAuth,\n withPrompt: authMiddleware.withPromptAuth,\n };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n const logging = createLoggingMiddleware({ logger });\n return {\n withTool: logging.withToolLogging,\n withResource: logging.withResourceLogging,\n withPrompt: logging.withPromptLogging,\n };\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n const logger = createLogger(config);\n const tokenStore = await createTokenStore(config.baseDir);\n const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n const createDomainModules =\n overrides?.createDomainModules ??\n (() => ({\n tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n }));\n const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger)];\n\n return {\n deps,\n middlewareFactories,\n createDomainModules,\n close: async () => {},\n };\n}\n"],"names":["pathToFileURL","sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","tokenStoreUri","process","env","TOKEN_STORE_URI","href","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createDefaultRuntime","overrides","auth","Error","tokenStore","baseUrl","port","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/runtime.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n const hasStdio = config.transport.type === 'stdio';\n const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string, logger?: Logger) {\n const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;\n return createStore<CachedToken>(tokenStoreUri, logger);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean, logger?: Logger) {\n if (!required) return undefined;\n const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;\n return createStore<unknown>(dcrStoreUri, logger);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n return {\n withTool: authMiddleware.withToolAuth,\n withResource: authMiddleware.withResourceAuth,\n withPrompt: authMiddleware.withPromptAuth,\n };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n const logging = createLoggingMiddleware({ logger });\n return {\n withTool: logging.withToolLogging,\n withResource: logging.withResourceLogging,\n withPrompt: logging.withPromptLogging,\n };\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n const logger = createLogger(config);\n const tokenStore = await createTokenStore(config.baseDir, logger);\n const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr', logger);\n const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n const createDomainModules =\n overrides?.createDomainModules ??\n (() => ({\n tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n }));\n const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger)];\n\n return {\n deps,\n middlewareFactories,\n createDomainModules,\n close: async () => {},\n };\n}\n"],"names":["pathToFileURL","sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","logger","tokenStoreUri","process","env","TOKEN_STORE_URI","href","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logging","withToolLogging","withResourceLogging","withPromptLogging","createDefaultRuntime","overrides","auth","Error","tokenStore","baseUrl","port","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,2BAA2B,QAAQ,eAAe;AAG3D,SAASC,uBAAuB,QAAQ,gBAAgB;AACxD,YAAYC,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAC7B,OAAOC,UAAU,OAAO;AACxB,OAAOC,iBAAiB,yBAAyB;AACjD,YAAYC,SAAS,kBAAkB;AAEvC,SAASC,mBAAmB,QAA4B,oBAAoB;AAE5E,OAAO,SAASC,aAAaC,MAAoB;QAI1BA;IAHrB,MAAMC,WAAWD,OAAOE,SAAS,CAACC,IAAI,KAAK;IAC3C,MAAMC,WAAWV,KAAKW,IAAI,CAACL,OAAOM,OAAO,EAAE,QAAQ,GAAGN,OAAOO,IAAI,CAAC,IAAI,CAAC;IACvE,IAAIN,UAAUR,GAAGe,SAAS,CAACd,KAAKe,OAAO,CAACL,WAAW;QAAEM,WAAW;IAAK;IACrE,OAAOf,KAAK;QAAEgB,KAAK,GAAEX,mBAAAA,OAAOY,QAAQ,cAAfZ,8BAAAA,mBAAmB;QAAQa,YAAYtB;IAA8B,GAAGU,WAAWN,KAAKmB,WAAW,CAAC;QAAEC,MAAMX;QAAUY,MAAM;IAAM,KAAKrB,KAAKmB,WAAW,CAAC;AAC/K;AAEA,OAAO,eAAeG,iBAAiBX,OAAe,EAAEY,MAAe;IACrE,MAAMC,gBAAgBC,QAAQC,GAAG,CAACC,eAAe,IAAIhC,cAAcI,KAAKW,IAAI,CAACC,SAAS,gBAAgBiB,IAAI;IAC1G,OAAO3B,YAAyBuB,eAAeD;AACjD;AAEA,OAAO,eAAeM,eAAelB,OAAe,EAAEmB,QAAiB,EAAEP,MAAe;IACtF,IAAI,CAACO,UAAU,OAAOC;IACtB,MAAMC,cAAcP,QAAQC,GAAG,CAACO,aAAa,IAAItC,cAAcI,KAAKW,IAAI,CAACC,SAAS,aAAaiB,IAAI;IACnG,OAAO3B,YAAqB+B,aAAaT;AAC3C;AAEA,OAAO,SAASW,gBAAgBC,cAA2C;IACzE,OAAO;QACLC,UAAUD,eAAeE,YAAY;QACrCC,cAAcH,eAAeI,gBAAgB;QAC7CC,YAAYL,eAAeM,cAAc;IAC3C;AACF;AAEA,OAAO,SAASC,mBAAmBnB,MAAc;IAC/C,MAAMoB,UAAU9C,wBAAwB;QAAE0B;IAAO;IACjD,OAAO;QACLa,UAAUO,QAAQC,eAAe;QACjCN,cAAcK,QAAQE,mBAAmB;QACzCL,YAAYG,QAAQG,iBAAiB;IACvC;AACF;AAEA,OAAO,eAAeC,qBAAqB1C,MAAoB,EAAE2C,SAA4B;QAK3E3C;IAJhB,IAAIA,OAAO4C,IAAI,KAAK,SAAS5C,OAAOE,SAAS,CAACC,IAAI,KAAK,QAAQ,MAAM,IAAI0C,MAAM;IAE/E,MAAM3B,SAASnB,aAAaC;IAC5B,MAAM8C,aAAa,MAAM7B,iBAAiBjB,OAAOM,OAAO,EAAEY;IAC1D,MAAM6B,WAAU/C,kBAAAA,OAAO+C,OAAO,cAAd/C,6BAAAA,kBAAmBA,OAAOE,SAAS,CAACC,IAAI,KAAK,UAAUH,OAAOE,SAAS,CAAC8C,IAAI,GAAG,CAAC,iBAAiB,EAAEhD,OAAOE,SAAS,CAAC8C,IAAI,EAAE,GAAGtB;IAC7I,MAAMuB,WAAW,MAAMzB,eAAexB,OAAOM,OAAO,EAAEN,OAAO4C,IAAI,KAAK,OAAO1B;IAC7E,MAAMgC,gBAAgB,MAAMpD,oBAAoBE,QAAQ;QAAEkB;QAAQ4B;QAAYG;IAAS,GAAGF;IAC1F,MAAMI,OAAoB;QAAEnD;QAAQkB;QAAQ4B;QAAYI;QAAeH;IAAQ;IAC/E,MAAMK,8BACJT,sBAAAA,gCAAAA,UAAWS,mBAAmB,uCAC7B,IAAO,CAAA;YACNC,OAAOC,OAAOC,MAAM,CAAC1D,IAAI2D,aAAa,EAAEC,GAAG,CAAC,CAACC,UAAYA;YACzDC,WAAWL,OAAOC,MAAM,CAAC1D,IAAI+D,iBAAiB,EAAEH,GAAG,CAAC,CAACC,UAAYA;YACjEG,SAASP,OAAOC,MAAM,CAAC1D,IAAIiE,eAAe,EAAEL,GAAG,CAAC,CAACC,UAAYA;QAC/D,CAAA;IACF,MAAMK,+BAAsBpB,sBAAAA,gCAAAA,UAAWoB,mBAAmB,yCAAI;QAAC,IAAMlC,gBAAgBqB,cAAcc,UAAU;QAAG,IAAM3B,mBAAmBnB;KAAQ;IAEjJ,OAAO;QACLiC;QACAY;QACAX;QACAa,OAAO,WAAa;IACtB;AACF"}
@@ -94,8 +94,15 @@ export declare function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets,
94
94
  * Partitions data into updates vs appends based on existing keys with row position tracking
95
95
  */
96
96
  export declare function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates?: boolean, keyToRowMap?: Map<string, number>): DataPartition;
97
+ /** values.batchUpdate body writing each row to its A1 range on the named tab, so the tab is addressed by title and valueInputOption applies. */
98
+ export declare function buildRowUpdateBody(sheetTitle: string, updates: Array<{
99
+ row: Row;
100
+ existingRowIndex: number;
101
+ }>, columnCount: number, valueInputOption: 'RAW' | 'USER_ENTERED'): sheets_v4.Schema$BatchUpdateValuesRequest;
102
+ /** True when the call tried writes and none landed: only errors, no updated or inserted rows. */
103
+ export declare function allWritesFailed(result: BatchOperationResult): boolean;
97
104
  /**
98
- * Performs batch updates on existing rows using batchUpdate API
105
+ * Performs batch updates on existing rows using values.batchUpdate with A1 ranges
99
106
  */
100
107
  export declare function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{
101
108
  row: Row;
@@ -464,8 +464,28 @@ export async function snapshotHeaderAndKeys(sheets, spreadsheetId, sheetTitle, k
464
464
  skippedKeys
465
465
  };
466
466
  }
467
+ /** A1 range covering one whole row of the table; the title is quoted so tab names with spaces or punctuation resolve. */ function rowRange(sheetTitle, rowNumber, columnCount) {
468
+ return `'${sheetTitle.replace(/'/g, "''")}'!A${rowNumber}:${a1Col(columnCount)}${rowNumber}`;
469
+ }
470
+ /** values.batchUpdate body writing each row to its A1 range on the named tab, so the tab is addressed by title and valueInputOption applies. */ export function buildRowUpdateBody(sheetTitle, updates, columnCount, valueInputOption) {
471
+ return {
472
+ valueInputOption,
473
+ data: updates.map(({ row, existingRowIndex })=>({
474
+ range: rowRange(sheetTitle, existingRowIndex, columnCount),
475
+ majorDimension: 'ROWS',
476
+ values: [
477
+ row
478
+ ]
479
+ }))
480
+ };
481
+ }
482
+ /** True when the call tried writes and none landed: only errors, no updated or inserted rows. */ export function allWritesFailed(result) {
483
+ var _ref;
484
+ var _result_errors;
485
+ return ((_ref = (_result_errors = result.errors) === null || _result_errors === void 0 ? void 0 : _result_errors.length) !== null && _ref !== void 0 ? _ref : 0) > 0 && result.updatedRows === 0 && result.inserted.length === 0;
486
+ }
467
487
  /**
468
- * Performs batch updates on existing rows using batchUpdate API
488
+ * Performs batch updates on existing rows using values.batchUpdate with A1 ranges
469
489
  */ export async function performBatchUpdates(sheets, spreadsheetId, sheetTitle, updates, header, batchSize, valueInputOption) {
470
490
  const errors = [];
471
491
  let totalUpdated = 0;
@@ -473,46 +493,18 @@ export async function snapshotHeaderAndKeys(sheets, spreadsheetId, sheetTitle, k
473
493
  for(let i = 0; i < updates.length; i += batchSize){
474
494
  const batch = updates.slice(i, i + batchSize);
475
495
  try {
476
- const requests = [];
477
- for (const { row, existingRowIndex } of batch){
478
- requests.push({
479
- updateCells: {
480
- range: {
481
- sheetId: 0,
482
- startRowIndex: existingRowIndex - 1,
483
- endRowIndex: existingRowIndex,
484
- startColumnIndex: 0,
485
- endColumnIndex: header.length
486
- },
487
- rows: [
488
- {
489
- values: row.map((cellValue)=>({
490
- userEnteredValue: {
491
- stringValue: String(cellValue !== null && cellValue !== void 0 ? cellValue : '')
492
- }
493
- }))
494
- }
495
- ],
496
- fields: 'userEnteredValue'
497
- }
498
- });
499
- }
500
- if (requests.length > 0) {
501
- await sheets.spreadsheets.batchUpdate({
502
- spreadsheetId,
503
- requestBody: {
504
- requests
505
- }
506
- });
507
- totalUpdated += batch.length;
508
- }
496
+ await sheets.spreadsheets.values.batchUpdate({
497
+ spreadsheetId,
498
+ requestBody: buildRowUpdateBody(sheetTitle, batch, header.length, valueInputOption)
499
+ });
500
+ totalUpdated += batch.length;
509
501
  } catch (error) {
510
502
  const errorMsg = `Batch update ${Math.floor(i / batchSize) + 1} failed: ${error instanceof Error ? error.message : String(error)}`;
511
503
  errors.push(errorMsg);
512
504
  // Try individual updates for failed batches
513
505
  for (const { row, existingRowIndex } of batch){
514
506
  try {
515
- const range = `${sheetTitle}!A${existingRowIndex}:${a1Col(header.length)}${existingRowIndex}`;
507
+ const range = rowRange(sheetTitle, existingRowIndex, header.length);
516
508
  await sheets.spreadsheets.values.update({
517
509
  spreadsheetId,
518
510
  range,