@mcp-ts/sdk 1.0.0

package/dist/events-BP6WyRNh.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Simple event emitter pattern for MCP connection events
+ * Inspired by Cloudflare's agents pattern but adapted for serverless
+ */
+type Disposable = {
+    dispose(): void;
+};
+type Event<T> = (listener: (event: T) => void) => Disposable;
+/**
+ * Event emitter class for type-safe event handling
+ * Similar to Cloudflare's Emitter but simplified for our use case
+ */
+declare class Emitter<T> {
+    private listeners;
+    /**
+     * Subscribe to events
+     * @param listener - Callback function to handle events
+     * @returns Disposable to unsubscribe
+     */
+    get event(): Event<T>;
+    /**
+     * Fire an event to all listeners
+     * @param event - Event data to emit
+     */
+    fire(event: T): void;
+    /**
+     * Clear all listeners
+     */
+    dispose(): void;
+    /**
+     * Get number of active listeners
+     */
+    get listenerCount(): number;
+}
+/**
+ * Connection state types matching your existing ConnectionStatus
+ * Extended with more granular states for better observability
+ */
+type McpConnectionState = 'DISCONNECTED' | 'CONNECTING' | 'AUTHENTICATING' | 'AUTHENTICATED' | 'DISCOVERING' | 'CONNECTED' | 'READY' | 'VALIDATING' | 'RECONNECTING' | 'INITIALIZING' | 'FAILED';
+/**
+ * MCP Connection Event Types
+ * Discriminated union for type-safe event handling
+ */
+type McpConnectionEvent = {
+    type: 'state_changed';
+    sessionId: string;
+    serverId: string;
+    serverName: string;
+    state: McpConnectionState;
+    previousState: McpConnectionState;
+    timestamp: number;
+} | {
+    type: 'tools_discovered';
+    sessionId: string;
+    serverId: string;
+    toolCount: number;
+    tools: any[];
+    timestamp: number;
+} | {
+    type: 'auth_required';
+    sessionId: string;
+    serverId: string;
+    authUrl: string;
+    timestamp: number;
+} | {
+    type: 'error';
+    sessionId: string;
+    serverId: string;
+    error: string;
+    errorType: 'connection' | 'auth' | 'validation' | 'unknown';
+    timestamp: number;
+} | {
+    type: 'disconnected';
+    sessionId: string;
+    serverId: string;
+    reason?: string;
+    timestamp: number;
+} | {
+    type: 'progress';
+    sessionId: string;
+    serverId: string;
+    message: string;
+    timestamp: number;
+};
+/**
+ * Observability event for debugging and monitoring
+ */
+interface McpObservabilityEvent {
+    type?: string;
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    message?: string;
+    displayMessage?: string;
+    sessionId?: string;
+    serverId?: string;
+    payload?: Record<string, any>;
+    metadata?: Record<string, any>;
+    timestamp: number;
+    id?: string;
+}
+/**
+ * DisposableStore for managing multiple disposables
+ * Useful for cleanup in React hooks
+ */
+declare class DisposableStore {
+    private disposables;
+    add(disposable: Disposable): void;
+    dispose(): void;
+}
+
+export { type Disposable as D, Emitter as E, type McpConnectionEvent as M, DisposableStore as a, type Event as b, type McpConnectionState as c, type McpObservabilityEvent as d };

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvider } from './multi-session-client-DMF3ED2O.mjs';
+export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from './utils-0qmYrqoa.mjs';
+export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.mjs';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from './events-BP6WyRNh.mjs';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from './types-SbDlA2VX.mjs';
+export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+export { SSEClient, SSEClientOptions } from './client/index.mjs';
+export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS } from './shared/index.mjs';
+import '@modelcontextprotocol/sdk/client/auth.js';

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvider } from './multi-session-client-BOFgPypS.js';
+export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from './utils-0qmYrqoa.js';
+export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.js';
+export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from './events-BP6WyRNh.js';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from './types-SbDlA2VX.js';
+export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+export { SSEClient, SSEClientOptions } from './client/index.js';
+export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS } from './shared/index.js';
+import '@modelcontextprotocol/sdk/client/auth.js';