@mcp-z/mcp-sheets 1.0.0

package/dist/cjs/mcp/resources/spreadsheet.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createResource;
+    }
+});
+var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var _googleapis = require("googleapis");
+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 _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
+        };
+    }
+}
+function createResource() {
+    var template = new _mcp.ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {
+        list: undefined
+    });
+    var config = {
+        description: 'Sheets spreadsheet resource',
+        mimeType: 'application/json'
+    };
+    var handler = function(uri, variables, extra) {
+        return _async_to_generator(function() {
+            var spreadsheetId, _data_properties, _data_properties1, logger, authContext, sheets, resp, data, error, _ref, logger1;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;
+                        if (!spreadsheetId) {
+                            return [
+                                2,
+                                {
+                                    contents: [
+                                        {
+                                            uri: uri.href,
+                                            mimeType: 'application/json',
+                                            text: JSON.stringify({
+                                                error: 'spreadsheetId is required'
+                                            })
+                                        }
+                                    ]
+                                }
+                            ];
+                        }
+                        _state.label = 1;
+                    case 1:
+                        _state.trys.push([
+                            1,
+                            3,
+                            ,
+                            4
+                        ]);
+                        // Safe type guard to access middleware-enriched extra
+                        logger = extra.logger, authContext = extra.authContext;
+                        sheets = _googleapis.google.sheets({
+                            version: 'v4',
+                            auth: authContext.auth
+                        });
+                        return [
+                            4,
+                            sheets.spreadsheets.get({
+                                spreadsheetId: spreadsheetId,
+                                fields: 'spreadsheetId,properties.title,sheets.properties'
+                            })
+                        ];
+                    case 2:
+                        resp = _state.sent();
+                        data = resp.data;
+                        logger.info('sheets-spreadsheet resource fetch success', {
+                            spreadsheetId: data.spreadsheetId,
+                            title: data === null || data === void 0 ? void 0 : (_data_properties = data.properties) === null || _data_properties === void 0 ? void 0 : _data_properties.title,
+                            sheetCount: ((data === null || data === void 0 ? void 0 : data.sheets) || []).length
+                        });
+                        return [
+                            2,
+                            {
+                                contents: [
+                                    {
+                                        uri: uri.href,
+                                        mimeType: 'application/json',
+                                        text: JSON.stringify({
+                                            id: data === null || data === void 0 ? void 0 : data.spreadsheetId,
+                                            title: data === null || data === void 0 ? void 0 : (_data_properties1 = data.properties) === null || _data_properties1 === void 0 ? void 0 : _data_properties1.title,
+                                            sheets: ((data === null || data === void 0 ? void 0 : data.sheets) || []).map(function(s) {
+                                                var _s_properties, _s_properties1, _s_properties_gridProperties, _s_properties2, _s_properties_gridProperties1, _s_properties3;
+                                                return {
+                                                    id: s === null || s === void 0 ? void 0 : (_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId,
+                                                    title: s === null || s === void 0 ? void 0 : (_s_properties1 = s.properties) === null || _s_properties1 === void 0 ? void 0 : _s_properties1.title,
+                                                    rowCount: s === null || s === void 0 ? void 0 : (_s_properties2 = s.properties) === null || _s_properties2 === void 0 ? void 0 : (_s_properties_gridProperties = _s_properties2.gridProperties) === null || _s_properties_gridProperties === void 0 ? void 0 : _s_properties_gridProperties.rowCount,
+                                                    columnCount: s === null || s === void 0 ? void 0 : (_s_properties3 = s.properties) === null || _s_properties3 === void 0 ? void 0 : (_s_properties_gridProperties1 = _s_properties3.gridProperties) === null || _s_properties_gridProperties1 === void 0 ? void 0 : _s_properties_gridProperties1.columnCount
+                                                };
+                                            })
+                                        })
+                                    }
+                                ]
+                            }
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        logger1 = extra.logger;
+                        logger1.info('sheets-spreadsheet resource fetch failed', error);
+                        return [
+                            2,
+                            {
+                                contents: [
+                                    {
+                                        uri: uri.href,
+                                        mimeType: 'application/json',
+                                        text: JSON.stringify({
+                                            error: String((_ref = error === null || error === void 0 ? void 0 : error.message) !== null && _ref !== void 0 ? _ref : error)
+                                        })
+                                    }
+                                ]
+                            }
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    };
+    return {
+        name: 'spreadsheet',
+        template: template,
+        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/resources/spreadsheet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../../types.js';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = google.sheets({ version: 'v4', auth: authContext.auth });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["createResource","template","ResourceTemplate","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","data","logger","authContext","sheets","resp","error","Array","isArray","contents","href","text","JSON","stringify","google","version","auth","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/cells-format.d.cts

@@ -0,0 +1,144 @@
+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;
+    gid: z.ZodCoercedString<unknown>;
+    requests: z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        backgroundColor: z.ZodOptional<z.ZodObject<{
+            red: z.ZodNumber;
+            green: z.ZodNumber;
+            blue: z.ZodNumber;
+        }, z.core.$strip>>;
+        textColor: z.ZodOptional<z.ZodObject<{
+            red: z.ZodNumber;
+            green: z.ZodNumber;
+            blue: z.ZodNumber;
+        }, z.core.$strip>>;
+        bold: z.ZodOptional<z.ZodBoolean>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        horizontalAlignment: z.ZodOptional<z.ZodEnum<{
+            LEFT: "LEFT";
+            CENTER: "CENTER";
+            RIGHT: "RIGHT";
+        }>>;
+        numberFormat: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                TEXT: "TEXT";
+                NUMBER: "NUMBER";
+                PERCENT: "PERCENT";
+                CURRENCY: "CURRENCY";
+                DATE: "DATE";
+                TIME: "TIME";
+            }>;
+            pattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        borders: z.ZodOptional<z.ZodObject<{
+            style: z.ZodEnum<{
+                SOLID: "SOLID";
+                DASHED: "DASHED";
+                DOTTED: "DOTTED";
+            }>;
+            color: z.ZodObject<{
+                red: z.ZodNumber;
+                green: z.ZodNumber;
+                blue: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    successCount: z.ZodNumber;
+    failedRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, 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, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            requests: z.ZodArray<z.ZodObject<{
+                range: z.ZodString;
+                backgroundColor: z.ZodOptional<z.ZodObject<{
+                    red: z.ZodNumber;
+                    green: z.ZodNumber;
+                    blue: z.ZodNumber;
+                }, z.core.$strip>>;
+                textColor: z.ZodOptional<z.ZodObject<{
+                    red: z.ZodNumber;
+                    green: z.ZodNumber;
+                    blue: z.ZodNumber;
+                }, z.core.$strip>>;
+                bold: z.ZodOptional<z.ZodBoolean>;
+                fontSize: z.ZodOptional<z.ZodNumber>;
+                horizontalAlignment: z.ZodOptional<z.ZodEnum<{
+                    LEFT: "LEFT";
+                    CENTER: "CENTER";
+                    RIGHT: "RIGHT";
+                }>>;
+                numberFormat: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        TEXT: "TEXT";
+                        NUMBER: "NUMBER";
+                        PERCENT: "PERCENT";
+                        CURRENCY: "CURRENCY";
+                        DATE: "DATE";
+                        TIME: "TIME";
+                    }>;
+                    pattern: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                borders: z.ZodOptional<z.ZodObject<{
+                    style: z.ZodEnum<{
+                        SOLID: "SOLID";
+                        DASHED: "DASHED";
+                        DOTTED: "DOTTED";
+                    }>;
+                    color: z.ZodObject<{
+                        red: z.ZodNumber;
+                        green: z.ZodNumber;
+                        blue: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                successCount: z.ZodNumber;
+                failedRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    range: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, 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/cells-format.d.ts

@@ -0,0 +1,144 @@
+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;
+    gid: z.ZodCoercedString<unknown>;
+    requests: z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        backgroundColor: z.ZodOptional<z.ZodObject<{
+            red: z.ZodNumber;
+            green: z.ZodNumber;
+            blue: z.ZodNumber;
+        }, z.core.$strip>>;
+        textColor: z.ZodOptional<z.ZodObject<{
+            red: z.ZodNumber;
+            green: z.ZodNumber;
+            blue: z.ZodNumber;
+        }, z.core.$strip>>;
+        bold: z.ZodOptional<z.ZodBoolean>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        horizontalAlignment: z.ZodOptional<z.ZodEnum<{
+            LEFT: "LEFT";
+            CENTER: "CENTER";
+            RIGHT: "RIGHT";
+        }>>;
+        numberFormat: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                TEXT: "TEXT";
+                NUMBER: "NUMBER";
+                PERCENT: "PERCENT";
+                CURRENCY: "CURRENCY";
+                DATE: "DATE";
+                TIME: "TIME";
+            }>;
+            pattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        borders: z.ZodOptional<z.ZodObject<{
+            style: z.ZodEnum<{
+                SOLID: "SOLID";
+                DASHED: "DASHED";
+                DOTTED: "DOTTED";
+            }>;
+            color: z.ZodObject<{
+                red: z.ZodNumber;
+                green: z.ZodNumber;
+                blue: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    successCount: z.ZodNumber;
+    failedRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        range: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, 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, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            requests: z.ZodArray<z.ZodObject<{
+                range: z.ZodString;
+                backgroundColor: z.ZodOptional<z.ZodObject<{
+                    red: z.ZodNumber;
+                    green: z.ZodNumber;
+                    blue: z.ZodNumber;
+                }, z.core.$strip>>;
+                textColor: z.ZodOptional<z.ZodObject<{
+                    red: z.ZodNumber;
+                    green: z.ZodNumber;
+                    blue: z.ZodNumber;
+                }, z.core.$strip>>;
+                bold: z.ZodOptional<z.ZodBoolean>;
+                fontSize: z.ZodOptional<z.ZodNumber>;
+                horizontalAlignment: z.ZodOptional<z.ZodEnum<{
+                    LEFT: "LEFT";
+                    CENTER: "CENTER";
+                    RIGHT: "RIGHT";
+                }>>;
+                numberFormat: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        TEXT: "TEXT";
+                        NUMBER: "NUMBER";
+                        PERCENT: "PERCENT";
+                        CURRENCY: "CURRENCY";
+                        DATE: "DATE";
+                        TIME: "TIME";
+                    }>;
+                    pattern: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                borders: z.ZodOptional<z.ZodObject<{
+                    style: z.ZodEnum<{
+                        SOLID: "SOLID";
+                        DASHED: "DASHED";
+                        DOTTED: "DOTTED";
+                    }>;
+                    color: z.ZodObject<{
+                        red: z.ZodNumber;
+                        green: z.ZodNumber;
+                        blue: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                successCount: z.ZodNumber;
+                failedRanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    range: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, 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 {};