skybridge 0.0.0-dev.ff4b4a2 → 0.0.0-dev.ffe77e9

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 (263) hide show
  1. package/README.md +24 -15
  2. package/dist/cli/detect-port.d.ts +18 -0
  3. package/dist/cli/detect-port.js +61 -0
  4. package/dist/cli/detect-port.js.map +1 -0
  5. package/dist/cli/header.js +1 -1
  6. package/dist/cli/header.js.map +1 -1
  7. package/dist/cli/run-command.js.map +1 -1
  8. package/dist/cli/telemetry.js.map +1 -1
  9. package/dist/cli/tunnel-control-server.d.ts +9 -0
  10. package/dist/cli/tunnel-control-server.js +31 -0
  11. package/dist/cli/tunnel-control-server.js.map +1 -0
  12. package/dist/cli/tunnel-control-server.test.js +39 -0
  13. package/dist/cli/tunnel-control-server.test.js.map +1 -0
  14. package/dist/cli/tunnel-handler.d.ts +3 -0
  15. package/dist/cli/tunnel-handler.js +48 -0
  16. package/dist/cli/tunnel-handler.js.map +1 -0
  17. package/dist/cli/tunnel-handler.test.js +105 -0
  18. package/dist/cli/tunnel-handler.test.js.map +1 -0
  19. package/dist/cli/tunnel.d.ts +57 -0
  20. package/dist/cli/tunnel.js +154 -0
  21. package/dist/cli/tunnel.js.map +1 -0
  22. package/dist/cli/tunnel.test.d.ts +1 -0
  23. package/dist/cli/tunnel.test.js +190 -0
  24. package/dist/cli/tunnel.test.js.map +1 -0
  25. package/dist/cli/types.d.ts +5 -0
  26. package/dist/cli/types.js +2 -0
  27. package/dist/cli/types.js.map +1 -0
  28. package/dist/cli/use-execute-steps.js.map +1 -1
  29. package/dist/cli/use-messages.d.ts +3 -0
  30. package/dist/cli/use-messages.js +11 -0
  31. package/dist/cli/use-messages.js.map +1 -0
  32. package/dist/cli/use-nodemon.d.ts +2 -6
  33. package/dist/cli/use-nodemon.js +30 -18
  34. package/dist/cli/use-nodemon.js.map +1 -1
  35. package/dist/cli/use-open-browser.d.ts +1 -0
  36. package/dist/cli/use-open-browser.js +44 -0
  37. package/dist/cli/use-open-browser.js.map +1 -0
  38. package/dist/cli/use-tunnel.d.ts +14 -0
  39. package/dist/cli/use-tunnel.js +131 -0
  40. package/dist/cli/use-tunnel.js.map +1 -0
  41. package/dist/cli/use-typescript-check.d.ts +1 -0
  42. package/dist/cli/use-typescript-check.js +41 -6
  43. package/dist/cli/use-typescript-check.js.map +1 -1
  44. package/dist/commands/build.js +63 -7
  45. package/dist/commands/build.js.map +1 -1
  46. package/dist/commands/dev.d.ts +4 -1
  47. package/dist/commands/dev.js +57 -8
  48. package/dist/commands/dev.js.map +1 -1
  49. package/dist/commands/start.d.ts +3 -1
  50. package/dist/commands/start.js +31 -15
  51. package/dist/commands/start.js.map +1 -1
  52. package/dist/commands/telemetry/disable.js.map +1 -1
  53. package/dist/commands/telemetry/enable.js.map +1 -1
  54. package/dist/commands/telemetry/status.js.map +1 -1
  55. package/dist/server/asset-base-url-transform-plugin.d.ts +5 -6
  56. package/dist/server/asset-base-url-transform-plugin.js +9 -10
  57. package/dist/server/asset-base-url-transform-plugin.js.map +1 -1
  58. package/dist/server/asset-base-url-transform-plugin.test.js +41 -13
  59. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -1
  60. package/dist/server/content-helpers.d.ts +27 -0
  61. package/dist/server/content-helpers.js +46 -0
  62. package/dist/server/content-helpers.js.map +1 -0
  63. package/dist/server/content-helpers.test.d.ts +1 -0
  64. package/dist/server/content-helpers.test.js +70 -0
  65. package/dist/server/content-helpers.test.js.map +1 -0
  66. package/dist/server/express.d.ts +11 -0
  67. package/dist/server/express.js +101 -0
  68. package/dist/server/express.js.map +1 -0
  69. package/dist/server/express.test.d.ts +1 -0
  70. package/dist/server/express.test.js +430 -0
  71. package/dist/server/express.test.js.map +1 -0
  72. package/dist/server/index.d.ts +5 -3
  73. package/dist/server/index.js +3 -2
  74. package/dist/server/index.js.map +1 -1
  75. package/dist/server/inferUtilityTypes.d.ts +6 -6
  76. package/dist/server/inferUtilityTypes.js.map +1 -1
  77. package/dist/server/metric.d.ts +14 -0
  78. package/dist/server/metric.js +62 -0
  79. package/dist/server/metric.js.map +1 -0
  80. package/dist/server/middleware.d.ts +124 -0
  81. package/dist/server/middleware.js +93 -0
  82. package/dist/server/middleware.js.map +1 -0
  83. package/dist/server/middleware.test-d.d.ts +1 -0
  84. package/dist/server/middleware.test-d.js +75 -0
  85. package/dist/server/middleware.test-d.js.map +1 -0
  86. package/dist/server/middleware.test.d.ts +1 -0
  87. package/dist/server/middleware.test.js +493 -0
  88. package/dist/server/middleware.test.js.map +1 -0
  89. package/dist/server/server.d.ts +160 -63
  90. package/dist/server/server.js +391 -76
  91. package/dist/server/server.js.map +1 -1
  92. package/dist/server/templateHelper.d.ts +5 -8
  93. package/dist/server/templateHelper.js +3 -22
  94. package/dist/server/templateHelper.js.map +1 -1
  95. package/dist/server/templates.generated.d.ts +4 -0
  96. package/dist/server/templates.generated.js +47 -0
  97. package/dist/server/templates.generated.js.map +1 -0
  98. package/dist/server/tunnel-proxy-router.d.ts +7 -0
  99. package/dist/server/tunnel-proxy-router.js +110 -0
  100. package/dist/server/tunnel-proxy-router.js.map +1 -0
  101. package/dist/server/tunnel-proxy-router.test.d.ts +1 -0
  102. package/dist/server/tunnel-proxy-router.test.js +229 -0
  103. package/dist/server/tunnel-proxy-router.test.js.map +1 -0
  104. package/dist/server/viewsDevServer.d.ts +14 -0
  105. package/dist/server/viewsDevServer.js +45 -0
  106. package/dist/server/viewsDevServer.js.map +1 -0
  107. package/dist/test/utils.d.ts +13 -21
  108. package/dist/test/utils.js +42 -37
  109. package/dist/test/utils.js.map +1 -1
  110. package/dist/test/view.test.d.ts +1 -0
  111. package/dist/test/view.test.js +523 -0
  112. package/dist/test/view.test.js.map +1 -0
  113. package/dist/version.d.ts +1 -0
  114. package/dist/version.js +3 -0
  115. package/dist/version.js.map +1 -0
  116. package/dist/web/bridges/apps-sdk/adaptor.d.ts +9 -7
  117. package/dist/web/bridges/apps-sdk/adaptor.js +51 -19
  118. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -1
  119. package/dist/web/bridges/apps-sdk/bridge.d.ts +1 -1
  120. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  121. package/dist/web/bridges/apps-sdk/index.d.ts +1 -1
  122. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  123. package/dist/web/bridges/apps-sdk/types.d.ts +30 -14
  124. package/dist/web/bridges/apps-sdk/types.js.map +1 -1
  125. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -1
  126. package/dist/web/bridges/get-adaptor.js.map +1 -1
  127. package/dist/web/bridges/index.js.map +1 -1
  128. package/dist/web/bridges/mcp-app/adaptor.d.ts +21 -9
  129. package/dist/web/bridges/mcp-app/adaptor.js +142 -64
  130. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -1
  131. package/dist/web/bridges/mcp-app/bridge.d.ts +13 -30
  132. package/dist/web/bridges/mcp-app/bridge.js +43 -196
  133. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  134. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  135. package/dist/web/bridges/mcp-app/types.js.map +1 -1
  136. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +5 -3
  137. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +2 -2
  138. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -1
  139. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +1 -41
  140. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -1
  141. package/dist/web/bridges/types.d.ts +26 -13
  142. package/dist/web/bridges/types.js.map +1 -1
  143. package/dist/web/bridges/use-host-context.js.map +1 -1
  144. package/dist/web/components/modal-provider.js +3 -5
  145. package/dist/web/components/modal-provider.js.map +1 -1
  146. package/dist/web/create-store.js +17 -3
  147. package/dist/web/create-store.js.map +1 -1
  148. package/dist/web/create-store.test.js +23 -20
  149. package/dist/web/create-store.test.js.map +1 -1
  150. package/dist/web/data-llm.d.ts +1 -1
  151. package/dist/web/data-llm.js +3 -3
  152. package/dist/web/data-llm.js.map +1 -1
  153. package/dist/web/data-llm.test.js +33 -30
  154. package/dist/web/data-llm.test.js.map +1 -1
  155. package/dist/web/generate-helpers.d.ts +20 -18
  156. package/dist/web/generate-helpers.js +20 -18
  157. package/dist/web/generate-helpers.js.map +1 -1
  158. package/dist/web/generate-helpers.test-d.js +26 -26
  159. package/dist/web/generate-helpers.test-d.js.map +1 -1
  160. package/dist/web/generate-helpers.test.js.map +1 -1
  161. package/dist/web/helpers/state.d.ts +2 -2
  162. package/dist/web/helpers/state.js +11 -11
  163. package/dist/web/helpers/state.js.map +1 -1
  164. package/dist/web/helpers/state.test.js +9 -9
  165. package/dist/web/helpers/state.test.js.map +1 -1
  166. package/dist/web/hooks/index.d.ts +2 -2
  167. package/dist/web/hooks/index.js +1 -1
  168. package/dist/web/hooks/index.js.map +1 -1
  169. package/dist/web/hooks/test/utils.js +4 -0
  170. package/dist/web/hooks/test/utils.js.map +1 -1
  171. package/dist/web/hooks/use-call-tool.js.map +1 -1
  172. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -1
  173. package/dist/web/hooks/use-call-tool.test.js +0 -4
  174. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  175. package/dist/web/hooks/use-display-mode.d.ts +3 -3
  176. package/dist/web/hooks/use-display-mode.js.map +1 -1
  177. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  178. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  179. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  180. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  181. package/dist/web/hooks/use-files.d.ts +2 -1
  182. package/dist/web/hooks/use-files.js +1 -0
  183. package/dist/web/hooks/use-files.js.map +1 -1
  184. package/dist/web/hooks/use-files.test.js +27 -3
  185. package/dist/web/hooks/use-files.test.js.map +1 -1
  186. package/dist/web/hooks/use-layout.js.map +1 -1
  187. package/dist/web/hooks/use-layout.test.js +3 -3
  188. package/dist/web/hooks/use-layout.test.js.map +1 -1
  189. package/dist/web/hooks/use-open-external.d.ts +3 -1
  190. package/dist/web/hooks/use-open-external.js +1 -1
  191. package/dist/web/hooks/use-open-external.js.map +1 -1
  192. package/dist/web/hooks/use-open-external.test.js +26 -11
  193. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  194. package/dist/web/hooks/use-request-modal.d.ts +1 -1
  195. package/dist/web/hooks/use-request-modal.js +4 -4
  196. package/dist/web/hooks/use-request-modal.js.map +1 -1
  197. package/dist/web/hooks/use-request-modal.test.js +5 -1
  198. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  199. package/dist/web/hooks/use-send-follow-up-message.d.ts +2 -1
  200. package/dist/web/hooks/use-send-follow-up-message.js +2 -2
  201. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -1
  202. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -1
  203. package/dist/web/hooks/use-set-open-in-app-url.test.js +5 -11
  204. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  205. package/dist/web/hooks/use-tool-info.js.map +1 -1
  206. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -1
  207. package/dist/web/hooks/use-tool-info.test.js +1 -1
  208. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  209. package/dist/web/hooks/use-user.js +18 -2
  210. package/dist/web/hooks/use-user.js.map +1 -1
  211. package/dist/web/hooks/use-user.test.js +29 -1
  212. package/dist/web/hooks/use-user.test.js.map +1 -1
  213. package/dist/web/hooks/use-view-state.d.ts +4 -0
  214. package/dist/web/hooks/use-view-state.js +32 -0
  215. package/dist/web/hooks/use-view-state.js.map +1 -0
  216. package/dist/web/hooks/use-view-state.test.d.ts +1 -0
  217. package/dist/web/hooks/use-view-state.test.js +177 -0
  218. package/dist/web/hooks/use-view-state.test.js.map +1 -0
  219. package/dist/web/index.d.ts +1 -2
  220. package/dist/web/index.js +1 -2
  221. package/dist/web/index.js.map +1 -1
  222. package/dist/web/mount-view.d.ts +1 -0
  223. package/dist/web/{mount-widget.js → mount-view.js} +2 -2
  224. package/dist/web/mount-view.js.map +1 -0
  225. package/dist/web/plugin/data-llm.test.js.map +1 -1
  226. package/dist/web/plugin/plugin.d.ts +4 -1
  227. package/dist/web/plugin/plugin.js +128 -18
  228. package/dist/web/plugin/plugin.js.map +1 -1
  229. package/dist/web/plugin/scan-views.d.ts +16 -0
  230. package/dist/web/plugin/scan-views.js +88 -0
  231. package/dist/web/plugin/scan-views.js.map +1 -0
  232. package/dist/web/plugin/scan-views.test.d.ts +1 -0
  233. package/dist/web/plugin/scan-views.test.js +99 -0
  234. package/dist/web/plugin/scan-views.test.js.map +1 -0
  235. package/dist/web/plugin/transform-data-llm.js +1 -1
  236. package/dist/web/plugin/transform-data-llm.js.map +1 -1
  237. package/dist/web/plugin/transform-data-llm.test.js.map +1 -1
  238. package/dist/web/plugin/validate-view.d.ts +1 -0
  239. package/dist/web/plugin/validate-view.js +9 -0
  240. package/dist/web/plugin/validate-view.js.map +1 -0
  241. package/dist/web/plugin/validate-view.test.d.ts +1 -0
  242. package/dist/web/plugin/validate-view.test.js +24 -0
  243. package/dist/web/plugin/validate-view.test.js.map +1 -0
  244. package/dist/web/proxy.js.map +1 -1
  245. package/dist/web/types.js.map +1 -1
  246. package/package.json +44 -30
  247. package/tsconfig.base.json +33 -0
  248. package/dist/server/templates/development.hbs +0 -67
  249. package/dist/server/templates/production.hbs +0 -6
  250. package/dist/server/widgetsDevServer.d.ts +0 -12
  251. package/dist/server/widgetsDevServer.js +0 -57
  252. package/dist/server/widgetsDevServer.js.map +0 -1
  253. package/dist/test/widget.test.js +0 -255
  254. package/dist/test/widget.test.js.map +0 -1
  255. package/dist/web/hooks/use-widget-state.d.ts +0 -4
  256. package/dist/web/hooks/use-widget-state.js +0 -32
  257. package/dist/web/hooks/use-widget-state.js.map +0 -1
  258. package/dist/web/hooks/use-widget-state.test.js +0 -61
  259. package/dist/web/hooks/use-widget-state.test.js.map +0 -1
  260. package/dist/web/mount-widget.d.ts +0 -1
  261. package/dist/web/mount-widget.js.map +0 -1
  262. /package/dist/{test/widget.test.d.ts → cli/tunnel-control-server.test.d.ts} +0 -0
  263. /package/dist/{web/hooks/use-widget-state.test.d.ts → cli/tunnel-handler.test.d.ts} +0 -0
@@ -0,0 +1,493 @@
1
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
2
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
3
+ import { describe, expect, it, vi } from "vitest";
4
+ import { z } from "zod";
5
+ import { buildMiddlewareChain, getHandlerMaps, matchesFilter, } from "./middleware.js";
6
+ import { McpServer } from "./server.js";
7
+ // ---------------------------------------------------------------------------
8
+ // matchesFilter
9
+ // ---------------------------------------------------------------------------
10
+ describe("matchesFilter", () => {
11
+ it("matches exact method", () => {
12
+ expect(matchesFilter("tools/call", "tools/call", false)).toBe(true);
13
+ });
14
+ it("rejects non-matching exact method", () => {
15
+ expect(matchesFilter("tools/list", "tools/call", false)).toBe(false);
16
+ });
17
+ it("matches wildcard", () => {
18
+ expect(matchesFilter("tools/call", "tools/*", false)).toBe(true);
19
+ expect(matchesFilter("tools/list", "tools/*", false)).toBe(true);
20
+ });
21
+ it("rejects non-matching wildcard", () => {
22
+ expect(matchesFilter("resources/read", "tools/*", false)).toBe(false);
23
+ });
24
+ it('category "request" matches when isNotification=false', () => {
25
+ expect(matchesFilter("tools/call", "request", false)).toBe(true);
26
+ });
27
+ it('category "request" rejects when isNotification=true', () => {
28
+ expect(matchesFilter("notifications/initialized", "request", true)).toBe(false);
29
+ });
30
+ it('category "notification" matches when isNotification=true', () => {
31
+ expect(matchesFilter("notifications/initialized", "notification", true)).toBe(true);
32
+ });
33
+ it('category "notification" rejects when isNotification=false', () => {
34
+ expect(matchesFilter("tools/call", "notification", false)).toBe(false);
35
+ });
36
+ });
37
+ // ---------------------------------------------------------------------------
38
+ // buildMiddlewareChain
39
+ // ---------------------------------------------------------------------------
40
+ describe("buildMiddlewareChain", () => {
41
+ const fakeExtra = {};
42
+ const makeHandler = (returnValue) => vi.fn(async () => returnValue);
43
+ const makeEntry = (filter, handler) => ({ filter, handler });
44
+ it("returns original handler when no middleware applies", () => {
45
+ const original = makeHandler("result");
46
+ const chain = buildMiddlewareChain("tools/call", false, original, [
47
+ makeEntry("resources/*", async (_req, _extra, next) => next()),
48
+ ]);
49
+ expect(chain).toBe(original);
50
+ });
51
+ it("catch-all middleware runs for any method", async () => {
52
+ const original = makeHandler("ok");
53
+ const spy = vi.fn();
54
+ const chain = buildMiddlewareChain("tools/call", false, original, [
55
+ makeEntry(null, async (request, _extra, next) => {
56
+ spy(request.method);
57
+ return next();
58
+ }),
59
+ ]);
60
+ const result = await chain({ method: "tools/call", params: {} }, fakeExtra);
61
+ expect(spy).toHaveBeenCalledWith("tools/call");
62
+ expect(result).toBe("ok");
63
+ });
64
+ it("method-scoped middleware only runs for matching methods", async () => {
65
+ const original = makeHandler("ok");
66
+ const spy = vi.fn();
67
+ const entries = [
68
+ makeEntry("tools/call", async (_req, _extra, next) => {
69
+ spy("tools/call");
70
+ return next();
71
+ }),
72
+ ];
73
+ // Matching
74
+ const chain1 = buildMiddlewareChain("tools/call", false, original, entries);
75
+ await chain1({ method: "tools/call", params: {} }, fakeExtra);
76
+ expect(spy).toHaveBeenCalledTimes(1);
77
+ // Non-matching — returns original handler directly
78
+ const chain2 = buildMiddlewareChain("tools/list", false, original, entries);
79
+ expect(chain2).toBe(original);
80
+ });
81
+ it("executes middleware in registration order (onion model)", async () => {
82
+ const calls = [];
83
+ const original = makeHandler("result");
84
+ const chain = buildMiddlewareChain("tools/call", false, original, [
85
+ makeEntry(null, async (_req, _extra, next) => {
86
+ calls.push("A:before");
87
+ const result = await next();
88
+ calls.push("A:after");
89
+ return result;
90
+ }),
91
+ makeEntry(null, async (_req, _extra, next) => {
92
+ calls.push("B:before");
93
+ const result = await next();
94
+ calls.push("B:after");
95
+ return result;
96
+ }),
97
+ ]);
98
+ await chain({ method: "tools/call", params: {} }, fakeExtra);
99
+ expect(calls).toEqual(["A:before", "B:before", "B:after", "A:after"]);
100
+ });
101
+ it("short-circuit (no next() call) skips handler", async () => {
102
+ const original = makeHandler("original");
103
+ const chain = buildMiddlewareChain("tools/call", false, original, [
104
+ makeEntry(null, async () => "short-circuited"),
105
+ ]);
106
+ const result = await chain({ method: "tools/call", params: {} }, fakeExtra);
107
+ expect(result).toBe("short-circuited");
108
+ expect(original).not.toHaveBeenCalled();
109
+ });
110
+ it("middleware can modify result post-next()", async () => {
111
+ const original = makeHandler({ value: 1 });
112
+ const chain = buildMiddlewareChain("tools/call", false, original, [
113
+ makeEntry(null, async (_req, _extra, next) => {
114
+ const result = (await next());
115
+ return { value: result.value + 10 };
116
+ }),
117
+ ]);
118
+ const result = await chain({ method: "tools/call", params: {} }, fakeExtra);
119
+ expect(result).toEqual({ value: 11 });
120
+ });
121
+ it("throws on double next() call", async () => {
122
+ const original = makeHandler("ok");
123
+ const chain = buildMiddlewareChain("tools/call", false, original, [
124
+ makeEntry(null, async (_req, _extra, next) => {
125
+ await next();
126
+ return next(); // double call
127
+ }),
128
+ ]);
129
+ await expect(chain({ method: "tools/call", params: {} }, fakeExtra)).rejects.toThrow("next() called multiple times");
130
+ });
131
+ it("propagates errors from handler and middleware", async () => {
132
+ // Error from original handler bubbles through middleware
133
+ const failingHandler = vi.fn(async () => {
134
+ throw new Error("handler boom");
135
+ });
136
+ const chain1 = buildMiddlewareChain("tools/call", false, failingHandler, [
137
+ makeEntry(null, async (_req, _extra, next) => next()),
138
+ ]);
139
+ await expect(chain1({ method: "tools/call", params: {} }, fakeExtra)).rejects.toThrow("handler boom");
140
+ // Error thrown inside middleware propagates
141
+ const chain2 = buildMiddlewareChain("tools/call", false, makeHandler("ok"), [
142
+ makeEntry(null, async () => {
143
+ throw new Error("middleware boom");
144
+ }),
145
+ ]);
146
+ await expect(chain2({ method: "tools/call", params: {} }, fakeExtra)).rejects.toThrow("middleware boom");
147
+ });
148
+ it("passes extra as undefined for notifications (isNotification=true)", async () => {
149
+ const original = makeHandler(undefined);
150
+ let capturedExtra = {};
151
+ const chain = buildMiddlewareChain("notifications/initialized", true, original, [
152
+ makeEntry(null, async (_req, extra, next) => {
153
+ capturedExtra = extra;
154
+ return next();
155
+ }),
156
+ ]);
157
+ await chain({ method: "notifications/initialized" });
158
+ expect(capturedExtra).toBeUndefined();
159
+ });
160
+ it("defaults params to empty object when rawRequest has no params", async () => {
161
+ const original = makeHandler("ok");
162
+ let capturedParams;
163
+ const chain = buildMiddlewareChain("tools/call", false, original, [
164
+ makeEntry(null, async (request, _extra, next) => {
165
+ capturedParams = request.params;
166
+ return next();
167
+ }),
168
+ ]);
169
+ await chain({ method: "tools/call" }, fakeExtra);
170
+ expect(capturedParams).toEqual({});
171
+ });
172
+ it("propagates in-place param mutation to original handler", async () => {
173
+ let handlerReceivedName = "";
174
+ const original = vi.fn(async (rawReq) => {
175
+ handlerReceivedName = rawReq.params.name;
176
+ return "ok";
177
+ });
178
+ const chain = buildMiddlewareChain("tools/call", false, original, [
179
+ makeEntry(null, async (request, _extra, next) => {
180
+ request.params.name = "mutated";
181
+ return next();
182
+ }),
183
+ ]);
184
+ await chain({ params: { name: "original" } }, fakeExtra);
185
+ expect(handlerReceivedName).toBe("mutated");
186
+ });
187
+ it("propagates full param replacement to original handler", async () => {
188
+ let handlerReceivedParams = {};
189
+ const original = vi.fn(async (rawReq) => {
190
+ handlerReceivedParams = rawReq.params;
191
+ return "ok";
192
+ });
193
+ const chain = buildMiddlewareChain("tools/call", false, original, [
194
+ makeEntry(null, async (request, _extra, next) => {
195
+ request.params = { replaced: true };
196
+ return next();
197
+ }),
198
+ ]);
199
+ await chain({ params: { original: true } }, fakeExtra);
200
+ expect(handlerReceivedParams).toEqual({ replaced: true });
201
+ });
202
+ });
203
+ // ---------------------------------------------------------------------------
204
+ // McpServer.mcpMiddleware() integration tests
205
+ // ---------------------------------------------------------------------------
206
+ describe("McpServer.mcpMiddleware()", () => {
207
+ function createClient() {
208
+ return new Client({ name: "test-client", version: "1.0.0" });
209
+ }
210
+ it("returns this for chaining", () => {
211
+ const server = new McpServer({ name: "test", version: "1.0.0" });
212
+ const result = server.mcpMiddleware(async (_req, _extra, next) => next());
213
+ expect(result).toBe(server);
214
+ });
215
+ it("intercepts tools/call and exposes request params", async () => {
216
+ let capturedMethod = "";
217
+ let capturedParams = {};
218
+ const server = new McpServer({ name: "test", version: "1.0.0" });
219
+ server.registerTool({
220
+ name: "greet",
221
+ description: "greet",
222
+ inputSchema: { name: z.string() },
223
+ }, (args) => ({
224
+ content: [{ type: "text", text: `hi ${args.name}` }],
225
+ }));
226
+ server.mcpMiddleware("tools/call", async (request, _extra, next) => {
227
+ capturedMethod = request.method;
228
+ capturedParams = request.params;
229
+ return next();
230
+ });
231
+ const client = createClient();
232
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
233
+ await server.connect(serverTransport);
234
+ await client.connect(clientTransport);
235
+ const result = await client.callTool({
236
+ name: "greet",
237
+ arguments: { name: "World" },
238
+ });
239
+ expect(capturedMethod).toBe("tools/call");
240
+ expect(capturedParams).toMatchObject({
241
+ name: "greet",
242
+ arguments: { name: "World" },
243
+ });
244
+ expect(result.content).toEqual([{ type: "text", text: "hi World" }]);
245
+ await client.close();
246
+ await server.close();
247
+ });
248
+ it("array filter works", async () => {
249
+ const matchedMethods = [];
250
+ const server = new McpServer({ name: "test", version: "1.0.0" });
251
+ server.registerTool({ name: "t1", description: "t1" }, () => ({
252
+ content: [{ type: "text", text: "ok" }],
253
+ }));
254
+ server.mcpMiddleware(["tools/call", "tools/list"], async (request, _extra, next) => {
255
+ matchedMethods.push(request.method);
256
+ return next();
257
+ });
258
+ const client = createClient();
259
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
260
+ await server.connect(serverTransport);
261
+ await client.connect(clientTransport);
262
+ await client.listTools();
263
+ await client.callTool({ name: "t1" });
264
+ expect(matchedMethods).toEqual(["tools/list", "tools/call"]);
265
+ await client.close();
266
+ await server.close();
267
+ });
268
+ it("throws if registered after connect()", async () => {
269
+ const server = new McpServer({ name: "test", version: "1.0.0" });
270
+ const [_clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
271
+ await server.connect(serverTransport);
272
+ expect(() => server.mcpMiddleware(async (_req, _extra, next) => next())).toThrow("Cannot register MCP middleware after run() or connect()");
273
+ await server.close();
274
+ });
275
+ it("throws when filter provided without handler", () => {
276
+ const server = new McpServer({ name: "test", version: "1.0.0" });
277
+ expect(() =>
278
+ // @ts-expect-error intentionally passing filter without handler
279
+ server.mcpMiddleware("tools/call")).toThrow("mcpMiddleware requires a handler function");
280
+ });
281
+ it("catch-all middleware + filtered middleware stack correctly", async () => {
282
+ const calls = [];
283
+ const server = new McpServer({ name: "test", version: "1.0.0" });
284
+ server.registerTool({ name: "t1", description: "t1" }, () => ({
285
+ content: [{ type: "text", text: "ok" }],
286
+ }));
287
+ server
288
+ .mcpMiddleware(async (request, _extra, next) => {
289
+ calls.push(`global:${request.method}`);
290
+ return next();
291
+ })
292
+ .mcpMiddleware("tools/call", async (_req, _extra, next) => {
293
+ calls.push("tools-only");
294
+ return next();
295
+ });
296
+ const client = createClient();
297
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
298
+ await server.connect(serverTransport);
299
+ await client.connect(clientTransport);
300
+ await client.listTools();
301
+ await client.callTool({ name: "t1" });
302
+ // Catch-all also intercepts initialize + notifications/initialized from handshake.
303
+ // tools/list: only global middleware runs
304
+ // tools/call: global + tools-only both run
305
+ expect(calls).toContain("global:tools/list");
306
+ expect(calls).toContain("global:tools/call");
307
+ expect(calls).toContain("tools-only");
308
+ // "tools-only" must come right after "global:tools/call"
309
+ const toolsCallIdx = calls.indexOf("global:tools/call");
310
+ expect(calls[toolsCallIdx + 1]).toBe("tools-only");
311
+ await client.close();
312
+ await server.close();
313
+ });
314
+ it("notification middleware receives extra as undefined", async () => {
315
+ let capturedExtra = "sentinel";
316
+ const server = new McpServer({ name: "test", version: "1.0.0" });
317
+ server.registerTool({ name: "t1", description: "t1" }, () => ({
318
+ content: [{ type: "text", text: "ok" }],
319
+ }));
320
+ server.mcpMiddleware("notification", async (_request, extra, next) => {
321
+ capturedExtra = extra;
322
+ return next();
323
+ });
324
+ const client = createClient();
325
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
326
+ await server.connect(serverTransport);
327
+ await client.connect(clientTransport);
328
+ // The client sends notifications/initialized automatically on connect.
329
+ await client.listTools();
330
+ expect(capturedExtra).toBeUndefined();
331
+ await client.close();
332
+ await server.close();
333
+ });
334
+ it("wildcard filter intercepts matching methods only", async () => {
335
+ const matchedMethods = [];
336
+ const server = new McpServer({ name: "test", version: "1.0.0" });
337
+ server.registerTool({ name: "t1", description: "t1" }, () => ({
338
+ content: [{ type: "text", text: "ok" }],
339
+ }));
340
+ server.mcpMiddleware("tools/*", async (request, _extra, next) => {
341
+ matchedMethods.push(request.method);
342
+ return next();
343
+ });
344
+ const client = createClient();
345
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
346
+ await server.connect(serverTransport);
347
+ await client.connect(clientTransport);
348
+ await client.listTools();
349
+ await client.callTool({ name: "t1" });
350
+ expect(matchedMethods).toContain("tools/list");
351
+ expect(matchedMethods).toContain("tools/call");
352
+ // Should not match initialize or notifications
353
+ expect(matchedMethods).not.toContain("initialize");
354
+ expect(matchedMethods).not.toContain("notifications/initialized");
355
+ await client.close();
356
+ await server.close();
357
+ });
358
+ it("middleware can modify tool result via McpServer integration", async () => {
359
+ const server = new McpServer({ name: "test", version: "1.0.0" });
360
+ server.registerTool({
361
+ name: "greet",
362
+ description: "greet",
363
+ inputSchema: { name: z.string() },
364
+ }, (args) => ({
365
+ content: [{ type: "text", text: `hi ${args.name}` }],
366
+ }));
367
+ server.mcpMiddleware("tools/call", async (_req, _extra, next) => {
368
+ const result = (await next());
369
+ return {
370
+ ...result,
371
+ content: [
372
+ ...result.content,
373
+ { type: "text", text: " (modified)" },
374
+ ],
375
+ };
376
+ });
377
+ const client = createClient();
378
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
379
+ await server.connect(serverTransport);
380
+ await client.connect(clientTransport);
381
+ const result = await client.callTool({
382
+ name: "greet",
383
+ arguments: { name: "World" },
384
+ });
385
+ expect(result.content).toEqual([
386
+ { type: "text", text: "hi World" },
387
+ { type: "text", text: " (modified)" },
388
+ ]);
389
+ await client.close();
390
+ await server.close();
391
+ });
392
+ it("middleware can short-circuit via McpServer integration", async () => {
393
+ const handlerCalled = vi.fn();
394
+ const server = new McpServer({ name: "test", version: "1.0.0" });
395
+ server.registerTool({ name: "t1", description: "t1" }, () => {
396
+ handlerCalled();
397
+ return {
398
+ content: [{ type: "text", text: "original" }],
399
+ };
400
+ });
401
+ server.mcpMiddleware("tools/call", async () => ({
402
+ content: [{ type: "text", text: "short-circuited" }],
403
+ }));
404
+ const client = createClient();
405
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
406
+ await server.connect(serverTransport);
407
+ await client.connect(clientTransport);
408
+ const result = await client.callTool({ name: "t1" });
409
+ expect(result.content).toEqual([{ type: "text", text: "short-circuited" }]);
410
+ expect(handlerCalled).not.toHaveBeenCalled();
411
+ await client.close();
412
+ await server.close();
413
+ });
414
+ it("middleware can mutate tool call params via McpServer integration", async () => {
415
+ let receivedName = "";
416
+ const server = new McpServer({ name: "test", version: "1.0.0" });
417
+ server.registerTool({
418
+ name: "greet",
419
+ description: "greet",
420
+ inputSchema: { name: z.string() },
421
+ }, (args) => {
422
+ receivedName = args.name;
423
+ return {
424
+ content: [{ type: "text", text: `hi ${args.name}` }],
425
+ };
426
+ });
427
+ server.mcpMiddleware("tools/call", async (request, _extra, next) => {
428
+ request.params.arguments = { name: "Overridden" };
429
+ return next();
430
+ });
431
+ const client = createClient();
432
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
433
+ await server.connect(serverTransport);
434
+ await client.connect(clientTransport);
435
+ await client.callTool({
436
+ name: "greet",
437
+ arguments: { name: "Original" },
438
+ });
439
+ expect(receivedName).toBe("Overridden");
440
+ await client.close();
441
+ await server.close();
442
+ });
443
+ it("category 'request' filter matches requests but not notifications", async () => {
444
+ const matchedMethods = [];
445
+ const server = new McpServer({ name: "test", version: "1.0.0" });
446
+ server.registerTool({ name: "t1", description: "t1" }, () => ({
447
+ content: [{ type: "text", text: "ok" }],
448
+ }));
449
+ server.mcpMiddleware("request", async (request, _extra, next) => {
450
+ matchedMethods.push(request.method);
451
+ return next();
452
+ });
453
+ const client = createClient();
454
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
455
+ await server.connect(serverTransport);
456
+ await client.connect(clientTransport);
457
+ await client.listTools();
458
+ await client.callTool({ name: "t1" });
459
+ expect(matchedMethods).toContain("tools/list");
460
+ expect(matchedMethods).toContain("tools/call");
461
+ expect(matchedMethods).not.toContain("notifications/initialized");
462
+ await client.close();
463
+ await server.close();
464
+ });
465
+ });
466
+ // ---------------------------------------------------------------------------
467
+ // getHandlerMaps
468
+ // ---------------------------------------------------------------------------
469
+ describe("getHandlerMaps", () => {
470
+ it("throws for incompatible server objects", () => {
471
+ // Empty object
472
+ expect(() => getHandlerMaps({})).toThrow("Incompatible MCP SDK version");
473
+ // Only _requestHandlers (missing _notificationHandlers)
474
+ expect(() => getHandlerMaps({ _requestHandlers: new Map() })).toThrow("Incompatible MCP SDK version");
475
+ // Non-Map values
476
+ expect(() => getHandlerMaps({
477
+ _requestHandlers: {},
478
+ _notificationHandlers: {},
479
+ })).toThrow("Incompatible MCP SDK version");
480
+ });
481
+ it("returns handler maps from valid server", () => {
482
+ const reqMap = new Map();
483
+ const notifMap = new Map();
484
+ const fake = {
485
+ _requestHandlers: reqMap,
486
+ _notificationHandlers: notifMap,
487
+ };
488
+ const result = getHandlerMaps(fake);
489
+ expect(result.requestHandlers).toBe(reqMap);
490
+ expect(result.notificationHandlers).toBe(notifMap);
491
+ });
492
+ });
493
+ //# sourceMappingURL=middleware.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"middleware.test.js","sourceRoot":"","sources":["../../src/server/middleware.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { InMemoryTransport } from \"@modelcontextprotocol/sdk/inMemory.js\";\nimport { describe, expect, it, vi } from \"vitest\";\nimport { z } from \"zod\";\nimport {\n buildMiddlewareChain,\n getHandlerMaps,\n type McpExtra,\n type McpMiddlewareEntry,\n type McpMiddlewareFn,\n matchesFilter,\n} from \"./middleware.js\";\nimport { McpServer } from \"./server.js\";\n\n// ---------------------------------------------------------------------------\n// matchesFilter\n// ---------------------------------------------------------------------------\ndescribe(\"matchesFilter\", () => {\n it(\"matches exact method\", () => {\n expect(matchesFilter(\"tools/call\", \"tools/call\", false)).toBe(true);\n });\n\n it(\"rejects non-matching exact method\", () => {\n expect(matchesFilter(\"tools/list\", \"tools/call\", false)).toBe(false);\n });\n\n it(\"matches wildcard\", () => {\n expect(matchesFilter(\"tools/call\", \"tools/*\", false)).toBe(true);\n expect(matchesFilter(\"tools/list\", \"tools/*\", false)).toBe(true);\n });\n\n it(\"rejects non-matching wildcard\", () => {\n expect(matchesFilter(\"resources/read\", \"tools/*\", false)).toBe(false);\n });\n\n it('category \"request\" matches when isNotification=false', () => {\n expect(matchesFilter(\"tools/call\", \"request\", false)).toBe(true);\n });\n\n it('category \"request\" rejects when isNotification=true', () => {\n expect(matchesFilter(\"notifications/initialized\", \"request\", true)).toBe(\n false,\n );\n });\n\n it('category \"notification\" matches when isNotification=true', () => {\n expect(\n matchesFilter(\"notifications/initialized\", \"notification\", true),\n ).toBe(true);\n });\n\n it('category \"notification\" rejects when isNotification=false', () => {\n expect(matchesFilter(\"tools/call\", \"notification\", false)).toBe(false);\n });\n});\n\n// ---------------------------------------------------------------------------\n// buildMiddlewareChain\n// ---------------------------------------------------------------------------\ndescribe(\"buildMiddlewareChain\", () => {\n const fakeExtra = {} as McpExtra;\n\n const makeHandler = (returnValue: unknown) => vi.fn(async () => returnValue);\n\n const makeEntry = (\n filter: McpMiddlewareEntry[\"filter\"],\n handler: McpMiddlewareFn,\n ): McpMiddlewareEntry => ({ filter, handler });\n\n it(\"returns original handler when no middleware applies\", () => {\n const original = makeHandler(\"result\");\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(\"resources/*\", async (_req, _extra, next) => next()),\n ]);\n expect(chain).toBe(original);\n });\n\n it(\"catch-all middleware runs for any method\", async () => {\n const original = makeHandler(\"ok\");\n const spy = vi.fn();\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async (request, _extra, next) => {\n spy(request.method);\n return next();\n }),\n ]);\n const result = await chain({ method: \"tools/call\", params: {} }, fakeExtra);\n expect(spy).toHaveBeenCalledWith(\"tools/call\");\n expect(result).toBe(\"ok\");\n });\n\n it(\"method-scoped middleware only runs for matching methods\", async () => {\n const original = makeHandler(\"ok\");\n const spy = vi.fn();\n const entries = [\n makeEntry(\"tools/call\", async (_req, _extra, next) => {\n spy(\"tools/call\");\n return next();\n }),\n ];\n\n // Matching\n const chain1 = buildMiddlewareChain(\"tools/call\", false, original, entries);\n await chain1({ method: \"tools/call\", params: {} }, fakeExtra);\n expect(spy).toHaveBeenCalledTimes(1);\n\n // Non-matching — returns original handler directly\n const chain2 = buildMiddlewareChain(\"tools/list\", false, original, entries);\n expect(chain2).toBe(original);\n });\n\n it(\"executes middleware in registration order (onion model)\", async () => {\n const calls: string[] = [];\n const original = makeHandler(\"result\");\n\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async (_req, _extra, next) => {\n calls.push(\"A:before\");\n const result = await next();\n calls.push(\"A:after\");\n return result;\n }),\n makeEntry(null, async (_req, _extra, next) => {\n calls.push(\"B:before\");\n const result = await next();\n calls.push(\"B:after\");\n return result;\n }),\n ]);\n\n await chain({ method: \"tools/call\", params: {} }, fakeExtra);\n expect(calls).toEqual([\"A:before\", \"B:before\", \"B:after\", \"A:after\"]);\n });\n\n it(\"short-circuit (no next() call) skips handler\", async () => {\n const original = makeHandler(\"original\");\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async () => \"short-circuited\"),\n ]);\n const result = await chain({ method: \"tools/call\", params: {} }, fakeExtra);\n expect(result).toBe(\"short-circuited\");\n expect(original).not.toHaveBeenCalled();\n });\n\n it(\"middleware can modify result post-next()\", async () => {\n const original = makeHandler({ value: 1 });\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async (_req, _extra, next) => {\n const result = (await next()) as { value: number };\n return { value: result.value + 10 };\n }),\n ]);\n const result = await chain({ method: \"tools/call\", params: {} }, fakeExtra);\n expect(result).toEqual({ value: 11 });\n });\n\n it(\"throws on double next() call\", async () => {\n const original = makeHandler(\"ok\");\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async (_req, _extra, next) => {\n await next();\n return next(); // double call\n }),\n ]);\n await expect(\n chain({ method: \"tools/call\", params: {} }, fakeExtra),\n ).rejects.toThrow(\"next() called multiple times\");\n });\n\n it(\"propagates errors from handler and middleware\", async () => {\n // Error from original handler bubbles through middleware\n const failingHandler = vi.fn(async () => {\n throw new Error(\"handler boom\");\n });\n const chain1 = buildMiddlewareChain(\"tools/call\", false, failingHandler, [\n makeEntry(null, async (_req, _extra, next) => next()),\n ]);\n await expect(\n chain1({ method: \"tools/call\", params: {} }, fakeExtra),\n ).rejects.toThrow(\"handler boom\");\n\n // Error thrown inside middleware propagates\n const chain2 = buildMiddlewareChain(\n \"tools/call\",\n false,\n makeHandler(\"ok\"),\n [\n makeEntry(null, async () => {\n throw new Error(\"middleware boom\");\n }),\n ],\n );\n await expect(\n chain2({ method: \"tools/call\", params: {} }, fakeExtra),\n ).rejects.toThrow(\"middleware boom\");\n });\n\n it(\"passes extra as undefined for notifications (isNotification=true)\", async () => {\n const original = makeHandler(undefined);\n let capturedExtra: McpExtra | undefined = {} as McpExtra;\n const chain = buildMiddlewareChain(\n \"notifications/initialized\",\n true,\n original,\n [\n makeEntry(null, async (_req, extra, next) => {\n capturedExtra = extra;\n return next();\n }),\n ],\n );\n await chain({ method: \"notifications/initialized\" });\n expect(capturedExtra).toBeUndefined();\n });\n\n it(\"defaults params to empty object when rawRequest has no params\", async () => {\n const original = makeHandler(\"ok\");\n let capturedParams: Record<string, unknown> | undefined;\n const chain = buildMiddlewareChain(\"tools/call\", false, original, [\n makeEntry(null, async (request, _extra, next) => {\n capturedParams = request.params;\n return next();\n }),\n ]);\n await chain({ method: \"tools/call\" }, fakeExtra);\n expect(capturedParams).toEqual({});\n });\n\n it(\"propagates in-place param mutation to original handler\", async () => {\n let handlerReceivedName = \"\";\n const original = vi.fn(async (rawReq: { params: { name: string } }) => {\n handlerReceivedName = rawReq.params.name;\n return \"ok\";\n });\n\n const chain = buildMiddlewareChain(\n \"tools/call\",\n false,\n original as unknown as (...args: unknown[]) => Promise<unknown>,\n [\n makeEntry(null, async (request, _extra, next) => {\n request.params.name = \"mutated\";\n return next();\n }),\n ],\n );\n\n await chain({ params: { name: \"original\" } }, fakeExtra);\n expect(handlerReceivedName).toBe(\"mutated\");\n });\n\n it(\"propagates full param replacement to original handler\", async () => {\n let handlerReceivedParams: Record<string, unknown> = {};\n const original = vi.fn(\n async (rawReq: { params: Record<string, unknown> }) => {\n handlerReceivedParams = rawReq.params;\n return \"ok\";\n },\n );\n\n const chain = buildMiddlewareChain(\n \"tools/call\",\n false,\n original as unknown as (...args: unknown[]) => Promise<unknown>,\n [\n makeEntry(null, async (request, _extra, next) => {\n request.params = { replaced: true };\n return next();\n }),\n ],\n );\n\n await chain({ params: { original: true } }, fakeExtra);\n expect(handlerReceivedParams).toEqual({ replaced: true });\n });\n});\n\n// ---------------------------------------------------------------------------\n// McpServer.mcpMiddleware() integration tests\n// ---------------------------------------------------------------------------\ndescribe(\"McpServer.mcpMiddleware()\", () => {\n function createClient() {\n return new Client({ name: \"test-client\", version: \"1.0.0\" });\n }\n\n it(\"returns this for chaining\", () => {\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n const result = server.mcpMiddleware(async (_req, _extra, next) => next());\n expect(result).toBe(server);\n });\n\n it(\"intercepts tools/call and exposes request params\", async () => {\n let capturedMethod = \"\";\n let capturedParams: Record<string, unknown> = {};\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool(\n {\n name: \"greet\",\n description: \"greet\",\n inputSchema: { name: z.string() },\n },\n (args) => ({\n content: [{ type: \"text\" as const, text: `hi ${args.name}` }],\n }),\n );\n\n server.mcpMiddleware(\"tools/call\", async (request, _extra, next) => {\n capturedMethod = request.method;\n capturedParams = request.params;\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n const result = await client.callTool({\n name: \"greet\",\n arguments: { name: \"World\" },\n });\n expect(capturedMethod).toBe(\"tools/call\");\n expect(capturedParams).toMatchObject({\n name: \"greet\",\n arguments: { name: \"World\" },\n });\n expect(result.content).toEqual([{ type: \"text\", text: \"hi World\" }]);\n\n await client.close();\n await server.close();\n });\n\n it(\"array filter works\", async () => {\n const matchedMethods: string[] = [];\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => ({\n content: [{ type: \"text\" as const, text: \"ok\" }],\n }));\n\n server.mcpMiddleware(\n [\"tools/call\", \"tools/list\"],\n async (request, _extra, next) => {\n matchedMethods.push(request.method);\n return next();\n },\n );\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n await client.listTools();\n await client.callTool({ name: \"t1\" });\n\n expect(matchedMethods).toEqual([\"tools/list\", \"tools/call\"]);\n\n await client.close();\n await server.close();\n });\n\n it(\"throws if registered after connect()\", async () => {\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n const [_clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n\n expect(() =>\n server.mcpMiddleware(async (_req, _extra, next) => next()),\n ).toThrow(\"Cannot register MCP middleware after run() or connect()\");\n\n await server.close();\n });\n\n it(\"throws when filter provided without handler\", () => {\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n expect(() =>\n // @ts-expect-error intentionally passing filter without handler\n server.mcpMiddleware(\"tools/call\"),\n ).toThrow(\"mcpMiddleware requires a handler function\");\n });\n\n it(\"catch-all middleware + filtered middleware stack correctly\", async () => {\n const calls: string[] = [];\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => ({\n content: [{ type: \"text\" as const, text: \"ok\" }],\n }));\n\n server\n .mcpMiddleware(async (request, _extra, next) => {\n calls.push(`global:${request.method}`);\n return next();\n })\n .mcpMiddleware(\"tools/call\", async (_req, _extra, next) => {\n calls.push(\"tools-only\");\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n await client.listTools();\n await client.callTool({ name: \"t1\" });\n\n // Catch-all also intercepts initialize + notifications/initialized from handshake.\n // tools/list: only global middleware runs\n // tools/call: global + tools-only both run\n expect(calls).toContain(\"global:tools/list\");\n expect(calls).toContain(\"global:tools/call\");\n expect(calls).toContain(\"tools-only\");\n // \"tools-only\" must come right after \"global:tools/call\"\n const toolsCallIdx = calls.indexOf(\"global:tools/call\");\n expect(calls[toolsCallIdx + 1]).toBe(\"tools-only\");\n\n await client.close();\n await server.close();\n });\n\n it(\"notification middleware receives extra as undefined\", async () => {\n let capturedExtra: unknown = \"sentinel\";\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => ({\n content: [{ type: \"text\" as const, text: \"ok\" }],\n }));\n\n server.mcpMiddleware(\"notification\", async (_request, extra, next) => {\n capturedExtra = extra;\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n // The client sends notifications/initialized automatically on connect.\n await client.listTools();\n expect(capturedExtra).toBeUndefined();\n\n await client.close();\n await server.close();\n });\n\n it(\"wildcard filter intercepts matching methods only\", async () => {\n const matchedMethods: string[] = [];\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => ({\n content: [{ type: \"text\" as const, text: \"ok\" }],\n }));\n\n server.mcpMiddleware(\"tools/*\", async (request, _extra, next) => {\n matchedMethods.push(request.method);\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n await client.listTools();\n await client.callTool({ name: \"t1\" });\n\n expect(matchedMethods).toContain(\"tools/list\");\n expect(matchedMethods).toContain(\"tools/call\");\n // Should not match initialize or notifications\n expect(matchedMethods).not.toContain(\"initialize\");\n expect(matchedMethods).not.toContain(\"notifications/initialized\");\n\n await client.close();\n await server.close();\n });\n\n it(\"middleware can modify tool result via McpServer integration\", async () => {\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool(\n {\n name: \"greet\",\n description: \"greet\",\n inputSchema: { name: z.string() },\n },\n (args) => ({\n content: [{ type: \"text\" as const, text: `hi ${args.name}` }],\n }),\n );\n\n server.mcpMiddleware(\"tools/call\", async (_req, _extra, next) => {\n const result = (await next()) as {\n content: { type: string; text: string }[];\n };\n return {\n ...result,\n content: [\n ...result.content,\n { type: \"text\" as const, text: \" (modified)\" },\n ],\n };\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n const result = await client.callTool({\n name: \"greet\",\n arguments: { name: \"World\" },\n });\n expect(result.content).toEqual([\n { type: \"text\", text: \"hi World\" },\n { type: \"text\", text: \" (modified)\" },\n ]);\n\n await client.close();\n await server.close();\n });\n\n it(\"middleware can short-circuit via McpServer integration\", async () => {\n const handlerCalled = vi.fn();\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => {\n handlerCalled();\n return {\n content: [{ type: \"text\" as const, text: \"original\" }],\n };\n });\n\n server.mcpMiddleware(\"tools/call\", async () => ({\n content: [{ type: \"text\" as const, text: \"short-circuited\" }],\n }));\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n const result = await client.callTool({ name: \"t1\" });\n expect(result.content).toEqual([{ type: \"text\", text: \"short-circuited\" }]);\n expect(handlerCalled).not.toHaveBeenCalled();\n\n await client.close();\n await server.close();\n });\n\n it(\"middleware can mutate tool call params via McpServer integration\", async () => {\n let receivedName = \"\";\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool(\n {\n name: \"greet\",\n description: \"greet\",\n inputSchema: { name: z.string() },\n },\n (args) => {\n receivedName = args.name;\n return {\n content: [{ type: \"text\" as const, text: `hi ${args.name}` }],\n };\n },\n );\n\n server.mcpMiddleware(\"tools/call\", async (request, _extra, next) => {\n request.params.arguments = { name: \"Overridden\" };\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n await client.callTool({\n name: \"greet\",\n arguments: { name: \"Original\" },\n });\n expect(receivedName).toBe(\"Overridden\");\n\n await client.close();\n await server.close();\n });\n\n it(\"category 'request' filter matches requests but not notifications\", async () => {\n const matchedMethods: string[] = [];\n\n const server = new McpServer({ name: \"test\", version: \"1.0.0\" });\n\n server.registerTool({ name: \"t1\", description: \"t1\" }, () => ({\n content: [{ type: \"text\" as const, text: \"ok\" }],\n }));\n\n server.mcpMiddleware(\"request\", async (request, _extra, next) => {\n matchedMethods.push(request.method);\n return next();\n });\n\n const client = createClient();\n const [clientTransport, serverTransport] =\n InMemoryTransport.createLinkedPair();\n await server.connect(serverTransport);\n await client.connect(clientTransport);\n\n await client.listTools();\n await client.callTool({ name: \"t1\" });\n\n expect(matchedMethods).toContain(\"tools/list\");\n expect(matchedMethods).toContain(\"tools/call\");\n expect(matchedMethods).not.toContain(\"notifications/initialized\");\n\n await client.close();\n await server.close();\n });\n});\n\n// ---------------------------------------------------------------------------\n// getHandlerMaps\n// ---------------------------------------------------------------------------\ndescribe(\"getHandlerMaps\", () => {\n it(\"throws for incompatible server objects\", () => {\n // Empty object\n expect(() => getHandlerMaps({} as never)).toThrow(\n \"Incompatible MCP SDK version\",\n );\n // Only _requestHandlers (missing _notificationHandlers)\n expect(() =>\n getHandlerMaps({ _requestHandlers: new Map() } as never),\n ).toThrow(\"Incompatible MCP SDK version\");\n // Non-Map values\n expect(() =>\n getHandlerMaps({\n _requestHandlers: {},\n _notificationHandlers: {},\n } as never),\n ).toThrow(\"Incompatible MCP SDK version\");\n });\n\n it(\"returns handler maps from valid server\", () => {\n const reqMap = new Map();\n const notifMap = new Map();\n const fake = {\n _requestHandlers: reqMap,\n _notificationHandlers: notifMap,\n };\n const result = getHandlerMaps(fake as never);\n expect(result.requestHandlers).toBe(reqMap);\n expect(result.notificationHandlers).toBe(notifMap);\n });\n});\n"]}