@mcp-z/client 1.0.0

package/dist/cjs/monkey-patches.js

@@ -0,0 +1,236 @@
+/**
+ * Monkey patches for MCP SDK bugs
+ *
+ * These patches fix bugs in dependencies that haven't been fixed upstream yet.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+var _protocol = require("@modelcontextprotocol/sdk/shared/protocol.js");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+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 _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+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
+        };
+    }
+}
+/**
+ * FIX: Protocol.close() doesn't clear pending timeouts
+ *
+ * BUG: The MCP SDK's Protocol.close() only closes the transport but does NOT
+ * clear pending timeouts from the internal _timeoutInfo Map. This causes Node.js
+ * to hang until timeouts fire (default 60 seconds).
+ *
+ * PATCH: Wrap Protocol.close() to clear all pending timeouts before closing.
+ *
+ * TO TEST IF STILL NEEDED:
+ * 1. Comment out this patch
+ * 2. Run: npm run test:unit
+ * 3. If tests hang ~60 seconds after completing, bug still exists
+ * 4. If tests exit promptly, SDK is fixed and this can be removed
+ *
+ * UPSTREAM: https://github.com/modelcontextprotocol/typescript-sdk/issues/XXX
+ */ var originalClose = _protocol.Protocol.prototype.close;
+_protocol.Protocol.prototype.close = function() {
+    return _async_to_generator(function() {
+        var self, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, info;
+        return _ts_generator(this, function(_state) {
+            self = this;
+            if (self._timeoutInfo) {
+                _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                try {
+                    for(_iterator = self._timeoutInfo[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                        _step_value = _sliced_to_array(_step.value, 2), info = _step_value[1];
+                        clearTimeout(info.timeoutId);
+                    }
+                } catch (err) {
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                }
+                self._timeoutInfo.clear();
+            }
+            return [
+                2,
+                originalClose.call(this)
+            ];
+        });
+    }).call(this);
+};
+/* 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/monkey-patches.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/monkey-patches.ts"],"sourcesContent":["/**\n * Monkey patches for MCP SDK bugs\n *\n * These patches fix bugs in dependencies that haven't been fixed upstream yet.\n */\n\nimport { Protocol } from '@modelcontextprotocol/sdk/shared/protocol.js';\n\n/**\n * FIX: Protocol.close() doesn't clear pending timeouts\n *\n * BUG: The MCP SDK's Protocol.close() only closes the transport but does NOT\n * clear pending timeouts from the internal _timeoutInfo Map. This causes Node.js\n * to hang until timeouts fire (default 60 seconds).\n *\n * PATCH: Wrap Protocol.close() to clear all pending timeouts before closing.\n *\n * TO TEST IF STILL NEEDED:\n * 1. Comment out this patch\n * 2. Run: npm run test:unit\n * 3. If tests hang ~60 seconds after completing, bug still exists\n * 4. If tests exit promptly, SDK is fixed and this can be removed\n *\n * UPSTREAM: https://github.com/modelcontextprotocol/typescript-sdk/issues/XXX\n */\nconst originalClose = Protocol.prototype.close;\nProtocol.prototype.close = async function () {\n  const self = this as unknown as { _timeoutInfo?: Map<unknown, { timeoutId: ReturnType<typeof setTimeout> }> };\n  if (self._timeoutInfo) {\n    for (const [, info] of self._timeoutInfo) {\n      clearTimeout(info.timeoutId);\n    }\n    self._timeoutInfo.clear();\n  }\n  return originalClose.call(this);\n};\n"],"names":["originalClose","Protocol","prototype","close","self","info","_timeoutInfo","clearTimeout","timeoutId","clear","call"],"mappings":"AAAA;;;;CAIC;;;;wBAEwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzB;;;;;;;;;;;;;;;;CAgBC,GACD,IAAMA,gBAAgBC,kBAAQ,CAACC,SAAS,CAACC,KAAK;AAC9CF,kBAAQ,CAACC,SAAS,CAACC,KAAK,GAAG;;YACnBC,MAEC,2BAAA,mBAAA,gBAAA,WAAA,oBAASC;;YAFVD,OAAO,IAAI;YACjB,IAAIA,KAAKE,YAAY,EAAE;gBAChB,kCAAA,2BAAA;;oBAAL,IAAK,YAAkBF,KAAKE,YAAY,uBAAnC,6BAAA,QAAA,yBAAA,iCAAqC;uDAArC,iBAASD;wBACZE,aAAaF,KAAKG,SAAS;oBAC7B;;oBAFK;oBAAA;;;6BAAA,6BAAA;4BAAA;;;4BAAA;kCAAA;;;;gBAGLJ,KAAKE,YAAY,CAACG,KAAK;YACzB;YACA;;gBAAOT,cAAcU,IAAI,CAAC,IAAI;;;IAChC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/dist/cjs/response-wrappers.d.cts

@@ -0,0 +1,41 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+export type NativeCallToolResponse = Awaited<ReturnType<Client['callTool']>>;
+export type NativeGetPromptResponse = Awaited<ReturnType<Client['getPrompt']>>;
+export type NativeReadResourceResponse = Awaited<ReturnType<Client['readResource']>>;
+export type JsonValidator<T> = (value: unknown) => asserts value is T;
+export declare class ToolResponseError extends Error {
+    readonly response: NativeCallToolResponse;
+    constructor(message: string, response: NativeCallToolResponse);
+}
+export declare class ToolResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeCallToolResponse);
+    raw(): NativeCallToolResponse;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+    text(): string;
+    private resolveJsonPayload;
+    private throwIfError;
+}
+export declare class PromptResponseError extends Error {
+    readonly response: NativeGetPromptResponse;
+    constructor(message: string, response: NativeGetPromptResponse);
+}
+export declare class PromptResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeGetPromptResponse);
+    raw(): NativeGetPromptResponse;
+    text(): string;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+}
+export declare class ResourceResponseError extends Error {
+    readonly response: NativeReadResourceResponse;
+    constructor(message: string, response: NativeReadResourceResponse);
+}
+export declare class ResourceResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeReadResourceResponse);
+    raw(): NativeReadResourceResponse;
+    text(): string;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+    private firstEntry;
+}

package/dist/cjs/response-wrappers.d.ts

@@ -0,0 +1,41 @@
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+export type NativeCallToolResponse = Awaited<ReturnType<Client['callTool']>>;
+export type NativeGetPromptResponse = Awaited<ReturnType<Client['getPrompt']>>;
+export type NativeReadResourceResponse = Awaited<ReturnType<Client['readResource']>>;
+export type JsonValidator<T> = (value: unknown) => asserts value is T;
+export declare class ToolResponseError extends Error {
+    readonly response: NativeCallToolResponse;
+    constructor(message: string, response: NativeCallToolResponse);
+}
+export declare class ToolResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeCallToolResponse);
+    raw(): NativeCallToolResponse;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+    text(): string;
+    private resolveJsonPayload;
+    private throwIfError;
+}
+export declare class PromptResponseError extends Error {
+    readonly response: NativeGetPromptResponse;
+    constructor(message: string, response: NativeGetPromptResponse);
+}
+export declare class PromptResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeGetPromptResponse);
+    raw(): NativeGetPromptResponse;
+    text(): string;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+}
+export declare class ResourceResponseError extends Error {
+    readonly response: NativeReadResourceResponse;
+    constructor(message: string, response: NativeReadResourceResponse);
+}
+export declare class ResourceResponseWrapper {
+    private readonly payload;
+    constructor(payload: NativeReadResourceResponse);
+    raw(): NativeReadResourceResponse;
+    text(): string;
+    json<T = unknown>(validator?: JsonValidator<T>): T;
+    private firstEntry;
+}