@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/mcp/tools/sheet-delete.js

@@ -0,0 +1,341 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _index = require("../../schemas/index.js");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+var MAX_BATCH_SIZE = 1000;
+var inputSchema = _zod.z.object({
+    id: _index.SpreadsheetIdSchema,
+    gids: _zod.z.array(_index.SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete')
+});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    operationSummary: _zod.z.string().describe('Human-readable summary of the operation'),
+    itemsProcessed: _zod.z.number().describe('Total sheets attempted to delete'),
+    itemsChanged: _zod.z.number().describe('Number of sheets successfully deleted'),
+    completedAt: _zod.z.string().describe('ISO timestamp when operation completed'),
+    recoverable: _zod.z.literal(false).describe('Whether deletion can be undone (always false)'),
+    id: _index.SpreadsheetIdOutput,
+    spreadsheetUrl: _zod.z.string().optional().describe('URL to view the spreadsheet'),
+    failures: _zod.z.array(_zod.z.object({
+        gid: _zod.z.string().describe('Grid ID of sheet that failed to delete'),
+        error: _zod.z.string().describe('Error message explaining the failure')
+    })).optional().describe('Details of any sheets that failed to delete')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, gids, logger, sheets, results, failures, successCount, failureCount, totalCount, summary, result, error, message;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, gids = param.gids;
+                    logger = extra.logger;
+                    logger.info('sheets.sheet.delete called', {
+                        id: id,
+                        count: gids.length
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    return [
+                        4,
+                        Promise.allSettled(gids.map(function(gid) {
+                            return _async_to_generator(function() {
+                                return _ts_generator(this, function(_state) {
+                                    switch(_state.label){
+                                        case 0:
+                                            return [
+                                                4,
+                                                sheets.spreadsheets.batchUpdate({
+                                                    spreadsheetId: id,
+                                                    requestBody: {
+                                                        requests: [
+                                                            {
+                                                                deleteSheet: {
+                                                                    sheetId: Number(gid)
+                                                                }
+                                                            }
+                                                        ]
+                                                    }
+                                                })
+                                            ];
+                                        case 1:
+                                            _state.sent();
+                                            return [
+                                                2,
+                                                gid
+                                            ];
+                                    }
+                                });
+                            })();
+                        }))
+                    ];
+                case 2:
+                    results = _state.sent();
+                    // Separate successes and failures
+                    failures = [];
+                    results.forEach(function(result, index) {
+                        var gid = gids[index];
+                        if (!gid) return;
+                        if (result.status === 'rejected') {
+                            var errorMessage = _instanceof(result.reason, Error) ? result.reason.message : String(result.reason);
+                            failures.push({
+                                gid: gid,
+                                error: errorMessage
+                            });
+                        }
+                    });
+                    successCount = gids.length - failures.length;
+                    failureCount = failures.length;
+                    totalCount = gids.length;
+                    summary = failureCount === 0 ? "Permanently deleted ".concat(successCount, " sheet").concat(successCount === 1 ? '' : 's') : "Deleted ".concat(successCount, " of ").concat(totalCount, " sheet").concat(totalCount === 1 ? '' : 's', " (").concat(failureCount, " failed)");
+                    logger.info('sheets.sheet.delete completed', {
+                        totalCount: totalCount,
+                        successCount: successCount,
+                        failureCount: failureCount
+                    });
+                    result = _object_spread({
+                        type: 'success',
+                        operationSummary: summary,
+                        itemsProcessed: totalCount,
+                        itemsChanged: successCount,
+                        completedAt: new Date().toISOString(),
+                        recoverable: false,
+                        id: id,
+                        spreadsheetUrl: "https://docs.google.com/spreadsheets/d/".concat(id)
+                    }, failures.length > 0 && {
+                        failures: failures
+                    });
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result
+                            }
+                        }
+                    ];
+                case 3:
+                    error = _state.sent();
+                    message = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('sheets.sheet.delete error', {
+                        error: message
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error deleting sheet: ".concat(message), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 4:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'sheet-delete',
+        config: config,
+        handler: handler
+    };
+}
+/* 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; }

package/dist/cjs/mcp/tools/sheet-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst MAX_BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gids: z.array(SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Human-readable summary of the operation'),\n  itemsProcessed: z.number().describe('Total sheets attempted to delete'),\n  itemsChanged: z.number().describe('Number of sheets successfully deleted'),\n  completedAt: z.string().describe('ISO timestamp when operation completed'),\n  recoverable: z.literal(false).describe('Whether deletion can be undone (always false)'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n  failures: z\n    .array(\n      z.object({\n        gid: z.string().describe('Grid ID of sheet that failed to delete'),\n        error: z.string().describe('Error message explaining the failure'),\n      })\n    )\n    .optional()\n    .describe('Details of any sheets that failed to delete'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',\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, gids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.delete called', { id, count: gids.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    const results = await Promise.allSettled(\n      gids.map(async (gid) => {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [{ deleteSheet: { sheetId: Number(gid) } }],\n          },\n        });\n        return gid;\n      })\n    );\n\n    // Separate successes and failures\n    const failures: Array<{ gid: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const gid = gids[index];\n      if (!gid) return;\n\n      if (result.status === 'rejected') {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ gid, error: errorMessage });\n      }\n    });\n\n    const successCount = gids.length - failures.length;\n    const failureCount = failures.length;\n    const totalCount = gids.length;\n\n    const summary = failureCount === 0 ? `Permanently deleted ${successCount} sheet${successCount === 1 ? '' : 's'}` : `Deleted ${successCount} of ${totalCount} sheet${totalCount === 1 ? '' : 's'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.delete completed', {\n      totalCount,\n      successCount,\n      failureCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      recoverable: false as const,\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      ...(failures.length > 0 && { failures }),\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.sheet.delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","MAX_BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gids","array","SheetGidSchema","min","max","describe","successBranchSchema","type","literal","operationSummary","string","itemsProcessed","number","itemsChanged","completedAt","recoverable","SpreadsheetIdOutput","spreadsheetUrl","optional","failures","gid","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheets","results","successCount","failureCount","totalCount","summary","message","info","count","length","google","version","auth","authContext","Promise","allSettled","map","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","deleteSheet","sheetId","Number","forEach","index","status","errorMessage","reason","Error","String","push","Date","toISOString","content","text","JSON","stringify","structuredContent","McpError","ErrorCode","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/sheet-find.d.cts

@@ -0,0 +1,48 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    sheetRef: z.ZodString;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    title: z.ZodString;
+    sheetUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Find an existing sheet/tab within a known spreadsheet by title or GUID";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            sheetRef: z.ZodString;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                title: z.ZodString;
+                sheetUrl: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/sheet-find.d.ts

@@ -0,0 +1,48 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    sheetRef: z.ZodString;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    title: z.ZodString;
+    sheetUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Find an existing sheet/tab within a known spreadsheet by title or GUID";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            sheetRef: z.ZodString;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                title: z.ZodString;
+                sheetUrl: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};