nitrostack 1.0.18 → 1.0.19

package/dist/core/transports/streamable-http.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Streamable HTTP Transport for MCP
+ *
+ * Implements the MCP Streamable HTTP transport specification (2025-06-18).
+ * https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http
+ *
+ * Features:
+ * - Single MCP endpoint supporting both POST and GET
+ * - POST for sending messages to server
+ * - GET for SSE streams from server
+ * - Session management with Mcp-Session-Id header
+ * - Resumability support with Last-Event-ID
+ * - Multiple concurrent client connections
+ * - Protocol version header support
+ */
+import { Express } from 'express';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+export interface StreamableHttpTransportOptions {
+    /**
+     * Port to listen on (default: 3000)
+     */
+    port?: number;
+    /**
+     * Host to bind to (default: 'localhost' for security)
+     */
+    host?: string;
+    /**
+     * MCP endpoint path (default: '/mcp')
+     */
+    endpoint?: string;
+    /**
+     * Enable session management (default: true)
+     */
+    enableSessions?: boolean;
+    /**
+     * Session timeout in ms (default: 30 minutes)
+     */
+    sessionTimeout?: number;
+    /**
+     * Custom Express app (optional)
+     */
+    app?: Express;
+    /**
+     * Enable CORS (default: false for security)
+     */
+    enableCors?: boolean;
+}
+/**
+ * Streamable HTTP Transport
+ * Implements MCP Streamable HTTP specification
+ */
+export declare class StreamableHttpTransport implements Transport {
+    private app;
+    private server;
+    private sessions;
+    private activeStreams;
+    private messageHandler?;
+    private closeHandler?;
+    private errorHandler?;
+    private options;
+    private sessionCleanupInterval?;
+    constructor(options?: StreamableHttpTransportOptions);
+    /**
+     * Setup Express middleware
+     */
+    private setupMiddleware;
+    /**
+     * Setup MCP endpoint routes
+     */
+    private setupRoutes;
+    /**
+     * Handle POST requests (client sending messages to server)
+     */
+    private handlePost;
+    /**
+     * Handle GET requests (client opening SSE stream)
+     */
+    private handleGet;
+    /**
+     * Handle DELETE requests (session termination)
+     */
+    private handleDelete;
+    /**
+     * Start SSE stream for a request
+     */
+    private startSSEStream;
+    /**
+     * Send message to client(s)
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Send message to a specific stream
+     */
+    private sendToStream;
+    /**
+     * Send response to the stream that made the request
+     */
+    private sendToRequestStream;
+    /**
+     * Send message to a sessionless stream
+     */
+    private sendToStreamSessionless;
+    /**
+     * Replay messages for resumability
+     */
+    private replayMessages;
+    /**
+     * Start the HTTP server
+     */
+    start(): Promise<void>;
+    /**
+     * Close the transport
+     */
+    close(): Promise<void>;
+    /**
+     * Set message handler
+     */
+    set onmessage(handler: (message: JSONRPCMessage) => Promise<void>);
+    /**
+     * Set close handler
+     */
+    set onclose(handler: () => void);
+    /**
+     * Set error handler
+     */
+    set onerror(handler: (error: Error) => void);
+    /**
+     * Start session cleanup interval
+     */
+    private startSessionCleanup;
+    /**
+     * Helper methods
+     */
+    private generateSessionId;
+    private getMessageType;
+    private isResponse;
+    private isInitializeRequest;
+    private isLocalhost;
+    /**
+     * Get the Express app (for adding custom routes)
+     */
+    getApp(): Express;
+}
+//# sourceMappingURL=streamable-http.d.ts.map

package/dist/core/transports/streamable-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamable-http.d.ts","sourceRoot":"","sources":["../../../src/core/transports/streamable-http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAgB,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAwD,MAAM,oCAAoC,CAAC;AAG1H,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAuBD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,SAAS;IACvD,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,cAAc,CAAC,CAA6C;IACpE,OAAO,CAAC,YAAY,CAAC,CAAa;IAClC,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,OAAO,CAAwD;IACvE,OAAO,CAAC,sBAAsB,CAAC,CAAiB;gBAEpC,OAAO,GAAE,8BAAmC;IAoBxD;;OAEG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgGnB;;OAEG;YACW,UAAU;IAwFxB;;OAEG;IACH,OAAO,CAAC,SAAS;IA4FjB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;YACW,cAAc;IAkD5B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BlD;;OAEG;YACW,YAAY;IAwB1B;;OAEG;YACW,mBAAmB;IAuCjC;;OAEG;YACW,uBAAuB;IAiBrC;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C5B;;OAEG;IACH,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAEhE;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,EAE9B;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAE1C;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IAEH,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,MAAM,IAAI,OAAO;CAGlB"}