@mcp-ts/sdk 1.0.0

package/dist/server/index.d.ts

@@ -0,0 +1,269 @@
+export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvider } from '../multi-session-client-BOFgPypS.js';
+export { U as UnauthorizedError, s as sanitizeServerLabel } from '../utils-0qmYrqoa.js';
+import { OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+import { M as McpConnectionEvent, d as McpObservabilityEvent } from '../events-BP6WyRNh.js';
+export { D as Disposable, E as Emitter, b as Event, c as McpConnectionState } from '../events-BP6WyRNh.js';
+import { q as McpRpcResponse, p as McpRpcRequest } from '../types-SbDlA2VX.js';
+export { a as CallToolRequest, b as CallToolResponse, f as ConnectRequest, g as ConnectResponse, m as ListToolsResponse, T as ToolInfo } from '../types-SbDlA2VX.js';
+export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import '@modelcontextprotocol/sdk/client/auth.js';
+
+interface SessionData {
+    sessionId: string;
+    serverId?: string;
+    serverName?: string;
+    serverUrl: string;
+    transportType: 'sse' | 'streamable_http';
+    callbackUrl: string;
+    createdAt: number;
+    identity?: string;
+    headers?: Record<string, string>;
+    clientInformation?: OAuthClientInformationMixed;
+    tokens?: OAuthTokens;
+    codeVerifier?: string;
+    clientId?: string;
+}
+/**
+ * Interface for MCP Session Storage Backends
+ */
+interface StorageBackend {
+    /**
+     * Optional initialization (e.g., database connection)
+     */
+    init?(): Promise<void>;
+    /**
+     * Generates a unique session ID
+     */
+    generateSessionId(): string;
+    /**
+     * Stores or updates a session
+     */
+    /**
+     * Creates a new session. Throws if session already exists.
+     * @param session - Session data to create
+     * @param ttl - Optional TTL in seconds (defaults to backend's default)
+     */
+    createSession(session: SessionData, ttl?: number): Promise<void>;
+    /**
+     * Updates an existing session with partial data. Throws if session does not exist.
+     * @param identity - User identity
+     * @param sessionId - Session identifier
+     * @param data - Partial session data to update
+     * @param ttl - Optional TTL in seconds (defaults to backend's default)
+     */
+    updateSession(identity: string, sessionId: string, data: Partial<SessionData>, ttl?: number): Promise<void>;
+    /**
+     * Retrieves a session
+     */
+    getSession(identity: string, sessionId: string): Promise<SessionData | null>;
+    /**
+     * Gets full session data for all of an identity's sessions
+     */
+    getIdentitySessionsData(identity: string): Promise<SessionData[]>;
+    /**
+     * Removes a session
+     */
+    removeSession(identity: string, sessionId: string): Promise<void>;
+    /**
+     * Gets all sessions IDs of an identity
+     */
+    getIdentityMcpSessions(identity: string): Promise<string[]>;
+    /**
+     * Gets all session IDs across all users (Admin)
+     */
+    getAllSessionIds(): Promise<string[]>;
+    /**
+     * Clears all sessions (Admin)
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Clean up expired sessions
+     */
+    cleanupExpiredSessions(): Promise<void>;
+    /**
+     * Disconnect from storage backend
+     */
+    disconnect(): Promise<void>;
+}
+
+/**
+ * Global session store instance
+ * Uses lazy initialization with a Proxy to handle async setup transparently
+ */
+declare const storage: StorageBackend;
+
+/**
+ * SSE (Server-Sent Events) Handler for MCP Connections
+ * Provides real-time connection state updates to clients
+ * Based on Cloudflare's agents pattern but adapted for HTTP/SSE
+ */
+
+interface ClientMetadata {
+    clientName?: string;
+    clientUri?: string;
+    logoUri?: string;
+    policyUri?: string;
+}
+interface SSEHandlerOptions {
+    /**
+     * User/Client identifier
+     */
+    identity: string;
+    /**
+     * Optional callback for authentication/authorization
+     */
+    onAuth?: (identity: string) => Promise<boolean>;
+    /**
+     * Heartbeat interval in ms (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Static OAuth client metadata defaults (for all connections)
+     */
+    clientDefaults?: ClientMetadata;
+    /**
+     * Dynamic OAuth client metadata getter (per-request, useful for multi-tenant)
+     * Takes precedence over clientDefaults
+     */
+    getClientMetadata?: (request?: any) => ClientMetadata | Promise<ClientMetadata>;
+}
+/**
+ * SSE Connection Manager
+ * Handles a single SSE connection and manages MCP operations
+ */
+declare class SSEConnectionManager {
+    private options;
+    private sendEvent;
+    private identity;
+    private clients;
+    private heartbeatTimer?;
+    private isActive;
+    constructor(options: SSEHandlerOptions, sendEvent: (event: McpConnectionEvent | McpObservabilityEvent | McpRpcResponse) => void);
+    /**
+     * Get resolved client metadata (dynamic > static > defaults)
+     */
+    private getResolvedClientMetadata;
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    private startHeartbeat;
+    /**
+     * Handle incoming RPC requests
+     */
+    handleRequest(request: McpRpcRequest): Promise<void>;
+    /**
+     * Get all user sessions
+     */
+    private getSessions;
+    /**
+     * Connect to an MCP server
+     */
+    private connect;
+    /**
+     * Disconnect from an MCP server
+     */
+    private disconnect;
+    /**
+     * Helper to get or restore a client
+     */
+    private getOrCreateClient;
+    /**
+     * List tools from a session
+     */
+    private listTools;
+    /**
+     * Call a tool
+     */
+    private callTool;
+    /**
+     * Refresh/validate a session
+     */
+    private restoreSession;
+    /**
+     * Complete OAuth authorization
+     */
+    private finishAuth;
+    /**
+     * List prompts from a session
+     */
+    private listPrompts;
+    /**
+     * Get a specific prompt
+     */
+    private getPrompt;
+    /**
+     * List resources from a session
+     */
+    private listResources;
+    /**
+     * Read a specific resource
+     */
+    private readResource;
+    /**
+     * Emit connection event
+     */
+    private emitConnectionEvent;
+    /**
+     * Cleanup and close all connections
+     */
+    dispose(): void;
+}
+/**
+ * Create SSE endpoint handler
+ * Compatible with various Node.js frameworks
+ */
+declare function createSSEHandler(options: SSEHandlerOptions): (req: any, res: any) => Promise<void>;
+
+/**
+ * Next.js App Router Handler for MCP SSE
+ * Provides a clean, zero-boilerplate API for Next.js applications
+ */
+
+interface NextMcpHandlerOptions {
+    /**
+     * Extract identity from request (default: from 'identity' query param)
+     */
+    getIdentity?: (request: Request) => string | null;
+    /**
+     * Extract auth token from request (default: from 'token' query param or Authorization header)
+     */
+    getAuthToken?: (request: Request) => string | null;
+    /**
+     * Authenticate user and verify access (optional)
+     * Return true if user is authenticated, false otherwise
+     */
+    authenticate?: (identity: string, token: string | null) => Promise<boolean> | boolean;
+    /**
+     * Heartbeat interval in milliseconds (default: 30000)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Static OAuth client metadata defaults (for all connections)
+     * Use this for single-tenant applications with fixed branding
+     */
+    clientDefaults?: ClientMetadata;
+    /**
+     * Dynamic OAuth client metadata getter (per-request, useful for multi-tenant)
+     * Use this when you need different branding based on request (tenant, domain, etc.)
+     * Takes precedence over clientDefaults
+     */
+    getClientMetadata?: (request: Request) => ClientMetadata | Promise<ClientMetadata>;
+}
+/**
+ * Creates Next.js App Router handlers (GET and POST) for MCP SSE endpoint
+ *
+ * @example
+ * ```typescript
+ * // app/api/mcp/route.ts
+ * import { createNextMcpHandler } from '@mcp-ts/core/server';
+ *
+ * export const { GET, POST } = createNextMcpHandler();
+ * ```
+ */
+declare function createNextMcpHandler(options?: NextMcpHandlerOptions): {
+    GET: (request: Request) => Promise<Response>;
+    POST: (request: Request) => Promise<Response>;
+};
+
+export { type ClientMetadata, McpConnectionEvent, McpObservabilityEvent, McpRpcRequest, McpRpcResponse, type NextMcpHandlerOptions, SSEConnectionManager, type SSEHandlerOptions, type StorageBackend, createNextMcpHandler, createSSEHandler, storage };