@mcp-b/global 1.3.0 → 1.5.0

package/dist/testing.d.ts

@@ -0,0 +1,71 @@
+import { M as ToolInfo, N as ToolListItem, P as ToolResponse, g as ModelContextTesting } from "./types-DemXxUoc.js";
+
+//#region src/testing.d.ts
+
+/**
+ * Test helper API exposed via @mcp-b/global/testing.
+ * Wraps navigator.modelContextTesting and normalizes object-arg tool execution.
+ */
+interface ModelContextTestHelper {
+  /**
+   * Execute a tool with object arguments.
+   * Internally delegates to modelContextTesting.executeTool(name, JSON.stringify(args)).
+   */
+  executeTool(toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+  /**
+   * List tools exposed by modelContextTesting.
+   */
+  listTools(): ToolInfo[];
+  /**
+   * Register for tool list updates.
+   */
+  onToolsChanged(callback: () => void): void;
+  /**
+   * Get recorded tool calls.
+   * Only available when using the polyfill extensions.
+   */
+  getToolCalls(): Array<{
+    toolName: string;
+    arguments: Record<string, unknown>;
+    timestamp: number;
+  }>;
+  /**
+   * Clear recorded tool calls.
+   * Only available when using the polyfill extensions.
+   */
+  clearToolCalls(): void;
+  /**
+   * Set mock response for a tool.
+   * Only available when using the polyfill extensions.
+   */
+  setMockToolResponse(toolName: string, response: ToolResponse): void;
+  /**
+   * Clear mock response for a tool.
+   * Only available when using the polyfill extensions.
+   */
+  clearMockToolResponse(toolName: string): void;
+  /**
+   * Clear all mock responses.
+   * Only available when using the polyfill extensions.
+   */
+  clearAllMockToolResponses(): void;
+  /**
+   * Get registered tools from modelContext internals.
+   * Only available when using the polyfill extensions.
+   */
+  getRegisteredTools(): ToolListItem[];
+  /**
+   * Reset polyfill testing state.
+   * Only available when using the polyfill extensions.
+   */
+  reset(): void;
+}
+/**
+ * Create a testing helper bound to modelContextTesting.
+ *
+ * @param testingOverride - Optional explicit testing API instance.
+ */
+declare function createTestHelper(testingOverride?: ModelContextTesting): ModelContextTestHelper;
+//#endregion
+export { ModelContextTestHelper, createTestHelper };
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","names":[],"sources":["../src/testing.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;AAKiE,UALhD,sBAAA,CAKgD;EAKlD;;;;EA6CS,WAAA,CAAA,QAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAlDe,MAkDf,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EAlDyC,OAkDzC,CAAA,OAAA,CAAA;EAAY;AAuEpC;;eApHe;;;;;;;;;kBAWG;;eAEH;;;;;;;;;;;;kDAcmC;;;;;;;;;;;;;;;wBAkB1B;;;;;;;;;;;;iBAuER,gBAAA,mBAAmC,sBAAsB"}

package/dist/testing.js

@@ -0,0 +1,48 @@
+//#region src/testing.ts
+function resolveTestingAPI(override) {
+	if (override) return override;
+	if (typeof window !== "undefined") {
+		const bridgeTesting = window.__mcpBridge?.modelContextTesting;
+		if (bridgeTesting) return bridgeTesting;
+	}
+	if (typeof navigator === "undefined" || !navigator.modelContextTesting) throw new Error("navigator.modelContextTesting is not available. Ensure @mcp-b/global is initialized first.");
+	return navigator.modelContextTesting;
+}
+function getPolyfillExtensions(testing) {
+	const candidate = testing;
+	for (const method of [
+		"getToolCalls",
+		"clearToolCalls",
+		"setMockToolResponse",
+		"clearMockToolResponse",
+		"clearAllMockToolResponses",
+		"getRegisteredTools",
+		"reset"
+	]) if (typeof candidate[method] !== "function") throw new Error(`modelContextTesting.${String(method)} is not available in this runtime. These helpers require the @mcp-b/global polyfill testing extensions.`);
+	return candidate;
+}
+/**
+* Create a testing helper bound to modelContextTesting.
+*
+* @param testingOverride - Optional explicit testing API instance.
+*/
+function createTestHelper(testingOverride) {
+	const testing = resolveTestingAPI(testingOverride);
+	const polyfillExtensions = () => getPolyfillExtensions(testing);
+	return {
+		executeTool: (toolName, args = {}) => testing.executeTool(toolName, JSON.stringify(args)),
+		listTools: () => testing.listTools(),
+		onToolsChanged: (callback) => testing.registerToolsChangedCallback(callback),
+		getToolCalls: () => polyfillExtensions().getToolCalls(),
+		clearToolCalls: () => polyfillExtensions().clearToolCalls(),
+		setMockToolResponse: (toolName, response) => polyfillExtensions().setMockToolResponse(toolName, response),
+		clearMockToolResponse: (toolName) => polyfillExtensions().clearMockToolResponse(toolName),
+		clearAllMockToolResponses: () => polyfillExtensions().clearAllMockToolResponses(),
+		getRegisteredTools: () => polyfillExtensions().getRegisteredTools(),
+		reset: () => polyfillExtensions().reset()
+	};
+}
+
+//#endregion
+export { createTestHelper };
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type { ModelContextTesting, ToolInfo, ToolListItem, ToolResponse } from './types.js';\n\n/**\n * Test helper API exposed via @mcp-b/global/testing.\n * Wraps navigator.modelContextTesting and normalizes object-arg tool execution.\n */\nexport interface ModelContextTestHelper {\n  /**\n   * Execute a tool with object arguments.\n   * Internally delegates to modelContextTesting.executeTool(name, JSON.stringify(args)).\n   */\n  executeTool(toolName: string, args?: Record<string, unknown>): Promise<unknown>;\n\n  /**\n   * List tools exposed by modelContextTesting.\n   */\n  listTools(): ToolInfo[];\n\n  /**\n   * Register for tool list updates.\n   */\n  onToolsChanged(callback: () => void): void;\n\n  /**\n   * Get recorded tool calls.\n   * Only available when using the polyfill extensions.\n   */\n  getToolCalls(): Array<{\n    toolName: string;\n    arguments: Record<string, unknown>;\n    timestamp: number;\n  }>;\n\n  /**\n   * Clear recorded tool calls.\n   * Only available when using the polyfill extensions.\n   */\n  clearToolCalls(): void;\n\n  /**\n   * Set mock response for a tool.\n   * Only available when using the polyfill extensions.\n   */\n  setMockToolResponse(toolName: string, response: ToolResponse): void;\n\n  /**\n   * Clear mock response for a tool.\n   * Only available when using the polyfill extensions.\n   */\n  clearMockToolResponse(toolName: string): void;\n\n  /**\n   * Clear all mock responses.\n   * Only available when using the polyfill extensions.\n   */\n  clearAllMockToolResponses(): void;\n\n  /**\n   * Get registered tools from modelContext internals.\n   * Only available when using the polyfill extensions.\n   */\n  getRegisteredTools(): ToolListItem[];\n\n  /**\n   * Reset polyfill testing state.\n   * Only available when using the polyfill extensions.\n   */\n  reset(): void;\n}\n\ntype PolyfillTestingExtensions = Pick<\n  ModelContextTesting,\n  | 'getToolCalls'\n  | 'clearToolCalls'\n  | 'setMockToolResponse'\n  | 'clearMockToolResponse'\n  | 'clearAllMockToolResponses'\n  | 'getRegisteredTools'\n  | 'reset'\n>;\n\nfunction resolveTestingAPI(override?: ModelContextTesting): ModelContextTesting {\n  if (override) {\n    return override;\n  }\n\n  // Prefer bridge-bound instance to avoid touching deprecated navigator accessor.\n  if (typeof window !== 'undefined') {\n    const bridgeTesting = window.__mcpBridge?.modelContextTesting;\n    if (bridgeTesting) {\n      return bridgeTesting;\n    }\n  }\n\n  if (typeof navigator === 'undefined' || !navigator.modelContextTesting) {\n    throw new Error(\n      'navigator.modelContextTesting is not available. Ensure @mcp-b/global is initialized first.'\n    );\n  }\n\n  return navigator.modelContextTesting;\n}\n\nfunction getPolyfillExtensions(testing: ModelContextTesting): PolyfillTestingExtensions {\n  const candidate = testing as ModelContextTesting & Partial<PolyfillTestingExtensions>;\n  const requiredMethods: Array<keyof PolyfillTestingExtensions> = [\n    'getToolCalls',\n    'clearToolCalls',\n    'setMockToolResponse',\n    'clearMockToolResponse',\n    'clearAllMockToolResponses',\n    'getRegisteredTools',\n    'reset',\n  ];\n\n  for (const method of requiredMethods) {\n    if (typeof candidate[method] !== 'function') {\n      throw new Error(\n        `modelContextTesting.${String(method)} is not available in this runtime. ` +\n          'These helpers require the @mcp-b/global polyfill testing extensions.'\n      );\n    }\n  }\n\n  return candidate as PolyfillTestingExtensions;\n}\n\n/**\n * Create a testing helper bound to modelContextTesting.\n *\n * @param testingOverride - Optional explicit testing API instance.\n */\nexport function createTestHelper(testingOverride?: ModelContextTesting): ModelContextTestHelper {\n  const testing = resolveTestingAPI(testingOverride);\n  const polyfillExtensions = () => getPolyfillExtensions(testing);\n\n  return {\n    executeTool: (toolName: string, args: Record<string, unknown> = {}) =>\n      testing.executeTool(toolName, JSON.stringify(args)),\n    listTools: () => testing.listTools(),\n    onToolsChanged: (callback: () => void) => testing.registerToolsChangedCallback(callback),\n    getToolCalls: () => polyfillExtensions().getToolCalls(),\n    clearToolCalls: () => polyfillExtensions().clearToolCalls(),\n    setMockToolResponse: (toolName: string, response: ToolResponse) =>\n      polyfillExtensions().setMockToolResponse(toolName, response),\n    clearMockToolResponse: (toolName: string) =>\n      polyfillExtensions().clearMockToolResponse(toolName),\n    clearAllMockToolResponses: () => polyfillExtensions().clearAllMockToolResponses(),\n    getRegisteredTools: () => polyfillExtensions().getRegisteredTools(),\n    reset: () => polyfillExtensions().reset(),\n  };\n}\n"],"mappings":";AAiFA,SAAS,kBAAkB,UAAqD;AAC9E,KAAI,SACF,QAAO;AAIT,KAAI,OAAO,WAAW,aAAa;EACjC,MAAM,gBAAgB,OAAO,aAAa;AAC1C,MAAI,cACF,QAAO;;AAIX,KAAI,OAAO,cAAc,eAAe,CAAC,UAAU,oBACjD,OAAM,IAAI,MACR,6FACD;AAGH,QAAO,UAAU;;AAGnB,SAAS,sBAAsB,SAAyD;CACtF,MAAM,YAAY;AAWlB,MAAK,MAAM,UAVqD;EAC9D;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAGC,KAAI,OAAO,UAAU,YAAY,WAC/B,OAAM,IAAI,MACR,uBAAuB,OAAO,OAAO,CAAC,yGAEvC;AAIL,QAAO;;;;;;;AAQT,SAAgB,iBAAiB,iBAA+D;CAC9F,MAAM,UAAU,kBAAkB,gBAAgB;CAClD,MAAM,2BAA2B,sBAAsB,QAAQ;AAE/D,QAAO;EACL,cAAc,UAAkB,OAAgC,EAAE,KAChE,QAAQ,YAAY,UAAU,KAAK,UAAU,KAAK,CAAC;EACrD,iBAAiB,QAAQ,WAAW;EACpC,iBAAiB,aAAyB,QAAQ,6BAA6B,SAAS;EACxF,oBAAoB,oBAAoB,CAAC,cAAc;EACvD,sBAAsB,oBAAoB,CAAC,gBAAgB;EAC3D,sBAAsB,UAAkB,aACtC,oBAAoB,CAAC,oBAAoB,UAAU,SAAS;EAC9D,wBAAwB,aACtB,oBAAoB,CAAC,sBAAsB,SAAS;EACtD,iCAAiC,oBAAoB,CAAC,2BAA2B;EACjF,0BAA0B,oBAAoB,CAAC,oBAAoB;EACnE,aAAa,oBAAoB,CAAC,OAAO;EAC1C"}