integrate-sdk 0.1.0

package/dist/plugins/github.d.ts

@@ -0,0 +1,51 @@
+/**
+ * GitHub Plugin
+ * Enables GitHub tools with OAuth configuration
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * GitHub plugin configuration
+ */
+export interface GitHubPluginConfig {
+    /** GitHub OAuth client ID */
+    clientId: string;
+    /** GitHub OAuth client secret */
+    clientSecret: string;
+    /** Additional OAuth scopes (default: ['repo', 'user']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+    /** GitHub API base URL (default: https://api.github.com) */
+    apiBaseUrl?: string;
+}
+/**
+ * Default GitHub tools that this plugin enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const GITHUB_TOOLS: readonly ["github/createIssue", "github/listIssues", "github/getIssue", "github/updateIssue", "github/closeIssue", "github/createPullRequest", "github/listPullRequests", "github/getPullRequest", "github/mergePullRequest", "github/listRepositories", "github/getRepository", "github/createRepository", "github/listBranches", "github/createBranch", "github/getUser", "github/listCommits", "github/getCommit"];
+/**
+ * GitHub Plugin
+ *
+ * Enables GitHub integration with OAuth authentication
+ *
+ * @example
+ * ```typescript
+ * const client = createMCPClient({
+ *   serverUrl: 'http://localhost:3000/mcp',
+ *   plugins: [
+ *     githubPlugin({
+ *       clientId: process.env.GITHUB_CLIENT_ID!,
+ *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
+ *       scopes: ['repo', 'user', 'read:org'],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function githubPlugin(config: GitHubPluginConfig): MCPPlugin<GitHubPluginConfig>;
+/**
+ * Export tool names for type inference
+ */
+export type GitHubTools = typeof GITHUB_TOOLS[number];
+export {};
+//# sourceMappingURL=github.d.ts.map

package/dist/plugins/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/plugins/github.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,QAAA,MAAM,YAAY,uZAkBR,CAAC;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,CAAC,CA0BtF;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/dist/plugins/gmail.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Gmail Plugin
+ * Enables Gmail tools with OAuth configuration
+ */
+import type { MCPPlugin } from "./types.js";
+/**
+ * Gmail plugin configuration
+ */
+export interface GmailPluginConfig {
+    /** Google OAuth client ID */
+    clientId: string;
+    /** Google OAuth client secret */
+    clientSecret: string;
+    /** Additional OAuth scopes (default: Gmail API scopes) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default Gmail tools that this plugin enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const GMAIL_TOOLS: readonly ["gmail/sendEmail", "gmail/listEmails", "gmail/getEmail", "gmail/deleteEmail", "gmail/searchEmails", "gmail/markAsRead", "gmail/markAsUnread", "gmail/addLabel", "gmail/removeLabel", "gmail/listLabels", "gmail/createLabel", "gmail/getDraft", "gmail/createDraft", "gmail/updateDraft", "gmail/deleteDraft", "gmail/sendDraft"];
+/**
+ * Gmail Plugin
+ *
+ * Enables Gmail integration with OAuth authentication
+ *
+ * @example
+ * ```typescript
+ * const client = createMCPClient({
+ *   serverUrl: 'http://localhost:3000/mcp',
+ *   plugins: [
+ *     gmailPlugin({
+ *       clientId: process.env.GMAIL_CLIENT_ID!,
+ *       clientSecret: process.env.GMAIL_CLIENT_SECRET!,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function gmailPlugin(config: GmailPluginConfig): MCPPlugin<GmailPluginConfig>;
+/**
+ * Export tool names for type inference
+ */
+export type GmailTools = typeof GMAIL_TOOLS[number];
+export {};
+//# sourceMappingURL=gmail.d.ts.map

package/dist/plugins/gmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../src/plugins/gmail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,6UAiBP,CAAC;AAEX;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC,iBAAiB,CAAC,CA4BnF;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Plugin System Types
+ * Inspired by BetterAuth's provider pattern
+ */
+import type { MCPClient } from "../client.js";
+/**
+ * OAuth Configuration for a plugin
+ */
+export interface OAuthConfig<TConfig = Record<string, unknown>> {
+    /** OAuth provider identifier (e.g., 'github', 'google') */
+    provider: string;
+    /** OAuth client ID */
+    clientId: string;
+    /** OAuth client secret */
+    clientSecret: string;
+    /** Required OAuth scopes */
+    scopes: string[];
+    /** Redirect URI for OAuth flow */
+    redirectUri?: string;
+    /** Provider-specific configuration */
+    config?: TConfig;
+}
+/**
+ * MCP Plugin Interface
+ *
+ * Plugins enable specific tools and configure OAuth providers
+ */
+export interface MCPPlugin<TConfig = Record<string, unknown>> {
+    /** Unique plugin identifier */
+    id: string;
+    /** List of tool names this plugin enables */
+    tools: string[];
+    /** OAuth configuration for this plugin */
+    oauth?: OAuthConfig<TConfig>;
+    /** Called when the plugin is initialized with the client */
+    onInit?: (client: MCPClient) => Promise<void> | void;
+    /** Called before the client connects to the server */
+    onBeforeConnect?: (client: MCPClient) => Promise<void> | void;
+    /** Called after the client successfully connects */
+    onAfterConnect?: (client: MCPClient) => Promise<void> | void;
+    /** Called when the client disconnects */
+    onDisconnect?: (client: MCPClient) => Promise<void> | void;
+}
+/**
+ * Helper type to extract plugin IDs from an array of plugins
+ */
+export type ExtractPluginIds<T extends readonly MCPPlugin[]> = T[number]["id"];
+/**
+ * Helper type to extract tools from an array of plugins
+ */
+export type ExtractPluginTools<T extends readonly MCPPlugin[]> = T[number]["tools"][number];
+/**
+ * Type guard to check if a plugin has OAuth configuration
+ */
+export declare function hasOAuthConfig(plugin: MCPPlugin): plugin is MCPPlugin & {
+    oauth: OAuthConfig;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAE7B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAErD,sDAAsD;IACtD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9D,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE7D,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5F;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,GAChB,MAAM,IAAI,SAAS,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAE9C"}

package/dist/protocol/jsonrpc.d.ts

@@ -0,0 +1,32 @@
+/**
+ * JSON-RPC 2.0 Implementation
+ */
+import type { JSONRPCRequest, JSONRPCResponse, JSONRPCNotification } from "./messages.js";
+export declare function generateRequestId(): number;
+/**
+ * Create a JSON-RPC request
+ */
+export declare function createRequest(method: string, params?: unknown): JSONRPCRequest;
+/**
+ * Create a JSON-RPC notification (no response expected)
+ */
+export declare function createNotification(method: string, params?: unknown): JSONRPCNotification;
+/**
+ * Check if a response is an error
+ */
+export declare function isErrorResponse(response: JSONRPCResponse): response is JSONRPCResponse & {
+    error: NonNullable<unknown>;
+};
+/**
+ * Extract result from a successful response
+ */
+export declare function getResult<T>(response: JSONRPCResponse<T>): T;
+/**
+ * Parse a JSON-RPC message from string
+ */
+export declare function parseMessage(message: string): JSONRPCResponse | JSONRPCNotification;
+/**
+ * Serialize a JSON-RPC message to string
+ */
+export declare function serializeMessage(message: JSONRPCRequest | JSONRPCNotification): string;
+//# sourceMappingURL=jsonrpc.d.ts.map

package/dist/protocol/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/protocol/jsonrpc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAMvB,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,cAAc,CAOhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,mBAAmB,CAMrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,GACxB,QAAQ,IAAI,eAAe,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAO5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,mBAAmB,CAMnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,GAAG,mBAAmB,GAC5C,MAAM,CAER"}

package/dist/protocol/messages.d.ts

@@ -0,0 +1,130 @@
+/**
+ * MCP Protocol Message Types
+ * Based on JSON-RPC 2.0 specification with MCP extensions
+ */
+/**
+ * JSON-RPC 2.0 Request
+ */
+export interface JSONRPCRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown> | unknown[];
+}
+/**
+ * JSON-RPC 2.0 Response (Success)
+ */
+export interface JSONRPCSuccessResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number;
+    result: T;
+}
+/**
+ * JSON-RPC 2.0 Response (Error)
+ */
+export interface JSONRPCErrorResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * JSON-RPC 2.0 Notification (no response expected)
+ */
+export interface JSONRPCNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown> | unknown[];
+}
+/**
+ * Union type for any JSON-RPC response
+ */
+export type JSONRPCResponse<T = unknown> = JSONRPCSuccessResponse<T> | JSONRPCErrorResponse;
+/**
+ * MCP Tool Definition
+ */
+export interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * MCP Tools List Response
+ */
+export interface MCPToolsListResponse {
+    tools: MCPTool[];
+}
+/**
+ * MCP Tool Call Request Parameters
+ */
+export interface MCPToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+/**
+ * MCP Tool Call Response
+ */
+export interface MCPToolCallResponse {
+    content: Array<{
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: string;
+        mimeType?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * MCP Protocol Methods
+ */
+export declare enum MCPMethod {
+    INITIALIZE = "initialize",
+    TOOLS_LIST = "tools/list",
+    TOOLS_CALL = "tools/call",
+    RESOURCES_LIST = "resources/list",
+    RESOURCES_READ = "resources/read",
+    PROMPTS_LIST = "prompts/list",
+    PROMPTS_GET = "prompts/get"
+}
+/**
+ * Initialize request parameters
+ */
+export interface MCPInitializeParams {
+    protocolVersion: string;
+    capabilities: {
+        tools?: Record<string, unknown>;
+        resources?: Record<string, unknown>;
+        prompts?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    clientInfo: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Initialize response
+ */
+export interface MCPInitializeResponse {
+    protocolVersion: string;
+    capabilities: {
+        tools?: Record<string, unknown>;
+        resources?: Record<string, unknown>;
+        prompts?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/protocol/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"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"}

package/dist/transport/http-session.d.ts

@@ -0,0 +1,67 @@
+/**
+ * HTTP Session-Based Transport for MCP
+ * Uses POST for request/response and optional SSE for notifications
+ * Compatible with MCP StreamableHTTPServer with sessions
+ */
+import type { JSONRPCResponse, JSONRPCNotification } from "../protocol/messages.js";
+export type MessageHandler = (message: JSONRPCResponse | JSONRPCNotification) => void;
+export interface HttpSessionTransportOptions {
+    url: string;
+    headers?: Record<string, string>;
+    /** Timeout for requests in milliseconds */
+    timeout?: number;
+}
+/**
+ * HTTP Session Transport
+ * Maintains a session with the MCP server
+ * - Sends requests via POST
+ * - Receives responses in POST response body
+ * - Optionally listens for notifications via SSE
+ */
+export declare class HttpSessionTransport {
+    private url;
+    private headers;
+    private timeout;
+    private messageHandlers;
+    private sessionId?;
+    private sseController?;
+    private connected;
+    constructor(options: HttpSessionTransportOptions);
+    /**
+     * Initialize session (no persistent connection needed)
+     */
+    connect(): Promise<void>;
+    /**
+     * Send a request to the server and get immediate response
+     */
+    sendRequest<T = unknown>(method: string, params?: unknown): Promise<T>;
+    /**
+     * Start SSE listener for server-initiated notifications
+     */
+    private startSSEListener;
+    /**
+     * Process SSE stream for server notifications
+     */
+    private processSSEStream;
+    /**
+     * Handle incoming notification from SSE
+     */
+    private handleNotification;
+    /**
+     * Register a message handler for notifications
+     */
+    onMessage(handler: MessageHandler): () => void;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string | undefined;
+}
+//# sourceMappingURL=http-session.d.ts.map

package/dist/transport/http-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-session.d.ts","sourceRoot":"","sources":["../../src/transport/http-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,eAAe,GAAG,mBAAmB,KAC3C,IAAI,CAAC;AAEV,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAkB;IACxC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,2BAA2B;IAMhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,CAAC,CAAC;IAiEb;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI;IAS9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;CAGnC"}

package/dist/transport/http-stream.d.ts

@@ -0,0 +1,69 @@
+/**
+ * HTTP Streaming Transport for MCP
+ * Implements HTTP streaming with newline-delimited JSON (NDJSON)
+ * Compatible with MCP's StreamableHTTPServer
+ */
+import type { JSONRPCResponse, JSONRPCNotification } from "../protocol/messages.js";
+export type MessageHandler = (message: JSONRPCResponse | JSONRPCNotification) => void;
+export interface HttpStreamTransportOptions {
+    url: string;
+    headers?: Record<string, string>;
+    /** Timeout for requests in milliseconds */
+    timeout?: number;
+    /** Heartbeat interval in milliseconds (default: 30000) */
+    heartbeatInterval?: number;
+}
+/**
+ * HTTP Streaming Transport
+ * Handles bidirectional communication with MCP server via HTTP streaming
+ * Uses newline-delimited JSON (NDJSON) over a single persistent connection
+ */
+export declare class HttpStreamTransport {
+    private url;
+    private headers;
+    private timeout;
+    private heartbeatInterval;
+    private messageHandlers;
+    private pendingRequests;
+    private streamController?;
+    private connected;
+    private heartbeatTimer?;
+    constructor(options: HttpStreamTransportOptions);
+    /**
+     * Connect to the MCP server and establish SSE connection
+     */
+    connect(): Promise<void>;
+    /**
+     * Process incoming SSE stream
+     */
+    private processStream;
+    /**
+     * Start sending periodic heartbeats to keep connection alive
+     */
+    private startHeartbeat;
+    /**
+     * Handle incoming message from server
+     */
+    private handleMessage;
+    /**
+     * Send a raw message to the server via POST (internal use)
+     */
+    private sendRawMessage;
+    /**
+     * Send a request to the server
+     */
+    sendRequest<T = unknown>(method: string, params?: unknown): Promise<T>;
+    /**
+     * Register a message handler for notifications and other messages
+     */
+    onMessage(handler: MessageHandler): () => void;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=http-stream.d.ts.map

package/dist/transport/http-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-stream.d.ts","sourceRoot":"","sources":["../../src/transport/http-stream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AAGjC,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,eAAe,GAAG,mBAAmB,KAC3C,IAAI,CAAC;AAEV,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,eAAe,CAOT;IACd,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAiC;gBAE5C,OAAO,EAAE,0BAA0B;IAO/C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C9B;;OAEG;YACW,aAAa;IAiD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;YACW,cAAc;IAgB5B;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,CAAC,CAAC;IA8Cb;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI;IAS9C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCjC;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "integrate-sdk",
+  "version": "0.1.0",
+  "description": "Type-safe TypeScript SDK for MCP Client with plugin-based OAuth provider configuration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/integrate-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/YOUR_USERNAME/integrate-sdk/issues"
+  },
+  "homepage": "https://github.com/YOUR_USERNAME/integrate-sdk#readme",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node --format esm && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --declaration --declarationMap",
+    "dev": "bun --watch src/index.ts",
+    "type-check": "tsc --noEmit",
+    "test": "bun test tests/protocol tests/plugins tests/client tests/integration/simple-integration.test.ts",
+    "test:watch": "bun test --watch tests/protocol tests/plugins tests/client tests/integration/simple-integration.test.ts",
+    "test:unit": "bun test tests/protocol tests/plugins tests/client",
+    "test:integration": "bun test tests/integration/simple-integration.test.ts",
+    "test:coverage": "bun test --coverage tests/protocol tests/plugins tests/client tests/integration/simple-integration.test.ts"
+  },
+  "keywords": [
+    "mcp",
+    "client",
+    "sdk",
+    "typescript",
+    "oauth",
+    "plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  }
+}
+