@mcp-z/mcp-sheets 2.4.2 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/README.md +45 -29
  2. package/dist/cjs/constants.d.cts +26 -0
  3. package/dist/cjs/constants.d.ts +26 -0
  4. package/dist/cjs/constants.js +83 -3
  5. package/dist/cjs/constants.js.map +1 -1
  6. package/dist/cjs/mcp/tools/cells-copy.d.cts +165 -0
  7. package/dist/cjs/mcp/tools/cells-copy.d.ts +165 -0
  8. package/dist/cjs/mcp/tools/cells-copy.js +388 -0
  9. package/dist/cjs/mcp/tools/cells-copy.js.map +1 -0
  10. package/dist/cjs/mcp/tools/cells-format.d.cts +3 -3
  11. package/dist/cjs/mcp/tools/cells-format.d.ts +3 -3
  12. package/dist/cjs/mcp/tools/cells-format.js +3 -2
  13. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  14. package/dist/cjs/mcp/tools/columns-get.d.cts +2 -2
  15. package/dist/cjs/mcp/tools/columns-get.d.ts +2 -2
  16. package/dist/cjs/mcp/tools/columns-get.js +2 -1
  17. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  18. package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
  19. package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
  20. package/dist/cjs/mcp/tools/columns-update.js +3 -2
  21. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  22. package/dist/cjs/mcp/tools/index.d.cts +1 -0
  23. package/dist/cjs/mcp/tools/index.d.ts +1 -0
  24. package/dist/cjs/mcp/tools/index.js +4 -0
  25. package/dist/cjs/mcp/tools/index.js.map +1 -1
  26. package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
  27. package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
  28. package/dist/cjs/mcp/tools/rows-append.js +2 -1
  29. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  30. package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
  31. package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
  32. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
  33. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  34. package/dist/cjs/mcp/tools/rows-get.d.cts +2 -2
  35. package/dist/cjs/mcp/tools/rows-get.d.ts +2 -2
  36. package/dist/cjs/mcp/tools/rows-get.js +2 -1
  37. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  38. package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
  39. package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
  40. package/dist/cjs/mcp/tools/values-batch-update.js +3 -2
  41. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  42. package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
  43. package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
  44. package/dist/cjs/mcp/tools/values-csv-update.js +3 -2
  45. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  46. package/dist/cjs/mcp/tools/values-search.d.cts +2 -2
  47. package/dist/cjs/mcp/tools/values-search.d.ts +2 -2
  48. package/dist/cjs/mcp/tools/values-search.js +2 -1
  49. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  50. package/dist/cjs/schemas/index.d.cts +1 -0
  51. package/dist/cjs/schemas/index.d.ts +1 -0
  52. package/dist/cjs/schemas/index.js +16 -0
  53. package/dist/cjs/schemas/index.js.map +1 -1
  54. package/dist/cjs/setup/config.js +26 -14
  55. package/dist/cjs/setup/config.js.map +1 -1
  56. package/dist/cjs/setup/version-help.js +1 -1
  57. package/dist/cjs/setup/version-help.js.map +1 -1
  58. package/dist/cjs/spreadsheet/data-operations.js +60 -181
  59. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  60. package/dist/cjs/spreadsheet/range-operations.d.cts +27 -5
  61. package/dist/cjs/spreadsheet/range-operations.d.ts +27 -5
  62. package/dist/cjs/spreadsheet/range-operations.js +48 -28
  63. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  64. package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
  65. package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
  66. package/dist/cjs/spreadsheet/sheet-operations.js +114 -124
  67. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  68. package/dist/esm/constants.d.ts +26 -0
  69. package/dist/esm/constants.js +55 -0
  70. package/dist/esm/constants.js.map +1 -1
  71. package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
  72. package/dist/esm/mcp/tools/cells-copy.js +190 -0
  73. package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
  74. package/dist/esm/mcp/tools/cells-format.d.ts +3 -3
  75. package/dist/esm/mcp/tools/cells-format.js +3 -2
  76. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  77. package/dist/esm/mcp/tools/columns-get.d.ts +2 -2
  78. package/dist/esm/mcp/tools/columns-get.js +2 -1
  79. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  80. package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
  81. package/dist/esm/mcp/tools/columns-update.js +3 -2
  82. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  83. package/dist/esm/mcp/tools/index.d.ts +1 -0
  84. package/dist/esm/mcp/tools/index.js +1 -0
  85. package/dist/esm/mcp/tools/index.js.map +1 -1
  86. package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
  87. package/dist/esm/mcp/tools/rows-append.js +2 -1
  88. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  89. package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
  90. package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
  91. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  92. package/dist/esm/mcp/tools/rows-get.d.ts +2 -2
  93. package/dist/esm/mcp/tools/rows-get.js +2 -1
  94. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  95. package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
  96. package/dist/esm/mcp/tools/values-batch-update.js +3 -2
  97. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  98. package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
  99. package/dist/esm/mcp/tools/values-csv-update.js +3 -2
  100. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  101. package/dist/esm/mcp/tools/values-search.d.ts +2 -2
  102. package/dist/esm/mcp/tools/values-search.js +2 -1
  103. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  104. package/dist/esm/schemas/index.d.ts +1 -0
  105. package/dist/esm/schemas/index.js +9 -0
  106. package/dist/esm/schemas/index.js.map +1 -1
  107. package/dist/esm/setup/config.js +26 -14
  108. package/dist/esm/setup/config.js.map +1 -1
  109. package/dist/esm/setup/version-help.js +7 -0
  110. package/dist/esm/setup/version-help.js.map +1 -1
  111. package/dist/esm/spreadsheet/data-operations.js +47 -95
  112. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  113. package/dist/esm/spreadsheet/range-operations.d.ts +27 -5
  114. package/dist/esm/spreadsheet/range-operations.js +50 -27
  115. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  116. package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
  117. package/dist/esm/spreadsheet/sheet-operations.js +88 -79
  118. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  119. package/package.json +3 -3
@@ -1 +1 @@
1
- {"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":["A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SheetRefSchema","SheetRowSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","SpreadsheetRefSchema","z","string","min","describe","SPREADSHEET_ID_DESC","SHEET_ID_DESC","coerce","union","number","literal","Infinity","boolean","null","object","rowIndex","int","positive","values","array","optional","range"],"mappings":";;;;;;;;;;;QAmCaA;eAAAA;;QAVAC;eAAAA;;QALAC;eAAAA;;QAJAC;eAAAA;;QAXAC;eAAAA;;QAuBAC;eAAAA;;QATAC;eAAAA;;QAJAC;eAAAA;;QAZAC;eAAAA;;;mBAHK;AAGX,IAAMA,uBAAuBC,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAExD,IAAMR,iBAAiBK,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAEzD,sCAAsC;AACtC,IAAMC,sBAAsB;AAC5B,IAAMC,gBAAgB;AAMf,IAAMP,sBAAsBE,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACC;AACvD,IAAMV,iBAAiBM,MAAC,CAACM,MAAM,CAACL,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACE;AAGzD,IAAMR,sBAAsBG,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACC;AAChD,IAAMX,iBAAiBO,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACE;AAK3C,IAAMb,kBAAkBQ,MAAC,CAACO,KAAK,CAAC;IAACP,MAAC,CAACC,MAAM;IAAID,MAAC,CAACQ,MAAM;IAAIR,MAAC,CAACS,OAAO,CAACC;IAAWV,MAAC,CAACS,OAAO,CAAC,CAACC;IAAWV,MAAC,CAACW,OAAO;IAAIX,MAAC,CAACY,IAAI;CAAG;AAG1H,IAAMhB,iBAAiBI,MAAC,CAACa,MAAM,CAAC;IACrCC,UAAUd,MAAC,CAACQ,MAAM,GAAGO,GAAG,GAAGC,QAAQ,GAAGb,QAAQ,CAAC;IAC/Cc,QAAQjB,MAAC,CAACkB,KAAK,CAAC1B,iBAAiB2B,QAAQ,GAAGhB,QAAQ,CAAC;IACrDiB,OAAOpB,MAAC,CAACC,MAAM,GAAGkB,QAAQ,GAAGhB,QAAQ,CAAC;AACxC;AAGO,IAAMZ,mBAAmBS,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC"}
1
+ {"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// Strict sheet ID: a non-negative integer number or a string of digits (gid 0 and \"0\" both work).\n// Unlike SheetGidSchema it does not coerce, so null, undefined, booleans, negatives, decimals and\n// non-digit strings are rejected instead of becoming \"null\", \"undefined\", \"true\", etc.\n// Sheet IDs are int32, so values above 2147483647 are rejected (keeps Number(gid) exact).\nconst MAX_SHEET_GID = 2147483647;\nexport const StrictSheetGidSchema = z\n .union([\n z.number().int().nonnegative().max(MAX_SHEET_GID),\n z\n .string()\n .regex(/^\\d+$/, 'Sheet ID must be a non-negative integer')\n .refine((value) => Number(value) <= MAX_SHEET_GID, `Sheet ID must be at most ${MAX_SHEET_GID}`),\n ])\n .transform((value) => String(typeof value === 'number' ? value : Number(value)))\n .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":["A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SheetRefSchema","SheetRowSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","SpreadsheetRefSchema","StrictSheetGidSchema","z","string","min","describe","SPREADSHEET_ID_DESC","SHEET_ID_DESC","coerce","MAX_SHEET_GID","union","number","int","nonnegative","max","regex","refine","value","Number","transform","String","literal","Infinity","boolean","null","object","rowIndex","positive","values","array","optional","range"],"mappings":";;;;;;;;;;;QAmDaA;eAAAA;;QAVAC;eAAAA;;QALAC;eAAAA;;QApBAC;eAAAA;;QAXAC;eAAAA;;QAuCAC;eAAAA;;QATAC;eAAAA;;QApBAC;eAAAA;;QAZAC;eAAAA;;QAoBAC;eAAAA;;;mBAvBK;AAGX,IAAMD,uBAAuBE,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAExD,IAAMT,iBAAiBM,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAEzD,sCAAsC;AACtC,IAAMC,sBAAsB;AAC5B,IAAMC,gBAAgB;AAMf,IAAMR,sBAAsBG,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACC;AACvD,IAAMX,iBAAiBO,MAAC,CAACM,MAAM,CAACL,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAACE;AAEhE,kGAAkG;AAClG,kGAAkG;AAClG,uFAAuF;AACvF,0FAA0F;AAC1F,IAAME,gBAAgB;AACf,IAAMR,uBAAuBC,MAAC,CAClCQ,KAAK,CAAC;IACLR,MAAC,CAACS,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGC,GAAG,CAACL;IACnCP,MAAC,CACEC,MAAM,GACNY,KAAK,CAAC,SAAS,2CACfC,MAAM,CAAC,SAACC;eAAUC,OAAOD,UAAUR;OAAe,AAAC,4BAAyC,OAAdA;CAClF,EACAU,SAAS,CAAC,SAACF;WAAUG,OAAO,OAAOH,UAAU,WAAWA,QAAQC,OAAOD;GACvEZ,QAAQ,CAACE;AAGL,IAAMT,sBAAsBI,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACC;AAChD,IAAMZ,iBAAiBQ,MAAC,CAACC,MAAM,GAAGE,QAAQ,CAACE;AAK3C,IAAMd,kBAAkBS,MAAC,CAACQ,KAAK,CAAC;IAACR,MAAC,CAACC,MAAM;IAAID,MAAC,CAACS,MAAM;IAAIT,MAAC,CAACmB,OAAO,CAACC;IAAWpB,MAAC,CAACmB,OAAO,CAAC,CAACC;IAAWpB,MAAC,CAACqB,OAAO;IAAIrB,MAAC,CAACsB,IAAI;CAAG;AAG1H,IAAM3B,iBAAiBK,MAAC,CAACuB,MAAM,CAAC;IACrCC,UAAUxB,MAAC,CAACS,MAAM,GAAGC,GAAG,GAAGe,QAAQ,GAAGtB,QAAQ,CAAC;IAC/CuB,QAAQ1B,MAAC,CAAC2B,KAAK,CAACpC,iBAAiBqC,QAAQ,GAAGzB,QAAQ,CAAC;IACrD0B,OAAO7B,MAAC,CAACC,MAAM,GAAG2B,QAAQ,GAAGzB,QAAQ,CAAC;AACxC;AAGO,IAAMb,mBAAmBU,MAAC,CAACC,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC"}
@@ -107,6 +107,7 @@ function _type_of(obj) {
107
107
  return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
108
108
  }
109
109
  var pkg = (0, _versionhelpts.readPkg)();
110
+ var SERVER_NAME = pkg.name.replace(/^@[^/]+\//, '');
110
111
  // @mcp-z/oauth-google and @mcp-z/server are requireable at the >=20 floor; deferred so
111
112
  // --version/--help (handled via version-help.ts, never this file) load neither package.
112
113
  var _require = typeof require === 'undefined' ? _module.Module.createRequire(require("url").pathToFileURL(__filename).toString()) : require;
@@ -135,22 +136,11 @@ function parseConfig(args, env) {
135
136
  strict: false,
136
137
  allowPositionals: true
137
138
  }).values;
138
- var name = pkg.name.replace(/^@[^/]+\//, '');
139
+ var name = SERVER_NAME;
139
140
  // Parse repository URL from package.json, stripping git+ prefix and .git suffix
140
141
  var rawRepoUrl = _type_of(pkg.repository) === 'object' ? pkg.repository.url : pkg.repository;
141
142
  var repositoryUrl = (_ref = rawRepoUrl === null || rawRepoUrl === void 0 ? void 0 : rawRepoUrl.replace(/^git\+/, '').replace(/\.git$/, '')) !== null && _ref !== void 0 ? _ref : "https://github.com/mcp-z/".concat(name);
142
- var rootDir = (0, _os.homedir)();
143
- try {
144
- var configPath = mcpServer.findConfigPath({
145
- config: '.mcp.json',
146
- cwd: process.cwd(),
147
- stopDir: (0, _os.homedir)()
148
- });
149
- rootDir = _path.dirname(configPath);
150
- } catch (unused) {
151
- rootDir = (0, _os.homedir)();
152
- }
153
- var baseDir = _path.join(rootDir, '.mcp-z');
143
+ var baseDir = resolveBaseDir();
154
144
  var cliLogLevel = typeof values['log-level'] === 'string' ? values['log-level'] : undefined;
155
145
  var envLogLevel = env.LOG_LEVEL;
156
146
  var logLevel = (_ref1 = cliLogLevel !== null && cliLogLevel !== void 0 ? cliLogLevel : envLogLevel) !== null && _ref1 !== void 0 ? _ref1 : 'info';
@@ -188,7 +178,29 @@ function normalizeResourceStoreUri(resourceStoreUri) {
188
178
  var expandedPath = resourceStoreUri.startsWith('~') ? resourceStoreUri.replace(/^~/, (0, _os.homedir)()) : resourceStoreUri;
189
179
  return (0, _nodeurl.pathToFileURL)(_path.resolve(expandedPath)).href;
190
180
  }
181
+ /** The server's data directory: `.mcp-z` beside the nearest .mcp.json (searched from cwd up to home), else in the home directory. */ function resolveBaseDir() {
182
+ var mcpServer = _require('@mcp-z/server');
183
+ try {
184
+ var configPath = mcpServer.findConfigPath({
185
+ config: '.mcp.json',
186
+ cwd: process.cwd(),
187
+ stopDir: (0, _os.homedir)()
188
+ });
189
+ return _path.join(_path.dirname(configPath), '.mcp-z');
190
+ } catch (unused) {
191
+ return _path.join((0, _os.homedir)(), '.mcp-z');
192
+ }
193
+ }
191
194
  function createConfig() {
192
- return parseConfig(process.argv, process.env);
195
+ var mcpServer = _require('@mcp-z/server');
196
+ var envResult = mcpServer.loadServerEnv({
197
+ name: SERVER_NAME,
198
+ baseDir: resolveBaseDir()
199
+ });
200
+ try {
201
+ return parseConfig(process.argv, process.env);
202
+ } catch (error) {
203
+ throw new Error("".concat(error.message, "\n").concat(mcpServer.formatServerEnvSearch(envResult)));
204
+ }
193
205
  }
194
206
  /* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }
@@ -1 +1 @@
1
- {"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":["createConfig","parseConfig","pkg","readPkg","_require","require","Module","createRequire","args","env","cliLogLevel","cliResourceStoreUri","oauthGoogle","mcpServer","transportConfig","oauthConfig","dcrConfig","auth","parseDcrConfig","GOOGLE_SCOPE","undefined","values","parseArgs","options","type","strict","allowPositionals","name","replace","rawRepoUrl","repository","url","repositoryUrl","rootDir","homedir","configPath","findConfigPath","config","cwd","process","stopDir","path","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","fileURLToPath","pathToFileURL","resolve","href","includes","expandedPath","argv"],"mappings":"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"}
1
+ {"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();\nconst SERVER_NAME = pkg.name.replace(/^@[^/]+\\//, '');\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 = SERVER_NAME;\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 const baseDir = resolveBaseDir();\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/** The server's data directory: `.mcp-z` beside the nearest .mcp.json (searched from cwd up to home), else in the home directory. */\nfunction resolveBaseDir(): string {\n const mcpServer = _require('@mcp-z/server') as typeof McpServer;\n try {\n const configPath = mcpServer.findConfigPath({ config: '.mcp.json', cwd: process.cwd(), stopDir: homedir() });\n return path.join(path.dirname(configPath), '.mcp-z');\n } catch {\n return path.join(homedir(), '.mcp-z');\n }\n}\n\n/**\n * Build production configuration from process globals.\n * Entry point for production server.\n */\nexport function createConfig(): ServerConfig {\n const mcpServer = _require('@mcp-z/server') as typeof McpServer;\n const envResult = mcpServer.loadServerEnv({ name: SERVER_NAME, baseDir: resolveBaseDir() });\n try {\n return parseConfig(process.argv, process.env);\n } catch (error) {\n throw new Error(`${(error as Error).message}\\n${mcpServer.formatServerEnvSearch(envResult)}`);\n }\n}\n"],"names":["createConfig","parseConfig","pkg","readPkg","SERVER_NAME","name","replace","_require","require","Module","createRequire","args","env","cliLogLevel","cliResourceStoreUri","oauthGoogle","mcpServer","transportConfig","oauthConfig","dcrConfig","auth","parseDcrConfig","GOOGLE_SCOPE","undefined","values","parseArgs","options","type","strict","allowPositionals","rawRepoUrl","repository","url","repositoryUrl","baseDir","resolveBaseDir","envLogLevel","LOG_LEVEL","logLevel","envResourceStoreUri","RESOURCE_STORE_URI","defaultResourceStorePath","path","join","resourceStoreUri","normalizeResourceStoreUri","cliBaseUrl","envBaseUrl","BASE_URL","baseUrl","transport","version","filePrefix","startsWith","rawPath","slice","length","filePath","homedir","fileURLToPath","pathToFileURL","resolve","href","includes","expandedPath","configPath","findConfigPath","config","cwd","process","stopDir","dirname","envResult","loadServerEnv","argv","error","Error","message","formatServerEnvSearch"],"mappings":"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"}
@@ -60,7 +60,7 @@ function _interop_require_wildcard(obj, nodeInterop) {
60
60
  // resolve nothing beyond Node startup: config.ts's parseConfig pulls in @mcp-z/oauth-google and
61
61
  // @mcp-z/server, which this path must not touch.
62
62
  var pkg = JSON.parse(_fs.readFileSync(_path.join((0, _modulerootsync.default)(_url.fileURLToPath(require("url").pathToFileURL(__filename).toString())), 'package.json'), 'utf-8'));
63
- var 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();
63
+ var 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\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-sheets/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-sheets/.env)\n 2. ~/.config/mcp-z/mcp-sheets/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json "env", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\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();
64
64
  function readPkg() {
65
65
  return pkg;
66
66
  }
@@ -1 +1 @@
1
- {"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":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":";;;;;;;;;;;QAyEgBA;eAAAA;;QARAC;eAAAA;;;0DAjEI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,mFAAmF;AACnF,gGAAgG;AAChG,iDAAiD;AACjD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,yxFAmDhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAM,AAAEC,SAAWC,IAAAA,eAAS,EAAC;QAC3BF,MAAAA;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB,GARQR;IAUR,IAAIA,OAAOG,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQvB,IAAIgB,OAAO;IAAC;IAChE,IAAIH,OAAOM,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}
1
+ {"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\nConfiguration Files:\n Variables may also be set in the first of these files that exists:\n 1. .mcp-z/mcp-sheets/.env beside the nearest .mcp.json (else ~/.mcp-z/mcp-sheets/.env)\n 2. ~/.config/mcp-z/mcp-sheets/.env (~ is your home directory, on every OS)\n Values already in the environment, including .mcp.json \"env\", take precedence.\n On macOS and Linux the file must be private (chmod 600), or the server will not start.\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":["handleVersionHelp","readPkg","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","HELP_TEXT","trim","args","values","parseArgs","options","version","type","short","help","strict","allowPositionals","handled","output"],"mappings":";;;;;;;;;;;QAgFgBA;eAAAA;;QARAC;eAAAA;;;0DAxEI;qEACG;4DACD;2DACD;oBACK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE1B,mFAAmF;AACnF,gGAAgG;AAChG,iDAAiD;AACjD,IAAMC,MAAMC,KAAKC,KAAK,CAACC,IAAGC,YAAY,CAACC,MAAKC,IAAI,CAACC,IAAAA,uBAAU,EAACC,KAAIC,aAAa,CAAC,uDAAmB,iBAAiB;AAElH,IAAMC,YAAY,itGA0DhBC,IAAI;AAGC,SAASZ;IACd,OAAOC;AACT;AAMO,SAASF,kBAAkBc,IAAc;IAC9C,IAAM,AAAEC,SAAWC,IAAAA,eAAS,EAAC;QAC3BF,MAAAA;QACAG,SAAS;YACPC,SAAS;gBAAEC,MAAM;gBAAWC,OAAO;YAAI;YACvCC,MAAM;gBAAEF,MAAM;gBAAWC,OAAO;YAAI;QACtC;QACAE,QAAQ;QACRC,kBAAkB;IACpB,GARQR;IAUR,IAAIA,OAAOG,OAAO,EAAE,OAAO;QAAEM,SAAS;QAAMC,QAAQvB,IAAIgB,OAAO;IAAC;IAChE,IAAIH,OAAOM,IAAI,EAAE,OAAO;QAAEG,SAAS;QAAMC,QAAQb;IAAU;IAC3D,OAAO;QAAEY,SAAS;IAAM;AAC1B"}
@@ -205,16 +205,10 @@ function _unsupported_iterable_to_array(o, minLen) {
205
205
  }
206
206
  function discoverHeader(sheets, spreadsheetId, sheetTitle) {
207
207
  return _async_to_generator(function() {
208
- var _response_data, response, unused;
208
+ var _response_data, response;
209
209
  return _ts_generator(this, function(_state) {
210
210
  switch(_state.label){
211
211
  case 0:
212
- _state.trys.push([
213
- 0,
214
- 2,
215
- ,
216
- 3
217
- ]);
218
212
  return [
219
213
  4,
220
214
  sheets.spreadsheets.values.get({
@@ -229,16 +223,6 @@ function discoverHeader(sheets, spreadsheetId, sheetTitle) {
229
223
  2,
230
224
  (((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [])[0] || []
231
225
  ];
232
- case 2:
233
- unused = _state.sent();
234
- return [
235
- 2,
236
- []
237
- ];
238
- case 3:
239
- return [
240
- 2
241
- ];
242
226
  }
243
227
  });
244
228
  })();
@@ -743,9 +727,41 @@ function mapRowsToHeader(param) {
743
727
  return mappedRow;
744
728
  });
745
729
  }
730
+ /** Calls onKey with each non-empty generated key of the data rows and its 1-indexed row number; see scanKeyColumnRows for the bounded, error-reporting scan. */ function scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, onKey) {
731
+ return _async_to_generator(function() {
732
+ var _Math, _Math1, minIndex, maxIndex;
733
+ return _ts_generator(this, function(_state) {
734
+ switch(_state.label){
735
+ case 0:
736
+ minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
737
+ maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
738
+ return [
739
+ 4,
740
+ (0, _sheetoperationsts.scanKeyColumnRows)(sheets, spreadsheetId, sheetTitle, (0, _columnutilitiests.a1Col)(minIndex + 1), (0, _columnutilitiests.a1Col)(maxIndex + 1), function(rawRow, rowNumber) {
741
+ // Reconstruct full row for key generation
742
+ var fullRow = new Array(header.length).fill('');
743
+ keyIndices.forEach(function(globalIndex) {
744
+ var localRowArrayIndex = globalIndex - minIndex;
745
+ if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {
746
+ fullRow[globalIndex] = rawRow[localRowArrayIndex];
747
+ }
748
+ });
749
+ var key = generateRowKey(fullRow, header, strategy);
750
+ if (key.replace(/\\+/g, '') !== '') onKey(key, rowNumber);
751
+ })
752
+ ];
753
+ case 1:
754
+ _state.sent();
755
+ return [
756
+ 2
757
+ ];
758
+ }
759
+ });
760
+ })();
761
+ }
746
762
  function snapshotHeaderAndKeys(_0, _1, _2, _3) {
747
763
  return _async_to_generator(function(sheets, spreadsheetId, sheetTitle) {
748
- var keyColumns, keyStrategy, _Math, _Math1, _ref, _ref1, header, keySet, strategy, keyIndices, chunkSize, startRow, minIndex, maxIndex, startCol, endCol, endRow, range, _response_data, response, rows, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _loop, _iterator, _step, unused;
764
+ var keyColumns, keyStrategy, _ref, _ref1, header, keySet, strategy, keyIndices;
749
765
  var _arguments = arguments;
750
766
  return _ts_generator(this, function(_state) {
751
767
  switch(_state.label){
@@ -799,97 +815,14 @@ function snapshotHeaderAndKeys(_0, _1, _2, _3) {
799
815
  }
800
816
  ];
801
817
  }
802
- // Read key columns data in chunks
803
- chunkSize = 1000;
804
- startRow = 2;
805
- minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
806
- maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
807
- startCol = (0, _columnutilitiests.a1Col)(minIndex + 1);
808
- endCol = (0, _columnutilitiests.a1Col)(maxIndex + 1);
809
- _state.label = 2;
810
- case 2:
811
- if (!true) return [
812
- 3,
813
- 7
814
- ];
815
- endRow = startRow + chunkSize - 1;
816
- range = "".concat(sheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
817
- _state.label = 3;
818
- case 3:
819
- _state.trys.push([
820
- 3,
821
- 5,
822
- ,
823
- 6
824
- ]);
825
818
  return [
826
819
  4,
827
- sheets.spreadsheets.values.get({
828
- spreadsheetId: spreadsheetId,
829
- range: range,
830
- majorDimension: 'ROWS'
820
+ scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, function(key) {
821
+ keySet.add(key);
831
822
  })
832
823
  ];
833
- case 4:
834
- response = _state.sent();
835
- rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
836
- if (rows.length === 0) return [
837
- 3,
838
- 7
839
- ];
840
- _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
841
- try {
842
- _loop = function() {
843
- var rawRow = _step.value;
844
- // Reconstruct full row for key generation
845
- var fullRow = new Array(header.length).fill('');
846
- keyIndices.forEach(function(globalIndex, _localIndex) {
847
- var localRowIndex = globalIndex - minIndex;
848
- if (localRowIndex >= 0 && localRowIndex < rawRow.length) {
849
- fullRow[globalIndex] = rawRow[localRowIndex];
850
- }
851
- });
852
- var key = generateRowKey(fullRow, header, strategy);
853
- if (key.replace(/\\+/g, '') !== '') {
854
- keySet.add(key);
855
- }
856
- };
857
- for(_iterator = rows[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
858
- } catch (err) {
859
- _didIteratorError = true;
860
- _iteratorError = err;
861
- } finally{
862
- try {
863
- if (!_iteratorNormalCompletion && _iterator.return != null) {
864
- _iterator.return();
865
- }
866
- } finally{
867
- if (_didIteratorError) {
868
- throw _iteratorError;
869
- }
870
- }
871
- }
872
- startRow += rows.length;
873
- if (rows.length < chunkSize) return [
874
- 3,
875
- 7
876
- ]; // Last chunk
877
- return [
878
- 3,
879
- 6
880
- ];
881
- case 5:
882
- unused = _state.sent();
883
- return [
884
- 3,
885
- 7
886
- ]; // End of data or error
887
- case 6:
888
- return [
889
- 3,
890
- 2
891
- ];
892
- case 7:
824
+ case 2:
825
+ _state.sent();
893
826
  return [
894
827
  2,
895
828
  {
@@ -902,9 +835,17 @@ function snapshotHeaderAndKeys(_0, _1, _2, _3) {
902
835
  });
903
836
  }).apply(this, arguments);
904
837
  }
838
+ /** Message naming every duplicate key and its 1-indexed row numbers */ function formatDuplicateSheetKeys(keyToRows) {
839
+ var parts = [];
840
+ keyToRows.forEach(function(rows, key) {
841
+ if (rows.length > 1) parts.push('"'.concat(key, '" (rows ').concat(rows.join(', '), ")"));
842
+ });
843
+ if (parts.length === 0) return undefined;
844
+ return "duplicate keys found on the sheet: ".concat(parts.join('; '), ". Nothing was written; make each key unique and retry.");
845
+ }
905
846
  function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
906
847
  return _async_to_generator(function(sheets, spreadsheetId, sheetTitle) {
907
- var keyColumns, keyStrategy, _Math, _Math1, _ref, _ref1, header, keySet, keyToRowMap, strategy, keyIndices, chunkSize, startRow, minIndex, maxIndex, startCol, endCol, endRow, range, _loop, _response_data, response, rows, localRowIndex, unused;
848
+ var keyColumns, keyStrategy, _ref, _ref1, header, keySet, keyToRowMap, keyToRows, strategy, keyIndices, duplicateMessage;
908
849
  var _arguments = arguments;
909
850
  return _ts_generator(this, function(_state) {
910
851
  switch(_state.label){
@@ -920,6 +861,7 @@ function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
920
861
  header = _state.sent();
921
862
  keySet = new Set();
922
863
  keyToRowMap = new Map();
864
+ keyToRows = new Map();
923
865
  if (header.length === 0) {
924
866
  return [
925
867
  2,
@@ -961,85 +903,22 @@ function snapshotHeaderKeysAndPositions(_0, _1, _2, _3) {
961
903
  }
962
904
  ];
963
905
  }
964
- // Read key columns data in chunks and track row positions
965
- chunkSize = 1000;
966
- startRow = 2; // Start from row 2 (after header)
967
- minIndex = (_Math = Math).min.apply(_Math, _to_consumable_array(keyIndices));
968
- maxIndex = (_Math1 = Math).max.apply(_Math1, _to_consumable_array(keyIndices));
969
- startCol = (0, _columnutilitiests.a1Col)(minIndex + 1);
970
- endCol = (0, _columnutilitiests.a1Col)(maxIndex + 1);
971
- _state.label = 2;
972
- case 2:
973
- if (!true) return [
974
- 3,
975
- 7
976
- ];
977
- endRow = startRow + chunkSize - 1;
978
- range = "".concat(sheetTitle, "!").concat(startCol).concat(startRow, ":").concat(endCol).concat(endRow);
979
- _state.label = 3;
980
- case 3:
981
- _state.trys.push([
982
- 3,
983
- 5,
984
- ,
985
- 6
986
- ]);
987
- _loop = function(localRowIndex) {
988
- var rawRow = rows[localRowIndex];
989
- var globalRowNumber = startRow + localRowIndex;
990
- // Reconstruct full row for key generation
991
- var fullRow = new Array(header.length).fill('');
992
- if (rawRow) {
993
- keyIndices.forEach(function(globalIndex, _localIndex) {
994
- var localRowArrayIndex = globalIndex - minIndex;
995
- if (localRowArrayIndex >= 0 && localRowArrayIndex < rawRow.length) {
996
- fullRow[globalIndex] = rawRow[localRowArrayIndex];
997
- }
998
- });
999
- }
1000
- var key = generateRowKey(fullRow, header, strategy);
1001
- if (key.replace(/\\+/g, '') !== '') {
1002
- keySet.add(key);
1003
- keyToRowMap.set(key, globalRowNumber); // Store 1-indexed row number
1004
- }
1005
- };
1006
906
  return [
1007
907
  4,
1008
- sheets.spreadsheets.values.get({
1009
- spreadsheetId: spreadsheetId,
1010
- range: range,
1011
- majorDimension: 'ROWS'
908
+ scanKeyRows(sheets, spreadsheetId, sheetTitle, header, keyIndices, strategy, function(key, rowNumber) {
909
+ keySet.add(key);
910
+ keyToRowMap.set(key, rowNumber); // Store 1-indexed row number
911
+ var seenRows = keyToRows.get(key);
912
+ if (seenRows) seenRows.push(rowNumber);
913
+ else keyToRows.set(key, [
914
+ rowNumber
915
+ ]);
1012
916
  })
1013
917
  ];
1014
- case 4:
1015
- response = _state.sent();
1016
- rows = ((_response_data = response.data) === null || _response_data === void 0 ? void 0 : _response_data.values) || [];
1017
- if (rows.length === 0) return [
1018
- 3,
1019
- 7
1020
- ];
1021
- for(localRowIndex = 0; localRowIndex < rows.length; localRowIndex++)_loop(localRowIndex);
1022
- startRow += rows.length;
1023
- if (rows.length < chunkSize) return [
1024
- 3,
1025
- 7
1026
- ]; // Last chunk
1027
- return [
1028
- 3,
1029
- 6
1030
- ];
1031
- case 5:
1032
- unused = _state.sent();
1033
- return [
1034
- 3,
1035
- 7
1036
- ]; // End of data or error
1037
- case 6:
1038
- return [
1039
- 3,
1040
- 2
1041
- ];
1042
- case 7:
918
+ case 2:
919
+ _state.sent();
920
+ duplicateMessage = formatDuplicateSheetKeys(keyToRows);
921
+ if (duplicateMessage) throw new Error(duplicateMessage);
1043
922
  return [
1044
923
  2,
1045
924
  {