@mcp-b/global 1.5.0 → 1.6.1

package/dist/index.d.ts

@@ -1,91 +1,40 @@
-import { A as ToolCallEvent, B as ZodSchemaObject, C as ResourceContents, D as SamplingRequestParams, E as ResourceTemplateInfo, F as TransportConfiguration, I as ValidatedPromptDescriptor, L as ValidatedResourceDescriptor, M as ToolInfo, N as ToolListItem, O as SamplingResult, P as ToolResponse, R as ValidatedToolDescriptor, S as Resource, T as ResourceTemplate, _ as NavigationMetadata, a as ElicitResult, b as PromptMessage, c as ElicitationResult, d as InternalModelContext, f as InterruptionMetadata, g as ModelContextTesting, h as ModelContextInput, i as ElicitRequest, j as ToolDescriptor, k as ToolAnnotations, l as ElicitationUrlParams, m as ModelContext, n as CreateMessageRequest, o as ElicitationFormParams, p as MCPBridge, r as CreateMessageResult, s as ElicitationParams, t as CallToolResult, u as InputSchema, v as Prompt, w as ResourceDescriptor, x as RegistrationHandle, y as PromptDescriptor, z as WebModelContextInitOptions } from "./types-DemXxUoc.js";
-import { z } from "zod";
+import { IframeChildTransportOptions, TabServerTransportOptions } from "@mcp-b/transports";
 
-//#region src/global.d.ts
+//#region src/types.d.ts
+interface TransportConfiguration {
+  tabServer?: Partial<TabServerTransportOptions> | false;
+  iframeServer?: Partial<IframeChildTransportOptions> | false;
+}
+type NativeModelContextBehavior = 'preserve' | 'patch';
+interface WebModelContextInitOptions {
+  transport?: TransportConfiguration;
+  autoInitialize?: boolean;
+  /**
+   * Behavior when navigator.modelContext already exists.
+   * - 'preserve' (default): wrap native with BrowserMcpServer, mirroring
+   *   core operations to the native object while extending with prompts,
+   *   resources, and other MCP capabilities.
+   * - 'patch': same wrapping behavior (kept for backward compatibility).
+   */
+  nativeModelContextBehavior?: NativeModelContextBehavior;
+  /**
+   * Forwarded to @mcp-b/webmcp-polyfill when polyfill installation is needed.
+   * - true or 'if-missing' (default): install modelContextTesting only when missing.
+   * - 'always': replace existing modelContextTesting.
+   * - false: do not install modelContextTesting.
+   */
+  installTestingShim?: boolean | 'always' | 'if-missing';
+}
 declare global {
   interface Window {
     __webModelContextOptions?: WebModelContextInitOptions;
   }
 }
-/**
- * Initializes the Web Model Context API on window.navigator.
- * Creates and exposes navigator.modelContext and navigator.modelContextTesting.
- * Automatically detects and uses native Chromium implementation if available.
- *
- * @param {WebModelContextInitOptions} [options] - Configuration options
- * @throws {Error} If initialization fails
- * @example
- * ```typescript
- * import { initializeWebModelContext } from '@mcp-b/global';
- *
- * initializeWebModelContext({
- *   transport: {
- *     tabServer: {
- *       allowedOrigins: ['https://example.com']
- *     }
- *   }
- * });
- * ```
- */
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/global.d.ts
 declare function initializeWebModelContext(options?: WebModelContextInitOptions): void;
-/**
- * Cleans up the Web Model Context API.
- * Closes all MCP servers and removes API from window.navigator.
- * Useful for testing and hot module replacement.
- *
- * @example
- * ```typescript
- * import { cleanupWebModelContext } from '@mcp-b/global';
- *
- * cleanupWebModelContext();
- * ```
- */
 declare function cleanupWebModelContext(): void;
 //#endregion
-//#region src/logger.d.ts
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Logger interface with standard log levels
- *
- * All methods accept the same argument patterns as their console.* equivalents,
- * supporting format strings, object inspection, and multiple arguments.
- */
-interface Logger {
-  /** Debug-level logging (disabled by default, enable via WEBMCP_DEBUG) */
-  debug(message?: unknown, ...optionalParams: unknown[]): void;
-  /** Info-level logging (disabled by default, enable via WEBMCP_DEBUG) */
-  info(message?: unknown, ...optionalParams: unknown[]): void;
-  /** Warning-level logging (enabled by default, not gated by WEBMCP_DEBUG) */
-  warn(message?: unknown, ...optionalParams: unknown[]): void;
-  /** Error-level logging (enabled by default, not gated by WEBMCP_DEBUG) */
-  error(message?: unknown, ...optionalParams: unknown[]): void;
-}
-/**
- * Create a namespaced logger
- *
- * Uses .bind() to prepend namespace prefixes to console methods without manual
- * string concatenation. Debug enablement is determined at logger creation time
- * for performance - changes to localStorage after creation won't affect existing
- * loggers. Refresh the page to apply new WEBMCP_DEBUG settings.
- *
- * @param namespace - Namespace for the logger (e.g., 'WebModelContext', 'NativeAdapter')
- * @returns Logger instance with debug, info, warn, error methods
- *
- * @example
- * ```typescript
- * const logger = createLogger('WebModelContext');
- * logger.debug('Tool registered:', toolName); // Only shown if WEBMCP_DEBUG includes 'WebModelContext'
- * logger.error('Execution failed:', error); // Always enabled
- * ```
- */
-declare function createLogger(namespace: string): Logger;
-//#endregion
-//#region src/validation.d.ts
-declare function zodToJsonSchema(schema: ZodSchemaObject): InputSchema;
-//#endregion
-export { CallToolResult, CreateMessageRequest, CreateMessageResult, ElicitRequest, ElicitResult, ElicitationFormParams, ElicitationParams, ElicitationResult, ElicitationUrlParams, InputSchema, InternalModelContext, InterruptionMetadata, MCPBridge, ModelContext, ModelContextInput, ModelContextTesting, NavigationMetadata, Prompt, PromptDescriptor, PromptMessage, RegistrationHandle, Resource, ResourceContents, ResourceDescriptor, ResourceTemplate, ResourceTemplateInfo, SamplingRequestParams, SamplingResult, ToolAnnotations, ToolCallEvent, ToolDescriptor, ToolInfo, ToolListItem, ToolResponse, TransportConfiguration, ValidatedPromptDescriptor, ValidatedResourceDescriptor, ValidatedToolDescriptor, WebModelContextInitOptions, ZodSchemaObject, cleanupWebModelContext, createLogger, initializeWebModelContext, zodToJsonSchema };
+export { type NativeModelContextBehavior, type TransportConfiguration, type WebModelContextInitOptions, cleanupWebModelContext, initializeWebModelContext };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/global.ts","../src/logger.ts","../src/validation.ts"],"sourcesContent":[],"mappings":";;;;;;+BAgE+B;EAVX;;;;;AAmqDpB;AAmIA;;;;;;;;;ACxvDA;;;;ACvEA;;;iBF4rDgB,yBAAA,WAAoC;;;;;;;;;;;;;iBAmIpC,sBAAA,CAAA;;;;;;;AAtyDI;;;;;AAmqDpB;AAmIA;UCrxDiB,MAAA;;;;;;;EAAjB;EA6BgB,KAAA,CAAA,OAAY,CAAZ,EAAY,OAAA,EAAA,GAAqB,cAAM,EAAA,OAAA,EAAA,CAAA,EAAA,IAAA;;;;ACvEvD;;;;;;;;;;;;;;;;iBDuEgB,YAAA,qBAAiC;;;iBCvEjC,eAAA,SAAwB,kBAAkB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/global.ts"],"sourcesContent":[],"mappings":";;;UAEiB,sBAAA;cACH,QAAQ;EADL,YAAA,CAAA,EAEA,OAFA,CAEQ,2BAFc,CAAA,GAAA,KAAA;;AACzB,KAIF,0BAAA,GAJE,UAAA,GAAA,OAAA;AACW,UAKR,0BAAA,CALQ;EAAR,SAAA,CAAA,EAMH,sBANG;EAAO,cAAA,CAAA,EAAA,OAAA;EAGZ;AAEZ;AAkBC;;;;;+BAR8B;;;AC4K/B;AAwCA;;;;;;;+BDxM+B;;;;;;iBCgKf,yBAAA,WAAoC;iBAwCpC,sBAAA,CAAA"}