@mcp-z/mcp-sheets 2.3.1 → 2.4.0

package/dist/esm/mcp/tools/values-markdown-update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n  cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n  text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n  cells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference of the cell that was written'),\n        text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n        linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n      })\n    )\n    .describe('Cells successfully written'),\n  failedCells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference that failed'),\n        error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description:\n    'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.markdownUpdate called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for markdown update', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build one updateCells request per cell\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n    const failedCells: Array<{ cell: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation and reject anything that isn't a single cell\n        const rangeRef = parseA1Notation(request.cell);\n        if (rangeRef.type !== 'cell') {\n          throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n        }\n\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n        const parsed = parseInlineMarkdown(request.text);\n        const runs = buildTextFormatRuns(parsed);\n\n        batchRequests.push({\n          updateCells: {\n            range: gridRange,\n            rows: [\n              {\n                values: [\n                  {\n                    userEnteredValue: { stringValue: parsed.text },\n                    textFormatRuns: runs,\n                  },\n                ],\n              },\n            ],\n            fields: 'userEnteredValue,textFormatRuns',\n          },\n        });\n        cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse cell for markdown update', {\n          cell: request.cell,\n          error: message,\n        });\n        failedCells.push({\n          cell: request.cell,\n          error: `Failed to parse cell: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all cells failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        cells: [],\n        failedCells: failedCells.length > 0 ? failedCells : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.values.markdownUpdate executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.values.markdownUpdate completed successfully', {\n      successCount: cells.length,\n      failedCount: failedCells.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: cells.length,\n      cells,\n      failedCells: failedCells.length > 0 ? failedCells : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // Re-throw ProtocolError as-is\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Markdown update operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-markdown-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildTextFormatRuns","parseInlineMarkdown","parseA1Notation","rangeReferenceToGridRange","MarkdownCellRequestSchema","object","cell","string","min","describe","text","inputSchema","id","gid","requests","array","max","successBranchSchema","type","literal","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","Error","gridRange","parsed","runs","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","message","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n  cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n  text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n  cells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference of the cell that was written'),\n        text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n        linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n      })\n    )\n    .describe('Cells successfully written'),\n  failedCells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference that failed'),\n        error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description:\n    'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.markdownUpdate called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for markdown update', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build one updateCells request per cell\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n    const failedCells: Array<{ cell: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation and reject anything that isn't a single cell\n        const rangeRef = parseA1Notation(request.cell);\n        if (rangeRef.type !== 'cell') {\n          throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n        }\n\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n        const parsed = parseInlineMarkdown(request.text);\n        const runs = buildTextFormatRuns(parsed);\n\n        batchRequests.push({\n          updateCells: {\n            range: gridRange,\n            rows: [\n              {\n                values: [\n                  {\n                    userEnteredValue: { stringValue: parsed.text },\n                    textFormatRuns: runs,\n                  },\n                ],\n              },\n            ],\n            fields: 'userEnteredValue,textFormatRuns',\n          },\n        });\n        cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse cell for markdown update', {\n          cell: request.cell,\n          error: message,\n        });\n        failedCells.push({\n          cell: request.cell,\n          error: `Failed to parse cell: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all cells failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        cells: [],\n        failedCells: failedCells.length > 0 ? failedCells : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.values.markdownUpdate executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.values.markdownUpdate completed successfully', {\n      successCount: cells.length,\n      failedCount: failedCells.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: cells.length,\n      cells,\n      failedCells: failedCells.length > 0 ? failedCells : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // Re-throw ProtocolError as-is\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Markdown update operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-markdown-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildTextFormatRuns","parseInlineMarkdown","parseA1Notation","rangeReferenceToGridRange","MarkdownCellRequestSchema","object","cell","string","min","describe","text","inputSchema","id","gid","requests","array","max","successBranchSchema","type","literal","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","Error","gridRange","parsed","runs","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","message","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}

package/dist/esm/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 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}

package/dist/esm/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 { 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","object","id","gid","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","sheetTitle","title","rowCount","gridProperties","columnCount","endColumn","fullRange","debug","response","range","valueRenderOption","res","allRows","Array","isArray","searchQuery","toLowerCase","a1Array","valuesArray","cellMatches","cell","cellValue","includes","rowIdx","length","row","colIdx","colLetter","rowNum","push","matchingRows","matches","some","colEnd","max","headerRow","matchingCols","header","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","object","id","gid","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","sheetTitle","title","rowCount","gridProperties","columnCount","endColumn","fullRange","debug","response","range","valueRenderOption","res","allRows","Array","isArray","searchQuery","toLowerCase","a1Array","valuesArray","cellMatches","cell","cellValue","includes","rowIdx","length","row","colIdx","colLetter","rowNum","push","matchingRows","matches","some","colEnd","max","headerRow","matchingCols","header","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool","name"],"mappings":"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"}

package/dist/esm/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/schemas/index.ts"],"sourcesContent":["import { z } from 'zod';\n\n// Spreadsheet and sheet reference schemas\nexport const SpreadsheetRefSchema = z.string().min(1).describe('Spreadsheet reference: full URL, exact name, or partial name (not ID - use spreadsheet-find to get ID)');\n\nexport const SheetRefSchema = z.string().min(1).describe('Sheet reference: exact title or partial name match (not ID - use sheet-find to get ID)');\n\n// Shared descriptions for consistency\nconst SPREADSHEET_ID_DESC = 'Spreadsheet ID (from URL d/{id})';\nconst SHEET_ID_DESC = 'Sheet ID (from URL gid={gid})';\n\n// Input schemas (with validation)\n// Note: z.coerce.string() converts numbers to strings, handling cases where MCP clients\n// pass gid: 0 (number) instead of gid: \"0\" (string). This is critical for gid=0 which\n// is the default sheet ID in new spreadsheets.\nexport const SpreadsheetIdSchema = z.string().min(1).describe(SPREADSHEET_ID_DESC);\nexport const SheetGidSchema = z.coerce.string().min(1).describe(SHEET_ID_DESC);\n\n// Output schemas (for use in output/response schemas)\nexport const SpreadsheetIdOutput = z.string().describe(SPREADSHEET_ID_DESC);\nexport const SheetGidOutput = z.string().describe(SHEET_ID_DESC);\n\n// Schema for individual sheet cells (can be string, number, boolean, or null)\n// null represents empty cells - JSON cannot represent undefined, and Google API uses null for empty cells\n// Infinity values are allowed as Google Sheets can contain them, but NaN is still rejected\nexport const SheetCellSchema = z.union([z.string(), z.number(), z.literal(Infinity), z.literal(-Infinity), z.boolean(), z.null()]);\n\n// Schema for a row in a sheet search result\nexport const SheetRowSchema = z.object({\n  rowIndex: z.number().int().positive().describe('1-based row number in the sheet'),\n  values: z.array(SheetCellSchema).optional().describe('Cell values for this row (included when includeData=true)'),\n  range: z.string().optional().describe('A1 notation range for this row (e.g., A5:D5)'),\n});\n\n// A1 notation validation - simplified for zod compatibility\nexport const A1NotationSchema = z.string().min(1).describe('A1 notation for cell range (e.g., A1, A1:B2, A:B, 1:2)');\n"],"names":["z","SpreadsheetRefSchema","string","min","describe","SheetRefSchema","SPREADSHEET_ID_DESC","SHEET_ID_DESC","SpreadsheetIdSchema","SheetGidSchema","coerce","SpreadsheetIdOutput","SheetGidOutput","SheetCellSchema","union","number","literal","Infinity","boolean","null","SheetRowSchema","object","rowIndex","int","positive","values","array","optional","range","A1NotationSchema"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AAExB,0CAA0C;AAC1C,OAAO,MAAMC,uBAAuBD,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0GAA0G;AAEzK,OAAO,MAAMC,iBAAiBL,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0FAA0F;AAEnJ,sCAAsC;AACtC,MAAME,sBAAsB;AAC5B,MAAMC,gBAAgB;AAEtB,kCAAkC;AAClC,wFAAwF;AACxF,sFAAsF;AACtF,+CAA+C;AAC/C,OAAO,MAAMC,sBAAsBR,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACE,qBAAqB;AACnF,OAAO,MAAMG,iBAAiBT,EAAEU,MAAM,CAACR,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACG,eAAe;AAE/E,sDAAsD;AACtD,OAAO,MAAMI,sBAAsBX,EAAEE,MAAM,GAAGE,QAAQ,CAACE,qBAAqB;AAC5E,OAAO,MAAMM,iBAAiBZ,EAAEE,MAAM,GAAGE,QAAQ,CAACG,eAAe;AAEjE,8EAA8E;AAC9E,0GAA0G;AAC1G,2FAA2F;AAC3F,OAAO,MAAMM,kBAAkBb,EAAEc,KAAK,CAAC;IAACd,EAAEE,MAAM;IAAIF,EAAEe,MAAM;IAAIf,EAAEgB,OAAO,CAACC;IAAWjB,EAAEgB,OAAO,CAAC,CAACC;IAAWjB,EAAEkB,OAAO;IAAIlB,EAAEmB,IAAI;CAAG,EAAE;AAEnI,4CAA4C;AAC5C,OAAO,MAAMC,iBAAiBpB,EAAEqB,MAAM,CAAC;IACrCC,UAAUtB,EAAEe,MAAM,GAAGQ,GAAG,GAAGC,QAAQ,GAAGpB,QAAQ,CAAC;IAC/CqB,QAAQzB,EAAE0B,KAAK,CAACb,iBAAiBc,QAAQ,GAAGvB,QAAQ,CAAC;IACrDwB,OAAO5B,EAAEE,MAAM,GAAGyB,QAAQ,GAAGvB,QAAQ,CAAC;AACxC,GAAG;AAEH,4DAA4D;AAC5D,OAAO,MAAMyB,mBAAmB7B,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0DAA0D"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/schemas/index.ts"],"sourcesContent":["import { z } from 'zod';\n\n// Spreadsheet and sheet reference schemas\nexport const SpreadsheetRefSchema = z.string().min(1).describe('Spreadsheet reference: full URL, exact name, or partial name (not ID - use spreadsheet-find to get ID)');\n\nexport const SheetRefSchema = z.string().min(1).describe('Sheet reference: exact title or partial name match (not ID - use sheet-find to get ID)');\n\n// Shared descriptions for consistency\nconst SPREADSHEET_ID_DESC = 'Spreadsheet ID (from URL d/{id})';\nconst SHEET_ID_DESC = 'Sheet ID (from URL gid={gid})';\n\n// Input schemas (with validation)\n// Note: z.coerce.string() converts numbers to strings, handling cases where MCP clients\n// pass gid: 0 (number) instead of gid: \"0\" (string). This is critical for gid=0 which\n// is the default sheet ID in new spreadsheets.\nexport const SpreadsheetIdSchema = z.string().min(1).describe(SPREADSHEET_ID_DESC);\nexport const SheetGidSchema = z.coerce.string().min(1).describe(SHEET_ID_DESC);\n\n// Output schemas (for use in output/response schemas)\nexport const SpreadsheetIdOutput = z.string().describe(SPREADSHEET_ID_DESC);\nexport const SheetGidOutput = z.string().describe(SHEET_ID_DESC);\n\n// Schema for individual sheet cells (can be string, number, boolean, or null)\n// null represents empty cells - JSON cannot represent undefined, and Google API uses null for empty cells\n// Infinity values are allowed as Google Sheets can contain them, but NaN is still rejected\nexport const SheetCellSchema = z.union([z.string(), z.number(), z.literal(Infinity), z.literal(-Infinity), z.boolean(), z.null()]);\n\n// Schema for a row in a sheet search result\nexport const SheetRowSchema = z.object({\n  rowIndex: z.number().int().positive().describe('1-based row number in the sheet'),\n  values: z.array(SheetCellSchema).optional().describe('Cell values for this row (included when includeData=true)'),\n  range: z.string().optional().describe('A1 notation range for this row (e.g., A5:D5)'),\n});\n\n// A1 notation validation - simplified for zod compatibility\nexport const A1NotationSchema = z.string().min(1).describe('A1 notation for cell range (e.g., A1, A1:B2, A:B, 1:2)');\n"],"names":["z","SpreadsheetRefSchema","string","min","describe","SheetRefSchema","SPREADSHEET_ID_DESC","SHEET_ID_DESC","SpreadsheetIdSchema","SheetGidSchema","coerce","SpreadsheetIdOutput","SheetGidOutput","SheetCellSchema","union","number","literal","Infinity","boolean","null","SheetRowSchema","object","rowIndex","int","positive","values","array","optional","range","A1NotationSchema"],"mappings":"AAAA,SAASA,CAAC,QAAQ,MAAM;AAExB,0CAA0C;AAC1C,OAAO,MAAMC,uBAAuBD,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0GAA0G;AAEzK,OAAO,MAAMC,iBAAiBL,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0FAA0F;AAEnJ,sCAAsC;AACtC,MAAME,sBAAsB;AAC5B,MAAMC,gBAAgB;AAEtB,kCAAkC;AAClC,wFAAwF;AACxF,sFAAsF;AACtF,+CAA+C;AAC/C,OAAO,MAAMC,sBAAsBR,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACE,qBAAqB;AACnF,OAAO,MAAMG,iBAAiBT,EAAEU,MAAM,CAACR,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACG,eAAe;AAE/E,sDAAsD;AACtD,OAAO,MAAMI,sBAAsBX,EAAEE,MAAM,GAAGE,QAAQ,CAACE,qBAAqB;AAC5E,OAAO,MAAMM,iBAAiBZ,EAAEE,MAAM,GAAGE,QAAQ,CAACG,eAAe;AAEjE,8EAA8E;AAC9E,0GAA0G;AAC1G,2FAA2F;AAC3F,OAAO,MAAMM,kBAAkBb,EAAEc,KAAK,CAAC;IAACd,EAAEE,MAAM;IAAIF,EAAEe,MAAM;IAAIf,EAAEgB,OAAO,CAACC;IAAWjB,EAAEgB,OAAO,CAAC,CAACC;IAAWjB,EAAEkB,OAAO;IAAIlB,EAAEmB,IAAI;CAAG,EAAE;AAEnI,4CAA4C;AAC5C,OAAO,MAAMC,iBAAiBpB,EAAEqB,MAAM,CAAC;IACrCC,UAAUtB,EAAEe,MAAM,GAAGQ,GAAG,GAAGC,QAAQ,GAAGpB,QAAQ,CAAC;IAC/CqB,QAAQzB,EAAE0B,KAAK,CAACb,iBAAiBc,QAAQ,GAAGvB,QAAQ,CAAC;IACrDwB,OAAO5B,EAAEE,MAAM,GAAGyB,QAAQ,GAAGvB,QAAQ,CAAC;AACxC,GAAG;AAEH,4DAA4D;AAC5D,OAAO,MAAMyB,mBAAmB7B,EAAEE,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC,0DAA0D"}

package/dist/esm/setup/config.js

@@ -1,3 +1,4 @@
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { Module } from 'module';
 import { homedir } from 'os';
 import * as path from 'path';
@@ -115,12 +116,12 @@ function normalizeResourceStoreUri(resourceStoreUri) {
     const filePrefix = 'file://';
     if (resourceStoreUri.startsWith(filePrefix)) {
         const rawPath = resourceStoreUri.slice(filePrefix.length);
-        const expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath;
-        return `${filePrefix}${path.resolve(expandedPath)}`;
+        const filePath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath.startsWith('/') ? fileURLToPath(resourceStoreUri) : rawPath;
+        return pathToFileURL(path.resolve(filePath)).href;
     }
     if (resourceStoreUri.includes('://')) return resourceStoreUri;
     const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;
-    return `${filePrefix}${path.resolve(expandedPath)}`;
+    return pathToFileURL(path.resolve(expandedPath)).href;
 }
 /**
  * Build production configuration from process globals.

package/dist/esm/setup/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/config.ts"],"sourcesContent":["import type * as OAuthGoogle from '@mcp-z/oauth-google';\nimport type * as McpServer from '@mcp-z/server';\nimport { Module } from 'module';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.ts';\nimport { readPkg } from './version-help.ts';\n\nconst pkg = readPkg();\n\n// @mcp-z/oauth-google and @mcp-z/server are requireable at the >=20 floor; deferred so\n// --version/--help (handled via version-help.ts, never this file) load neither package.\nconst _require = typeof require === 'undefined' ? Module.createRequire(import.meta.url) : require;\n\n/**\n * Parse Sheets server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-sheets/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - TOKEN_STORE_URI        Token storage URI (optional)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - RESOURCE_STORE_URI            Resource store URI (optional, file://)\n * - BASE_URL               Base URL for HTTP file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const oauthGoogle = _require('@mcp-z/oauth-google') as typeof OAuthGoogle;\n  const mcpServer = _require('@mcp-z/server') as typeof McpServer;\n\n  const transportConfig = mcpServer.parseConfig(args, env);\n  const oauthConfig = oauthGoogle.parseConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? oauthGoogle.parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, RESOURCE_STORE_URI, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'base-url': { type: 'string' },\n      'resource-store-uri': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  let rootDir = homedir();\n  try {\n    const configPath = mcpServer.findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;\n  const envResourceStoreUri = env.RESOURCE_STORE_URI;\n  const defaultResourceStorePath = path.join(baseDir, name, 'files');\n  const resourceStoreUri = normalizeResourceStoreUri(cliResourceStoreUri ?? envResourceStoreUri ?? defaultResourceStorePath);\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  return {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    resourceStoreUri,\n    ...(baseUrl && { baseUrl }),\n    ...(dcrConfig && { dcrConfig }),\n  };\n}\n\nfunction normalizeResourceStoreUri(resourceStoreUri: string): string {\n  const filePrefix = 'file://';\n  if (resourceStoreUri.startsWith(filePrefix)) {\n    const rawPath = resourceStoreUri.slice(filePrefix.length);\n    const expandedPath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath;\n    return `${filePrefix}${path.resolve(expandedPath)}`;\n  }\n\n  if (resourceStoreUri.includes('://')) return resourceStoreUri;\n\n  const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;\n  return `${filePrefix}${path.resolve(expandedPath)}`;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["Module","homedir","path","parseArgs","GOOGLE_SCOPE","readPkg","pkg","_require","require","createRequire","url","parseConfig","args","env","cliLogLevel","cliResourceStoreUri","oauthGoogle","mcpServer","transportConfig","oauthConfig","dcrConfig","auth","parseDcrConfig","undefined","values","options","type","strict","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","configPath","findConfigPath","config","cwd","process","stopDir","dirname","baseDir","join","envLogLevel","LOG_LEVEL","logLevel","envResourceStoreUri","RESOURCE_STORE_URI","defaultResourceStorePath","resourceStoreUri","normalizeResourceStoreUri","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","transport","version","filePrefix","startsWith","rawPath","slice","length","expandedPath","resolve","includes","createConfig","argv"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/config.ts"],"sourcesContent":["import { fileURLToPath, pathToFileURL } from 'node:url';\nimport type * as OAuthGoogle from '@mcp-z/oauth-google';\nimport type * as McpServer from '@mcp-z/server';\nimport { Module } from 'module';\nimport { homedir } from 'os';\nimport * as path from 'path';\nimport { parseArgs } from 'util';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.ts';\nimport { readPkg } from './version-help.ts';\n\nconst pkg = readPkg();\n\n// @mcp-z/oauth-google and @mcp-z/server are requireable at the >=20 floor; deferred so\n// --version/--help (handled via version-help.ts, never this file) load neither package.\nconst _require = typeof require === 'undefined' ? Module.createRequire(import.meta.url) : require;\n\n/**\n * Parse Sheets server configuration from CLI arguments and environment.\n *\n * CLI Arguments (all optional):\n * - --auth=<mode>          Authentication mode (default: loopback-oauth)\n *                          Modes: loopback-oauth, service-account, dcr\n * - --headless             Disable browser auto-open, return auth URL instead\n * - --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n * - --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n * - --dcr-verify-url=<url> External verification endpoint (required for external mode)\n * - --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n * - --port=<port>          Enable HTTP transport on specified port\n * - --stdio                Enable stdio transport (default if no port)\n * - --log-level=<level>    Logging level (default: info)\n * - --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-sheets/files)\n * - --base-url=<url>       Base URL for HTTP file serving (optional)\n *\n * Environment Variables:\n * - GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n * - GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n * - AUTH_MODE              Default authentication mode (optional)\n * - HEADLESS               Disable browser auto-open (optional)\n * - DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n * - DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n * - DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n * - TOKEN_STORE_URI        Token storage URI (optional)\n * - PORT                   Default HTTP port (optional)\n * - LOG_LEVEL              Default logging level (optional)\n * - RESOURCE_STORE_URI            Resource store URI (optional, file://)\n * - BASE_URL               Base URL for HTTP file serving (optional)\n *\n * OAuth Scopes (from constants.ts):\n * openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive\n */\nexport function parseConfig(args: string[], env: Record<string, string | undefined>): ServerConfig {\n  const oauthGoogle = _require('@mcp-z/oauth-google') as typeof OAuthGoogle;\n  const mcpServer = _require('@mcp-z/server') as typeof McpServer;\n\n  const transportConfig = mcpServer.parseConfig(args, env);\n  const oauthConfig = oauthGoogle.parseConfig(args, env);\n\n  // Parse DCR configuration if DCR mode is enabled\n  const dcrConfig = oauthConfig.auth === 'dcr' ? oauthGoogle.parseDcrConfig(args, env, GOOGLE_SCOPE) : undefined;\n\n  // Parse application-level config (LOG_LEVEL, RESOURCE_STORE_URI, BASE_URL)\n  const { values } = parseArgs({\n    args,\n    options: {\n      'log-level': { type: 'string' },\n      'base-url': { type: 'string' },\n      'resource-store-uri': { type: 'string' },\n    },\n    strict: false, // Allow other arguments\n    allowPositionals: true,\n  });\n\n  const name = pkg.name.replace(/^@[^/]+\\//, '');\n  // Parse repository URL from package.json, stripping git+ prefix and .git suffix\n  const rawRepoUrl = typeof pkg.repository === 'object' ? pkg.repository.url : pkg.repository;\n  const repositoryUrl = rawRepoUrl?.replace(/^git\\+/, '').replace(/\\.git$/, '') ?? `https://github.com/mcp-z/${name}`;\n  let rootDir = homedir();\n  try {\n    const configPath = mcpServer.findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n    rootDir = path.dirname(configPath);\n  } catch {\n    rootDir = homedir();\n  }\n  const baseDir = path.join(rootDir, '.mcp-z');\n  const cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;\n  const envLogLevel = env.LOG_LEVEL;\n  const logLevel = cliLogLevel ?? envLogLevel ?? 'info';\n\n  // Parse storage configuration\n  const cliResourceStoreUri = typeof values['resource-store-uri'] === 'string' ? values['resource-store-uri'] : undefined;\n  const envResourceStoreUri = env.RESOURCE_STORE_URI;\n  const defaultResourceStorePath = path.join(baseDir, name, 'files');\n  const resourceStoreUri = normalizeResourceStoreUri(cliResourceStoreUri ?? envResourceStoreUri ?? defaultResourceStorePath);\n\n  const cliBaseUrl = typeof values['base-url'] === 'string' ? values['base-url'] : undefined;\n  const envBaseUrl = env.BASE_URL;\n  const baseUrl = cliBaseUrl ?? envBaseUrl;\n\n  // Combine configs\n  return {\n    ...oauthConfig, // Includes clientId, auth, headless, redirectUri\n    transport: transportConfig.transport,\n    logLevel,\n    baseDir,\n    name,\n    version: pkg.version,\n    repositoryUrl,\n    resourceStoreUri,\n    ...(baseUrl && { baseUrl }),\n    ...(dcrConfig && { dcrConfig }),\n  };\n}\n\nfunction normalizeResourceStoreUri(resourceStoreUri: string): string {\n  const filePrefix = 'file://';\n  if (resourceStoreUri.startsWith(filePrefix)) {\n    const rawPath = resourceStoreUri.slice(filePrefix.length);\n    const filePath = rawPath.startsWith('~') ? rawPath.replace(/^~/, homedir()) : rawPath.startsWith('/') ? fileURLToPath(resourceStoreUri) : rawPath;\n    return pathToFileURL(path.resolve(filePath)).href;\n  }\n\n  if (resourceStoreUri.includes('://')) return resourceStoreUri;\n\n  const expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, homedir()) : resourceStoreUri;\n  return pathToFileURL(path.resolve(expandedPath)).href;\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n  return parseConfig(process.argv, process.env);\n}\n"],"names":["fileURLToPath","pathToFileURL","Module","homedir","path","parseArgs","GOOGLE_SCOPE","readPkg","pkg","_require","require","createRequire","url","parseConfig","args","env","cliLogLevel","cliResourceStoreUri","oauthGoogle","mcpServer","transportConfig","oauthConfig","dcrConfig","auth","parseDcrConfig","undefined","values","options","type","strict","allowPositionals","name","replace","rawRepoUrl","repository","repositoryUrl","rootDir","configPath","findConfigPath","config","cwd","process","stopDir","dirname","baseDir","join","envLogLevel","LOG_LEVEL","logLevel","envResourceStoreUri","RESOURCE_STORE_URI","defaultResourceStorePath","resourceStoreUri","normalizeResourceStoreUri","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","transport","version","filePrefix","startsWith","rawPath","slice","length","filePath","resolve","href","includes","expandedPath","createConfig","argv"],"mappings":"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"}

package/dist/esm/setup/http.d.ts

@@ -1,6 +1,6 @@
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
-    httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    httpServer: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/esm/setup/http.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, tools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(buildServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback and the DCR discovery/registration endpoints are\n  // meant to be reached from a browser on another origin. Keep cors() for them,\n  // scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectHttp","defaultCacheHints","McpServer","registerPrompts","registerResources","registerTools","cors","express","createDefaultRuntime","createHTTPServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","port","transport","Error","tools","oauthAdapters","accountTools","prompts","accountPrompts","buildServer","mcpServer","name","version","cacheHints","resources","app","use","json","limit","publicUrl","baseUrl","URL","undefined","info","close","httpServer","allowedOrigins","origin","allowedHosts","host","loopbackRouter","dcrRouter"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,WAAW,EAAEC,iBAAiB,EAAEC,SAAS,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAChJ,OAAOC,UAAU,OAAO;AACxB,OAAOC,aAAa,UAAU;AAE9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,iBAAiBC,MAAoB,EAAEC,SAA4B;IACvF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWrB,kBAAkBc,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAClC,MAAMC,OAAOZ,OAAOa,SAAS,CAACD,IAAI;IAClC,IAAI,CAACA,MAAM,MAAM,IAAIE,MAAM;IAE3B,MAAMC,QAAQ;WAAIL,SAASK,KAAK;WAAKb,QAAQO,IAAI,CAACO,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIR,SAASQ,OAAO;WAAKhB,QAAQO,IAAI,CAACO,aAAa,CAACG,cAAc;KAAC;IAEnF,sFAAsF;IACtF,yFAAyF;IACzF,2FAA2F;IAC3F,4EAA4E;IAC5E,MAAMC,cAAc;QAClB,MAAMC,YAAY,IAAI7B,UAAU;YAAE8B,MAAMtB,OAAOsB,IAAI;YAAEC,SAASvB,OAAOuB,OAAO;QAAC,GAAG;YAAEC,YAAYjC;QAAkB;QAChHI,cAAc0B,WAAWN;QACzBrB,kBAAkB2B,WAAWX,SAASe,SAAS;QAC/ChC,gBAAgB4B,WAAWH;QAC3B,OAAOG;IACT;IAEA,MAAMK,MAAM7B;IACZ6B,IAAIC,GAAG,CAAC9B,QAAQ+B,IAAI,CAAC;QAAEC,OAAO;IAAO;IAErC,sFAAsF;IACtF,wFAAwF;IACxF,MAAMC,YAAY9B,OAAO+B,OAAO,GAAG,IAAIC,IAAIhC,OAAO+B,OAAO,IAAIE;IAC7DtB,OAAOuB,IAAI,CAAC,CAAC,SAAS,EAAElC,OAAOsB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEa,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM9C,YAAY8B,aAAa;QAC3DT;QACAe;QACAd;QACAyB,gBAAgBP,YAAY;YAACA,UAAUQ,MAAM;SAAC,GAAGL;QACjDM,cAAcT,YAAY;YAACA,UAAUU,IAAI;SAAC,GAAGP;IAC/C;IAEA,+EAA+E;IAC/E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI/B,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc,EAAE;QAC7Cf,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc;QAC9D9B,OAAOuB,IAAI,CAAC;IACd;IAEA,IAAIhC,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS,EAAE;QACxChB,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS;QACzD/B,OAAOuB,IAAI,CAAC;IACd;IAEAvB,OAAOuB,IAAI,CAAC;IAEZ,OAAO;QACLE;QACAzB;QACAwB,OAAO;YACL,MAAMA;YACN,MAAMjC,QAAQiC,KAAK;QACrB;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, tools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(buildServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback and the DCR discovery/registration endpoints are\n  // meant to be reached from a browser on another origin. Keep cors() for them,\n  // scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectHttp","defaultCacheHints","McpServer","registerPrompts","registerResources","registerTools","cors","express","createDefaultRuntime","createHTTPServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","port","transport","Error","tools","oauthAdapters","accountTools","prompts","accountPrompts","buildServer","mcpServer","name","version","cacheHints","resources","app","use","json","limit","publicUrl","baseUrl","URL","undefined","info","close","httpServer","allowedOrigins","origin","allowedHosts","host","loopbackRouter","dcrRouter"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,WAAW,EAAEC,iBAAiB,EAAEC,SAAS,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAChJ,OAAOC,UAAU,OAAO;AACxB,OAAOC,aAAa,UAAU;AAE9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,iBAAiBC,MAAoB,EAAEC,SAA4B;IACvF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWrB,kBAAkBc,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAClC,MAAMC,OAAOZ,OAAOa,SAAS,CAACD,IAAI;IAClC,IAAI,CAACA,MAAM,MAAM,IAAIE,MAAM;IAE3B,MAAMC,QAAQ;WAAIL,SAASK,KAAK;WAAKb,QAAQO,IAAI,CAACO,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIR,SAASQ,OAAO;WAAKhB,QAAQO,IAAI,CAACO,aAAa,CAACG,cAAc;KAAC;IAEnF,sFAAsF;IACtF,yFAAyF;IACzF,2FAA2F;IAC3F,4EAA4E;IAC5E,MAAMC,cAAc;QAClB,MAAMC,YAAY,IAAI7B,UAAU;YAAE8B,MAAMtB,OAAOsB,IAAI;YAAEC,SAASvB,OAAOuB,OAAO;QAAC,GAAG;YAAEC,YAAYjC;QAAkB;QAChHI,cAAc0B,WAAWN;QACzBrB,kBAAkB2B,WAAWX,SAASe,SAAS;QAC/ChC,gBAAgB4B,WAAWH;QAC3B,OAAOG;IACT;IAEA,MAAMK,MAAM7B;IACZ6B,IAAIC,GAAG,CAAC9B,QAAQ+B,IAAI,CAAC;QAAEC,OAAO;IAAO;IAErC,sFAAsF;IACtF,wFAAwF;IACxF,MAAMC,YAAY9B,OAAO+B,OAAO,GAAG,IAAIC,IAAIhC,OAAO+B,OAAO,IAAIE;IAC7DtB,OAAOuB,IAAI,CAAC,CAAC,SAAS,EAAElC,OAAOsB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEa,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM9C,YAAY8B,aAAa;QAC3DT;QACAe;QACAd;QACAyB,gBAAgBP,YAAY;YAACA,UAAUQ,MAAM;SAAC,GAAGL;QACjDM,cAAcT,YAAY;YAACA,UAAUU,IAAI;SAAC,GAAGP;IAC/C;IAEA,+EAA+E;IAC/E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI/B,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc,EAAE;QAC7Cf,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc;QAC9D9B,OAAOuB,IAAI,CAAC;IACd;IAEA,IAAIhC,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS,EAAE;QACxChB,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS;QACzD/B,OAAOuB,IAAI,CAAC;IACd;IAEAvB,OAAOuB,IAAI,CAAC;IAEZ,OAAO;QACLE;QACAzB;QACAwB,OAAO;YACL,MAAMA;YACN,MAAMjC,QAAQiC,KAAK;QACrB;IACF;AACF"}

package/dist/esm/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/index.ts"],"sourcesContent":["export { createConfig, parseConfig } from './config.ts';\nexport { createHTTPServer } from './http.ts';\nexport { type AuthMiddleware, createOAuthAdapters, type OAuthAdapters, type OAuthRuntimeDeps } from './oauth-google.ts';\nexport * from './runtime.ts';\nexport { createStdioServer } from './stdio.ts';\n"],"names":["createConfig","parseConfig","createHTTPServer","createOAuthAdapters","createStdioServer"],"mappings":"AAAA,SAASA,YAAY,EAAEC,WAAW,QAAQ,cAAc;AACxD,SAASC,gBAAgB,QAAQ,YAAY;AAC7C,SAA8BC,mBAAmB,QAAmD,oBAAoB;AACxH,cAAc,eAAe;AAC7B,SAASC,iBAAiB,QAAQ,aAAa"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/index.ts"],"sourcesContent":["export { createConfig, parseConfig } from './config.ts';\nexport { createHTTPServer } from './http.ts';\nexport { type AuthMiddleware, createOAuthAdapters, type OAuthAdapters, type OAuthRuntimeDeps } from './oauth-google.ts';\nexport * from './runtime.ts';\nexport { createStdioServer } from './stdio.ts';\n"],"names":["createConfig","parseConfig","createHTTPServer","createOAuthAdapters","createStdioServer"],"mappings":"AAAA,SAASA,YAAY,EAAEC,WAAW,QAAQ,cAAc;AACxD,SAASC,gBAAgB,QAAQ,YAAY;AAC7C,SAA8BC,mBAAmB,QAAmD,oBAAoB;AACxH,cAAc,eAAe;AAC7B,SAASC,iBAAiB,QAAQ,aAAa"}

package/dist/esm/setup/oauth-google.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/oauth-google.ts"],"sourcesContent":["import { type AccountAuthProvider, AccountServer } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport { createDcrRouter, createLoopbackCallbackRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';\nimport type { Logger, PromptModule, ToolModule } from '@mcp-z/server';\nimport type { Router } from 'express';\nimport type { Keyv } from 'keyv';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.ts';\n\n/**\n * Gmail OAuth runtime dependencies.\n */\nexport interface OAuthRuntimeDeps {\n  logger: Logger;\n  tokenStore: Keyv<CachedToken>;\n  dcrStore?: Keyv<unknown>;\n}\n\n/**\n * Auth middleware helpers used to wrap MCP modules.\n */\nexport interface AuthMiddleware {\n  withToolAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n  withResourceAuth<T extends { name: string; template?: unknown; config?: unknown; handler: unknown }>(module: T): T;\n  withPromptAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n}\n\n/**\n * Result returned by createOAuthAdapters.\n */\nexport interface OAuthAdapters {\n  primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n  middleware: AuthMiddleware;\n  authAdapter: AccountAuthProvider;\n  accountTools: ToolModule[];\n  accountPrompts: PromptModule[];\n  dcrRouter?: Router;\n  loopbackRouter?: Router;\n}\n\n/**\n * Create Sheets OAuth adapters and helpers.\n *\n * @param config Sheets server configuration.\n * @param deps Runtime dependencies (logger, token store, optional DCR store).\n */\nexport async function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters> {\n  const { logger, tokenStore, dcrStore } = deps;\n  const oauthStaticConfig = {\n    service: config.name,\n    clientId: config.clientId,\n    clientSecret: config.clientSecret,\n    scope: GOOGLE_SCOPE,\n    auth: config.auth,\n    headless: config.headless,\n    redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,\n    ...(config.serviceAccountKeyFile && { serviceAccountKeyFile: config.serviceAccountKeyFile }),\n    ...(baseUrl && { baseUrl }),\n  };\n\n  let primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n\n  if (oauthStaticConfig.auth === 'dcr') {\n    logger.debug('Creating DCR provider', { service: oauthStaticConfig.service });\n\n    if (!dcrStore) {\n      throw new Error('DCR mode requires dcrStore to be configured');\n    }\n    if (!oauthStaticConfig.baseUrl) {\n      throw new Error('DCR mode requires baseUrl to be configured');\n    }\n\n    primary = new DcrOAuthProvider({\n      clientId: oauthStaticConfig.clientId,\n      ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      scope: oauthStaticConfig.scope,\n      verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,\n      logger,\n    });\n\n    const dcrRouter = createDcrRouter({\n      store: dcrStore,\n      issuerUrl: oauthStaticConfig.baseUrl,\n      baseUrl: oauthStaticConfig.baseUrl,\n      scopesSupported: oauthStaticConfig.scope.split(' '),\n      clientConfig: {\n        clientId: oauthStaticConfig.clientId,\n        ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      },\n    });\n\n    const middleware = primary.authMiddleware();\n    const authAdapter: AccountAuthProvider = {\n      getAccessToken: () => {\n        throw new Error('DCR mode does not support getAccessToken - tokens are provided via bearer auth');\n      },\n      getUserEmail: () => {\n        throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');\n      },\n    };\n\n    return {\n      primary,\n      middleware: middleware as unknown as AuthMiddleware,\n      authAdapter,\n      accountTools: [],\n      accountPrompts: [],\n      dcrRouter,\n    };\n  }\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    if (!oauthStaticConfig.serviceAccountKeyFile) {\n      throw new Error('Service account key file is required when auth mode is \"service-account\". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');\n    }\n\n    logger.debug('Creating service account provider', { service: oauthStaticConfig.service });\n    primary = new ServiceAccountProvider({\n      keyFilePath: oauthStaticConfig.serviceAccountKeyFile,\n      scopes: oauthStaticConfig.scope.split(' '),\n      logger,\n    });\n  } else {\n    logger.debug('Creating loopback OAuth provider', { service: oauthStaticConfig.service });\n    primary = new LoopbackOAuthProvider({\n      service: oauthStaticConfig.service,\n      clientId: oauthStaticConfig.clientId,\n      clientSecret: oauthStaticConfig.clientSecret,\n      scope: oauthStaticConfig.scope,\n      headless: oauthStaticConfig.headless,\n      logger,\n      tokenStore,\n      ...(oauthStaticConfig.redirectUri !== undefined && { redirectUri: oauthStaticConfig.redirectUri }),\n    });\n  }\n\n  const authAdapter: AccountAuthProvider = primary;\n\n  let middleware: ReturnType<LoopbackOAuthProvider['authMiddleware']>;\n  let accountTools: ToolModule[];\n  let accountPrompts: PromptModule[];\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    middleware = primary.authMiddleware();\n    accountTools = [];\n    accountPrompts = [];\n    logger.debug('Service account mode - no account tools', { service: oauthStaticConfig.service });\n  } else {\n    middleware = primary.authMiddleware();\n\n    const result = AccountServer.createLoopback({\n      service: oauthStaticConfig.service,\n      store: tokenStore,\n      logger,\n      auth: authAdapter,\n    });\n    accountTools = result.tools as ToolModule[];\n    accountPrompts = result.prompts as PromptModule[];\n    logger.debug('Loopback OAuth (multi-account mode)', { service: oauthStaticConfig.service });\n  }\n\n  const loopbackRouter = primary instanceof LoopbackOAuthProvider && oauthStaticConfig.redirectUri ? createLoopbackCallbackRouter(primary) : undefined;\n\n  return {\n    primary,\n    middleware: middleware as unknown as AuthMiddleware,\n    authAdapter,\n    accountTools,\n    accountPrompts,\n    loopbackRouter,\n  };\n}\n"],"names":["AccountServer","createDcrRouter","createLoopbackCallbackRouter","DcrOAuthProvider","LoopbackOAuthProvider","ServiceAccountProvider","GOOGLE_SCOPE","createOAuthAdapters","config","deps","baseUrl","logger","tokenStore","dcrStore","oauthStaticConfig","service","name","clientId","clientSecret","scope","auth","headless","redirectUri","transport","type","undefined","serviceAccountKeyFile","primary","debug","Error","verifyEndpoint","dcrRouter","store","issuerUrl","scopesSupported","split","clientConfig","middleware","authMiddleware","authAdapter","getAccessToken","getUserEmail","accountTools","accountPrompts","keyFilePath","scopes","result","createLoopback","tools","prompts","loopbackRouter"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/oauth-google.ts"],"sourcesContent":["import { type AccountAuthProvider, AccountServer } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport { createDcrRouter, createLoopbackCallbackRouter, DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';\nimport type { Logger, PromptModule, ToolModule } from '@mcp-z/server';\nimport type { Router } from 'express';\nimport type { Keyv } from 'keyv';\nimport { GOOGLE_SCOPE } from '../constants.ts';\nimport type { ServerConfig } from '../types.ts';\n\n/**\n * Gmail OAuth runtime dependencies.\n */\nexport interface OAuthRuntimeDeps {\n  logger: Logger;\n  tokenStore: Keyv<CachedToken>;\n  dcrStore?: Keyv<unknown>;\n}\n\n/**\n * Auth middleware helpers used to wrap MCP modules.\n */\nexport interface AuthMiddleware {\n  withToolAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n  withResourceAuth<T extends { name: string; template?: unknown; config?: unknown; handler: unknown }>(module: T): T;\n  withPromptAuth<T extends { name: string; config: unknown; handler: unknown }>(module: T): T;\n}\n\n/**\n * Result returned by createOAuthAdapters.\n */\nexport interface OAuthAdapters {\n  primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n  middleware: AuthMiddleware;\n  authAdapter: AccountAuthProvider;\n  accountTools: ToolModule[];\n  accountPrompts: PromptModule[];\n  dcrRouter?: Router;\n  loopbackRouter?: Router;\n}\n\n/**\n * Create Sheets OAuth adapters and helpers.\n *\n * @param config Sheets server configuration.\n * @param deps Runtime dependencies (logger, token store, optional DCR store).\n */\nexport async function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters> {\n  const { logger, tokenStore, dcrStore } = deps;\n  const oauthStaticConfig = {\n    service: config.name,\n    clientId: config.clientId,\n    clientSecret: config.clientSecret,\n    scope: GOOGLE_SCOPE,\n    auth: config.auth,\n    headless: config.headless,\n    redirectUri: config.transport.type === 'stdio' ? undefined : config.redirectUri,\n    ...(config.serviceAccountKeyFile && { serviceAccountKeyFile: config.serviceAccountKeyFile }),\n    ...(baseUrl && { baseUrl }),\n  };\n\n  let primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;\n\n  if (oauthStaticConfig.auth === 'dcr') {\n    logger.debug('Creating DCR provider', { service: oauthStaticConfig.service });\n\n    if (!dcrStore) {\n      throw new Error('DCR mode requires dcrStore to be configured');\n    }\n    if (!oauthStaticConfig.baseUrl) {\n      throw new Error('DCR mode requires baseUrl to be configured');\n    }\n\n    primary = new DcrOAuthProvider({\n      clientId: oauthStaticConfig.clientId,\n      ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      scope: oauthStaticConfig.scope,\n      verifyEndpoint: `${oauthStaticConfig.baseUrl}/oauth/verify`,\n      logger,\n    });\n\n    const dcrRouter = createDcrRouter({\n      store: dcrStore,\n      issuerUrl: oauthStaticConfig.baseUrl,\n      baseUrl: oauthStaticConfig.baseUrl,\n      scopesSupported: oauthStaticConfig.scope.split(' '),\n      clientConfig: {\n        clientId: oauthStaticConfig.clientId,\n        ...(oauthStaticConfig.clientSecret && { clientSecret: oauthStaticConfig.clientSecret }),\n      },\n    });\n\n    const middleware = primary.authMiddleware();\n    const authAdapter: AccountAuthProvider = {\n      getAccessToken: () => {\n        throw new Error('DCR mode does not support getAccessToken - tokens are provided via bearer auth');\n      },\n      getUserEmail: () => {\n        throw new Error('DCR mode does not support getUserEmail - tokens are provided via bearer auth');\n      },\n    };\n\n    return {\n      primary,\n      middleware: middleware as unknown as AuthMiddleware,\n      authAdapter,\n      accountTools: [],\n      accountPrompts: [],\n      dcrRouter,\n    };\n  }\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    if (!oauthStaticConfig.serviceAccountKeyFile) {\n      throw new Error('Service account key file is required when auth mode is \"service-account\". Set GOOGLE_SERVICE_ACCOUNT_KEY_FILE environment variable or use --service-account-key-file flag.');\n    }\n\n    logger.debug('Creating service account provider', { service: oauthStaticConfig.service });\n    primary = new ServiceAccountProvider({\n      keyFilePath: oauthStaticConfig.serviceAccountKeyFile,\n      scopes: oauthStaticConfig.scope.split(' '),\n      logger,\n    });\n  } else {\n    logger.debug('Creating loopback OAuth provider', { service: oauthStaticConfig.service });\n    primary = new LoopbackOAuthProvider({\n      service: oauthStaticConfig.service,\n      clientId: oauthStaticConfig.clientId,\n      clientSecret: oauthStaticConfig.clientSecret,\n      scope: oauthStaticConfig.scope,\n      headless: oauthStaticConfig.headless,\n      logger,\n      tokenStore,\n      ...(oauthStaticConfig.redirectUri !== undefined && { redirectUri: oauthStaticConfig.redirectUri }),\n    });\n  }\n\n  const authAdapter: AccountAuthProvider = primary;\n\n  let middleware: ReturnType<LoopbackOAuthProvider['authMiddleware']>;\n  let accountTools: ToolModule[];\n  let accountPrompts: PromptModule[];\n\n  if (oauthStaticConfig.auth === 'service-account') {\n    middleware = primary.authMiddleware();\n    accountTools = [];\n    accountPrompts = [];\n    logger.debug('Service account mode - no account tools', { service: oauthStaticConfig.service });\n  } else {\n    middleware = primary.authMiddleware();\n\n    const result = AccountServer.createLoopback({\n      service: oauthStaticConfig.service,\n      store: tokenStore,\n      logger,\n      auth: authAdapter,\n    });\n    accountTools = result.tools as ToolModule[];\n    accountPrompts = result.prompts as PromptModule[];\n    logger.debug('Loopback OAuth (multi-account mode)', { service: oauthStaticConfig.service });\n  }\n\n  const loopbackRouter = primary instanceof LoopbackOAuthProvider && oauthStaticConfig.redirectUri ? createLoopbackCallbackRouter(primary) : undefined;\n\n  return {\n    primary,\n    middleware: middleware as unknown as AuthMiddleware,\n    authAdapter,\n    accountTools,\n    accountPrompts,\n    loopbackRouter,\n  };\n}\n"],"names":["AccountServer","createDcrRouter","createLoopbackCallbackRouter","DcrOAuthProvider","LoopbackOAuthProvider","ServiceAccountProvider","GOOGLE_SCOPE","createOAuthAdapters","config","deps","baseUrl","logger","tokenStore","dcrStore","oauthStaticConfig","service","name","clientId","clientSecret","scope","auth","headless","redirectUri","transport","type","undefined","serviceAccountKeyFile","primary","debug","Error","verifyEndpoint","dcrRouter","store","issuerUrl","scopesSupported","split","clientConfig","middleware","authMiddleware","authAdapter","getAccessToken","getUserEmail","accountTools","accountPrompts","keyFilePath","scopes","result","createLoopback","tools","prompts","loopbackRouter"],"mappings":"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"}

package/dist/esm/setup/runtime.js

@@ -1,3 +1,4 @@
+import { pathToFileURL } from 'node:url';
 import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';
 import { createLoggingMiddleware } from '@mcp-z/server';
 import * as fs from 'fs';
@@ -22,12 +23,12 @@ export function createLogger(config) {
     }) : pino.destination(1));
 }
 export async function createTokenStore(baseDir) {
-    const tokenStoreUri = process.env.TOKEN_STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;
+    const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;
     return createStore(tokenStoreUri);
 }
 export async function createDcrStore(baseDir, required) {
     if (!required) return undefined;
-    const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;
+    const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;
     return createStore(dcrStoreUri);
 }
 export function createAuthLayer(authMiddleware) {

package/dist/esm/setup/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/runtime.ts"],"sourcesContent":["import { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const tokenStoreUri = process.env.TOKEN_STORE_URI || `file://${path.join(baseDir, 'tokens.json')}`;\n  return createStore<CachedToken>(tokenStoreUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || `file://${path.join(baseDir, 'dcr.json')}`;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger)];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","tokenStoreUri","process","env","TOKEN_STORE_URI","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createDefaultRuntime","overrides","auth","Error","tokenStore","baseUrl","port","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/runtime.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\nimport { sanitizeForLoggingFormatter } from '@mcp-z/oauth';\nimport type { CachedToken } from '@mcp-z/oauth-google';\nimport type { Logger, MiddlewareLayer } from '@mcp-z/server';\nimport { createLoggingMiddleware } from '@mcp-z/server';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport pino from 'pino';\nimport createStore from '../lib/create-store.ts';\nimport * as mcp from '../mcp/index.ts';\nimport type { CommonRuntime, RuntimeDeps, RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createOAuthAdapters, type OAuthAdapters } from './oauth-google.ts';\n\nexport function createLogger(config: ServerConfig): Logger {\n  const hasStdio = config.transport.type === 'stdio';\n  const logsPath = path.join(config.baseDir, 'logs', `${config.name}.log`);\n  if (hasStdio) fs.mkdirSync(path.dirname(logsPath), { recursive: true });\n  return pino({ level: config.logLevel ?? 'info', formatters: sanitizeForLoggingFormatter() }, hasStdio ? pino.destination({ dest: logsPath, sync: false }) : pino.destination(1));\n}\n\nexport async function createTokenStore(baseDir: string) {\n  const tokenStoreUri = process.env.TOKEN_STORE_URI || pathToFileURL(path.join(baseDir, 'tokens.json')).href;\n  return createStore<CachedToken>(tokenStoreUri);\n}\n\nexport async function createDcrStore(baseDir: string, required: boolean) {\n  if (!required) return undefined;\n  const dcrStoreUri = process.env.DCR_STORE_URI || pathToFileURL(path.join(baseDir, 'dcr.json')).href;\n  return createStore<unknown>(dcrStoreUri);\n}\n\nexport function createAuthLayer(authMiddleware: OAuthAdapters['middleware']): MiddlewareLayer {\n  return {\n    withTool: authMiddleware.withToolAuth,\n    withResource: authMiddleware.withResourceAuth,\n    withPrompt: authMiddleware.withPromptAuth,\n  };\n}\n\nexport function createLoggingLayer(logger: Logger): MiddlewareLayer {\n  const logging = createLoggingMiddleware({ logger });\n  return {\n    withTool: logging.withToolLogging,\n    withResource: logging.withResourceLogging,\n    withPrompt: logging.withPromptLogging,\n  };\n}\n\nexport async function createDefaultRuntime(config: ServerConfig, overrides?: RuntimeOverrides): Promise<CommonRuntime> {\n  if (config.auth === 'dcr' && config.transport.type !== 'http') throw new Error('DCR mode requires an HTTP transport');\n\n  const logger = createLogger(config);\n  const tokenStore = await createTokenStore(config.baseDir);\n  const baseUrl = config.baseUrl ?? (config.transport.type === 'http' && config.transport.port ? `http://localhost:${config.transport.port}` : undefined);\n  const dcrStore = await createDcrStore(config.baseDir, config.auth === 'dcr');\n  const oauthAdapters = await createOAuthAdapters(config, { logger, tokenStore, dcrStore }, baseUrl);\n  const deps: RuntimeDeps = { config, logger, tokenStore, oauthAdapters, baseUrl };\n  const createDomainModules =\n    overrides?.createDomainModules ??\n    (() => ({\n      tools: Object.values(mcp.toolFactories).map((factory) => factory()),\n      resources: Object.values(mcp.resourceFactories).map((factory) => factory()),\n      prompts: Object.values(mcp.promptFactories).map((factory) => factory()),\n    }));\n  const middlewareFactories = overrides?.middlewareFactories ?? [() => createAuthLayer(oauthAdapters.middleware), () => createLoggingLayer(logger)];\n\n  return {\n    deps,\n    middlewareFactories,\n    createDomainModules,\n    close: async () => {},\n  };\n}\n"],"names":["pathToFileURL","sanitizeForLoggingFormatter","createLoggingMiddleware","fs","path","pino","createStore","mcp","createOAuthAdapters","createLogger","config","hasStdio","transport","type","logsPath","join","baseDir","name","mkdirSync","dirname","recursive","level","logLevel","formatters","destination","dest","sync","createTokenStore","tokenStoreUri","process","env","TOKEN_STORE_URI","href","createDcrStore","required","undefined","dcrStoreUri","DCR_STORE_URI","createAuthLayer","authMiddleware","withTool","withToolAuth","withResource","withResourceAuth","withPrompt","withPromptAuth","createLoggingLayer","logger","logging","withToolLogging","withResourceLogging","withPromptLogging","createDefaultRuntime","overrides","auth","Error","tokenStore","baseUrl","port","dcrStore","oauthAdapters","deps","createDomainModules","tools","Object","values","toolFactories","map","factory","resources","resourceFactories","prompts","promptFactories","middlewareFactories","middleware","close"],"mappings":"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"}

package/dist/esm/setup/stdio.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, tools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(buildServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectStdio","defaultCacheHints","McpServer","registerPrompts","registerResources","registerTools","createDefaultRuntime","createStdioServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","tools","oauthAdapters","accountTools","prompts","accountPrompts","buildServer","mcpServer","name","version","cacheHints","resources","info","close"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,YAAY,EAAEC,iBAAiB,EAAEC,SAAS,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAEjJ,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,kBAAkBC,MAAoB,EAAEC,SAA4B;IACxF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWnB,kBAAkBY,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAElC,MAAMC,QAAQ;WAAIF,SAASE,KAAK;WAAKV,QAAQO,IAAI,CAACI,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIL,SAASK,OAAO;WAAKb,QAAQO,IAAI,CAACI,aAAa,CAACG,cAAc;KAAC;IAEnF,sFAAsF;IACtF,yFAAyF;IACzF,2FAA2F;IAC3F,4EAA4E;IAC5E,MAAMC,cAAc;QAClB,MAAMC,YAAY,IAAIxB,UAAU;YAAEyB,MAAMnB,OAAOmB,IAAI;YAAEC,SAASpB,OAAOoB,OAAO;QAAC,GAAG;YAAEC,YAAY5B;QAAkB;QAChHI,cAAcqB,WAAWN;QACzBhB,kBAAkBsB,WAAWR,SAASY,SAAS;QAC/C3B,gBAAgBuB,WAAWH;QAC3B,OAAOG;IACT;IAEAP,OAAOY,IAAI,CAAC,CAAC,SAAS,EAAEvB,OAAOmB,IAAI,CAAC,mBAAmB,CAAC;IACxD,MAAM,EAAEK,KAAK,EAAE,GAAG,MAAMhC,aAAayB,aAAa;QAAEN;IAAO;IAC3DA,OAAOY,IAAI,CAAC;IAEZ,OAAO;QACLZ;QACAa,OAAO;YACL,MAAMA;YACN,MAAMtB,QAAQsB,KAAK;QACrB;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, tools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(buildServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectStdio","defaultCacheHints","McpServer","registerPrompts","registerResources","registerTools","createDefaultRuntime","createStdioServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","tools","oauthAdapters","accountTools","prompts","accountPrompts","buildServer","mcpServer","name","version","cacheHints","resources","info","close"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,YAAY,EAAEC,iBAAiB,EAAEC,SAAS,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAEjJ,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,kBAAkBC,MAAoB,EAAEC,SAA4B;IACxF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWnB,kBAAkBY,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAElC,MAAMC,QAAQ;WAAIF,SAASE,KAAK;WAAKV,QAAQO,IAAI,CAACI,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIL,SAASK,OAAO;WAAKb,QAAQO,IAAI,CAACI,aAAa,CAACG,cAAc;KAAC;IAEnF,sFAAsF;IACtF,yFAAyF;IACzF,2FAA2F;IAC3F,4EAA4E;IAC5E,MAAMC,cAAc;QAClB,MAAMC,YAAY,IAAIxB,UAAU;YAAEyB,MAAMnB,OAAOmB,IAAI;YAAEC,SAASpB,OAAOoB,OAAO;QAAC,GAAG;YAAEC,YAAY5B;QAAkB;QAChHI,cAAcqB,WAAWN;QACzBhB,kBAAkBsB,WAAWR,SAASY,SAAS;QAC/C3B,gBAAgBuB,WAAWH;QAC3B,OAAOG;IACT;IAEAP,OAAOY,IAAI,CAAC,CAAC,SAAS,EAAEvB,OAAOmB,IAAI,CAAC,mBAAmB,CAAC;IACxD,MAAM,EAAEK,KAAK,EAAE,GAAG,MAAMhC,aAAayB,aAAa;QAAEN;IAAO;IAC3DA,OAAOY,IAAI,CAAC;IAEZ,OAAO;QACLZ;QACAa,OAAO;YACL,MAAMA;YACN,MAAMtB,QAAQsB,KAAK;QACrB;IACF;AACF"}

package/dist/esm/setup/version-help.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-google and\n// @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-sheets [options]\n\nMCP server for Google Sheets spreadsheet management with OAuth authentication.\n\nOptions:\n  --version, -v          Show version number\n  --help, -h             Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-sheets/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nStorage Backends:\n  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n  file:// (the default) and memory:// work out of the box. Any other backend\n  needs its adapter installed alongside this server:\n    npm install -g @keyv/redis\n    TOKEN_STORE_URI=redis://localhost:6379 mcp-sheets\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive\n\nExamples:\n  mcp-sheets                           # Use default settings\n  mcp-sheets --auth=service-account    # Use service account auth\n  mcp-sheets --port=3000               # HTTP transport on port 3000\n  mcp-sheets --resource-store-uri=file:///tmp/sheets    # Custom resource store URI\n  GOOGLE_CLIENT_ID=xxx mcp-sheets      # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean', short: 'v' },\n      help: { type: 'boolean', short: 'h' },\n    },\n    strict: false,\n    allowPositionals: true,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n"],"names":["fs","moduleRoot","path","url","parseArgs","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","readPkg","handleVersionHelp","args","values","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,OAAOC,gBAAgB,mBAAmB;AAC1C,YAAYC,UAAU,OAAO;AAC7B,YAAYC,SAAS,MAAM;AAC3B,SAASC,SAAS,QAAQ,OAAO;AAEjC,mFAAmF;AACnF,gGAAgG;AAChG,iDAAiD;AACjD,MAAMC,MAAMC,KAAKC,KAAK,CAACP,GAAGQ,YAAY,CAACN,KAAKO,IAAI,CAACR,WAAWE,IAAIO,aAAa,CAAC,YAAYP,GAAG,IAAI,iBAAiB;AAElH,MAAMQ,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnB,CAAC,CAACC,IAAI;AAEN,6EAA6E,GAC7E,OAAO,SAASC;IACd,OAAOR;AACT;AAEA;;;CAGC,GACD,OAAO,SAASS,kBAAkBC,IAAc;IAC9C,MAAM,EAAEC,MAAM,EAAE,GAAGZ,UAAU;QAC3BW;QACAE,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB;IAEA,IAAIP,OAAOE,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQpB,IAAIa,OAAO;IAAC;IAChE,IAAIF,OAAOK,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQd;IAAU;IAC3D,OAAO;QAAEa,SAAS;IAAM;AAC1B"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/setup/version-help.ts"],"sourcesContent":["import * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { parseArgs } from 'util';\n\n// Kept dependency-free (fs/path/url/module-root-sync only) so `--version`/`--help`\n// resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-google and\n// @mcp-z/server, which this path must not touch.\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nconst HELP_TEXT = `\nUsage: mcp-sheets [options]\n\nMCP server for Google Sheets spreadsheet management with OAuth authentication.\n\nOptions:\n  --version, -v          Show version number\n  --help, -h             Show this help message\n  --auth=<mode>          Authentication mode (default: loopback-oauth)\n                         Modes: loopback-oauth, service-account, dcr\n  --headless             Disable browser auto-open, return auth URL instead\n  --redirect-uri=<uri>   OAuth redirect URI (default: ephemeral loopback)\n  --dcr-mode=<mode>      DCR mode (self-hosted or external, default: self-hosted)\n  --dcr-verify-url=<url> External verification endpoint (required for external mode)\n  --dcr-store-uri=<uri>  DCR client storage URI (required for self-hosted mode)\n  --port=<port>          Enable HTTP transport on specified port\n  --stdio                Enable stdio transport (default if no port)\n  --log-level=<level>    Logging level (default: info)\n  --resource-store-uri=<uri>    Resource store URI for CSV file storage (default: file://~/.mcp-z/mcp-sheets/files)\n  --base-url=<url>       Base URL for HTTP file serving (optional)\n\nEnvironment Variables:\n  GOOGLE_CLIENT_ID       OAuth client ID (REQUIRED)\n  GOOGLE_CLIENT_SECRET   OAuth client secret (optional)\n  AUTH_MODE              Default authentication mode (optional)\n  HEADLESS               Disable browser auto-open (optional)\n  DCR_MODE               DCR mode (optional, same format as --dcr-mode)\n  DCR_VERIFY_URL         External verification URL (optional, same as --dcr-verify-url)\n  DCR_STORE_URI          DCR storage URI (optional, same as --dcr-store-uri)\n  TOKEN_STORE_URI        Token storage URI (optional)\n  PORT                   Default HTTP port (optional)\n  LOG_LEVEL              Default logging level (optional)\n  RESOURCE_STORE_URI            Resource store URI (optional, file://)\n  BASE_URL               Base URL for HTTP file serving (optional)\n\nStorage Backends:\n  TOKEN_STORE_URI and DCR_STORE_URI accept any keyv-registry protocol.\n  file:// (the default) and memory:// work out of the box. Any other backend\n  needs its adapter installed alongside this server:\n    npm install -g @keyv/redis\n    TOKEN_STORE_URI=redis://localhost:6379 mcp-sheets\n\nOAuth Scopes:\n  openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive\n\nExamples:\n  mcp-sheets                           # Use default settings\n  mcp-sheets --auth=service-account    # Use service account auth\n  mcp-sheets --port=3000               # HTTP transport on port 3000\n  mcp-sheets --resource-store-uri=file:///tmp/sheets    # Custom resource store URI\n  GOOGLE_CLIENT_ID=xxx mcp-sheets      # Set client ID via env var\n`.trim();\n\n/** Package metadata read from package.json, resolved relative to this file. */\nexport function readPkg(): { name: string; version: string; repository?: string | { url?: string } } {\n  return pkg;\n}\n\n/**\n * Handle --version/--help flags before config parsing.\n * These must work without requiring any configuration or heavy dependency.\n */\nexport function handleVersionHelp(args: string[]): { handled: boolean; output?: string } {\n  const { values } = parseArgs({\n    args,\n    options: {\n      version: { type: 'boolean', short: 'v' },\n      help: { type: 'boolean', short: 'h' },\n    },\n    strict: false,\n    allowPositionals: true,\n  });\n\n  if (values.version) return { handled: true, output: pkg.version };\n  if (values.help) return { handled: true, output: HELP_TEXT };\n  return { handled: false };\n}\n"],"names":["fs","moduleRoot","path","url","parseArgs","pkg","JSON","parse","readFileSync","join","fileURLToPath","HELP_TEXT","trim","readPkg","handleVersionHelp","args","values","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,OAAOC,gBAAgB,mBAAmB;AAC1C,YAAYC,UAAU,OAAO;AAC7B,YAAYC,SAAS,MAAM;AAC3B,SAASC,SAAS,QAAQ,OAAO;AAEjC,mFAAmF;AACnF,gGAAgG;AAChG,iDAAiD;AACjD,MAAMC,MAAMC,KAAKC,KAAK,CAACP,GAAGQ,YAAY,CAACN,KAAKO,IAAI,CAACR,WAAWE,IAAIO,aAAa,CAAC,YAAYP,GAAG,IAAI,iBAAiB;AAElH,MAAMQ,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnB,CAAC,CAACC,IAAI;AAEN,6EAA6E,GAC7E,OAAO,SAASC;IACd,OAAOR;AACT;AAEA;;;CAGC,GACD,OAAO,SAASS,kBAAkBC,IAAc;IAC9C,MAAM,EAAEC,MAAM,EAAE,GAAGZ,UAAU;QAC3BW;QACAE,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB;IAEA,IAAIP,OAAOE,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQpB,IAAIa,OAAO;IAAC;IAChE,IAAIF,OAAOK,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQd;IAAU;IAC3D,OAAO;QAAEa,SAAS;IAAM;AAC1B"}

package/dist/esm/spreadsheet/column-utilities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/column-utilities.ts"],"sourcesContent":["export function a1Col(colIndex: number): string {\n  let col = '';\n  let i = colIndex;\n  while (i > 0) {\n    const rem = (i - 1) % 26;\n    col = String.fromCharCode(65 + rem) + col;\n    i = Math.floor((i - 1) / 26);\n  }\n  return col;\n}\n"],"names":["a1Col","colIndex","col","i","rem","String","fromCharCode","Math","floor"],"mappings":"AAAA,OAAO,SAASA,MAAMC,QAAgB;IACpC,IAAIC,MAAM;IACV,IAAIC,IAAIF;IACR,MAAOE,IAAI,EAAG;QACZ,MAAMC,MAAM,AAACD,CAAAA,IAAI,CAAA,IAAK;QACtBD,MAAMG,OAAOC,YAAY,CAAC,KAAKF,OAAOF;QACtCC,IAAII,KAAKC,KAAK,CAAC,AAACL,CAAAA,IAAI,CAAA,IAAK;IAC3B;IACA,OAAOD;AACT"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/column-utilities.ts"],"sourcesContent":["export function a1Col(colIndex: number): string {\n  let col = '';\n  let i = colIndex;\n  while (i > 0) {\n    const rem = (i - 1) % 26;\n    col = String.fromCharCode(65 + rem) + col;\n    i = Math.floor((i - 1) / 26);\n  }\n  return col;\n}\n"],"names":["a1Col","colIndex","col","i","rem","String","fromCharCode","Math","floor"],"mappings":"AAAA,OAAO,SAASA,MAAMC,QAAgB;IACpC,IAAIC,MAAM;IACV,IAAIC,IAAIF;IACR,MAAOE,IAAI,EAAG;QACZ,MAAMC,MAAM,AAACD,CAAAA,IAAI,CAAA,IAAK;QACtBD,MAAMG,OAAOC,YAAY,CAAC,KAAKF,OAAOF;QACtCC,IAAII,KAAKC,KAAK,CAAC,AAACL,CAAAA,IAAI,CAAA,IAAK;IAC3B;IACA,OAAOD;AACT"}

package/dist/esm/spreadsheet/csv-streaming.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/csv-streaming.ts"],"sourcesContent":["/** Streaming CSV parsing utilities for memory-efficient large file processing */\n\nimport { createReadStream } from 'fs';\nimport { resolve } from 'path';\nimport { Readable } from 'stream';\nimport type { ReadableStream as NodeReadableStream } from 'stream/web';\n\n/**\n * Get readable stream from CSV URI\n *\n * Memory efficiency:\n * - file:// URIs stream directly from disk\n * - http:// URIs stream directly from response (no temp files!)\n *\n * @example\n * ```ts\n * const readStream = await getCsvReadStream(csvUri);\n * const parser = readStream.pipe(parse({ columns: true }));\n * for await (const record of parser) {\n *   // Process record\n * }\n * ```\n */\nexport async function getCsvReadStream(csvUri: string): Promise<Readable> {\n  if (csvUri.startsWith('file://')) {\n    // Local file - stream directly from disk\n    const filePath = csvUri.replace('file://', '');\n    const resolvedPath = resolve(filePath);\n    return createReadStream(resolvedPath, { encoding: 'utf-8' });\n  }\n\n  if (csvUri.startsWith('http://') || csvUri.startsWith('https://')) {\n    // Remote file - stream directly from fetch response\n    const response = await fetch(csvUri);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch CSV from ${csvUri}: ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new Error(`No response body from ${csvUri}`);\n    }\n\n    // Convert web stream to Node.js stream\n    // response.body is ReadableStream<Uint8Array> from fetch API\n    // Cast to Node.js ReadableStream type for compatibility with Readable.fromWeb\n    return Readable.fromWeb(response.body as unknown as NodeReadableStream<Uint8Array>);\n  }\n\n  throw new Error(`Invalid CSV URI: ${csvUri}. Must start with file://, http://, or https://`);\n}\n"],"names":["createReadStream","resolve","Readable","getCsvReadStream","csvUri","startsWith","filePath","replace","resolvedPath","encoding","response","fetch","ok","Error","statusText","body","fromWeb"],"mappings":"AAAA,+EAA+E,GAE/E,SAASA,gBAAgB,QAAQ,KAAK;AACtC,SAASC,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,SAAS;AAGlC;;;;;;;;;;;;;;;CAeC,GACD,OAAO,eAAeC,iBAAiBC,MAAc;IACnD,IAAIA,OAAOC,UAAU,CAAC,YAAY;QAChC,yCAAyC;QACzC,MAAMC,WAAWF,OAAOG,OAAO,CAAC,WAAW;QAC3C,MAAMC,eAAeP,QAAQK;QAC7B,OAAON,iBAAiBQ,cAAc;YAAEC,UAAU;QAAQ;IAC5D;IAEA,IAAIL,OAAOC,UAAU,CAAC,cAAcD,OAAOC,UAAU,CAAC,aAAa;QACjE,oDAAoD;QACpD,MAAMK,WAAW,MAAMC,MAAMP;QAC7B,IAAI,CAACM,SAASE,EAAE,EAAE;YAChB,MAAM,IAAIC,MAAM,CAAC,yBAAyB,EAAET,OAAO,EAAE,EAAEM,SAASI,UAAU,EAAE;QAC9E;QAEA,IAAI,CAACJ,SAASK,IAAI,EAAE;YAClB,MAAM,IAAIF,MAAM,CAAC,sBAAsB,EAAET,QAAQ;QACnD;QAEA,uCAAuC;QACvC,6DAA6D;QAC7D,8EAA8E;QAC9E,OAAOF,SAASc,OAAO,CAACN,SAASK,IAAI;IACvC;IAEA,MAAM,IAAIF,MAAM,CAAC,iBAAiB,EAAET,OAAO,+CAA+C,CAAC;AAC7F"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/spreadsheet/csv-streaming.ts"],"sourcesContent":["/** Streaming CSV parsing utilities for memory-efficient large file processing */\n\nimport { createReadStream } from 'fs';\nimport { resolve } from 'path';\nimport { Readable } from 'stream';\nimport type { ReadableStream as NodeReadableStream } from 'stream/web';\n\n/**\n * Get readable stream from CSV URI\n *\n * Memory efficiency:\n * - file:// URIs stream directly from disk\n * - http:// URIs stream directly from response (no temp files!)\n *\n * @example\n * ```ts\n * const readStream = await getCsvReadStream(csvUri);\n * const parser = readStream.pipe(parse({ columns: true }));\n * for await (const record of parser) {\n *   // Process record\n * }\n * ```\n */\nexport async function getCsvReadStream(csvUri: string): Promise<Readable> {\n  if (csvUri.startsWith('file://')) {\n    // Local file - stream directly from disk\n    const filePath = csvUri.replace('file://', '');\n    const resolvedPath = resolve(filePath);\n    return createReadStream(resolvedPath, { encoding: 'utf-8' });\n  }\n\n  if (csvUri.startsWith('http://') || csvUri.startsWith('https://')) {\n    // Remote file - stream directly from fetch response\n    const response = await fetch(csvUri);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch CSV from ${csvUri}: ${response.statusText}`);\n    }\n\n    if (!response.body) {\n      throw new Error(`No response body from ${csvUri}`);\n    }\n\n    // Convert web stream to Node.js stream\n    // response.body is ReadableStream<Uint8Array> from fetch API\n    // Cast to Node.js ReadableStream type for compatibility with Readable.fromWeb\n    return Readable.fromWeb(response.body as unknown as NodeReadableStream<Uint8Array>);\n  }\n\n  throw new Error(`Invalid CSV URI: ${csvUri}. Must start with file://, http://, or https://`);\n}\n"],"names":["createReadStream","resolve","Readable","getCsvReadStream","csvUri","startsWith","filePath","replace","resolvedPath","encoding","response","fetch","ok","Error","statusText","body","fromWeb"],"mappings":"AAAA,+EAA+E,GAE/E,SAASA,gBAAgB,QAAQ,KAAK;AACtC,SAASC,OAAO,QAAQ,OAAO;AAC/B,SAASC,QAAQ,QAAQ,SAAS;AAGlC;;;;;;;;;;;;;;;CAeC,GACD,OAAO,eAAeC,iBAAiBC,MAAc;IACnD,IAAIA,OAAOC,UAAU,CAAC,YAAY;QAChC,yCAAyC;QACzC,MAAMC,WAAWF,OAAOG,OAAO,CAAC,WAAW;QAC3C,MAAMC,eAAeP,QAAQK;QAC7B,OAAON,iBAAiBQ,cAAc;YAAEC,UAAU;QAAQ;IAC5D;IAEA,IAAIL,OAAOC,UAAU,CAAC,cAAcD,OAAOC,UAAU,CAAC,aAAa;QACjE,oDAAoD;QACpD,MAAMK,WAAW,MAAMC,MAAMP;QAC7B,IAAI,CAACM,SAASE,EAAE,EAAE;YAChB,MAAM,IAAIC,MAAM,CAAC,yBAAyB,EAAET,OAAO,EAAE,EAAEM,SAASI,UAAU,EAAE;QAC9E;QAEA,IAAI,CAACJ,SAASK,IAAI,EAAE;YAClB,MAAM,IAAIF,MAAM,CAAC,sBAAsB,EAAET,QAAQ;QACnD;QAEA,uCAAuC;QACvC,6DAA6D;QAC7D,8EAA8E;QAC9E,OAAOF,SAASc,OAAO,CAACN,SAASK,IAAI;IACvC;IAEA,MAAM,IAAIF,MAAM,CAAC,iBAAiB,EAAET,OAAO,+CAA+C,CAAC;AAC7F"}