@mcp-b/global 4.0.0 → 5.0.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import { IframeChildTransport, TabServerTransport } from "@mcp-b/transports";
 import { initializeWebMCPPolyfill } from "@mcp-b/webmcp-polyfill";
-import { BrowserMcpServer, SERVER_MARKER_PROPERTY } from "@mcp-b/webmcp-ts-sdk";
+import { BrowserMcpServer, isBrowserMcpServer } from "@mcp-b/webmcp-ts-sdk";
 
 //#region src/global.ts
 let runtime = null;
@@ -8,155 +8,96 @@ function isBrowserEnvironment() {
 	return typeof window !== "undefined" && typeof window.navigator !== "undefined";
 }
 function readCurrentModelContext() {
-	if (Object.getOwnPropertyDescriptor(navigator, "modelContext")) return navigator.modelContext;
 	return document.modelContext ?? navigator.modelContext;
 }
 function replaceDocumentModelContext(value) {
-	try {
-		Object.defineProperty(document, "modelContext", {
-			configurable: true,
-			enumerable: true,
-			writable: false,
-			value
-		});
-	} catch {
-		Object.defineProperty(Object.getPrototypeOf(document), "modelContext", {
-			configurable: true,
-			enumerable: true,
-			get() {
-				return value;
-			}
-		});
-	}
+	Object.defineProperty(document, "modelContext", {
+		configurable: true,
+		enumerable: true,
+		writable: false,
+		value
+	});
 	if (document.modelContext !== value) console.error("[WebModelContext] Failed to replace document.modelContext.", "Descriptor:", Object.getOwnPropertyDescriptor(document, "modelContext"));
 }
 function replaceNavigatorModelContext(value) {
-	try {
-		Object.defineProperty(navigator, "modelContext", {
-			configurable: true,
-			enumerable: true,
-			writable: false,
-			value
-		});
-	} catch {
-		Object.defineProperty(Object.getPrototypeOf(navigator), "modelContext", {
-			configurable: true,
-			enumerable: true,
-			get() {
-				return value;
-			}
-		});
-	}
+	Object.defineProperty(navigator, "modelContext", {
+		configurable: true,
+		enumerable: true,
+		writable: false,
+		value
+	});
 	if (navigator.modelContext !== value) console.error("[WebModelContext] Failed to replace navigator.modelContext.", "Descriptor:", Object.getOwnPropertyDescriptor(navigator, "modelContext"));
 }
+function restoreProperty(target, key, descriptor) {
+	if (descriptor) Object.defineProperty(target, key, descriptor);
+	else Reflect.deleteProperty(target, key);
+}
 /**
 * Replace both modelContext surfaces with the given value.
 *
-* The Chrome 152 baseline uses document.modelContext as canonical and keeps
-* navigator.modelContext as a deprecated alias. @mcp-b/global still supports
-* old navigator-first users, so the bridge exposes the BrowserMcpServer wrapper
+* document.modelContext is canonical. @mcp-b/global still supports old
+* navigator-first users, so the bridge exposes the BrowserMcpServer wrapper
 * through both properties.
 */
-function replaceModelContext(value) {
-	replaceDocumentModelContext(value);
-	replaceNavigatorModelContext(value);
-}
-function createTransport(config) {
-	if (window.parent !== window && config?.iframeServer !== false) {
-		const { allowedOrigins, ...rest } = typeof config?.iframeServer === "object" ? config.iframeServer : {};
-		return new IframeChildTransport({
-			allowedOrigins: allowedOrigins ?? ["*"],
-			...rest
-		});
-	}
-	if (config?.tabServer === false) throw new Error("tabServer transport is disabled and iframe transport was not selected");
-	const { allowedOrigins, ...rest } = typeof config?.tabServer === "object" ? config.tabServer : {};
-	return new TabServerTransport({
-		allowedOrigins: allowedOrigins ?? ["*"],
-		...rest
-	});
-}
-function parseTestingInputSchema(inputSchema) {
-	if (!inputSchema) return;
+function replaceModelContext(value, previousDocumentDescriptor, previousNavigatorDescriptor) {
 	try {
-		const parsed = JSON.parse(inputSchema);
-		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return;
-		return parsed;
+		replaceDocumentModelContext(value);
+		replaceNavigatorModelContext(value);
 	} catch (error) {
-		console.warn("[WebMCP] Failed to parse testing inputSchema JSON:", error);
-		return;
+		restoreProperty(document, "modelContext", previousDocumentDescriptor);
+		restoreProperty(navigator, "modelContext", previousNavigatorDescriptor);
+		throw error;
 	}
 }
-function getTestingShimTools() {
-	const testingShim = navigator.modelContextTesting;
-	if (!testingShim) return;
-	if (typeof testingShim.getRegisteredTools === "function") return {
-		testingShim,
-		tools: testingShim.getRegisteredTools()
-	};
-	if (typeof testingShim.listTools !== "function") return;
-	return {
-		testingShim,
-		tools: testingShim.listTools().map((tool) => ({
-			name: tool.name,
-			description: tool.description ?? "",
-			inputSchema: parseTestingInputSchema(tool.inputSchema) ?? {
-				type: "object",
-				properties: {}
-			}
-		}))
-	};
-}
-function syncToolsFromTestingShim(server) {
-	const shimState = getTestingShimTools();
-	if (!shimState) return 0;
-	const { testingShim, tools } = shimState;
-	return server.backfillTools(tools, async (name, args) => {
-		const serialized = await testingShim.executeTool(name, JSON.stringify(args ?? {}));
-		if (serialized === null) return {
-			content: [{
-				type: "text",
-				text: "Tool execution interrupted by navigation"
-			}],
-			isError: true
-		};
-		let parsed;
-		try {
-			parsed = JSON.parse(serialized);
-		} catch (parseError) {
-			throw new Error(`Failed to parse serialized tool response for ${name}: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
-		}
-		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`Invalid serialized tool response for ${name}`);
-		return parsed;
-	});
+function createTransport(config) {
+	if (window.parent !== window && config?.iframeServer !== false) return new IframeChildTransport(typeof config?.iframeServer === "object" ? config.iframeServer : { allowedOrigins: ["*"] });
+	if (config?.tabServer === false) throw new Error("tabServer transport is disabled and iframe transport was not selected");
+	return new TabServerTransport(typeof config?.tabServer === "object" ? config.tabServer : { allowedOrigins: ["*"] });
 }
+/** Installs the global bridge on `document.modelContext`. */
 function initializeWebModelContext(options) {
-	if (!isBrowserEnvironment()) return;
+	if (!isBrowserEnvironment() || globalThis.isSecureContext === false) return;
 	if (runtime) return;
-	if (readCurrentModelContext()?.[SERVER_MARKER_PROPERTY]) return;
-	initializeWebMCPPolyfill({ installTestingShim: options?.installTestingShim ?? "if-missing" });
+	const existingContext = readCurrentModelContext();
+	if (existingContext && isBrowserMcpServer(existingContext)) return;
+	initializeWebMCPPolyfill({ installTestingShim: options?.installTestingShim ?? true });
 	const native = readCurrentModelContext();
 	if (!native) throw new Error("modelContext is not available");
+	const transport = createTransport(options?.transport);
 	const server = new BrowserMcpServer({
 		name: `${window.location.hostname || "localhost"}-webmcp`,
 		version: "1.0.0"
 	}, { native });
-	server.syncNativeTools();
-	syncToolsFromTestingShim(server);
 	const previousDocumentModelContextDescriptor = Object.getOwnPropertyDescriptor(document, "modelContext");
 	const previousNavigatorModelContextDescriptor = Object.getOwnPropertyDescriptor(navigator, "modelContext");
-	replaceModelContext(server);
-	const transport = createTransport(options?.transport);
-	runtime = {
-		native,
-		server,
-		transport,
-		previousDocumentModelContextDescriptor,
-		previousNavigatorModelContextDescriptor
-	};
-	server.connect(transport).catch((error) => {
-		console.error("[WebModelContext] Failed to connect MCP transport:", error);
-	});
+	try {
+		replaceModelContext(server, previousDocumentModelContextDescriptor, previousNavigatorModelContextDescriptor);
+		runtime = {
+			native,
+			server,
+			transport,
+			previousDocumentModelContextDescriptor,
+			previousNavigatorModelContextDescriptor
+		};
+	} catch (error) {
+		server.close();
+		transport.close();
+		throw error;
+	}
+	(async () => {
+		try {
+			await server.syncNativeTools();
+		} catch (error) {
+			console.warn("[WebModelContext] Native WebMCP tool synchronization failed:", error);
+		}
+		if (runtime?.server !== server) return;
+		try {
+			await server.connect(transport);
+		} catch (error) {
+			console.error("[WebModelContext] Failed to connect MCP transport:", error);
+			if (runtime?.server === server) cleanupWebModelContext();
+		}
+	})();
 }
 function cleanupWebModelContext() {
 	if (!runtime) return;
@@ -164,10 +105,8 @@ function cleanupWebModelContext() {
 	runtime = null;
 	server.close();
 	transport.close();
-	if (previousDocumentModelContextDescriptor) Object.defineProperty(document, "modelContext", previousDocumentModelContextDescriptor);
-	else delete document.modelContext;
-	if (previousNavigatorModelContextDescriptor) Object.defineProperty(navigator, "modelContext", previousNavigatorModelContextDescriptor);
-	else delete navigator.modelContext;
+	restoreProperty(document, "modelContext", previousDocumentModelContextDescriptor);
+	restoreProperty(navigator, "modelContext", previousNavigatorModelContextDescriptor);
 }
 
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/global.ts","../src/index.ts"],"sourcesContent":["import {\n  IframeChildTransport,\n  type IframeChildTransportOptions,\n  TabServerTransport,\n  type TabServerTransportOptions,\n} from '@mcp-b/transports';\nimport { initializeWebMCPPolyfill } from '@mcp-b/webmcp-polyfill';\nimport { BrowserMcpServer, SERVER_MARKER_PROPERTY, type Transport } from '@mcp-b/webmcp-ts-sdk';\nimport type {\n  InputSchema,\n  ModelContextCore,\n  ModelContextTesting,\n  ModelContextTestingPolyfillExtensions,\n  ToolListItem,\n  ToolResponse,\n} from '@mcp-b/webmcp-types';\nimport type { WebModelContextInitOptions } from './types.js';\n\ninterface RuntimeState {\n  native: ModelContextCore;\n  server: BrowserMcpServer;\n  transport: Transport;\n  previousDocumentModelContextDescriptor: PropertyDescriptor | undefined;\n  previousNavigatorModelContextDescriptor: PropertyDescriptor | undefined;\n}\n\nlet runtime: RuntimeState | null = null;\n\nfunction isBrowserEnvironment(): boolean {\n  return typeof window !== 'undefined' && typeof window.navigator !== 'undefined';\n}\n\nfunction readCurrentModelContext(): unknown {\n  const navigatorDescriptor = Object.getOwnPropertyDescriptor(navigator, 'modelContext');\n  if (navigatorDescriptor) {\n    return navigator.modelContext;\n  }\n\n  return document.modelContext ?? navigator.modelContext;\n}\n\nfunction replaceDocumentModelContext(value: unknown): void {\n  try {\n    Object.defineProperty(document, 'modelContext', {\n      configurable: true,\n      enumerable: true,\n      writable: false,\n      value,\n    });\n  } catch {\n    Object.defineProperty(Object.getPrototypeOf(document), 'modelContext', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return value;\n      },\n    });\n  }\n\n  if (document.modelContext !== value) {\n    console.error(\n      '[WebModelContext] Failed to replace document.modelContext.',\n      'Descriptor:',\n      Object.getOwnPropertyDescriptor(document, 'modelContext')\n    );\n  }\n}\n\nfunction replaceNavigatorModelContext(value: unknown): void {\n  try {\n    Object.defineProperty(navigator, 'modelContext', {\n      configurable: true,\n      enumerable: true,\n      writable: false,\n      value,\n    });\n  } catch {\n    // Native browser property is non-configurable on the instance.\n    // Shadow it with a getter on the prototype instead.\n    Object.defineProperty(Object.getPrototypeOf(navigator), 'modelContext', {\n      configurable: true,\n      enumerable: true,\n      get() {\n        return value;\n      },\n    });\n  }\n\n  // Verify the replacement actually worked — the prototype getter cannot\n  // shadow a non-configurable own property on the navigator instance.\n  if (navigator.modelContext !== value) {\n    console.error(\n      '[WebModelContext] Failed to replace navigator.modelContext.',\n      'Descriptor:',\n      Object.getOwnPropertyDescriptor(navigator, 'modelContext')\n    );\n  }\n}\n\n/**\n * Replace both modelContext surfaces with the given value.\n *\n * The Chrome 152 baseline uses document.modelContext as canonical and keeps\n * navigator.modelContext as a deprecated alias. @mcp-b/global still supports\n * old navigator-first users, so the bridge exposes the BrowserMcpServer wrapper\n * through both properties.\n */\nfunction replaceModelContext(value: unknown): void {\n  replaceDocumentModelContext(value);\n  replaceNavigatorModelContext(value);\n}\n\nfunction createTransport(config: WebModelContextInitOptions['transport']): Transport {\n  const inIframe = window.parent !== window;\n\n  if (inIframe && config?.iframeServer !== false) {\n    const iframeOptions =\n      typeof config?.iframeServer === 'object'\n        ? config.iframeServer\n        : ({} as Partial<IframeChildTransportOptions>);\n\n    const { allowedOrigins, ...rest } = iframeOptions;\n\n    return new IframeChildTransport({\n      allowedOrigins: allowedOrigins ?? ['*'],\n      ...rest,\n    });\n  }\n\n  if (config?.tabServer === false) {\n    throw new Error('tabServer transport is disabled and iframe transport was not selected');\n  }\n\n  const tabOptions =\n    typeof config?.tabServer === 'object'\n      ? config.tabServer\n      : ({} as Partial<TabServerTransportOptions>);\n\n  const { allowedOrigins, ...rest } = tabOptions;\n\n  return new TabServerTransport({\n    allowedOrigins: allowedOrigins ?? ['*'],\n    ...rest,\n  });\n}\n\nfunction parseTestingInputSchema(inputSchema: string | undefined): InputSchema | undefined {\n  if (!inputSchema) {\n    return undefined;\n  }\n\n  try {\n    const parsed = JSON.parse(inputSchema) as unknown;\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      return undefined;\n    }\n    return parsed as InputSchema;\n  } catch (error) {\n    console.warn('[WebMCP] Failed to parse testing inputSchema JSON:', error);\n    return undefined;\n  }\n}\n\nfunction getTestingShimTools():\n  | {\n      testingShim: ModelContextTesting;\n      tools: ToolListItem[];\n    }\n  | undefined {\n  const testingShim = navigator.modelContextTesting as\n    | (ModelContextTesting & Partial<ModelContextTestingPolyfillExtensions>)\n    | undefined;\n  if (!testingShim) {\n    return undefined;\n  }\n\n  if (typeof testingShim.getRegisteredTools === 'function') {\n    return {\n      testingShim,\n      tools: testingShim.getRegisteredTools() as ToolListItem[],\n    };\n  }\n\n  if (typeof testingShim.listTools !== 'function') {\n    return undefined;\n  }\n\n  const tools = testingShim.listTools().map(\n    (tool): ToolListItem => ({\n      name: tool.name,\n      description: tool.description ?? '',\n      inputSchema: parseTestingInputSchema(tool.inputSchema) ?? {\n        type: 'object',\n        properties: {},\n      },\n    })\n  );\n\n  return {\n    testingShim,\n    tools,\n  };\n}\n\nfunction syncToolsFromTestingShim(server: BrowserMcpServer): number {\n  const shimState = getTestingShimTools();\n  if (!shimState) {\n    return 0;\n  }\n\n  const { testingShim, tools } = shimState;\n  return server.backfillTools(tools, async (name: string, args: Record<string, unknown>) => {\n    const serialized = await testingShim.executeTool(name, JSON.stringify(args ?? {}));\n    if (serialized === null) {\n      return {\n        content: [{ type: 'text', text: 'Tool execution interrupted by navigation' }],\n        isError: true,\n      } satisfies ToolResponse;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(serialized);\n    } catch (parseError) {\n      throw new Error(\n        `Failed to parse serialized tool response for ${name}: ${parseError instanceof Error ? parseError.message : String(parseError)}`\n      );\n    }\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      throw new Error(`Invalid serialized tool response for ${name}`);\n    }\n    return parsed as ToolResponse;\n  });\n}\n\nexport function initializeWebModelContext(options?: WebModelContextInitOptions): void {\n  if (!isBrowserEnvironment()) {\n    return;\n  }\n\n  if (runtime) {\n    return;\n  }\n\n  // Cross-bundle guard: if modelContext is already a BrowserMcpServer\n  // (set by another bundle in this window), skip initialization.\n  const existingContext = readCurrentModelContext() as Record<string, unknown> | undefined;\n  if (existingContext?.[SERVER_MARKER_PROPERTY]) {\n    return;\n  }\n\n  // 1. Install polyfill (provides modelContext + modelContextTesting)\n  initializeWebMCPPolyfill({\n    installTestingShim: options?.installTestingShim ?? 'if-missing',\n  });\n\n  // 2. Save reference to the polyfill's (or native) context\n  const native = readCurrentModelContext() as ModelContextCore | undefined;\n  if (!native) {\n    throw new Error('modelContext is not available');\n  }\n\n  // 3. Create server with native mirroring\n  const hostname = window.location.hostname || 'localhost';\n  const server = new BrowserMcpServer({ name: `${hostname}-webmcp`, version: '1.0.0' }, { native });\n  server.syncNativeTools();\n  syncToolsFromTestingShim(server);\n\n  // 4. Replace navigator.modelContext with the server.\n  // Try own-property on the navigator instance first (works for polyfill and most cases).\n  // Fall back to a prototype getter if the native property is non-configurable.\n  const previousDocumentModelContextDescriptor = Object.getOwnPropertyDescriptor(\n    document,\n    'modelContext'\n  );\n  const previousNavigatorModelContextDescriptor = Object.getOwnPropertyDescriptor(\n    navigator,\n    'modelContext'\n  );\n  replaceModelContext(server);\n\n  // 5. Create transport and connect\n  const transport = createTransport(options?.transport);\n  runtime = {\n    native,\n    server,\n    transport,\n    previousDocumentModelContextDescriptor,\n    previousNavigatorModelContextDescriptor,\n  };\n\n  void server.connect(transport).catch((error: unknown) => {\n    console.error('[WebModelContext] Failed to connect MCP transport:', error);\n  });\n}\n\nexport function cleanupWebModelContext(): void {\n  if (!runtime) {\n    return;\n  }\n\n  const {\n    server,\n    transport,\n    previousDocumentModelContextDescriptor,\n    previousNavigatorModelContextDescriptor,\n  } = runtime;\n  runtime = null;\n\n  void server.close();\n  void transport.close();\n\n  // Restore the descriptors that existed before we wrapped with BrowserMcpServer.\n  // We intentionally do NOT call cleanupWebMCPPolyfill() here — the polyfill\n  // manages its own lifecycle (auto-init, testing shim) independently.\n  if (previousDocumentModelContextDescriptor) {\n    Object.defineProperty(document, 'modelContext', previousDocumentModelContextDescriptor);\n  } else {\n    delete (document as unknown as Record<string, unknown>).modelContext;\n  }\n\n  if (previousNavigatorModelContextDescriptor) {\n    Object.defineProperty(navigator, 'modelContext', previousNavigatorModelContextDescriptor);\n  } else {\n    delete (navigator as unknown as Record<string, unknown>).modelContext;\n  }\n}\n","import { cleanupWebModelContext, initializeWebModelContext } from './global.js';\n\nexport { cleanupWebModelContext, initializeWebModelContext };\n\nexport type {\n  NativeModelContextBehavior,\n  TransportConfiguration,\n  WebModelContextInitOptions,\n} from './types.js';\n\nif (typeof window !== 'undefined' && typeof document !== 'undefined') {\n  const options = window.__webModelContextOptions;\n  const shouldAutoInitialize = options?.autoInitialize !== false;\n\n  if (shouldAutoInitialize) {\n    try {\n      initializeWebModelContext(options);\n    } catch (error) {\n      console.error('[WebModelContext] Auto-initialization failed:', error);\n    }\n  }\n}\n"],"mappings":";;;;;AA0BA,IAAI,UAA+B;AAEnC,SAAS,uBAAgC;CACvC,OAAO,OAAO,WAAW,eAAe,OAAO,OAAO,cAAc;;AAGtE,SAAS,0BAAmC;CAE1C,IAD4B,OAAO,yBAAyB,WAAW,eAChD,EACrB,OAAO,UAAU;CAGnB,OAAO,SAAS,gBAAgB,UAAU;;AAG5C,SAAS,4BAA4B,OAAsB;CACzD,IAAI;EACF,OAAO,eAAe,UAAU,gBAAgB;GAC9C,cAAc;GACd,YAAY;GACZ,UAAU;GACV;GACD,CAAC;SACI;EACN,OAAO,eAAe,OAAO,eAAe,SAAS,EAAE,gBAAgB;GACrE,cAAc;GACd,YAAY;GACZ,MAAM;IACJ,OAAO;;GAEV,CAAC;;CAGJ,IAAI,SAAS,iBAAiB,OAC5B,QAAQ,MACN,8DACA,eACA,OAAO,yBAAyB,UAAU,eAAe,CAC1D;;AAIL,SAAS,6BAA6B,OAAsB;CAC1D,IAAI;EACF,OAAO,eAAe,WAAW,gBAAgB;GAC/C,cAAc;GACd,YAAY;GACZ,UAAU;GACV;GACD,CAAC;SACI;EAGN,OAAO,eAAe,OAAO,eAAe,UAAU,EAAE,gBAAgB;GACtE,cAAc;GACd,YAAY;GACZ,MAAM;IACJ,OAAO;;GAEV,CAAC;;CAKJ,IAAI,UAAU,iBAAiB,OAC7B,QAAQ,MACN,+DACA,eACA,OAAO,yBAAyB,WAAW,eAAe,CAC3D;;;;;;;;;;AAYL,SAAS,oBAAoB,OAAsB;CACjD,4BAA4B,MAAM;CAClC,6BAA6B,MAAM;;AAGrC,SAAS,gBAAgB,QAA4D;CAGnF,IAFiB,OAAO,WAAW,UAEnB,QAAQ,iBAAiB,OAAO;EAM9C,MAAM,EAAE,gBAAgB,GAAG,SAJzB,OAAO,QAAQ,iBAAiB,WAC5B,OAAO,eACN,EAAE;EAIT,OAAO,IAAI,qBAAqB;GAC9B,gBAAgB,kBAAkB,CAAC,IAAI;GACvC,GAAG;GACJ,CAAC;;CAGJ,IAAI,QAAQ,cAAc,OACxB,MAAM,IAAI,MAAM,wEAAwE;CAQ1F,MAAM,EAAE,gBAAgB,GAAG,SAJzB,OAAO,QAAQ,cAAc,WACzB,OAAO,YACN,EAAE;CAIT,OAAO,IAAI,mBAAmB;EAC5B,gBAAgB,kBAAkB,CAAC,IAAI;EACvC,GAAG;EACJ,CAAC;;AAGJ,SAAS,wBAAwB,aAA0D;CACzF,IAAI,CAAC,aACH;CAGF,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,YAAY;EACtC,IAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,EAChE;EAEF,OAAO;UACA,OAAO;EACd,QAAQ,KAAK,sDAAsD,MAAM;EACzE;;;AAIJ,SAAS,sBAKK;CACZ,MAAM,cAAc,UAAU;CAG9B,IAAI,CAAC,aACH;CAGF,IAAI,OAAO,YAAY,uBAAuB,YAC5C,OAAO;EACL;EACA,OAAO,YAAY,oBAAoB;EACxC;CAGH,IAAI,OAAO,YAAY,cAAc,YACnC;CAcF,OAAO;EACL;EACA,OAbY,YAAY,WAAW,CAAC,KACnC,UAAwB;GACvB,MAAM,KAAK;GACX,aAAa,KAAK,eAAe;GACjC,aAAa,wBAAwB,KAAK,YAAY,IAAI;IACxD,MAAM;IACN,YAAY,EAAE;IACf;GACF,EAKI;EACN;;AAGH,SAAS,yBAAyB,QAAkC;CAClE,MAAM,YAAY,qBAAqB;CACvC,IAAI,CAAC,WACH,OAAO;CAGT,MAAM,EAAE,aAAa,UAAU;CAC/B,OAAO,OAAO,cAAc,OAAO,OAAO,MAAc,SAAkC;EACxF,MAAM,aAAa,MAAM,YAAY,YAAY,MAAM,KAAK,UAAU,QAAQ,EAAE,CAAC,CAAC;EAClF,IAAI,eAAe,MACjB,OAAO;GACL,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAA4C,CAAC;GAC7E,SAAS;GACV;EAGH,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,WAAW;WACxB,YAAY;GACnB,MAAM,IAAI,MACR,gDAAgD,KAAK,IAAI,sBAAsB,QAAQ,WAAW,UAAU,OAAO,WAAW,GAC/H;;EAEH,IAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,EAChE,MAAM,IAAI,MAAM,wCAAwC,OAAO;EAEjE,OAAO;GACP;;AAGJ,SAAgB,0BAA0B,SAA4C;CACpF,IAAI,CAAC,sBAAsB,EACzB;CAGF,IAAI,SACF;CAMF,IADwB,yBACL,GAAG,yBACpB;CAIF,yBAAyB,EACvB,oBAAoB,SAAS,sBAAsB,cACpD,CAAC;CAGF,MAAM,SAAS,yBAAyB;CACxC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,gCAAgC;CAKlD,MAAM,SAAS,IAAI,iBAAiB;EAAE,MAAM,GAD3B,OAAO,SAAS,YAAY,YACW;EAAU,SAAS;EAAS,EAAE,EAAE,QAAQ,CAAC;CACjG,OAAO,iBAAiB;CACxB,yBAAyB,OAAO;CAKhC,MAAM,yCAAyC,OAAO,yBACpD,UACA,eACD;CACD,MAAM,0CAA0C,OAAO,yBACrD,WACA,eACD;CACD,oBAAoB,OAAO;CAG3B,MAAM,YAAY,gBAAgB,SAAS,UAAU;CACrD,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CAED,AAAK,OAAO,QAAQ,UAAU,CAAC,OAAO,UAAmB;EACvD,QAAQ,MAAM,sDAAsD,MAAM;GAC1E;;AAGJ,SAAgB,yBAA+B;CAC7C,IAAI,CAAC,SACH;CAGF,MAAM,EACJ,QACA,WACA,wCACA,4CACE;CACJ,UAAU;CAEV,AAAK,OAAO,OAAO;CACnB,AAAK,UAAU,OAAO;CAKtB,IAAI,wCACF,OAAO,eAAe,UAAU,gBAAgB,uCAAuC;MAEvF,OAAQ,SAAgD;CAG1D,IAAI,yCACF,OAAO,eAAe,WAAW,gBAAgB,wCAAwC;MAEzF,OAAQ,UAAiD;;;;;AC1T7D,IAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa;CACpE,MAAM,UAAU,OAAO;CAGvB,IAF6B,SAAS,mBAAmB,OAGvD,IAAI;EACF,0BAA0B,QAAQ;UAC3B,OAAO;EACd,QAAQ,MAAM,iDAAiD,MAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/global.ts","../src/index.ts"],"sourcesContent":["import { IframeChildTransport, TabServerTransport } from '@mcp-b/transports';\nimport { initializeWebMCPPolyfill } from '@mcp-b/webmcp-polyfill';\nimport { BrowserMcpServer, isBrowserMcpServer } from '@mcp-b/webmcp-ts-sdk';\nimport type { ModelContext } from '@mcp-b/webmcp-types';\nimport type { Transport } from '@modelcontextprotocol/server';\nimport type { WebModelContextInitOptions } from './types.js';\n\ninterface RuntimeState {\n  native: ModelContext;\n  server: BrowserMcpServer;\n  transport: Transport;\n  previousDocumentModelContextDescriptor: PropertyDescriptor | undefined;\n  previousNavigatorModelContextDescriptor: PropertyDescriptor | undefined;\n}\n\nlet runtime: RuntimeState | null = null;\n\nfunction isBrowserEnvironment(): boolean {\n  return typeof window !== 'undefined' && typeof window.navigator !== 'undefined';\n}\n\nfunction readCurrentModelContext(): ModelContext | undefined {\n  return document.modelContext ?? navigator.modelContext;\n}\n\nfunction replaceDocumentModelContext(value: unknown): void {\n  Object.defineProperty(document, 'modelContext', {\n    configurable: true,\n    enumerable: true,\n    writable: false,\n    value,\n  });\n\n  if (document.modelContext !== value) {\n    console.error(\n      '[WebModelContext] Failed to replace document.modelContext.',\n      'Descriptor:',\n      Object.getOwnPropertyDescriptor(document, 'modelContext')\n    );\n  }\n}\n\nfunction replaceNavigatorModelContext(value: unknown): void {\n  Object.defineProperty(navigator, 'modelContext', {\n    configurable: true,\n    enumerable: true,\n    writable: false,\n    value,\n  });\n\n  if (navigator.modelContext !== value) {\n    console.error(\n      '[WebModelContext] Failed to replace navigator.modelContext.',\n      'Descriptor:',\n      Object.getOwnPropertyDescriptor(navigator, 'modelContext')\n    );\n  }\n}\n\nfunction restoreProperty(\n  target: Document | Navigator,\n  key: 'modelContext',\n  descriptor: PropertyDescriptor | undefined\n): void {\n  if (descriptor) Object.defineProperty(target, key, descriptor);\n  else Reflect.deleteProperty(target, key);\n}\n\n/**\n * Replace both modelContext surfaces with the given value.\n *\n * document.modelContext is canonical. @mcp-b/global still supports old\n * navigator-first users, so the bridge exposes the BrowserMcpServer wrapper\n * through both properties.\n */\nfunction replaceModelContext(\n  value: unknown,\n  previousDocumentDescriptor: PropertyDescriptor | undefined,\n  previousNavigatorDescriptor: PropertyDescriptor | undefined\n): void {\n  try {\n    replaceDocumentModelContext(value);\n    replaceNavigatorModelContext(value);\n  } catch (error) {\n    restoreProperty(document, 'modelContext', previousDocumentDescriptor);\n    restoreProperty(navigator, 'modelContext', previousNavigatorDescriptor);\n    throw error;\n  }\n}\n\nfunction createTransport(config: WebModelContextInitOptions['transport']): Transport {\n  const inIframe = window.parent !== window;\n\n  if (inIframe && config?.iframeServer !== false) {\n    return new IframeChildTransport(\n      typeof config?.iframeServer === 'object' ? config.iframeServer : { allowedOrigins: ['*'] }\n    );\n  }\n\n  if (config?.tabServer === false) {\n    throw new Error('tabServer transport is disabled and iframe transport was not selected');\n  }\n\n  return new TabServerTransport(\n    typeof config?.tabServer === 'object' ? config.tabServer : { allowedOrigins: ['*'] }\n  );\n}\n\n/** Installs the global bridge on `document.modelContext`. */\nexport function initializeWebModelContext(options?: WebModelContextInitOptions): void {\n  if (!isBrowserEnvironment() || globalThis.isSecureContext === false) {\n    return;\n  }\n\n  if (runtime) {\n    return;\n  }\n\n  // Cross-bundle guard: if modelContext is already a BrowserMcpServer\n  // (set by another bundle in this window), skip initialization.\n  const existingContext = readCurrentModelContext();\n  if (existingContext && isBrowserMcpServer(existingContext)) {\n    return;\n  }\n\n  // 1. Install polyfill (provides modelContext + modelContextTesting)\n  initializeWebMCPPolyfill({\n    installTestingShim: options?.installTestingShim ?? true,\n  });\n\n  // 2. Save reference to the polyfill's (or native) context\n  const native = readCurrentModelContext();\n  if (!native) {\n    throw new Error('modelContext is not available');\n  }\n\n  // 3. Resolve transport before mutating either browser surface.\n  const transport = createTransport(options?.transport);\n\n  // 4. Create server with native mirroring\n  const hostname = window.location.hostname || 'localhost';\n  const server = new BrowserMcpServer({ name: `${hostname}-webmcp`, version: '1.0.0' }, { native });\n\n  // 5. Replace both the canonical document surface and compatibility alias.\n  const previousDocumentModelContextDescriptor = Object.getOwnPropertyDescriptor(\n    document,\n    'modelContext'\n  );\n  const previousNavigatorModelContextDescriptor = Object.getOwnPropertyDescriptor(\n    navigator,\n    'modelContext'\n  );\n  try {\n    replaceModelContext(\n      server,\n      previousDocumentModelContextDescriptor,\n      previousNavigatorModelContextDescriptor\n    );\n    runtime = {\n      native,\n      server,\n      transport,\n      previousDocumentModelContextDescriptor,\n      previousNavigatorModelContextDescriptor,\n    };\n  } catch (error) {\n    void server.close();\n    void transport.close();\n    throw error;\n  }\n\n  void (async () => {\n    try {\n      await server.syncNativeTools();\n    } catch (error) {\n      console.warn('[WebModelContext] Native WebMCP tool synchronization failed:', error);\n    }\n\n    if (runtime?.server !== server) {\n      return;\n    }\n\n    try {\n      await server.connect(transport);\n    } catch (error) {\n      console.error('[WebModelContext] Failed to connect MCP transport:', error);\n      if (runtime?.server === server) {\n        cleanupWebModelContext();\n      }\n    }\n  })();\n}\n\nexport function cleanupWebModelContext(): void {\n  if (!runtime) {\n    return;\n  }\n\n  const {\n    server,\n    transport,\n    previousDocumentModelContextDescriptor,\n    previousNavigatorModelContextDescriptor,\n  } = runtime;\n  runtime = null;\n\n  void server.close();\n  void transport.close();\n\n  // Restore the descriptors that existed before we wrapped with BrowserMcpServer.\n  // We intentionally do NOT call cleanupWebMCPPolyfill() here — the polyfill\n  // manages its own lifecycle (auto-init, testing shim) independently.\n  restoreProperty(document, 'modelContext', previousDocumentModelContextDescriptor);\n  restoreProperty(navigator, 'modelContext', previousNavigatorModelContextDescriptor);\n}\n","import { cleanupWebModelContext, initializeWebModelContext } from './global.js';\n\nexport { cleanupWebModelContext, initializeWebModelContext };\n\nexport type { TransportConfiguration, WebModelContextInitOptions } from './types.js';\n\nif (typeof window !== 'undefined' && typeof document !== 'undefined') {\n  const options = window.__webModelContextOptions;\n  const shouldAutoInitialize = options?.autoInitialize !== false;\n\n  if (shouldAutoInitialize) {\n    try {\n      initializeWebModelContext(options);\n    } catch (error) {\n      console.error('[WebModelContext] Auto-initialization failed:', error);\n    }\n  }\n}\n"],"mappings":";;;;;AAeA,IAAI,UAA+B;AAEnC,SAAS,uBAAgC;CACvC,OAAO,OAAO,WAAW,eAAe,OAAO,OAAO,cAAc;;AAGtE,SAAS,0BAAoD;CAC3D,OAAO,SAAS,gBAAgB,UAAU;;AAG5C,SAAS,4BAA4B,OAAsB;CACzD,OAAO,eAAe,UAAU,gBAAgB;EAC9C,cAAc;EACd,YAAY;EACZ,UAAU;EACV;EACD,CAAC;CAEF,IAAI,SAAS,iBAAiB,OAC5B,QAAQ,MACN,8DACA,eACA,OAAO,yBAAyB,UAAU,eAAe,CAC1D;;AAIL,SAAS,6BAA6B,OAAsB;CAC1D,OAAO,eAAe,WAAW,gBAAgB;EAC/C,cAAc;EACd,YAAY;EACZ,UAAU;EACV;EACD,CAAC;CAEF,IAAI,UAAU,iBAAiB,OAC7B,QAAQ,MACN,+DACA,eACA,OAAO,yBAAyB,WAAW,eAAe,CAC3D;;AAIL,SAAS,gBACP,QACA,KACA,YACM;CACN,IAAI,YAAY,OAAO,eAAe,QAAQ,KAAK,WAAW;MACzD,QAAQ,eAAe,QAAQ,IAAI;;;;;;;;;AAU1C,SAAS,oBACP,OACA,4BACA,6BACM;CACN,IAAI;EACF,4BAA4B,MAAM;EAClC,6BAA6B,MAAM;UAC5B,OAAO;EACd,gBAAgB,UAAU,gBAAgB,2BAA2B;EACrE,gBAAgB,WAAW,gBAAgB,4BAA4B;EACvE,MAAM;;;AAIV,SAAS,gBAAgB,QAA4D;CAGnF,IAFiB,OAAO,WAAW,UAEnB,QAAQ,iBAAiB,OACvC,OAAO,IAAI,qBACT,OAAO,QAAQ,iBAAiB,WAAW,OAAO,eAAe,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAC3F;CAGH,IAAI,QAAQ,cAAc,OACxB,MAAM,IAAI,MAAM,wEAAwE;CAG1F,OAAO,IAAI,mBACT,OAAO,QAAQ,cAAc,WAAW,OAAO,YAAY,EAAE,gBAAgB,CAAC,IAAI,EAAE,CACrF;;;AAIH,SAAgB,0BAA0B,SAA4C;CACpF,IAAI,CAAC,sBAAsB,IAAI,WAAW,oBAAoB,OAC5D;CAGF,IAAI,SACF;CAKF,MAAM,kBAAkB,yBAAyB;CACjD,IAAI,mBAAmB,mBAAmB,gBAAgB,EACxD;CAIF,yBAAyB,EACvB,oBAAoB,SAAS,sBAAsB,MACpD,CAAC;CAGF,MAAM,SAAS,yBAAyB;CACxC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,gCAAgC;CAIlD,MAAM,YAAY,gBAAgB,SAAS,UAAU;CAIrD,MAAM,SAAS,IAAI,iBAAiB;EAAE,MAAM,GAD3B,OAAO,SAAS,YAAY,YACW;EAAU,SAAS;EAAS,EAAE,EAAE,QAAQ,CAAC;CAGjG,MAAM,yCAAyC,OAAO,yBACpD,UACA,eACD;CACD,MAAM,0CAA0C,OAAO,yBACrD,WACA,eACD;CACD,IAAI;EACF,oBACE,QACA,wCACA,wCACD;EACD,UAAU;GACR;GACA;GACA;GACA;GACA;GACD;UACM,OAAO;EACd,AAAK,OAAO,OAAO;EACnB,AAAK,UAAU,OAAO;EACtB,MAAM;;CAGR,CAAM,YAAY;EAChB,IAAI;GACF,MAAM,OAAO,iBAAiB;WACvB,OAAO;GACd,QAAQ,KAAK,gEAAgE,MAAM;;EAGrF,IAAI,SAAS,WAAW,QACtB;EAGF,IAAI;GACF,MAAM,OAAO,QAAQ,UAAU;WACxB,OAAO;GACd,QAAQ,MAAM,sDAAsD,MAAM;GAC1E,IAAI,SAAS,WAAW,QACtB,wBAAwB;;KAG1B;;AAGN,SAAgB,yBAA+B;CAC7C,IAAI,CAAC,SACH;CAGF,MAAM,EACJ,QACA,WACA,wCACA,4CACE;CACJ,UAAU;CAEV,AAAK,OAAO,OAAO;CACnB,AAAK,UAAU,OAAO;CAKtB,gBAAgB,UAAU,gBAAgB,uCAAuC;CACjF,gBAAgB,WAAW,gBAAgB,wCAAwC;;;;;AC/MrF,IAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa;CACpE,MAAM,UAAU,OAAO;CAGvB,IAF6B,SAAS,mBAAmB,OAGvD,IAAI;EACF,0BAA0B,QAAQ;UAC3B,OAAO;EACd,QAAQ,MAAM,iDAAiD,MAAM"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-b/global",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.",
   "keywords": [
     "ai-agents",
@@ -48,7 +48,7 @@
   "sideEffects": true,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
-  "browser": "./dist/index.iife.js",
+  "browser": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -66,25 +66,26 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mcp-b/webmcp-polyfill": "4.0.0",
-    "@mcp-b/transports": "4.0.0",
-    "@mcp-b/webmcp-ts-sdk": "4.0.0",
-    "@mcp-b/webmcp-types": "4.0.0"
+    "@modelcontextprotocol/server": "2.0.0",
+    "@mcp-b/transports": "5.0.0",
+    "@mcp-b/webmcp-ts-sdk": "5.0.0",
+    "@mcp-b/webmcp-types": "5.0.0",
+    "@mcp-b/webmcp-polyfill": "5.0.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
     "@types/node": "22.17.2",
     "@vitest/coverage-v8": "^4.1.7",
-    "fast-check": "^4.0.0",
     "playwright": "^1.60.0",
     "typescript": "^5.8.3",
     "vite-plus": "^0.1.22",
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
-    "build": "vp pack",
+    "build": "vp pack && pnpm run typecheck:consumer",
     "check": "vp check --fix",
     "clean": "rm -rf dist",
     "format": "vp fmt --write",
@@ -92,17 +93,12 @@
     "publish:dry": "pnpm publish --access public --dry-run",
     "publish:npm": "pnpm publish --access public",
     "test": "vp test run",
-    "test:browser": "vp test run --browser.headless",
-    "test:browser:ui": "vp test --browser",
-    "test:conformance:global": "vp test run --config vitest.conformance.global.config.ts --browser.headless",
+    "test:conformance:global": "vp test run conformance/global-runtime.e2e.test.ts --browser.headless",
     "test:conformance:matrix": "pnpm run test:conformance:polyfill && pnpm run test:conformance:global && pnpm run test:conformance:native",
     "test:conformance:native": "vp test run --config vitest.conformance.native.config.ts --browser.headless",
     "test:conformance:polyfill": "pnpm --filter @mcp-b/webmcp-polyfill run test:conformance",
-    "test:node": "vp test run --config vitest.node.config.ts",
     "test:watch": "vp test",
     "typecheck": "tsc --noEmit && vp test run --typecheck --silent",
-    "version:major": "pnpm version major --no-git-tag-version",
-    "version:minor": "pnpm version minor --no-git-tag-version",
-    "version:patch": "pnpm version patch --no-git-tag-version"
+    "typecheck:consumer": "tsc --noEmit --strict --skipLibCheck --module preserve --moduleResolution bundler --lib ES2022,DOM type-tests/consumer.ts"
   }
 }

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/global.ts"],"mappings":";;;UAEiB,sBAAA;EACf,SAAA,GAAY,OAAA,CAAQ,yBAAA;EACpB,YAAA,GAAe,OAAA,CAAQ,2BAAA;AAAA;AAAA,KAGb,0BAAA;AAAA,UAEK,0BAAA;EACf,SAAA,GAAY,sBAAA;EACZ,cAAA;EAPe;;;;;;;EAef,0BAAA,GAA6B,0BAAA;EAfN;;;AAGzB;;;EAmBE,kBAAA;AAAA;AAAA,QAGM,MAAA;EAAA,UACI,MAAA;IACR,wBAAA,GAA2B,0BAAA;EAAA;AAAA;;;iBC4Mf,yBAAA,CAA0B,OAAA,GAAU,0BAAA;AAAA,iBA6DpC,sBAAA,CAAA"}