@mcp-z/mcp-sheets 2.1.0 → 2.1.1

package/dist/cjs/mcp/tools/values-replace.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\n      const spreadsheetResponse = await sheets.spreadsheets.get({\n        spreadsheetId: id,\n        fields: 'sheets.properties.sheetId,sheets.properties.title',\n      });\n\n      const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n      if (!sheet) {\n        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","googleAuth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\n      const spreadsheetResponse = await sheets.spreadsheets.get({\n        spreadsheetId: id,\n        fields: 'sheets.properties.sheetId,sheets.properties.title',\n      });\n\n      const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n      if (!sheet) {\n        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","sheetsApi","version","auth","googleAuth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/values-search.js

@@ -8,9 +8,9 @@ Object.defineProperty(exports, "default", {
         return createTool;
     }
 });
+var _sheets = require("@googleapis/sheets");
 var _oauthgoogle = require("@mcp-z/oauth-google");
 var _server = require("@mcp-z/server");
-var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _googleauthts = require("../../lib/google-auth.js");
 var _indexts = require("../../schemas/index.js");
@@ -247,7 +247,7 @@ function handler(_0, _1) {
                         ,
                         5
                     ]);
-                    sheets = _googleapis.google.sheets({
+                    sheets = (0, _sheets.sheets)({
                         version: 'v4',
                         auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
                     });

package/dist/cjs/mcp/tools/values-search.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n  let letter = '';\n  let num = index + 1;\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor((num - 1) / 26);\n  }\n  return letter;\n}\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n  select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n  values: z.boolean().optional().describe('Include cell values in response'),\n  a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n  matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  count: z.number().int().nonnegative().describe('Number of matches found'),\n  a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n  values: z\n    .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n    .optional()\n    .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get sheet details including grid dimensions\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.values-search sheet not found', { id, gid, query });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Use actual sheet dimensions from gridProperties, with sensible defaults\n    // Google Sheets default for new sheets is 1000 rows x 26 columns\n    const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n    const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n    const endColumn = columnIndexToLetter(columnCount - 1);\n    const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n    logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n    const res = response.data;\n    const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    // Prepare query for matching (case-insensitive by default)\n    const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n    let count = 0;\n    const a1Array: string[] = [];\n    const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n    // Helper to check if a cell matches the query\n    const cellMatches = (cell: string | number | boolean | null): boolean => {\n      if (!searchQuery) return true; // If no query, match all\n      if (typeof cell !== 'string') return false;\n      const cellValue = matchCase ? cell : cell.toLowerCase();\n      return cellValue.includes(searchQuery);\n    };\n\n    if (select === 'cells') {\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        for (let colIdx = 0; colIdx < row.length; colIdx++) {\n          const cell = row[colIdx];\n          if (cellMatches(cell)) {\n            count++;\n            if (a1s) {\n              const colLetter = columnIndexToLetter(colIdx);\n              const rowNum = rowIdx + 1;\n              a1Array.push(`${colLetter}${rowNum}`);\n            }\n            if (values) {\n              valuesArray.push(cell ?? null);\n            }\n          }\n        }\n      }\n    } else if (select === 'rows') {\n      const matchingRows: number[] = [];\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        const matches = row.some((cell) => cellMatches(cell));\n        if (matches) {\n          matchingRows.push(rowIdx);\n        }\n      }\n\n      count = matchingRows.length;\n      for (const rowIdx of matchingRows) {\n        const row = allRows[rowIdx];\n        if (!row) continue; // Skip if row is undefined\n        const rowNum = rowIdx + 1;\n\n        if (a1s) {\n          const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n          a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n        }\n        if (values) {\n          valuesArray.push(row);\n        }\n      }\n    } else if (select === 'columns') {\n      const headerRow = allRows[0] || [];\n      const matchingCols: number[] = [];\n\n      for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n        const header = headerRow[colIdx];\n        if (cellMatches(header)) {\n          matchingCols.push(colIdx);\n        }\n      }\n\n      count = matchingCols.length;\n      for (const colIdx of matchingCols) {\n        const colLetter = columnIndexToLetter(colIdx);\n\n        if (a1s) {\n          a1Array.push(`${colLetter}:${colLetter}`);\n        }\n        if (values) {\n          const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n          valuesArray.push(columnValues);\n        }\n      }\n    }\n\n    logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n    const result: Output = {\n      type: 'success' as const,\n      count,\n      ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n      ...(values && valuesArray.length > 0 && { values: valuesArray }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.values-search error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n  let letter = '';\n  let num = index + 1;\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor((num - 1) / 26);\n  }\n  return letter;\n}\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n  select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n  values: z.boolean().optional().describe('Include cell values in response'),\n  a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n  matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  count: z.number().int().nonnegative().describe('Number of matches found'),\n  a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n  values: z\n    .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n    .optional()\n    .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get sheet details including grid dimensions\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.values-search sheet not found', { id, gid, query });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Use actual sheet dimensions from gridProperties, with sensible defaults\n    // Google Sheets default for new sheets is 1000 rows x 26 columns\n    const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n    const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n    const endColumn = columnIndexToLetter(columnCount - 1);\n    const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n    logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n    const res = response.data;\n    const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    // Prepare query for matching (case-insensitive by default)\n    const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n    let count = 0;\n    const a1Array: string[] = [];\n    const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n    // Helper to check if a cell matches the query\n    const cellMatches = (cell: string | number | boolean | null): boolean => {\n      if (!searchQuery) return true; // If no query, match all\n      if (typeof cell !== 'string') return false;\n      const cellValue = matchCase ? cell : cell.toLowerCase();\n      return cellValue.includes(searchQuery);\n    };\n\n    if (select === 'cells') {\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        for (let colIdx = 0; colIdx < row.length; colIdx++) {\n          const cell = row[colIdx];\n          if (cellMatches(cell)) {\n            count++;\n            if (a1s) {\n              const colLetter = columnIndexToLetter(colIdx);\n              const rowNum = rowIdx + 1;\n              a1Array.push(`${colLetter}${rowNum}`);\n            }\n            if (values) {\n              valuesArray.push(cell ?? null);\n            }\n          }\n        }\n      }\n    } else if (select === 'rows') {\n      const matchingRows: number[] = [];\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        const matches = row.some((cell) => cellMatches(cell));\n        if (matches) {\n          matchingRows.push(rowIdx);\n        }\n      }\n\n      count = matchingRows.length;\n      for (const rowIdx of matchingRows) {\n        const row = allRows[rowIdx];\n        if (!row) continue; // Skip if row is undefined\n        const rowNum = rowIdx + 1;\n\n        if (a1s) {\n          const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n          a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n        }\n        if (values) {\n          valuesArray.push(row);\n        }\n      }\n    } else if (select === 'columns') {\n      const headerRow = allRows[0] || [];\n      const matchingCols: number[] = [];\n\n      for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n        const header = headerRow[colIdx];\n        if (cellMatches(header)) {\n          matchingCols.push(colIdx);\n        }\n      }\n\n      count = matchingCols.length;\n      for (const colIdx of matchingCols) {\n        const colLetter = columnIndexToLetter(colIdx);\n\n        if (a1s) {\n          a1Array.push(`${colLetter}:${colLetter}`);\n        }\n        if (values) {\n          const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n          valuesArray.push(columnValues);\n        }\n      }\n    }\n\n    logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n    const result: Output = {\n      type: 'success' as const,\n      count,\n      ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n      ...(values && valuesArray.length > 0 && { values: valuesArray }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.values-search error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}

package/dist/cjs/spreadsheet/data-operations.d.cts

@@ -1,4 +1,4 @@
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 import type { Logger } from '../types.js';
 export type Cell = string | number | boolean | null | undefined;
 export type Row = Cell[];

package/dist/cjs/spreadsheet/data-operations.d.ts

@@ -1,4 +1,4 @@
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 import type { Logger } from '../types.js';
 export type Cell = string | number | boolean | null | undefined;
 export type Row = Cell[];

package/dist/cjs/spreadsheet/data-operations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/data-operations.ts"],"sourcesContent":["import type { sheets_v4 } from 'googleapis';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\nimport { findSheetByRef } from './sheet-operations.ts';\n\n// Core data types\nexport type Cell = string | number | boolean | null | undefined;\nexport type Row = Cell[];\n\n// Enhanced type definitions for shared data operations\nexport interface ColumnMapping {\n  canonical: string;\n  sheet: string;\n  index: number;\n}\n\nexport interface HeaderValidationResult {\n  valid: boolean;\n  missingColumns: string[];\n  extraColumns: string[];\n  mappings: ColumnMapping[];\n}\n\nexport interface KeyGenerationStrategy {\n  keyColumns: string[];\n  useProviderIdLogic: boolean;\n  separator?: string;\n}\n\nexport interface DataPartition {\n  toAppend: Row[];\n  toUpdate: Array<{ row: Row; existingRowIndex: number }>;\n  skippedKeys: string[];\n}\n\nexport interface BatchOperationResult {\n  updatedRows: number;\n  inserted: string[];\n  rowsSkipped: number;\n  errors?: string[];\n}\n\nexport interface UpsertOptions {\n  keyStrategy: KeyGenerationStrategy;\n  allowUpdates: boolean;\n  batchSize?: number;\n  valueInputOption?: 'RAW' | 'USER_ENTERED';\n}\n\nexport async function discoverHeader(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string): Promise<string[]> {\n  try {\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId,\n      range: `${sheetTitle}!1:1`,\n      majorDimension: 'ROWS',\n    });\n    return ((response.data?.values || [])[0] || []) as string[];\n  } catch {\n    return [];\n  }\n}\n\nexport function validateAndMapHeaders(sheetHeaders: string[], canonicalHeaders: string[], requiredColumns: string[] = []): HeaderValidationResult {\n  const normalizeColumn = (col: string) =>\n    String(col ?? '')\n      .toLowerCase()\n      .replace(/[^a-z0-9]/g, '');\n\n  const sheetNormalized = sheetHeaders.map(normalizeColumn);\n  const canonicalNormalized = canonicalHeaders.map(normalizeColumn);\n  const requiredNormalized = requiredColumns.map(normalizeColumn);\n\n  const mappings: ColumnMapping[] = [];\n  const missingColumns: string[] = [];\n  const extraColumns: string[] = [...sheetHeaders];\n\n  // Create mappings for canonical columns\n  canonicalHeaders.forEach((canonical, canonicalIndex) => {\n    const canonicalNorm = canonicalNormalized[canonicalIndex];\n    if (!canonicalNorm) return; // Skip if normalization resulted in empty string\n\n    let sheetIndex = sheetNormalized.indexOf(canonicalNorm);\n\n    // Special handling for 'id' -> 'messageid' mapping\n    if (sheetIndex === -1 && canonicalNorm === 'id') {\n      sheetIndex = sheetNormalized.indexOf('messageid');\n    }\n\n    if (sheetIndex !== -1) {\n      const sheetHeader = sheetHeaders[sheetIndex];\n      if (sheetHeader !== undefined) {\n        mappings.push({\n          canonical,\n          sheet: sheetHeader,\n          index: sheetIndex,\n        });\n        // Remove from extra columns\n        const extraIndex = extraColumns.indexOf(sheetHeader);\n        if (extraIndex !== -1) {\n          extraColumns.splice(extraIndex, 1);\n        }\n      }\n    } else if (requiredNormalized.includes(canonicalNorm)) {\n      missingColumns.push(canonical);\n    }\n  });\n\n  return {\n    valid: missingColumns.length === 0,\n    missingColumns,\n    extraColumns,\n    mappings,\n  };\n}\n\n/** Ensures consistent key generation across all functions */\nexport function generateRowKey(row: Row, header: string[], strategy: KeyGenerationStrategy): string {\n  const { keyColumns, useProviderIdLogic, separator = '\\\\' } = strategy;\n\n  // Normalize header for consistent lookups\n  const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n\n  if (useProviderIdLogic) {\n    const providerIndex = lowerHeader.indexOf('provider');\n    let idIndex = lowerHeader.indexOf('messageid');\n    if (idIndex === -1) idIndex = lowerHeader.indexOf('id');\n\n    if (providerIndex >= 0 && idIndex >= 0) {\n      const providerVal = String(row[providerIndex] ?? '').trim();\n      const idVal = String(row[idIndex] ?? '').trim();\n      if (providerVal || idVal) {\n        // Only return key if at least one component exists\n        return [providerVal, idVal].join(separator);\n      }\n    }\n  }\n\n  // Standard key generation using specified columns\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      let index = lowerHeader.indexOf(normalizedName);\n      // Consistent fallback: id -> messageid\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return ''; // Return empty string for invalid key configurations\n  }\n\n  const components = keyIndices.map((index) => String(row[index] ?? '').trim());\n  // Only return key if all components are non-empty\n  if (components.every((comp) => comp.length > 0)) {\n    return components.join(separator);\n  }\n\n  return '';\n}\n\nexport function validateRowKeys(rows: Row[], header: string[], strategy: KeyGenerationStrategy): { valid: boolean; duplicateKeys: string[]; keyMap: Map<string, number[]> } {\n  const keyMap = new Map<string, number[]>();\n  const duplicateKeys: string[] = [];\n\n  rows.forEach((row, index) => {\n    const key = generateRowKey(row, header, strategy);\n    if (key.replace(/\\\\+/g, '') === '') return; // Skip empty keys\n\n    if (!keyMap.has(key)) {\n      keyMap.set(key, []);\n    }\n    keyMap.get(key)?.push(index);\n  });\n\n  // Find duplicates\n  keyMap.forEach((indices, key) => {\n    if (indices.length > 1) {\n      duplicateKeys.push(key);\n    }\n  });\n\n  return {\n    valid: duplicateKeys.length === 0,\n    duplicateKeys,\n    keyMap,\n  };\n}\n\n// Overloaded function signatures for appendRows\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    rows = [],\n    keySet = null as Set<string> | null,\n    keyColumns = ['id'] as string[],\n    header = [] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    rows?: unknown[];\n    keySet?: Set<string> | null;\n    keyColumns?: string[];\n    header?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('appendRows: sheets is required');\n  if (!spreadsheetId) throw new Error('appendRows: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('appendRows: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('appendRows: could not resolve sheet title');\n  if (!Array.isArray(rows) || rows.length === 0) return { updatedRows: 0, inserted: [] as string[] };\n\n  if (!Array.isArray(header) || header.length === 0) {\n    const respHeader = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = respHeader.data as sheets_v4.Schema$ValueRange;\n    header = ((vr?.values || [])[0] || []) as string[];\n  }\n\n  const resolveKeyIndices = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    for (const c of kc) {\n      if (typeof c !== 'string' || c.length === 0) throw new Error('appendRows: keyColumns must be an array of non-empty strings');\n    }\n    if (!Array.isArray(hdr) || hdr.length === 0) {\n      throw new Error('appendRows: header array is required when keyColumns are header names');\n    }\n    return kc.map((name) => {\n      const idx = hdr.indexOf(name);\n      if (idx === -1) throw new Error(`appendRows: header name \"${name}\" not found in header`);\n      return idx;\n    });\n  };\n\n  const keyColsIdx = resolveKeyIndices(keyColumns, header);\n\n  // Internal batch size to avoid Google Sheets limits\n  const batchSize = 50;\n\n  if (!keyColsIdx || keyColsIdx.length === 0) {\n    let totalUpdated = 0;\n    for (let i = 0; i < rows.length; i += batchSize) {\n      const batch = rows.slice(i, i + batchSize);\n      const resp = await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: batch as unknown[][] } });\n      const app = resp.data as sheets_v4.Schema$AppendValuesResponse;\n      const updatedRows = Number(app?.updates?.updatedRows || batch.length);\n      totalUpdated += updatedRows;\n    }\n    return { updatedRows: totalUpdated, inserted: [] as string[], rowsSkipped: 0 };\n  }\n\n  const toKey = (r: unknown[]) => {\n    const row = r as (string | number | boolean | null | undefined)[];\n\n    // Use consistent key generation strategy\n    const strategy: KeyGenerationStrategy = {\n      keyColumns,\n      useProviderIdLogic: true,\n      separator: '\\\\',\n    };\n\n    return generateRowKey(row, header, strategy);\n  };\n\n  const rowsToInsert: unknown[][] = [];\n  const insertedKeys: string[] = [];\n  for (const r of rows as unknown[][]) {\n    const key = toKey(r as unknown[]);\n    if (keySet && keySet.has(key)) continue;\n    rowsToInsert.push(r as unknown[]);\n    insertedKeys.push(key);\n  }\n\n  if (rowsToInsert.length === 0) {\n    const rowsSkipped = rows.length - rowsToInsert.length; // Should be rows.length when all are skipped\n    return { updatedRows: 0, inserted: [] as string[], rowsSkipped };\n  }\n\n  // Use smaller internal batch size to avoid Google Sheets character limit errors\n  // Especially important when dealing with emails that may have long bodies\n  const INTERNAL_BATCH_SIZE = 50;\n\n  let totalUpdated = 0;\n  for (let i = 0; i < rowsToInsert.length; i += INTERNAL_BATCH_SIZE) {\n    const batch = rowsToInsert.slice(i, i + INTERNAL_BATCH_SIZE);\n    try {\n      const resp = await sheets.spreadsheets.values.append({\n        spreadsheetId,\n        range: `${resolvedSheetTitle}!A1`,\n        valueInputOption: 'RAW',\n        insertDataOption: 'INSERT_ROWS',\n        requestBody: { values: batch as unknown[][] },\n      });\n      const app2 = resp.data as sheets_v4.Schema$AppendValuesResponse;\n      const updatedRows = Number(app2?.updates?.updatedRows || batch.length);\n      totalUpdated += updatedRows;\n    } catch (error) {\n      // If a batch fails, try with smaller batches to handle partial success\n      if (batch.length > 1) {\n        for (const singleRow of batch) {\n          try {\n            const singleResp = await sheets.spreadsheets.values.append({\n              spreadsheetId,\n              range: `${resolvedSheetTitle}!A1`,\n              valueInputOption: 'RAW',\n              insertDataOption: 'INSERT_ROWS',\n              requestBody: { values: [singleRow as unknown[]] },\n            });\n            const singleApp = singleResp.data as sheets_v4.Schema$AppendValuesResponse;\n            const singleUpdatedRows = Number(singleApp?.updates?.updatedRows || 1);\n            totalUpdated += singleUpdatedRows;\n          } catch (singleError) {\n            // Skip problematic individual rows but continue processing\n            logger.warn?.(`Failed to insert single row: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n          }\n        }\n      } else {\n        // Single row batch failed, skip it\n        logger.warn?.(`Failed to insert batch: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    }\n  }\n  const rowsSkipped = rows.length - rowsToInsert.length;\n  return { updatedRows: totalUpdated, inserted: insertedKeys, rowsSkipped };\n}\n\nexport function mapRowsToHeader({ rows = [], header = [], canonical = [] as string[] }: { rows?: Row[]; header?: string[]; canonical?: string[] }): Row[] {\n  if (!Array.isArray(rows) || rows.length === 0) return [];\n  if (!Array.isArray(header) || header.length === 0) return rows;\n  if (!Array.isArray(canonical) || canonical.length === 0) return rows;\n\n  const validation = validateAndMapHeaders(header, canonical);\n  const mappingLookup = new Map(validation.mappings.map((m) => [m.canonical, m.index]));\n\n  return rows.map((row: Row) => {\n    // Fill with null to skip unmapped columns (preserve existing values)\n    // Use '' (empty string) only when explicitly wanting to clear a cell\n    const mappedRow: Row = new Array(header.length).fill(null);\n\n    canonical.forEach((canonicalCol, canonicalIndex) => {\n      const sheetIndex = mappingLookup.get(canonicalCol);\n      if (sheetIndex !== undefined && canonicalIndex < row.length) {\n        // Preserve null values - they signal \"skip this cell\"\n        mappedRow[sheetIndex] = row[canonicalIndex];\n      }\n    });\n\n    return mappedRow;\n  });\n}\n\nexport async function snapshotHeaderAndKeys(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyIndices: number[] }> {\n  const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n  const keySet = new Set<string>();\n\n  if (header.length === 0) {\n    return { header, keySet, keyIndices: [] };\n  }\n\n  const strategy: KeyGenerationStrategy = {\n    keyColumns,\n    useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n    separator: keyStrategy?.separator ?? '\\\\',\n  };\n\n  // Find key column indices\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n      let index = lowerHeader.indexOf(normalizedName);\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return { header, keySet, keyIndices };\n  }\n\n  // Read key columns data in chunks\n  const chunkSize = 1000;\n  let startRow = 2;\n  const minIndex = Math.min(...keyIndices);\n  const maxIndex = Math.max(...keyIndices);\n  const startCol = a1Col(minIndex + 1);\n  const endCol = a1Col(maxIndex + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n    try {\n      const response = await sheets.spreadsheets.values.get({\n        spreadsheetId,\n        range,\n        majorDimension: 'ROWS',\n      });\n\n      const rows = (response.data?.values || []) as string[][];\n      if (rows.length === 0) break;\n\n      for (const rawRow of rows) {\n        // Reconstruct full row for key generation\n        const fullRow: Row = new Array(header.length).fill('');\n        keyIndices.forEach((globalIndex, _localIndex) => {\n          const localRowIndex = globalIndex - minIndex;\n          if (localRowIndex >= 0 && localRowIndex < rawRow.length) {\n            fullRow[globalIndex] = rawRow[localRowIndex];\n          }\n        });\n\n        const key = generateRowKey(fullRow, header, strategy);\n        if (key.replace(/\\\\+/g, '') !== '') {\n          keySet.add(key);\n        }\n      }\n\n      startRow += rows.length;\n      if (rows.length < chunkSize) break; // Last chunk\n    } catch {\n      break; // End of data or error\n    }\n  }\n\n  return { header, keySet, keyIndices };\n}\n\n/** Tracks row positions for updates in addition to keys */\nexport async function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyToRowMap: Map<string, number>; keyIndices: number[] }> {\n  const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n  const keySet = new Set<string>();\n  const keyToRowMap = new Map<string, number>();\n\n  if (header.length === 0) {\n    return { header, keySet, keyToRowMap, keyIndices: [] };\n  }\n\n  const strategy: KeyGenerationStrategy = {\n    keyColumns,\n    useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n    separator: keyStrategy?.separator ?? '\\\\',\n  };\n\n  // Find key column indices\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n      let index = lowerHeader.indexOf(normalizedName);\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return { header, keySet, keyToRowMap, keyIndices };\n  }\n\n  // Read key columns data in chunks and track row positions\n  const chunkSize = 1000;\n  let startRow = 2; // Start from row 2 (after header)\n  const minIndex = Math.min(...keyIndices);\n  const maxIndex = Math.max(...keyIndices);\n  const startCol = a1Col(minIndex + 1);\n  const endCol = a1Col(maxIndex + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n    try {\n      const response = await sheets.spreadsheets.values.get({\n        spreadsheetId,\n        range,\n        majorDimension: 'ROWS',\n      });\n\n      const rows = (response.data?.values || []) as string[][];\n      if (rows.length === 0) break;\n\n      for (let localRowIndex = 0; localRowIndex < rows.length; localRowIndex++) {\n        const rawRow = rows[localRowIndex];\n        const globalRowNumber = startRow + localRowIndex;\n\n        // Reconstruct full row for key generation\n        const fullRow: Row = new Array(header.length).fill('');\n        if (rawRow) {\n          keyIndices.forEach((globalIndex, _localIndex) => {\n            const localRowArrayIndex = globalIndex - minIndex;\n            if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {\n              fullRow[globalIndex] = rawRow[localRowArrayIndex];\n            }\n          });\n        }\n\n        const key = generateRowKey(fullRow, header, strategy);\n        if (key.replace(/\\\\+/g, '') !== '') {\n          keySet.add(key);\n          keyToRowMap.set(key, globalRowNumber); // Store 1-indexed row number\n        }\n      }\n\n      startRow += rows.length;\n      if (rows.length < chunkSize) break; // Last chunk\n    } catch {\n      break; // End of data or error\n    }\n  }\n\n  return { header, keySet, keyToRowMap, keyIndices };\n}\n\n/**\n * Partitions data into updates vs appends based on existing keys with row position tracking\n */\nexport function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates = false, keyToRowMap?: Map<string, number>): DataPartition {\n  const toAppend: Row[] = [];\n  const toUpdate: Array<{ row: Row; existingRowIndex: number }> = [];\n  const skippedKeys: string[] = [];\n\n  rows.forEach((row) => {\n    const key = generateRowKey(row, header, keyStrategy);\n    if (key.replace(/\\\\+/g, '') === '') {\n      // Skip rows with empty keys\n      return;\n    }\n\n    if (existingKeys.has(key)) {\n      if (allowUpdates && keyToRowMap) {\n        const existingRowIndex = keyToRowMap.get(key);\n        if (existingRowIndex !== undefined) {\n          toUpdate.push({ row, existingRowIndex });\n        } else {\n          skippedKeys.push(key);\n        }\n      } else {\n        skippedKeys.push(key);\n      }\n    } else {\n      toAppend.push(row);\n    }\n  });\n\n  return {\n    toAppend,\n    toUpdate,\n    skippedKeys,\n  };\n}\n\n/**\n * Performs batch updates on existing rows using batchUpdate API\n */\nexport async function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{ row: Row; existingRowIndex: number }>, header: string[], batchSize: number, valueInputOption: 'RAW' | 'USER_ENTERED'): Promise<{ updatedRows: number; errors?: string[] }> {\n  const errors: string[] = [];\n  let totalUpdated = 0;\n\n  // Process updates in batches\n  for (let i = 0; i < updates.length; i += batchSize) {\n    const batch = updates.slice(i, i + batchSize);\n\n    try {\n      const requests: sheets_v4.Schema$Request[] = [];\n\n      for (const { row, existingRowIndex } of batch) {\n        requests.push({\n          updateCells: {\n            range: {\n              sheetId: 0, // Will be resolved by sheet title in the range\n              startRowIndex: existingRowIndex - 1, // Convert to 0-indexed\n              endRowIndex: existingRowIndex, // Exclusive\n              startColumnIndex: 0,\n              endColumnIndex: header.length,\n            },\n            rows: [\n              {\n                values: row.map((cellValue) => ({\n                  userEnteredValue: {\n                    stringValue: String(cellValue ?? ''),\n                  },\n                })),\n              },\n            ],\n            fields: 'userEnteredValue',\n          },\n        });\n      }\n\n      if (requests.length > 0) {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId,\n          requestBody: {\n            requests,\n          },\n        });\n\n        totalUpdated += batch.length;\n      }\n    } catch (error) {\n      const errorMsg = `Batch update ${Math.floor(i / batchSize) + 1} failed: ${error instanceof Error ? error.message : String(error)}`;\n      errors.push(errorMsg);\n\n      // Try individual updates for failed batches\n      for (const { row, existingRowIndex } of batch) {\n        try {\n          const range = `${sheetTitle}!A${existingRowIndex}:${a1Col(header.length)}${existingRowIndex}`;\n          await sheets.spreadsheets.values.update({\n            spreadsheetId,\n            range,\n            valueInputOption,\n            requestBody: {\n              values: [row as (string | number | boolean | null | undefined)[]],\n            },\n          });\n          totalUpdated += 1;\n        } catch (singleError) {\n          errors.push(`Failed to update row ${existingRowIndex}: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n        }\n      }\n    }\n  }\n\n  const result: { updatedRows: number; errors?: string[] } = {\n    updatedRows: totalUpdated,\n  };\n\n  if (errors.length > 0) {\n    result.errors = errors;\n  }\n\n  return result;\n}\n\nexport async function upsertByKey(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    rows,\n    canonicalHeaders,\n    options,\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    rows: Row[];\n    canonicalHeaders?: string[];\n    options: UpsertOptions;\n    logger: Logger;\n  }\n): Promise<BatchOperationResult> {\n  // Validate inputs\n  if (!sheets) throw new Error('upsertByKey: sheets client is required');\n  if (!spreadsheetId) throw new Error('upsertByKey: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('upsertByKey: either sheetTitle or sheetRef is required');\n  if (!Array.isArray(rows) || rows.length === 0) {\n    return { updatedRows: 0, inserted: [], rowsSkipped: 0 };\n  }\n\n  // Step 1: Input validation (duplicate key checking)\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    resolvedSheetTitle = sheet?.properties?.title || sheetRef;\n  }\n\n  if (!resolvedSheetTitle) {\n    throw new Error('upsertByKey: could not resolve sheet title');\n  }\n\n  // Validate for duplicate keys in input data\n  const inputValidation = validateRowKeys(rows, canonicalHeaders || [], options.keyStrategy);\n  if (!inputValidation.valid) {\n    throw new Error(`upsertByKey: duplicate keys found in input data: ${inputValidation.duplicateKeys.join(', ')}`);\n  }\n\n  // Step 2: Header discovery and column mapping\n  const currentHeader = await discoverHeader(sheets, spreadsheetId, resolvedSheetTitle);\n  let effectiveHeader = currentHeader;\n\n  // If sheet is empty and we have canonical headers, use them\n  if (currentHeader.length === 0 && canonicalHeaders && canonicalHeaders.length > 0) {\n    effectiveHeader = canonicalHeaders;\n    // Write headers to sheet\n    await sheets.spreadsheets.values.append({\n      spreadsheetId,\n      range: `${resolvedSheetTitle}!A1`,\n      valueInputOption: options.valueInputOption || 'USER_ENTERED',\n      insertDataOption: 'INSERT_ROWS',\n      requestBody: { values: [effectiveHeader] },\n    });\n  }\n\n  // Validate headers if we have requirements\n  if (canonicalHeaders && canonicalHeaders.length > 0) {\n    const headerValidation = validateAndMapHeaders(effectiveHeader, canonicalHeaders);\n    if (!headerValidation.valid) {\n      throw new Error(`upsertByKey: missing required columns: ${headerValidation.missingColumns.join(', ')}`);\n    }\n  }\n\n  // Step 3: Key column reading for existing row lookup with position tracking\n  const { keySet: existingKeys, keyToRowMap } = await snapshotHeaderKeysAndPositions(sheets, spreadsheetId, resolvedSheetTitle, options.keyStrategy.keyColumns, options.keyStrategy);\n\n  // Step 4: Partition changes (updates vs appends)\n  let processedRows = rows;\n\n  // Map canonical data to sheet structure if needed\n  if (canonicalHeaders && canonicalHeaders.length > 0 && effectiveHeader.length > 0) {\n    processedRows = mapRowsToHeader({\n      rows,\n      header: effectiveHeader,\n      canonical: canonicalHeaders,\n    });\n  }\n\n  const partition = partitionDataForUpsert(processedRows, effectiveHeader, options.keyStrategy, existingKeys, options.allowUpdates, keyToRowMap);\n\n  // Step 5: Efficient batch writing\n  const batchSize = options.batchSize || 50;\n  const errors: string[] = [];\n  let totalUpdated = 0;\n  const insertedKeys: string[] = [];\n\n  // Handle appends with proper error handling and partial success tracking\n  if (partition.toAppend.length > 0) {\n    for (let i = 0; i < partition.toAppend.length; i += batchSize) {\n      const batch = partition.toAppend.slice(i, i + batchSize);\n      try {\n        const response = await sheets.spreadsheets.values.append({\n          spreadsheetId,\n          range: `${resolvedSheetTitle}!A1`,\n          valueInputOption: options.valueInputOption || 'USER_ENTERED',\n          insertDataOption: 'INSERT_ROWS',\n          requestBody: { values: batch },\n        });\n\n        const updatedRows = Number(response.data?.updates?.updatedRows || batch.length);\n        totalUpdated += updatedRows;\n\n        // Track inserted keys for successful batch\n        batch.forEach((row) => {\n          const key = generateRowKey(row, effectiveHeader, options.keyStrategy);\n          if (key.replace(/\\\\+/g, '') !== '') {\n            insertedKeys.push(key);\n          }\n        });\n      } catch (error) {\n        const errorMsg = `Batch ${Math.floor(i / batchSize) + 1} append failed: ${error instanceof Error ? error.message : String(error)}`;\n        errors.push(errorMsg);\n      }\n    }\n  }\n\n  // Handle updates with proper row position tracking\n  if (partition.toUpdate.length > 0 && options.allowUpdates) {\n    try {\n      const updateResult = await performBatchUpdates(sheets, spreadsheetId, resolvedSheetTitle, partition.toUpdate, effectiveHeader, batchSize, options.valueInputOption || 'USER_ENTERED');\n      totalUpdated += updateResult.updatedRows;\n      if (updateResult.errors) {\n        errors.push(...updateResult.errors);\n      }\n    } catch (updateError) {\n      const errorMsg = `Update operations failed: ${updateError instanceof Error ? updateError.message : String(updateError)}`;\n      errors.push(errorMsg);\n    }\n  }\n\n  const result: BatchOperationResult = {\n    updatedRows: totalUpdated,\n    inserted: insertedKeys,\n    rowsSkipped: partition.skippedKeys.length,\n  };\n\n  if (errors.length > 0) {\n    result.errors = errors;\n  }\n\n  return result;\n}\n"],"names":["appendRows","discoverHeader","generateRowKey","mapRowsToHeader","partitionDataForUpsert","performBatchUpdates","snapshotHeaderAndKeys","snapshotHeaderKeysAndPositions","upsertByKey","validateAndMapHeaders","validateRowKeys","sheets","spreadsheetId","sheetTitle","response","spreadsheets","values","get","range","majorDimension","data","sheetHeaders","canonicalHeaders","requiredColumns","normalizeColumn","col","String","toLowerCase","replace","sheetNormalized","map","canonicalNormalized","requiredNormalized","mappings","missingColumns","extraColumns","forEach","canonical","canonicalIndex","canonicalNorm","sheetIndex","indexOf","sheetHeader","undefined","push","sheet","index","extraIndex","splice","includes","valid","length","row","header","strategy","keyColumns","useProviderIdLogic","separator","lowerHeader","h","providerIndex","idIndex","providerVal","trim","idVal","join","keyIndices","name","normalizedName","filter","components","every","comp","rows","keyMap","Map","duplicateKeys","key","has","set","indices","sheetRef","keySet","logger","resolvedSheetTitle","respHeader","vr","resolveKeyIndices","keyColsIdx","batchSize","totalUpdated","i","app","batch","resp","updatedRows","toKey","rowsToInsert","insertedKeys","r","rowsSkipped","INTERNAL_BATCH_SIZE","app2","error","singleRow","singleApp","singleResp","singleUpdatedRows","singleError","Error","findSheetByRef","properties","title","Array","isArray","inserted","kc","hdr","c","idx","slice","append","valueInputOption","insertDataOption","requestBody","Number","updates","warn","message","validation","mappingLookup","m","mappedRow","fill","canonicalCol","keyStrategy","Math","chunkSize","startRow","minIndex","maxIndex","startCol","endCol","endRow","Set","min","max","a1Col","rawRow","fullRow","globalIndex","_localIndex","localRowIndex","add","keyToRowMap","globalRowNumber","localRowArrayIndex","existingKeys","allowUpdates","toAppend","toUpdate","skippedKeys","existingRowIndex","errors","requests","errorMsg","result","updateCells","sheetId","startRowIndex","endRowIndex","startColumnIndex","endColumnIndex","cellValue","userEnteredValue","stringValue","fields","batchUpdate","floor","update","options","inputValidation","currentHeader","effectiveHeader","headerValidation","processedRows","partition","updateResult","updateError"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/data-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\nimport { findSheetByRef } from './sheet-operations.ts';\n\n// Core data types\nexport type Cell = string | number | boolean | null | undefined;\nexport type Row = Cell[];\n\n// Enhanced type definitions for shared data operations\nexport interface ColumnMapping {\n  canonical: string;\n  sheet: string;\n  index: number;\n}\n\nexport interface HeaderValidationResult {\n  valid: boolean;\n  missingColumns: string[];\n  extraColumns: string[];\n  mappings: ColumnMapping[];\n}\n\nexport interface KeyGenerationStrategy {\n  keyColumns: string[];\n  useProviderIdLogic: boolean;\n  separator?: string;\n}\n\nexport interface DataPartition {\n  toAppend: Row[];\n  toUpdate: Array<{ row: Row; existingRowIndex: number }>;\n  skippedKeys: string[];\n}\n\nexport interface BatchOperationResult {\n  updatedRows: number;\n  inserted: string[];\n  rowsSkipped: number;\n  errors?: string[];\n}\n\nexport interface UpsertOptions {\n  keyStrategy: KeyGenerationStrategy;\n  allowUpdates: boolean;\n  batchSize?: number;\n  valueInputOption?: 'RAW' | 'USER_ENTERED';\n}\n\nexport async function discoverHeader(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string): Promise<string[]> {\n  try {\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId,\n      range: `${sheetTitle}!1:1`,\n      majorDimension: 'ROWS',\n    });\n    return ((response.data?.values || [])[0] || []) as string[];\n  } catch {\n    return [];\n  }\n}\n\nexport function validateAndMapHeaders(sheetHeaders: string[], canonicalHeaders: string[], requiredColumns: string[] = []): HeaderValidationResult {\n  const normalizeColumn = (col: string) =>\n    String(col ?? '')\n      .toLowerCase()\n      .replace(/[^a-z0-9]/g, '');\n\n  const sheetNormalized = sheetHeaders.map(normalizeColumn);\n  const canonicalNormalized = canonicalHeaders.map(normalizeColumn);\n  const requiredNormalized = requiredColumns.map(normalizeColumn);\n\n  const mappings: ColumnMapping[] = [];\n  const missingColumns: string[] = [];\n  const extraColumns: string[] = [...sheetHeaders];\n\n  // Create mappings for canonical columns\n  canonicalHeaders.forEach((canonical, canonicalIndex) => {\n    const canonicalNorm = canonicalNormalized[canonicalIndex];\n    if (!canonicalNorm) return; // Skip if normalization resulted in empty string\n\n    let sheetIndex = sheetNormalized.indexOf(canonicalNorm);\n\n    // Special handling for 'id' -> 'messageid' mapping\n    if (sheetIndex === -1 && canonicalNorm === 'id') {\n      sheetIndex = sheetNormalized.indexOf('messageid');\n    }\n\n    if (sheetIndex !== -1) {\n      const sheetHeader = sheetHeaders[sheetIndex];\n      if (sheetHeader !== undefined) {\n        mappings.push({\n          canonical,\n          sheet: sheetHeader,\n          index: sheetIndex,\n        });\n        // Remove from extra columns\n        const extraIndex = extraColumns.indexOf(sheetHeader);\n        if (extraIndex !== -1) {\n          extraColumns.splice(extraIndex, 1);\n        }\n      }\n    } else if (requiredNormalized.includes(canonicalNorm)) {\n      missingColumns.push(canonical);\n    }\n  });\n\n  return {\n    valid: missingColumns.length === 0,\n    missingColumns,\n    extraColumns,\n    mappings,\n  };\n}\n\n/** Ensures consistent key generation across all functions */\nexport function generateRowKey(row: Row, header: string[], strategy: KeyGenerationStrategy): string {\n  const { keyColumns, useProviderIdLogic, separator = '\\\\' } = strategy;\n\n  // Normalize header for consistent lookups\n  const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n\n  if (useProviderIdLogic) {\n    const providerIndex = lowerHeader.indexOf('provider');\n    let idIndex = lowerHeader.indexOf('messageid');\n    if (idIndex === -1) idIndex = lowerHeader.indexOf('id');\n\n    if (providerIndex >= 0 && idIndex >= 0) {\n      const providerVal = String(row[providerIndex] ?? '').trim();\n      const idVal = String(row[idIndex] ?? '').trim();\n      if (providerVal || idVal) {\n        // Only return key if at least one component exists\n        return [providerVal, idVal].join(separator);\n      }\n    }\n  }\n\n  // Standard key generation using specified columns\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      let index = lowerHeader.indexOf(normalizedName);\n      // Consistent fallback: id -> messageid\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return ''; // Return empty string for invalid key configurations\n  }\n\n  const components = keyIndices.map((index) => String(row[index] ?? '').trim());\n  // Only return key if all components are non-empty\n  if (components.every((comp) => comp.length > 0)) {\n    return components.join(separator);\n  }\n\n  return '';\n}\n\nexport function validateRowKeys(rows: Row[], header: string[], strategy: KeyGenerationStrategy): { valid: boolean; duplicateKeys: string[]; keyMap: Map<string, number[]> } {\n  const keyMap = new Map<string, number[]>();\n  const duplicateKeys: string[] = [];\n\n  rows.forEach((row, index) => {\n    const key = generateRowKey(row, header, strategy);\n    if (key.replace(/\\\\+/g, '') === '') return; // Skip empty keys\n\n    if (!keyMap.has(key)) {\n      keyMap.set(key, []);\n    }\n    keyMap.get(key)?.push(index);\n  });\n\n  // Find duplicates\n  keyMap.forEach((indices, key) => {\n    if (indices.length > 1) {\n      duplicateKeys.push(key);\n    }\n  });\n\n  return {\n    valid: duplicateKeys.length === 0,\n    duplicateKeys,\n    keyMap,\n  };\n}\n\n// Overloaded function signatures for appendRows\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; rows?: unknown[]; keySet?: Set<string> | null; keyColumns?: string[]; header?: string[]; logger: Logger }): Promise<{ updatedRows: number; inserted: string[]; rowsSkipped?: number }>;\n\nexport async function appendRows(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    rows = [],\n    keySet = null as Set<string> | null,\n    keyColumns = ['id'] as string[],\n    header = [] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    rows?: unknown[];\n    keySet?: Set<string> | null;\n    keyColumns?: string[];\n    header?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('appendRows: sheets is required');\n  if (!spreadsheetId) throw new Error('appendRows: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('appendRows: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('appendRows: could not resolve sheet title');\n  if (!Array.isArray(rows) || rows.length === 0) return { updatedRows: 0, inserted: [] as string[] };\n\n  if (!Array.isArray(header) || header.length === 0) {\n    const respHeader = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = respHeader.data as sheets_v4.Schema$ValueRange;\n    header = ((vr?.values || [])[0] || []) as string[];\n  }\n\n  const resolveKeyIndices = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    for (const c of kc) {\n      if (typeof c !== 'string' || c.length === 0) throw new Error('appendRows: keyColumns must be an array of non-empty strings');\n    }\n    if (!Array.isArray(hdr) || hdr.length === 0) {\n      throw new Error('appendRows: header array is required when keyColumns are header names');\n    }\n    return kc.map((name) => {\n      const idx = hdr.indexOf(name);\n      if (idx === -1) throw new Error(`appendRows: header name \"${name}\" not found in header`);\n      return idx;\n    });\n  };\n\n  const keyColsIdx = resolveKeyIndices(keyColumns, header);\n\n  // Internal batch size to avoid Google Sheets limits\n  const batchSize = 50;\n\n  if (!keyColsIdx || keyColsIdx.length === 0) {\n    let totalUpdated = 0;\n    for (let i = 0; i < rows.length; i += batchSize) {\n      const batch = rows.slice(i, i + batchSize);\n      const resp = await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: batch as unknown[][] } });\n      const app = resp.data as sheets_v4.Schema$AppendValuesResponse;\n      const updatedRows = Number(app?.updates?.updatedRows || batch.length);\n      totalUpdated += updatedRows;\n    }\n    return { updatedRows: totalUpdated, inserted: [] as string[], rowsSkipped: 0 };\n  }\n\n  const toKey = (r: unknown[]) => {\n    const row = r as (string | number | boolean | null | undefined)[];\n\n    // Use consistent key generation strategy\n    const strategy: KeyGenerationStrategy = {\n      keyColumns,\n      useProviderIdLogic: true,\n      separator: '\\\\',\n    };\n\n    return generateRowKey(row, header, strategy);\n  };\n\n  const rowsToInsert: unknown[][] = [];\n  const insertedKeys: string[] = [];\n  for (const r of rows as unknown[][]) {\n    const key = toKey(r as unknown[]);\n    if (keySet && keySet.has(key)) continue;\n    rowsToInsert.push(r as unknown[]);\n    insertedKeys.push(key);\n  }\n\n  if (rowsToInsert.length === 0) {\n    const rowsSkipped = rows.length - rowsToInsert.length; // Should be rows.length when all are skipped\n    return { updatedRows: 0, inserted: [] as string[], rowsSkipped };\n  }\n\n  // Use smaller internal batch size to avoid Google Sheets character limit errors\n  // Especially important when dealing with emails that may have long bodies\n  const INTERNAL_BATCH_SIZE = 50;\n\n  let totalUpdated = 0;\n  for (let i = 0; i < rowsToInsert.length; i += INTERNAL_BATCH_SIZE) {\n    const batch = rowsToInsert.slice(i, i + INTERNAL_BATCH_SIZE);\n    try {\n      const resp = await sheets.spreadsheets.values.append({\n        spreadsheetId,\n        range: `${resolvedSheetTitle}!A1`,\n        valueInputOption: 'RAW',\n        insertDataOption: 'INSERT_ROWS',\n        requestBody: { values: batch as unknown[][] },\n      });\n      const app2 = resp.data as sheets_v4.Schema$AppendValuesResponse;\n      const updatedRows = Number(app2?.updates?.updatedRows || batch.length);\n      totalUpdated += updatedRows;\n    } catch (error) {\n      // If a batch fails, try with smaller batches to handle partial success\n      if (batch.length > 1) {\n        for (const singleRow of batch) {\n          try {\n            const singleResp = await sheets.spreadsheets.values.append({\n              spreadsheetId,\n              range: `${resolvedSheetTitle}!A1`,\n              valueInputOption: 'RAW',\n              insertDataOption: 'INSERT_ROWS',\n              requestBody: { values: [singleRow as unknown[]] },\n            });\n            const singleApp = singleResp.data as sheets_v4.Schema$AppendValuesResponse;\n            const singleUpdatedRows = Number(singleApp?.updates?.updatedRows || 1);\n            totalUpdated += singleUpdatedRows;\n          } catch (singleError) {\n            // Skip problematic individual rows but continue processing\n            logger.warn?.(`Failed to insert single row: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n          }\n        }\n      } else {\n        // Single row batch failed, skip it\n        logger.warn?.(`Failed to insert batch: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    }\n  }\n  const rowsSkipped = rows.length - rowsToInsert.length;\n  return { updatedRows: totalUpdated, inserted: insertedKeys, rowsSkipped };\n}\n\nexport function mapRowsToHeader({ rows = [], header = [], canonical = [] as string[] }: { rows?: Row[]; header?: string[]; canonical?: string[] }): Row[] {\n  if (!Array.isArray(rows) || rows.length === 0) return [];\n  if (!Array.isArray(header) || header.length === 0) return rows;\n  if (!Array.isArray(canonical) || canonical.length === 0) return rows;\n\n  const validation = validateAndMapHeaders(header, canonical);\n  const mappingLookup = new Map(validation.mappings.map((m) => [m.canonical, m.index]));\n\n  return rows.map((row: Row) => {\n    // Fill with null to skip unmapped columns (preserve existing values)\n    // Use '' (empty string) only when explicitly wanting to clear a cell\n    const mappedRow: Row = new Array(header.length).fill(null);\n\n    canonical.forEach((canonicalCol, canonicalIndex) => {\n      const sheetIndex = mappingLookup.get(canonicalCol);\n      if (sheetIndex !== undefined && canonicalIndex < row.length) {\n        // Preserve null values - they signal \"skip this cell\"\n        mappedRow[sheetIndex] = row[canonicalIndex];\n      }\n    });\n\n    return mappedRow;\n  });\n}\n\nexport async function snapshotHeaderAndKeys(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyIndices: number[] }> {\n  const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n  const keySet = new Set<string>();\n\n  if (header.length === 0) {\n    return { header, keySet, keyIndices: [] };\n  }\n\n  const strategy: KeyGenerationStrategy = {\n    keyColumns,\n    useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n    separator: keyStrategy?.separator ?? '\\\\',\n  };\n\n  // Find key column indices\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n      let index = lowerHeader.indexOf(normalizedName);\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return { header, keySet, keyIndices };\n  }\n\n  // Read key columns data in chunks\n  const chunkSize = 1000;\n  let startRow = 2;\n  const minIndex = Math.min(...keyIndices);\n  const maxIndex = Math.max(...keyIndices);\n  const startCol = a1Col(minIndex + 1);\n  const endCol = a1Col(maxIndex + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n    try {\n      const response = await sheets.spreadsheets.values.get({\n        spreadsheetId,\n        range,\n        majorDimension: 'ROWS',\n      });\n\n      const rows = (response.data?.values || []) as string[][];\n      if (rows.length === 0) break;\n\n      for (const rawRow of rows) {\n        // Reconstruct full row for key generation\n        const fullRow: Row = new Array(header.length).fill('');\n        keyIndices.forEach((globalIndex, _localIndex) => {\n          const localRowIndex = globalIndex - minIndex;\n          if (localRowIndex >= 0 && localRowIndex < rawRow.length) {\n            fullRow[globalIndex] = rawRow[localRowIndex];\n          }\n        });\n\n        const key = generateRowKey(fullRow, header, strategy);\n        if (key.replace(/\\\\+/g, '') !== '') {\n          keySet.add(key);\n        }\n      }\n\n      startRow += rows.length;\n      if (rows.length < chunkSize) break; // Last chunk\n    } catch {\n      break; // End of data or error\n    }\n  }\n\n  return { header, keySet, keyIndices };\n}\n\n/** Tracks row positions for updates in addition to keys */\nexport async function snapshotHeaderKeysAndPositions(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, keyColumns: string[] = ['id'], keyStrategy?: Partial<KeyGenerationStrategy>): Promise<{ header: string[]; keySet: Set<string>; keyToRowMap: Map<string, number>; keyIndices: number[] }> {\n  const header = await discoverHeader(sheets, spreadsheetId, sheetTitle);\n  const keySet = new Set<string>();\n  const keyToRowMap = new Map<string, number>();\n\n  if (header.length === 0) {\n    return { header, keySet, keyToRowMap, keyIndices: [] };\n  }\n\n  const strategy: KeyGenerationStrategy = {\n    keyColumns,\n    useProviderIdLogic: keyStrategy?.useProviderIdLogic ?? true,\n    separator: keyStrategy?.separator ?? '\\\\',\n  };\n\n  // Find key column indices\n  const keyIndices = keyColumns\n    .map((name) => {\n      const normalizedName = String(name ?? '').toLowerCase();\n      const lowerHeader = header.map((h) => String(h ?? '').toLowerCase());\n      let index = lowerHeader.indexOf(normalizedName);\n      if (index === -1 && normalizedName === 'id') {\n        index = lowerHeader.indexOf('messageid');\n      }\n      return index;\n    })\n    .filter((index) => index >= 0);\n\n  if (keyIndices.length === 0) {\n    return { header, keySet, keyToRowMap, keyIndices };\n  }\n\n  // Read key columns data in chunks and track row positions\n  const chunkSize = 1000;\n  let startRow = 2; // Start from row 2 (after header)\n  const minIndex = Math.min(...keyIndices);\n  const maxIndex = Math.max(...keyIndices);\n  const startCol = a1Col(minIndex + 1);\n  const endCol = a1Col(maxIndex + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${sheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n\n    try {\n      const response = await sheets.spreadsheets.values.get({\n        spreadsheetId,\n        range,\n        majorDimension: 'ROWS',\n      });\n\n      const rows = (response.data?.values || []) as string[][];\n      if (rows.length === 0) break;\n\n      for (let localRowIndex = 0; localRowIndex < rows.length; localRowIndex++) {\n        const rawRow = rows[localRowIndex];\n        const globalRowNumber = startRow + localRowIndex;\n\n        // Reconstruct full row for key generation\n        const fullRow: Row = new Array(header.length).fill('');\n        if (rawRow) {\n          keyIndices.forEach((globalIndex, _localIndex) => {\n            const localRowArrayIndex = globalIndex - minIndex;\n            if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {\n              fullRow[globalIndex] = rawRow[localRowArrayIndex];\n            }\n          });\n        }\n\n        const key = generateRowKey(fullRow, header, strategy);\n        if (key.replace(/\\\\+/g, '') !== '') {\n          keySet.add(key);\n          keyToRowMap.set(key, globalRowNumber); // Store 1-indexed row number\n        }\n      }\n\n      startRow += rows.length;\n      if (rows.length < chunkSize) break; // Last chunk\n    } catch {\n      break; // End of data or error\n    }\n  }\n\n  return { header, keySet, keyToRowMap, keyIndices };\n}\n\n/**\n * Partitions data into updates vs appends based on existing keys with row position tracking\n */\nexport function partitionDataForUpsert(rows: Row[], header: string[], keyStrategy: KeyGenerationStrategy, existingKeys: Set<string>, allowUpdates = false, keyToRowMap?: Map<string, number>): DataPartition {\n  const toAppend: Row[] = [];\n  const toUpdate: Array<{ row: Row; existingRowIndex: number }> = [];\n  const skippedKeys: string[] = [];\n\n  rows.forEach((row) => {\n    const key = generateRowKey(row, header, keyStrategy);\n    if (key.replace(/\\\\+/g, '') === '') {\n      // Skip rows with empty keys\n      return;\n    }\n\n    if (existingKeys.has(key)) {\n      if (allowUpdates && keyToRowMap) {\n        const existingRowIndex = keyToRowMap.get(key);\n        if (existingRowIndex !== undefined) {\n          toUpdate.push({ row, existingRowIndex });\n        } else {\n          skippedKeys.push(key);\n        }\n      } else {\n        skippedKeys.push(key);\n      }\n    } else {\n      toAppend.push(row);\n    }\n  });\n\n  return {\n    toAppend,\n    toUpdate,\n    skippedKeys,\n  };\n}\n\n/**\n * Performs batch updates on existing rows using batchUpdate API\n */\nexport async function performBatchUpdates(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, updates: Array<{ row: Row; existingRowIndex: number }>, header: string[], batchSize: number, valueInputOption: 'RAW' | 'USER_ENTERED'): Promise<{ updatedRows: number; errors?: string[] }> {\n  const errors: string[] = [];\n  let totalUpdated = 0;\n\n  // Process updates in batches\n  for (let i = 0; i < updates.length; i += batchSize) {\n    const batch = updates.slice(i, i + batchSize);\n\n    try {\n      const requests: sheets_v4.Schema$Request[] = [];\n\n      for (const { row, existingRowIndex } of batch) {\n        requests.push({\n          updateCells: {\n            range: {\n              sheetId: 0, // Will be resolved by sheet title in the range\n              startRowIndex: existingRowIndex - 1, // Convert to 0-indexed\n              endRowIndex: existingRowIndex, // Exclusive\n              startColumnIndex: 0,\n              endColumnIndex: header.length,\n            },\n            rows: [\n              {\n                values: row.map((cellValue) => ({\n                  userEnteredValue: {\n                    stringValue: String(cellValue ?? ''),\n                  },\n                })),\n              },\n            ],\n            fields: 'userEnteredValue',\n          },\n        });\n      }\n\n      if (requests.length > 0) {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId,\n          requestBody: {\n            requests,\n          },\n        });\n\n        totalUpdated += batch.length;\n      }\n    } catch (error) {\n      const errorMsg = `Batch update ${Math.floor(i / batchSize) + 1} failed: ${error instanceof Error ? error.message : String(error)}`;\n      errors.push(errorMsg);\n\n      // Try individual updates for failed batches\n      for (const { row, existingRowIndex } of batch) {\n        try {\n          const range = `${sheetTitle}!A${existingRowIndex}:${a1Col(header.length)}${existingRowIndex}`;\n          await sheets.spreadsheets.values.update({\n            spreadsheetId,\n            range,\n            valueInputOption,\n            requestBody: {\n              values: [row as (string | number | boolean | null | undefined)[]],\n            },\n          });\n          totalUpdated += 1;\n        } catch (singleError) {\n          errors.push(`Failed to update row ${existingRowIndex}: ${singleError instanceof Error ? singleError.message : String(singleError)}`);\n        }\n      }\n    }\n  }\n\n  const result: { updatedRows: number; errors?: string[] } = {\n    updatedRows: totalUpdated,\n  };\n\n  if (errors.length > 0) {\n    result.errors = errors;\n  }\n\n  return result;\n}\n\nexport async function upsertByKey(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    rows,\n    canonicalHeaders,\n    options,\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    rows: Row[];\n    canonicalHeaders?: string[];\n    options: UpsertOptions;\n    logger: Logger;\n  }\n): Promise<BatchOperationResult> {\n  // Validate inputs\n  if (!sheets) throw new Error('upsertByKey: sheets client is required');\n  if (!spreadsheetId) throw new Error('upsertByKey: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('upsertByKey: either sheetTitle or sheetRef is required');\n  if (!Array.isArray(rows) || rows.length === 0) {\n    return { updatedRows: 0, inserted: [], rowsSkipped: 0 };\n  }\n\n  // Step 1: Input validation (duplicate key checking)\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    resolvedSheetTitle = sheet?.properties?.title || sheetRef;\n  }\n\n  if (!resolvedSheetTitle) {\n    throw new Error('upsertByKey: could not resolve sheet title');\n  }\n\n  // Validate for duplicate keys in input data\n  const inputValidation = validateRowKeys(rows, canonicalHeaders || [], options.keyStrategy);\n  if (!inputValidation.valid) {\n    throw new Error(`upsertByKey: duplicate keys found in input data: ${inputValidation.duplicateKeys.join(', ')}`);\n  }\n\n  // Step 2: Header discovery and column mapping\n  const currentHeader = await discoverHeader(sheets, spreadsheetId, resolvedSheetTitle);\n  let effectiveHeader = currentHeader;\n\n  // If sheet is empty and we have canonical headers, use them\n  if (currentHeader.length === 0 && canonicalHeaders && canonicalHeaders.length > 0) {\n    effectiveHeader = canonicalHeaders;\n    // Write headers to sheet\n    await sheets.spreadsheets.values.append({\n      spreadsheetId,\n      range: `${resolvedSheetTitle}!A1`,\n      valueInputOption: options.valueInputOption || 'USER_ENTERED',\n      insertDataOption: 'INSERT_ROWS',\n      requestBody: { values: [effectiveHeader] },\n    });\n  }\n\n  // Validate headers if we have requirements\n  if (canonicalHeaders && canonicalHeaders.length > 0) {\n    const headerValidation = validateAndMapHeaders(effectiveHeader, canonicalHeaders);\n    if (!headerValidation.valid) {\n      throw new Error(`upsertByKey: missing required columns: ${headerValidation.missingColumns.join(', ')}`);\n    }\n  }\n\n  // Step 3: Key column reading for existing row lookup with position tracking\n  const { keySet: existingKeys, keyToRowMap } = await snapshotHeaderKeysAndPositions(sheets, spreadsheetId, resolvedSheetTitle, options.keyStrategy.keyColumns, options.keyStrategy);\n\n  // Step 4: Partition changes (updates vs appends)\n  let processedRows = rows;\n\n  // Map canonical data to sheet structure if needed\n  if (canonicalHeaders && canonicalHeaders.length > 0 && effectiveHeader.length > 0) {\n    processedRows = mapRowsToHeader({\n      rows,\n      header: effectiveHeader,\n      canonical: canonicalHeaders,\n    });\n  }\n\n  const partition = partitionDataForUpsert(processedRows, effectiveHeader, options.keyStrategy, existingKeys, options.allowUpdates, keyToRowMap);\n\n  // Step 5: Efficient batch writing\n  const batchSize = options.batchSize || 50;\n  const errors: string[] = [];\n  let totalUpdated = 0;\n  const insertedKeys: string[] = [];\n\n  // Handle appends with proper error handling and partial success tracking\n  if (partition.toAppend.length > 0) {\n    for (let i = 0; i < partition.toAppend.length; i += batchSize) {\n      const batch = partition.toAppend.slice(i, i + batchSize);\n      try {\n        const response = await sheets.spreadsheets.values.append({\n          spreadsheetId,\n          range: `${resolvedSheetTitle}!A1`,\n          valueInputOption: options.valueInputOption || 'USER_ENTERED',\n          insertDataOption: 'INSERT_ROWS',\n          requestBody: { values: batch },\n        });\n\n        const updatedRows = Number(response.data?.updates?.updatedRows || batch.length);\n        totalUpdated += updatedRows;\n\n        // Track inserted keys for successful batch\n        batch.forEach((row) => {\n          const key = generateRowKey(row, effectiveHeader, options.keyStrategy);\n          if (key.replace(/\\\\+/g, '') !== '') {\n            insertedKeys.push(key);\n          }\n        });\n      } catch (error) {\n        const errorMsg = `Batch ${Math.floor(i / batchSize) + 1} append failed: ${error instanceof Error ? error.message : String(error)}`;\n        errors.push(errorMsg);\n      }\n    }\n  }\n\n  // Handle updates with proper row position tracking\n  if (partition.toUpdate.length > 0 && options.allowUpdates) {\n    try {\n      const updateResult = await performBatchUpdates(sheets, spreadsheetId, resolvedSheetTitle, partition.toUpdate, effectiveHeader, batchSize, options.valueInputOption || 'USER_ENTERED');\n      totalUpdated += updateResult.updatedRows;\n      if (updateResult.errors) {\n        errors.push(...updateResult.errors);\n      }\n    } catch (updateError) {\n      const errorMsg = `Update operations failed: ${updateError instanceof Error ? updateError.message : String(updateError)}`;\n      errors.push(errorMsg);\n    }\n  }\n\n  const result: BatchOperationResult = {\n    updatedRows: totalUpdated,\n    inserted: insertedKeys,\n    rowsSkipped: partition.skippedKeys.length,\n  };\n\n  if (errors.length > 0) {\n    result.errors = errors;\n  }\n\n  return result;\n}\n"],"names":["appendRows","discoverHeader","generateRowKey","mapRowsToHeader","partitionDataForUpsert","performBatchUpdates","snapshotHeaderAndKeys","snapshotHeaderKeysAndPositions","upsertByKey","validateAndMapHeaders","validateRowKeys","sheets","spreadsheetId","sheetTitle","response","spreadsheets","values","get","range","majorDimension","data","sheetHeaders","canonicalHeaders","requiredColumns","normalizeColumn","col","String","toLowerCase","replace","sheetNormalized","map","canonicalNormalized","requiredNormalized","mappings","missingColumns","extraColumns","forEach","canonical","canonicalIndex","canonicalNorm","sheetIndex","indexOf","sheetHeader","undefined","push","sheet","index","extraIndex","splice","includes","valid","length","row","header","strategy","keyColumns","useProviderIdLogic","separator","lowerHeader","h","providerIndex","idIndex","providerVal","trim","idVal","join","keyIndices","name","normalizedName","filter","components","every","comp","rows","keyMap","Map","duplicateKeys","key","has","set","indices","sheetRef","keySet","logger","resolvedSheetTitle","respHeader","vr","resolveKeyIndices","keyColsIdx","batchSize","totalUpdated","i","app","batch","resp","updatedRows","toKey","rowsToInsert","insertedKeys","r","rowsSkipped","INTERNAL_BATCH_SIZE","app2","error","singleRow","singleApp","singleResp","singleUpdatedRows","singleError","Error","findSheetByRef","properties","title","Array","isArray","inserted","kc","hdr","c","idx","slice","append","valueInputOption","insertDataOption","requestBody","Number","updates","warn","message","validation","mappingLookup","m","mappedRow","fill","canonicalCol","keyStrategy","Math","chunkSize","startRow","minIndex","maxIndex","startCol","endCol","endRow","Set","min","max","a1Col","rawRow","fullRow","globalIndex","_localIndex","localRowIndex","add","keyToRowMap","globalRowNumber","localRowArrayIndex","existingKeys","allowUpdates","toAppend","toUpdate","skippedKeys","existingRowIndex","errors","requests","errorMsg","result","updateCells","sheetId","startRowIndex","endRowIndex","startColumnIndex","endColumnIndex","cellValue","userEnteredValue","stringValue","fields","batchUpdate","floor","update","options","inputValidation","currentHeader","effectiveHeader","headerValidation","processedRows","partition","updateResult","updateError"],"mappings":";;;;;;;;;;;QAoMsBA;eAAAA;;QAnJAC;eAAAA;;QAmENC;eAAAA;;QA0OAC;eAAAA;;QAkMAC;eAAAA;;QAsCMC;eAAAA;;QA/MAC;eAAAA;;QAgFAC;eAAAA;;QA+MAC;eAAAA;;QAxlBNC;eAAAA;;QAqGAC;eAAAA;;;iCAjKM;iCACS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CxB,SAAeT,eAAeU,MAAwB,EAAEC,aAAqB,EAAEC,UAAkB;;YAO3FC,gBALHA;;;;;;;;;;oBAAW;;wBAAMH,OAAOI,YAAY,CAACC,MAAM,CAACC,GAAG,CAAC;4BACpDL,eAAAA;4BACAM,OAAO,AAAC,GAAa,OAAXL,YAAW;4BACrBM,gBAAgB;wBAClB;;;oBAJML,WAAW;oBAKjB;;wBAASA,CAAAA,EAAAA,iBAAAA,SAASM,IAAI,cAAbN,qCAAAA,eAAeE,MAAM,OAAK,CAAE,CAAC,EAAE;;;;oBAExC;;;;;;;;;;IAEJ;;AAEO,SAASP,sBAAsBY,YAAsB,EAAEC,gBAA0B;QAAEC,kBAAAA,iEAA4B,EAAE;IACtH,IAAMC,kBAAkB,yBAACC;eACvBC,OAAOD,gBAAAA,iBAAAA,MAAO,IACXE,WAAW,GACXC,OAAO,CAAC,cAAc;;IAE3B,IAAMC,kBAAkBR,aAAaS,GAAG,CAACN;IACzC,IAAMO,sBAAsBT,iBAAiBQ,GAAG,CAACN;IACjD,IAAMQ,qBAAqBT,gBAAgBO,GAAG,CAACN;IAE/C,IAAMS,WAA4B,EAAE;IACpC,IAAMC,iBAA2B,EAAE;IACnC,IAAMC,eAA0B,qBAAGd;IAEnC,wCAAwC;IACxCC,iBAAiBc,OAAO,CAAC,SAACC,WAAWC;QACnC,IAAMC,gBAAgBR,mBAAmB,CAACO,eAAe;QACzD,IAAI,CAACC,eAAe,QAAQ,iDAAiD;QAE7E,IAAIC,aAAaX,gBAAgBY,OAAO,CAACF;QAEzC,mDAAmD;QACnD,IAAIC,eAAe,CAAC,KAAKD,kBAAkB,MAAM;YAC/CC,aAAaX,gBAAgBY,OAAO,CAAC;QACvC;QAEA,IAAID,eAAe,CAAC,GAAG;YACrB,IAAME,cAAcrB,YAAY,CAACmB,WAAW;YAC5C,IAAIE,gBAAgBC,WAAW;gBAC7BV,SAASW,IAAI,CAAC;oBACZP,WAAAA;oBACAQ,OAAOH;oBACPI,OAAON;gBACT;gBACA,4BAA4B;gBAC5B,IAAMO,aAAaZ,aAAaM,OAAO,CAACC;gBACxC,IAAIK,eAAe,CAAC,GAAG;oBACrBZ,aAAaa,MAAM,CAACD,YAAY;gBAClC;YACF;QACF,OAAO,IAAIf,mBAAmBiB,QAAQ,CAACV,gBAAgB;YACrDL,eAAeU,IAAI,CAACP;QACtB;IACF;IAEA,OAAO;QACLa,OAAOhB,eAAeiB,MAAM,KAAK;QACjCjB,gBAAAA;QACAC,cAAAA;QACAF,UAAAA;IACF;AACF;AAGO,SAAS/B,eAAekD,GAAQ,EAAEC,MAAgB,EAAEC,QAA+B;IACxF,IAAQC,aAAqDD,SAArDC,YAAYC,qBAAyCF,SAAzCE,0CAAyCF,SAArBG,WAAAA,6CAAY;IAEpD,0CAA0C;IAC1C,IAAMC,cAAcL,OAAOvB,GAAG,CAAC,SAAC6B;eAAMjC,OAAOiC,cAAAA,eAAAA,IAAK,IAAIhC,WAAW;;IAEjE,IAAI6B,oBAAoB;QACtB,IAAMI,gBAAgBF,YAAYjB,OAAO,CAAC;QAC1C,IAAIoB,UAAUH,YAAYjB,OAAO,CAAC;QAClC,IAAIoB,YAAY,CAAC,GAAGA,UAAUH,YAAYjB,OAAO,CAAC;QAElD,IAAImB,iBAAiB,KAAKC,WAAW,GAAG;gBACXT,oBACNA;YADrB,IAAMU,cAAcpC,QAAO0B,qBAAAA,GAAG,CAACQ,cAAc,cAAlBR,gCAAAA,qBAAsB,IAAIW,IAAI;YACzD,IAAMC,QAAQtC,QAAO0B,eAAAA,GAAG,CAACS,QAAQ,cAAZT,0BAAAA,eAAgB,IAAIW,IAAI;YAC7C,IAAID,eAAeE,OAAO;gBACxB,mDAAmD;gBACnD,OAAO;oBAACF;oBAAaE;iBAAM,CAACC,IAAI,CAACR;YACnC;QACF;IACF;IAEA,kDAAkD;IAClD,IAAMS,aAAaX,WAChBzB,GAAG,CAAC,SAACqC;QACJ,IAAMC,iBAAiB1C,OAAOyC,iBAAAA,kBAAAA,OAAQ,IAAIxC,WAAW;QACrD,IAAImB,QAAQY,YAAYjB,OAAO,CAAC2B;QAChC,uCAAuC;QACvC,IAAItB,UAAU,CAAC,KAAKsB,mBAAmB,MAAM;YAC3CtB,QAAQY,YAAYjB,OAAO,CAAC;QAC9B;QACA,OAAOK;IACT,GACCuB,MAAM,CAAC,SAACvB;eAAUA,SAAS;;IAE9B,IAAIoB,WAAWf,MAAM,KAAK,GAAG;QAC3B,OAAO,IAAI,qDAAqD;IAClE;IAEA,IAAMmB,aAAaJ,WAAWpC,GAAG,CAAC,SAACgB;YAAiBM;eAAP1B,QAAO0B,aAAAA,GAAG,CAACN,MAAM,cAAVM,wBAAAA,aAAc,IAAIW,IAAI;;IAC1E,kDAAkD;IAClD,IAAIO,WAAWC,KAAK,CAAC,SAACC;eAASA,KAAKrB,MAAM,GAAG;QAAI;QAC/C,OAAOmB,WAAWL,IAAI,CAACR;IACzB;IAEA,OAAO;AACT;AAEO,SAAS/C,gBAAgB+D,IAAW,EAAEpB,MAAgB,EAAEC,QAA+B;IAC5F,IAAMoB,SAAS,IAAIC;IACnB,IAAMC,gBAA0B,EAAE;IAElCH,KAAKrC,OAAO,CAAC,SAACgB,KAAKN;YAOjB4B;QANA,IAAMG,MAAM3E,eAAekD,KAAKC,QAAQC;QACxC,IAAIuB,IAAIjD,OAAO,CAAC,QAAQ,QAAQ,IAAI,QAAQ,kBAAkB;QAE9D,IAAI,CAAC8C,OAAOI,GAAG,CAACD,MAAM;YACpBH,OAAOK,GAAG,CAACF,KAAK,EAAE;QACpB;SACAH,cAAAA,OAAOzD,GAAG,CAAC4D,kBAAXH,kCAAAA,YAAiB9B,IAAI,CAACE;IACxB;IAEA,kBAAkB;IAClB4B,OAAOtC,OAAO,CAAC,SAAC4C,SAASH;QACvB,IAAIG,QAAQ7B,MAAM,GAAG,GAAG;YACtByB,cAAchC,IAAI,CAACiC;QACrB;IACF;IAEA,OAAO;QACL3B,OAAO0B,cAAczB,MAAM,KAAK;QAChCyB,eAAAA;QACAF,QAAAA;IACF;AACF;AAOO,SAAe1E;wCACpBW,MAAwB,EACxB,KAkBC;YAjBCC,eACAC,YACAoE,uBACAR,qBACAS,2BACA3B,2BACAF,QACA8B,QAiBEC,oBAEIvC,OAEiBA,mBAWjBwC,YACAC,IAIFC,mBAeAC,YAGAC,WAGAC,cACKC,GAIoBC,cAHrBC,OACAC,MACAF,KACAG,aAMJC,OAaAC,cACAC,cACD,2BAAA,mBAAA,gBAAA,WAAA,OAAMC,GACHtB,KAOAuB,aAMFC,qBAEFX,eACKC,IACDE,QAUuBS,eARrBR,OAOAQ,MACAP,cAECQ,OAGA,4BAAA,oBAAA,iBAAA,YAAA,QAAMC,WAU0BC,oBAR3BC,YAOAD,WACAE,mBAECC,aACP,2DAA2D;QAC3DzB,mBAIJ,mCAAmC;QACnCA,eAIAiB;;;;oBAnJJxF,gBADF,MACEA,eACAC,aAFF,MAEEA,YACAoE,WAHF,MAGEA,wBAHF,MAIER,MAAAA,kEAJF,MAKES,QAAAA,oCAAS,0CALX,MAME3B,YAAAA;wBAAc;2DANhB,MAOEF,QAAAA,wDACA8B,SARF,MAQEA;oBAYF,IAAI,CAACxE,QAAQ,MAAM,IAAIkG,MAAM;oBAC7B,IAAI,CAACjG,eAAe,MAAM,IAAIiG,MAAM;oBACpC,IAAI,CAAChG,cAAc,CAACoE,UAAU,MAAM,IAAI4B,MAAM;oBAE9C,2DAA2D;oBACvDzB,qBAAqBvE;yBACrBoE,UAAAA;;;;oBACY;;wBAAM6B,IAAAA,iCAAc,EAACnG,QAAQC,eAAeqE,UAAUE;;;oBAA9DtC,QAAQ;oBACd,IAAIA,OAAO;;wBACTuC,qBAAqBvC,EAAAA,oBAAAA,MAAMkE,UAAU,cAAhBlE,wCAAAA,kBAAkBmE,KAAK,KAAI/B;oBAClD,OAAO;wBACL,qDAAqD;wBACrDG,qBAAqBH;oBACvB;;;oBAGF,IAAI,CAACG,oBAAoB,MAAM,IAAIyB,MAAM;oBACzC,IAAI,CAACI,MAAMC,OAAO,CAACzC,SAASA,KAAKtB,MAAM,KAAK,GAAG;;wBAAO;4BAAE4C,aAAa;4BAAGoB,QAAQ;wBAAiB;;yBAE7F,CAAA,CAACF,MAAMC,OAAO,CAAC7D,WAAWA,OAAOF,MAAM,KAAK,CAAA,GAA5C;;;;oBACiB;;wBAAMxC,OAAOI,YAAY,CAACC,MAAM,CAACC,GAAG,CAAC;4BAAEL,eAAAA;4BAAeM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAAOjE,gBAAgB;wBAAO;;;oBAA9HkE,aAAa;oBACbC,KAAKD,WAAWjE,IAAI;oBAC1BiC,SAAU,AAACiC,CAAAA,CAAAA,eAAAA,yBAAAA,GAAItE,MAAM,OAAK,CAAE,CAAC,EAAE;;;oBAG3BuE,oBAAoB,2BAAC6B,IAAcC;wBACvC,IAAI,CAACJ,MAAMC,OAAO,CAACE,OAAOA,GAAGjE,MAAM,KAAK,GAAG,OAAO,EAAE;4BAC/C,kCAAA,2BAAA;;4BAAL,QAAK,YAAWiE,uBAAX,SAAA,6BAAA,QAAA,yBAAA,iCAAe;gCAAf,IAAME,IAAN;gCACH,IAAI,OAAOA,MAAM,YAAYA,EAAEnE,MAAM,KAAK,GAAG,MAAM,IAAI0D,MAAM;4BAC/D;;4BAFK;4BAAA;;;qCAAA,6BAAA;oCAAA;;;oCAAA;0CAAA;;;;wBAGL,IAAI,CAACI,MAAMC,OAAO,CAACG,QAAQA,IAAIlE,MAAM,KAAK,GAAG;4BAC3C,MAAM,IAAI0D,MAAM;wBAClB;wBACA,OAAOO,GAAGtF,GAAG,CAAC,SAACqC;4BACb,IAAMoD,MAAMF,IAAI5E,OAAO,CAAC0B;4BACxB,IAAIoD,QAAQ,CAAC,GAAG,MAAM,IAAIV,MAAM,AAAC,4BAAgC,OAAL1C,MAAK;4BACjE,OAAOoD;wBACT;oBACF;oBAEM/B,aAAaD,kBAAkBhC,YAAYF;oBAEjD,oDAAoD;oBAC9CoC,YAAY;yBAEd,CAAA,CAACD,cAAcA,WAAWrC,MAAM,KAAK,CAAA,GAArC;;;;oBACEuC,eAAe;oBACVC,IAAI;;;yBAAGA,CAAAA,IAAIlB,KAAKtB,MAAM,AAAD;;;;oBACtB0C,QAAQpB,KAAK+C,KAAK,CAAC7B,GAAGA,IAAIF;oBACnB;;wBAAM9E,OAAOI,YAAY,CAACC,MAAM,CAACyG,MAAM,CAAC;4BAAE7G,eAAAA;4BAAeM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAAMsC,kBAAkB;4BAAOC,kBAAkB;4BAAeC,aAAa;gCAAE5G,QAAQ6E;4BAAqB;wBAAE;;;oBAA3MC,OAAO;oBACPF,MAAME,KAAK1E,IAAI;oBACf2E,cAAc8B,OAAOjC,CAAAA,gBAAAA,2BAAAA,eAAAA,IAAKkC,OAAO,cAAZlC,mCAAAA,aAAcG,WAAW,KAAIF,MAAM1C,MAAM;oBACpEuC,gBAAgBK;;;oBALeJ,KAAKF;;;;;;oBAOtC;;wBAAO;4BAAEM,aAAaL;4BAAcyB,QAAQ;4BAAkBf,aAAa;wBAAE;;;oBAGzEJ,QAAQ,eAACG;wBACb,IAAM/C,MAAM+C;wBAEZ,yCAAyC;wBACzC,IAAM7C,WAAkC;4BACtCC,YAAAA;4BACAC,oBAAoB;4BACpBC,WAAW;wBACb;wBAEA,OAAOvD,eAAekD,KAAKC,QAAQC;oBACrC;oBAEM2C;oBACAC;oBACD,kCAAA,2BAAA;;wBAAL,IAAK,YAAWzB,2BAAX,6BAAA,QAAA,yBAAA,iCAAgC;4BAA1B0B,IAAN;4BACGtB,MAAMmB,MAAMG;4BAClB,IAAIjB,UAAUA,OAAOJ,GAAG,CAACD,MAAM;4BAC/BoB,aAAarD,IAAI,CAACuD;4BAClBD,aAAatD,IAAI,CAACiC;wBACpB;;wBALK;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBAOL,IAAIoB,aAAa9C,MAAM,KAAK,GAAG;wBACvBiD,cAAc3B,KAAKtB,MAAM,GAAG8C,aAAa9C,MAAM,EAAE,6CAA6C;wBACpG;;4BAAO;gCAAE4C,aAAa;gCAAGoB,QAAQ;gCAAkBf,aAAAA;4BAAY;;oBACjE;oBAEA,gFAAgF;oBAChF,0EAA0E;oBACpEC,sBAAsB;oBAExBX,gBAAe;oBACVC,KAAI;;;yBAAGA,CAAAA,KAAIM,aAAa9C,MAAM,AAAD;;;;oBAC9B0C,SAAQI,aAAauB,KAAK,CAAC7B,IAAGA,KAAIU;;;;;;;;;oBAEzB;;wBAAM1F,OAAOI,YAAY,CAACC,MAAM,CAACyG,MAAM,CAAC;4BACnD7G,eAAAA;4BACAM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAC7BsC,kBAAkB;4BAClBC,kBAAkB;4BAClBC,aAAa;gCAAE5G,QAAQ6E;4BAAqB;wBAC9C;;;oBANMC,QAAO;oBAOPQ,OAAOR,MAAK1E,IAAI;oBAChB2E,eAAc8B,OAAOvB,CAAAA,iBAAAA,4BAAAA,gBAAAA,KAAMwB,OAAO,cAAbxB,oCAAAA,cAAeP,WAAW,KAAIF,OAAM1C,MAAM;oBACrEuC,iBAAgBK;;;;;;oBACTQ;yBAEHV,CAAAA,OAAM1C,MAAM,GAAG,CAAA,GAAf0C;;;;oBACG,mCAAA,4BAAA;;;;;;;;;oBAAA,aAAmBA;;;2BAAnB,8BAAA,SAAA;;;;oBAAMW,YAAN;;;;;;;;;oBAEkB;;wBAAM7F,OAAOI,YAAY,CAACC,MAAM,CAACyG,MAAM,CAAC;4BACzD7G,eAAAA;4BACAM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAC7BsC,kBAAkB;4BAClBC,kBAAkB;4BAClBC,aAAa;gCAAE5G,MAAM;oCAAGwF;;4BAAwB;wBAClD;;;oBANME,aAAa;oBAObD,YAAYC,WAAWtF,IAAI;oBAC3BuF,oBAAoBkB,OAAOpB,CAAAA,sBAAAA,iCAAAA,qBAAAA,UAAWqB,OAAO,cAAlBrB,yCAAAA,mBAAoBV,WAAW,KAAI;oBACpEL,iBAAgBiB;;;;;;oBACTC;qBAEPzB,eAAAA,OAAO4C,IAAI,cAAX5C,mCAAAA,kBAAAA,QAAc,AAAC,gCAAwG,OAAzEyB,AAAW,YAAXA,aAAuBC,SAAQD,YAAYoB,OAAO,GAAGtG,OAAOkF;;;;;;oBAdzG;;;;;;;;;;;;oBAAA;oBAAA;;;;;;;6BAAA,8BAAA;4BAAA;;;4BAAA;kCAAA;;;;;;;;;;;;qBAmBLzB,gBAAAA,OAAO4C,IAAI,cAAX5C,oCAAAA,mBAAAA,QAAc,AAAC,2BAAiF,OAAvDoB,AAAK,YAALA,OAAiBM,SAAQN,MAAMyB,OAAO,GAAGtG,OAAO6E;;;;;;;;oBAnCtDZ,MAAKU;;;;;;oBAuCxCD,eAAc3B,KAAKtB,MAAM,GAAG8C,aAAa9C,MAAM;oBACrD;;wBAAO;4BAAE4C,aAAaL;4BAAcyB,UAAUjB;4BAAcE,aAAAA;wBAAY;;;;IAC1E;;AAEO,SAASjG,gBAAgB,KAAiH;sBAAjH,MAAEsE,MAAAA,gCAAO,EAAE,gCAAX,MAAapB,QAAAA,oCAAS,EAAE,qCAAxB,MAA0BhB,WAAAA,0CAAY,EAAE;IACtE,IAAI,CAAC4E,MAAMC,OAAO,CAACzC,SAASA,KAAKtB,MAAM,KAAK,GAAG,OAAO,EAAE;IACxD,IAAI,CAAC8D,MAAMC,OAAO,CAAC7D,WAAWA,OAAOF,MAAM,KAAK,GAAG,OAAOsB;IAC1D,IAAI,CAACwC,MAAMC,OAAO,CAAC7E,cAAcA,UAAUc,MAAM,KAAK,GAAG,OAAOsB;IAEhE,IAAMwD,aAAaxH,sBAAsB4C,QAAQhB;IACjD,IAAM6F,gBAAgB,IAAIvD,IAAIsD,WAAWhG,QAAQ,CAACH,GAAG,CAAC,SAACqG;eAAM;YAACA,EAAE9F,SAAS;YAAE8F,EAAErF,KAAK;SAAC;;IAEnF,OAAO2B,KAAK3C,GAAG,CAAC,SAACsB;QACf,qEAAqE;QACrE,qEAAqE;QACrE,IAAMgF,YAAiB,IAAInB,MAAM5D,OAAOF,MAAM,EAAEkF,IAAI,CAAC;QAErDhG,UAAUD,OAAO,CAAC,SAACkG,cAAchG;YAC/B,IAAME,aAAa0F,cAAcjH,GAAG,CAACqH;YACrC,IAAI9F,eAAeG,aAAaL,iBAAiBc,IAAID,MAAM,EAAE;gBAC3D,sDAAsD;gBACtDiF,SAAS,CAAC5F,WAAW,GAAGY,GAAG,CAACd,eAAe;YAC7C;QACF;QAEA,OAAO8F;IACT;AACF;AAEO,SAAe9H;wCAAsBK,MAAwB,EAAEC,aAAqB,EAAEC,UAAkB;YAAE0C,YAA+BgF,aAkC7HC,OACAA,qBAlCXnF,QACA6B,QAMA5B,UAOAY,YAiBAuE,WACFC,UACEC,UACAC,UACAC,UACAC,QAGEC,QACA7H,OASUJ,gBANRA,UAMA2D,MAGD,2BAAA,mBAAA,uBAAA,WAAA;;;;;oBArDsGlB,aAAAA;wBAAwB;uBAAOgF;oBAC/H;;wBAAMtI,eAAeU,QAAQC,eAAeC;;;oBAArDwC,SAAS;oBACT6B,SAAS,IAAI8D;oBAEnB,IAAI3F,OAAOF,MAAM,KAAK,GAAG;wBACvB;;4BAAO;gCAAEE,QAAAA;gCAAQ6B,QAAAA;gCAAQhB,UAAU;4BAAK;;oBAC1C;oBAEMZ,WAAkC;wBACtCC,YAAAA;wBACAC,kBAAkB,UAAE+E,wBAAAA,kCAAAA,YAAa/E,kBAAkB,uCAAI;wBACvDC,SAAS,WAAE8E,wBAAAA,kCAAAA,YAAa9E,SAAS,yCAAI;oBACvC;oBAEA,0BAA0B;oBACpBS,aAAaX,WAChBzB,GAAG,CAAC,SAACqC;wBACJ,IAAMC,iBAAiB1C,OAAOyC,iBAAAA,kBAAAA,OAAQ,IAAIxC,WAAW;wBACrD,IAAM+B,cAAcL,OAAOvB,GAAG,CAAC,SAAC6B;mCAAMjC,OAAOiC,cAAAA,eAAAA,IAAK,IAAIhC,WAAW;;wBACjE,IAAImB,QAAQY,YAAYjB,OAAO,CAAC2B;wBAChC,IAAItB,UAAU,CAAC,KAAKsB,mBAAmB,MAAM;4BAC3CtB,QAAQY,YAAYjB,OAAO,CAAC;wBAC9B;wBACA,OAAOK;oBACT,GACCuB,MAAM,CAAC,SAACvB;+BAAUA,SAAS;;oBAE9B,IAAIoB,WAAWf,MAAM,KAAK,GAAG;wBAC3B;;4BAAO;gCAAEE,QAAAA;gCAAQ6B,QAAAA;gCAAQhB,YAAAA;4BAAW;;oBACtC;oBAEA,kCAAkC;oBAC5BuE,YAAY;oBACdC,WAAW;oBACTC,WAAWH,CAAAA,QAAAA,MAAKS,GAAG,OAART,OAAS,qBAAGtE;oBACvB0E,WAAWJ,CAAAA,SAAAA,MAAKU,GAAG,OAARV,QAAS,qBAAGtE;oBACvB2E,WAAWM,IAAAA,wBAAK,EAACR,WAAW;oBAC5BG,SAASK,IAAAA,wBAAK,EAACP,WAAW;;;yBAEzB;;;;oBACCG,SAASL,WAAWD,YAAY;oBAChCvH,QAAQ,AAAC,GAAgB2H,OAAdhI,YAAW,KAAc6H,OAAXG,UAAuBC,OAAZJ,UAAS,KAAYK,OAATD,QAAgB,OAAPC;;;;;;;;;oBAG5C;;wBAAMpI,OAAOI,YAAY,CAACC,MAAM,CAACC,GAAG,CAAC;4BACpDL,eAAAA;4BACAM,OAAAA;4BACAC,gBAAgB;wBAClB;;;oBAJML,WAAW;oBAMX2D,OAAQ3D,EAAAA,iBAAAA,SAASM,IAAI,cAAbN,qCAAAA,eAAeE,MAAM;oBACnC,IAAIyD,KAAKtB,MAAM,KAAK,GAAG;;;;oBAElB,kCAAA,2BAAA;;;4BAAA,IAAMiG,SAAN;4BACH,0CAA0C;4BAC1C,IAAMC,UAAe,IAAIpC,MAAM5D,OAAOF,MAAM,EAAEkF,IAAI,CAAC;4BACnDnE,WAAW9B,OAAO,CAAC,SAACkH,aAAaC;gCAC/B,IAAMC,gBAAgBF,cAAcX;gCACpC,IAAIa,iBAAiB,KAAKA,gBAAgBJ,OAAOjG,MAAM,EAAE;oCACvDkG,OAAO,CAACC,YAAY,GAAGF,MAAM,CAACI,cAAc;gCAC9C;4BACF;4BAEA,IAAM3E,MAAM3E,eAAemJ,SAAShG,QAAQC;4BAC5C,IAAIuB,IAAIjD,OAAO,CAAC,QAAQ,QAAQ,IAAI;gCAClCsD,OAAOuE,GAAG,CAAC5E;4BACb;wBACF;wBAdA,IAAK,YAAgBJ,2BAAhB,6BAAA,QAAA,yBAAA;;wBAAA;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBAgBLiE,YAAYjE,KAAKtB,MAAM;oBACvB,IAAIsB,KAAKtB,MAAM,GAAGsF,WAAW;;;uBAAO,aAAa;;;;;;;oBAEjD;;;uBAAO,uBAAuB;;;;;;;oBAIlC;;wBAAO;4BAAEpF,QAAAA;4BAAQ6B,QAAAA;4BAAQhB,YAAAA;wBAAW;;;;IACtC;;AAGO,SAAe3D;wCAA+BI,MAAwB,EAAEC,aAAqB,EAAEC,UAAkB;YAAE0C,YAA+BgF,aAmCtIC,OACAA,qBAnCXnF,QACA6B,QACAwE,aAMApG,UAOAY,YAiBAuE,WACFC,UACEC,UACAC,UACAC,UACAC,QAGEC,QACA7H,cASUJ,gBANRA,UAMA2D,MAGG+E;;;;;oBAtD2GjG,aAAAA;wBAAwB;uBAAOgF;oBACxI;;wBAAMtI,eAAeU,QAAQC,eAAeC;;;oBAArDwC,SAAS;oBACT6B,SAAS,IAAI8D;oBACbU,cAAc,IAAI/E;oBAExB,IAAItB,OAAOF,MAAM,KAAK,GAAG;wBACvB;;4BAAO;gCAAEE,QAAAA;gCAAQ6B,QAAAA;gCAAQwE,aAAAA;gCAAaxF,UAAU;4BAAK;;oBACvD;oBAEMZ,WAAkC;wBACtCC,YAAAA;wBACAC,kBAAkB,UAAE+E,wBAAAA,kCAAAA,YAAa/E,kBAAkB,uCAAI;wBACvDC,SAAS,WAAE8E,wBAAAA,kCAAAA,YAAa9E,SAAS,yCAAI;oBACvC;oBAEA,0BAA0B;oBACpBS,aAAaX,WAChBzB,GAAG,CAAC,SAACqC;wBACJ,IAAMC,iBAAiB1C,OAAOyC,iBAAAA,kBAAAA,OAAQ,IAAIxC,WAAW;wBACrD,IAAM+B,cAAcL,OAAOvB,GAAG,CAAC,SAAC6B;mCAAMjC,OAAOiC,cAAAA,eAAAA,IAAK,IAAIhC,WAAW;;wBACjE,IAAImB,QAAQY,YAAYjB,OAAO,CAAC2B;wBAChC,IAAItB,UAAU,CAAC,KAAKsB,mBAAmB,MAAM;4BAC3CtB,QAAQY,YAAYjB,OAAO,CAAC;wBAC9B;wBACA,OAAOK;oBACT,GACCuB,MAAM,CAAC,SAACvB;+BAAUA,SAAS;;oBAE9B,IAAIoB,WAAWf,MAAM,KAAK,GAAG;wBAC3B;;4BAAO;gCAAEE,QAAAA;gCAAQ6B,QAAAA;gCAAQwE,aAAAA;gCAAaxF,YAAAA;4BAAW;;oBACnD;oBAEA,0DAA0D;oBACpDuE,YAAY;oBACdC,WAAW,GAAG,kCAAkC;oBAC9CC,WAAWH,CAAAA,QAAAA,MAAKS,GAAG,OAART,OAAS,qBAAGtE;oBACvB0E,WAAWJ,CAAAA,SAAAA,MAAKU,GAAG,OAARV,QAAS,qBAAGtE;oBACvB2E,WAAWM,IAAAA,wBAAK,EAACR,WAAW;oBAC5BG,SAASK,IAAAA,wBAAK,EAACP,WAAW;;;yBAEzB;;;;oBACCG,SAASL,WAAWD,YAAY;oBAChCvH,QAAQ,AAAC,GAAgB2H,OAAdhI,YAAW,KAAc6H,OAAXG,UAAuBC,OAAZJ,UAAS,KAAYK,OAATD,QAAgB,OAAPC;;;;;;;;;;wBAa3D,IAAMK,SAAS3E,IAAI,CAAC+E,cAAc;wBAClC,IAAMG,kBAAkBjB,WAAWc;wBAEnC,0CAA0C;wBAC1C,IAAMH,UAAe,IAAIpC,MAAM5D,OAAOF,MAAM,EAAEkF,IAAI,CAAC;wBACnD,IAAIe,QAAQ;4BACVlF,WAAW9B,OAAO,CAAC,SAACkH,aAAaC;gCAC/B,IAAMK,qBAAqBN,cAAcX;gCACzC,IAAIiB,sBAAsB,KAAKA,qBAAqBR,OAAOjG,MAAM,EAAE;oCACjEkG,OAAO,CAACC,YAAY,GAAGF,MAAM,CAACQ,mBAAmB;gCACnD;4BACF;wBACF;wBAEA,IAAM/E,MAAM3E,eAAemJ,SAAShG,QAAQC;wBAC5C,IAAIuB,IAAIjD,OAAO,CAAC,QAAQ,QAAQ,IAAI;4BAClCsD,OAAOuE,GAAG,CAAC5E;4BACX6E,YAAY3E,GAAG,CAACF,KAAK8E,kBAAkB,6BAA6B;wBACtE;oBACF;oBA7BiB;;wBAAMhJ,OAAOI,YAAY,CAACC,MAAM,CAACC,GAAG,CAAC;4BACpDL,eAAAA;4BACAM,OAAAA;4BACAC,gBAAgB;wBAClB;;;oBAJML,WAAW;oBAMX2D,OAAQ3D,EAAAA,iBAAAA,SAASM,IAAI,cAAbN,qCAAAA,eAAeE,MAAM;oBACnC,IAAIyD,KAAKtB,MAAM,KAAK,GAAG;;;;oBAEvB,IAASqG,gBAAgB,GAAGA,gBAAgB/E,KAAKtB,MAAM,EAAEqG;oBAsBzDd,YAAYjE,KAAKtB,MAAM;oBACvB,IAAIsB,KAAKtB,MAAM,GAAGsF,WAAW;;;uBAAO,aAAa;;;;;;;oBAEjD;;;uBAAO,uBAAuB;;;;;;;oBAIlC;;wBAAO;4BAAEpF,QAAAA;4BAAQ6B,QAAAA;4BAAQwE,aAAAA;4BAAaxF,YAAAA;wBAAW;;;;IACnD;;AAKO,SAAS9D,uBAAuBqE,IAAW,EAAEpB,MAAgB,EAAEkF,WAAkC,EAAEsB,YAAyB;QAAEC,eAAAA,iEAAe,OAAOJ;IACzJ,IAAMK,WAAkB,EAAE;IAC1B,IAAMC,WAA0D,EAAE;IAClE,IAAMC,cAAwB,EAAE;IAEhCxF,KAAKrC,OAAO,CAAC,SAACgB;QACZ,IAAMyB,MAAM3E,eAAekD,KAAKC,QAAQkF;QACxC,IAAI1D,IAAIjD,OAAO,CAAC,QAAQ,QAAQ,IAAI;YAClC,4BAA4B;YAC5B;QACF;QAEA,IAAIiI,aAAa/E,GAAG,CAACD,MAAM;YACzB,IAAIiF,gBAAgBJ,aAAa;gBAC/B,IAAMQ,mBAAmBR,YAAYzI,GAAG,CAAC4D;gBACzC,IAAIqF,qBAAqBvH,WAAW;oBAClCqH,SAASpH,IAAI,CAAC;wBAAEQ,KAAAA;wBAAK8G,kBAAAA;oBAAiB;gBACxC,OAAO;oBACLD,YAAYrH,IAAI,CAACiC;gBACnB;YACF,OAAO;gBACLoF,YAAYrH,IAAI,CAACiC;YACnB;QACF,OAAO;YACLkF,SAASnH,IAAI,CAACQ;QAChB;IACF;IAEA,OAAO;QACL2G,UAAAA;QACAC,UAAAA;QACAC,aAAAA;IACF;AACF;AAKO,SAAe5J,oBAAoBM,MAAwB,EAAEC,aAAqB,EAAEC,UAAkB,EAAEiH,OAAsD,EAAEzE,MAAgB,EAAEoC,SAAiB,EAAEiC,gBAAwC;;YAC5OyC,QACFzE,cAGKC,GACDE,OAGEuE,UAED,2BAAA,mBAAA,gBAAA,WAAA,oBAAQhH,KAAK8G,kBAkCX3D,OACD8D,UAID,4BAAA,oBAAA,iBAAA,YAAA,sBAAQjH,MAAK8G,mBAERhJ,OAUC0F,kBAOT0D;;;;oBApEAH;oBACFzE,eAAe;oBAGVC,IAAI;;;yBAAGA,CAAAA,IAAImC,QAAQ3E,MAAM,AAAD;;;;oBACzB0C,QAAQiC,QAAQN,KAAK,CAAC7B,GAAGA,IAAIF;;;;;;;;;oBAG3B2E;oBAED,kCAAA,2BAAA;;wBAAL,IAAK,YAAmCvE,4BAAnC,6BAAA,QAAA,yBAAA,iCAA0C;0CAA1C,aAAQzC,kBAAAA,KAAK8G,+BAAAA;4BAChBE,SAASxH,IAAI,CAAC;gCACZ2H,aAAa;oCACXrJ,OAAO;wCACLsJ,SAAS;wCACTC,eAAeP,mBAAmB;wCAClCQ,aAAaR;wCACbS,kBAAkB;wCAClBC,gBAAgBvH,OAAOF,MAAM;oCAC/B;oCACAsB,IAAI;wCACF;4CACEzD,QAAQoC,IAAItB,GAAG,CAAC,SAAC+I;uDAAe;oDAC9BC,kBAAkB;wDAChBC,aAAarJ,OAAOmJ,sBAAAA,uBAAAA,YAAa;oDACnC;gDACF;;wCACF;;oCAEFG,QAAQ;gCACV;4BACF;wBACF;;wBAtBK;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;yBAwBDZ,CAAAA,SAASjH,MAAM,GAAG,CAAA,GAAlBiH;;;;oBACF;;wBAAMzJ,OAAOI,YAAY,CAACkK,WAAW,CAAC;4BACpCrK,eAAAA;4BACAgH,aAAa;gCACXwC,UAAAA;4BACF;wBACF;;;oBALA;oBAOA1E,gBAAgBG,MAAM1C,MAAM;;;;;;;;oBAEvBoD;oBACD8D,WAAW,AAAC,gBAAwD9D,OAAzCiC,KAAK0C,KAAK,CAACvF,IAAIF,aAAa,GAAE,aAAkE,OAAvDc,AAAK,YAALA,OAAiBM,SAAQN,MAAMyB,OAAO,GAAGtG,OAAO6E;oBAC1H4D,OAAOvH,IAAI,CAACyH;oBAGP,mCAAA,4BAAA;;;;;;;;;oBAAA,aAAmCxE;;;2BAAnC,8BAAA,SAAA;;;;mCAAA,cAAQzC,oBAAAA,KAAK8G,iCAAAA;;;;;;;;;oBAERhJ,QAAQ,AAAC,GAAiBgJ,OAAfrJ,YAAW,MAAwBsI,OAApBe,mBAAiB,KAA0BA,OAAvBf,IAAAA,wBAAK,EAAC9F,OAAOF,MAAM,GAAqB,OAAjB+G;oBAC3E;;wBAAMvJ,OAAOI,YAAY,CAACC,MAAM,CAACmK,MAAM,CAAC;4BACtCvK,eAAAA;4BACAM,OAAAA;4BACAwG,kBAAAA;4BACAE,aAAa;gCACX5G,MAAM;oCAAGoC;;4BACX;wBACF;;;oBAPA;oBAQAsC,gBAAgB;;;;;;oBACTkB;oBACPuD,OAAOvH,IAAI,CAAC,AAAC,wBAA4CgE,OAArBsD,mBAAiB,MAA6E,OAAzEtD,AAAW,YAAXA,aAAuBC,SAAQD,YAAYoB,OAAO,GAAGtG,OAAOkF;;;;;;oBAbpH;;;;;;;;;;;;oBAAA;oBAAA;;;;;;;6BAAA,8BAAA;4BAAA;;;4BAAA;kCAAA;;;;;;;;;;;;oBA7C2BjB,KAAKF;;;;;;oBAgEnC6E,SAAqD;wBACzDvE,aAAaL;oBACf;oBAEA,IAAIyE,OAAOhH,MAAM,GAAG,GAAG;wBACrBmH,OAAOH,MAAM,GAAGA;oBAClB;oBAEA;;wBAAOG;;;;IACT;;AAEO,SAAe9J;wCACpBG,MAAwB,EACxB,KAgBC;YAfCC,eACAC,YACAoE,UACAR,MACAnD,kBACA8J,SACAjG,QAoBEC,oBAGmBvC,mBADfA,OASFwI,iBAMAC,eACFC,iBAiBIC,kBAOsC,MAA9B3B,cAAcH,aAG1B+B,eAWEC,WAGAjG,WACA0E,QACFzE,cACEQ,cAIKP,GACDE,OAUuB/E,wBAAAA,gBARrBA,UAQAiF,aAUCQ,OACD8D,UASFsB,cAGJxB,SAEKyB,aACDvB,WAKJC;;;;oBAtIJ1J,gBADF,MACEA,eACAC,aAFF,MAEEA,YACAoE,WAHF,MAGEA,UACAR,OAJF,MAIEA,MACAnD,mBALF,MAKEA,kBACA8J,UANF,MAMEA,SACAjG,SAPF,MAOEA;oBAWF,kBAAkB;oBAClB,IAAI,CAACxE,QAAQ,MAAM,IAAIkG,MAAM;oBAC7B,IAAI,CAACjG,eAAe,MAAM,IAAIiG,MAAM;oBACpC,IAAI,CAAChG,cAAc,CAACoE,UAAU,MAAM,IAAI4B,MAAM;oBAC9C,IAAI,CAACI,MAAMC,OAAO,CAACzC,SAASA,KAAKtB,MAAM,KAAK,GAAG;wBAC7C;;4BAAO;gCAAE4C,aAAa;gCAAGoB,QAAQ;gCAAMf,aAAa;4BAAE;;oBACxD;oBAEA,oDAAoD;oBAChDhB,qBAAqBvE;yBACrBoE,UAAAA;;;;oBACY;;wBAAM6B,IAAAA,iCAAc,EAACnG,QAAQC,eAAeqE,UAAUE;;;oBAA9DtC,QAAQ;oBACduC,qBAAqBvC,CAAAA,kBAAAA,6BAAAA,oBAAAA,MAAOkE,UAAU,cAAjBlE,wCAAAA,kBAAmBmE,KAAK,KAAI/B;;;oBAGnD,IAAI,CAACG,oBAAoB;wBACvB,MAAM,IAAIyB,MAAM;oBAClB;oBAEA,4CAA4C;oBACtCwE,kBAAkB3K,gBAAgB+D,MAAMnD,wBAAwB8J,QAAQ7C,WAAW;oBACzF,IAAI,CAAC8C,gBAAgBnI,KAAK,EAAE;wBAC1B,MAAM,IAAI2D,MAAM,AAAC,oDAA4F,OAAzCwE,gBAAgBzG,aAAa,CAACX,IAAI,CAAC;oBACzG;oBAGsB;;wBAAMhE,eAAeU,QAAQC,eAAewE;;;oBAA5DkG,gBAAgB;oBAClBC,kBAAkBD;yBAGlBA,CAAAA,cAAcnI,MAAM,KAAK,KAAK7B,oBAAoBA,iBAAiB6B,MAAM,GAAG,CAAA,GAA5EmI;;;;oBACFC,kBAAkBjK;oBAClB,yBAAyB;oBACzB;;wBAAMX,OAAOI,YAAY,CAACC,MAAM,CAACyG,MAAM,CAAC;4BACtC7G,eAAAA;4BACAM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAC7BsC,kBAAkB0D,QAAQ1D,gBAAgB,IAAI;4BAC9CC,kBAAkB;4BAClBC,aAAa;gCAAE5G,MAAM;oCAAGuK;;4BAAiB;wBAC3C;;;oBANA;;;oBASF,2CAA2C;oBAC3C,IAAIjK,oBAAoBA,iBAAiB6B,MAAM,GAAG,GAAG;wBAC7CqI,mBAAmB/K,sBAAsB8K,iBAAiBjK;wBAChE,IAAI,CAACkK,iBAAiBtI,KAAK,EAAE;4BAC3B,MAAM,IAAI2D,MAAM,AAAC,0CAAoF,OAA3C2E,iBAAiBtJ,cAAc,CAAC+B,IAAI,CAAC;wBACjG;oBACF;oBAG8C;;wBAAM1D,+BAA+BI,QAAQC,eAAewE,oBAAoBgG,QAAQ7C,WAAW,CAAChF,UAAU,EAAE6H,QAAQ7C,WAAW;;;oBAAnI,OAAA,eAA9BsB,eAA8B,KAAtC3E,QAAsBwE,cAAgB,KAAhBA;oBAE9B,iDAAiD;oBAC7C+B,gBAAgBhH;oBAEpB,kDAAkD;oBAClD,IAAInD,oBAAoBA,iBAAiB6B,MAAM,GAAG,KAAKoI,gBAAgBpI,MAAM,GAAG,GAAG;wBACjFsI,gBAAgBtL,gBAAgB;4BAC9BsE,MAAAA;4BACApB,QAAQkI;4BACRlJ,WAAWf;wBACb;oBACF;oBAEMoK,YAAYtL,uBAAuBqL,eAAeF,iBAAiBH,QAAQ7C,WAAW,EAAEsB,cAAcuB,QAAQtB,YAAY,EAAEJ;oBAElI,kCAAkC;oBAC5BjE,YAAY2F,QAAQ3F,SAAS,IAAI;oBACjC0E;oBACFzE,eAAe;oBACbQ;yBAGFwF,CAAAA,UAAU3B,QAAQ,CAAC5G,MAAM,GAAG,CAAA,GAA5BuI;;;;oBACO/F,IAAI;;;yBAAGA,CAAAA,IAAI+F,UAAU3B,QAAQ,CAAC5G,MAAM,AAAD;;;;oBACpC0C,QAAQ6F,UAAU3B,QAAQ,CAACvC,KAAK,CAAC7B,GAAGA,IAAIF;;;;;;;;;oBAE3B;;wBAAM9E,OAAOI,YAAY,CAACC,MAAM,CAACyG,MAAM,CAAC;4BACvD7G,eAAAA;4BACAM,OAAO,AAAC,GAAqB,OAAnBkE,oBAAmB;4BAC7BsC,kBAAkB0D,QAAQ1D,gBAAgB,IAAI;4BAC9CC,kBAAkB;4BAClBC,aAAa;gCAAE5G,QAAQ6E;4BAAM;wBAC/B;;;oBANM/E,WAAW;oBAQXiF,cAAc8B,OAAO/G,EAAAA,iBAAAA,SAASM,IAAI,cAAbN,sCAAAA,yBAAAA,eAAegH,OAAO,cAAtBhH,6CAAAA,uBAAwBiF,WAAW,KAAIF,MAAM1C,MAAM;oBAC9EuC,gBAAgBK;oBAEhB,2CAA2C;oBAC3CF,MAAMzD,OAAO,CAAC,SAACgB;wBACb,IAAMyB,MAAM3E,eAAekD,KAAKmI,iBAAiBH,QAAQ7C,WAAW;wBACpE,IAAI1D,IAAIjD,OAAO,CAAC,QAAQ,QAAQ,IAAI;4BAClCsE,aAAatD,IAAI,CAACiC;wBACpB;oBACF;;;;;;oBACO0B;oBACD8D,WAAW,AAAC,SAAwD9D,OAAhDiC,KAAK0C,KAAK,CAACvF,IAAIF,aAAa,GAAE,oBAAyE,OAAvDc,AAAK,YAALA,OAAiBM,SAAQN,MAAMyB,OAAO,GAAGtG,OAAO6E;oBAC1H4D,OAAOvH,IAAI,CAACyH;;;;;;oBAvB+B1E,KAAKF;;;;;;yBA6BlDiG,CAAAA,UAAU1B,QAAQ,CAAC7G,MAAM,GAAG,KAAKiI,QAAQtB,YAAY,AAAD,GAApD4B;;;;;;;;;;;;oBAEqB;;wBAAMrL,oBAAoBM,QAAQC,eAAewE,oBAAoBsG,UAAU1B,QAAQ,EAAEuB,iBAAiB9F,WAAW2F,QAAQ1D,gBAAgB,IAAI;;;oBAAhKiE,eAAe;oBACrBjG,gBAAgBiG,aAAa5F,WAAW;oBACxC,IAAI4F,aAAaxB,MAAM,EAAE;;wBACvBA,CAAAA,UAAAA,QAAOvH,IAAI,OAAXuH,SAAY,qBAAGwB,aAAaxB,MAAM;oBACpC;;;;;;oBACOyB;oBACDvB,YAAW,AAAC,6BAAqG,OAAzEuB,AAAW,YAAXA,aAAuB/E,SAAQ+E,YAAY5D,OAAO,GAAGtG,OAAOkK;oBAC1GzB,OAAOvH,IAAI,CAACyH;;;;;;oBAIVC,SAA+B;wBACnCvE,aAAaL;wBACbyB,UAAUjB;wBACVE,aAAasF,UAAUzB,WAAW,CAAC9G,MAAM;oBAC3C;oBAEA,IAAIgH,OAAOhH,MAAM,GAAG,GAAG;wBACrBmH,OAAOH,MAAM,GAAGA;oBAClB;oBAEA;;wBAAOG;;;;IACT"}

package/dist/cjs/spreadsheet/markdown-runs.d.cts

@@ -1,34 +1,4 @@
-/**
- * Inline Markdown → Google Sheets textFormatRuns
- *
- * The Sheets values API can only write plain text or formulas — it cannot set
- * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`
- * only ever produces one link per cell. Multiple distinct clickable links (or
- * any other rich text) inside a single cell require `textFormatRuns`, which is
- * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module
- * parses a small, deliberately restricted subset of inline markdown into plain
- * text plus the `textFormatRuns` needed to render it.
- *
- * Supported inline constructs:
- *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`
- *   - `**bold**` / `__bold__`                    -> `format.bold`
- *   - `*italic*` / `_italic_`                     -> `format.italic`
- *   - `~~strikethrough~~`                         -> `format.strikethrough`
- *   - `\X` escapes any of the delimiter characters above to a literal `X`
- *
- * Everything else (headers, lists, tables, backticks, unmatched delimiters,
- * ...) is passed through as literal text. This module never throws on
- * malformed markdown — graceful degradation to literal text is the contract.
- *
- * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in
- * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,
- * `str.slice()`) already operates on UTF-16 code units, so plain indexing is
- * exactly correct here. Do NOT iterate with `[...str]` or any other code-point
- * aware iteration — that would silently misalign indices for any text
- * containing astral characters (e.g. emoji), which are represented as
- * surrogate pairs (2 code units).
- */
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 /** A formatting span over `text`, in UTF-16 code unit coordinates (half-open: [start, end)). */
 export interface MarkdownSpan {
     start: number;

package/dist/cjs/spreadsheet/markdown-runs.d.ts

@@ -1,34 +1,4 @@
-/**
- * Inline Markdown → Google Sheets textFormatRuns
- *
- * The Sheets values API can only write plain text or formulas — it cannot set
- * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`
- * only ever produces one link per cell. Multiple distinct clickable links (or
- * any other rich text) inside a single cell require `textFormatRuns`, which is
- * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module
- * parses a small, deliberately restricted subset of inline markdown into plain
- * text plus the `textFormatRuns` needed to render it.
- *
- * Supported inline constructs:
- *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`
- *   - `**bold**` / `__bold__`                    -> `format.bold`
- *   - `*italic*` / `_italic_`                     -> `format.italic`
- *   - `~~strikethrough~~`                         -> `format.strikethrough`
- *   - `\X` escapes any of the delimiter characters above to a literal `X`
- *
- * Everything else (headers, lists, tables, backticks, unmatched delimiters,
- * ...) is passed through as literal text. This module never throws on
- * malformed markdown — graceful degradation to literal text is the contract.
- *
- * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in
- * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,
- * `str.slice()`) already operates on UTF-16 code units, so plain indexing is
- * exactly correct here. Do NOT iterate with `[...str]` or any other code-point
- * aware iteration — that would silently misalign indices for any text
- * containing astral characters (e.g. emoji), which are represented as
- * surrogate pairs (2 code units).
- */
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 /** A formatting span over `text`, in UTF-16 code unit coordinates (half-open: [start, end)). */
 export interface MarkdownSpan {
     start: number;

package/dist/cjs/spreadsheet/markdown-runs.js

@@ -1,33 +1,4 @@
-/**
- * Inline Markdown → Google Sheets textFormatRuns
- *
- * The Sheets values API can only write plain text or formulas — it cannot set
- * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`
- * only ever produces one link per cell. Multiple distinct clickable links (or
- * any other rich text) inside a single cell require `textFormatRuns`, which is
- * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module
- * parses a small, deliberately restricted subset of inline markdown into plain
- * text plus the `textFormatRuns` needed to render it.
- *
- * Supported inline constructs:
- *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`
- *   - `**bold**` / `__bold__`                    -> `format.bold`
- *   - `*italic*` / `_italic_`                     -> `format.italic`
- *   - `~~strikethrough~~`                         -> `format.strikethrough`
- *   - `\X` escapes any of the delimiter characters above to a literal `X`
- *
- * Everything else (headers, lists, tables, backticks, unmatched delimiters,
- * ...) is passed through as literal text. This module never throws on
- * malformed markdown — graceful degradation to literal text is the contract.
- *
- * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in
- * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,
- * `str.slice()`) already operates on UTF-16 code units, so plain indexing is
- * exactly correct here. Do NOT iterate with `[...str]` or any other code-point
- * aware iteration — that would silently misalign indices for any text
- * containing astral characters (e.g. emoji), which are represented as
- * surrogate pairs (2 code units).
- */ "use strict";
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
@@ -105,7 +76,36 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
-// Default styling applied to link runs so they read as clickable links (Sheets'
+/**
+ * Inline Markdown → Google Sheets textFormatRuns
+ *
+ * The Sheets values API can only write plain text or formulas — it cannot set
+ * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`
+ * only ever produces one link per cell. Multiple distinct clickable links (or
+ * any other rich text) inside a single cell require `textFormatRuns`, which is
+ * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module
+ * parses a small, deliberately restricted subset of inline markdown into plain
+ * text plus the `textFormatRuns` needed to render it.
+ *
+ * Supported inline constructs:
+ *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`
+ *   - `**bold**` / `__bold__`                    -> `format.bold`
+ *   - `*italic*` / `_italic_`                     -> `format.italic`
+ *   - `~~strikethrough~~`                         -> `format.strikethrough`
+ *   - `\X` escapes any of the delimiter characters above to a literal `X`
+ *
+ * Everything else (headers, lists, tables, backticks, unmatched delimiters,
+ * ...) is passed through as literal text. This module never throws on
+ * malformed markdown — graceful degradation to literal text is the contract.
+ *
+ * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in
+ * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,
+ * `str.slice()`) already operates on UTF-16 code units, so plain indexing is
+ * exactly correct here. Do NOT iterate with `[...str]` or any other code-point
+ * aware iteration — that would silently misalign indices for any text
+ * containing astral characters (e.g. emoji), which are represented as
+ * surrogate pairs (2 code units).
+ */ // Default styling applied to link runs so they read as clickable links (Sheets'
 // own link color), matching what Sheets applies automatically for =HYPERLINK().
 var LINK_BLUE = {
     red: 0.06666667,