integrate-sdk 0.3.7 → 0.3.8

package/src/plugins/types.ts

@@ -1,89 +0,0 @@
-/**
- * Plugin System Types
- * Inspired by BetterAuth's provider pattern
- */
-
-import type { MCPClient } from "../client.js";
-
-/**
- * OAuth Configuration for a plugin
- * 
- * CLIENT-SIDE: You no longer need to provide clientId/clientSecret in the browser.
- * These should be kept server-side in your OAuth API routes for security.
- * 
- * SERVER-SIDE: OAuth credentials are provided via API route configuration
- * using createNextOAuthHandler() or createTanStackOAuthHandler().
- */
-export interface OAuthConfig {
-  /** OAuth provider identifier (e.g., 'github', 'google') */
-  provider: string;
-  
-  /** 
-   * OAuth client ID (optional - only needed for legacy direct MCP server calls)
-   * @deprecated Keep client ID server-side in OAuth API route configuration
-   */
-  clientId?: string | undefined;
-  
-  /** 
-   * OAuth client secret (optional - only needed for legacy direct MCP server calls)
-   * @deprecated Keep client secret server-side in OAuth API route configuration
-   */
-  clientSecret?: string | undefined;
-  
-  /** Required OAuth scopes */
-  scopes: string[];
-  
-  /** Redirect URI for OAuth flow */
-  redirectUri?: string;
-  
-  /** Provider-specific configuration */
-  config?: unknown;
-}
-
-/**
- * MCP Plugin Interface
- * 
- * Plugins enable specific tools and configure OAuth providers
- */
-export interface MCPPlugin {
-  /** Unique plugin identifier */
-  id: string;
-  
-  /** List of tool names this plugin enables */
-  tools: string[];
-  
-  /** OAuth configuration for this plugin */
-  oauth?: OAuthConfig;
-  
-  /** Called when the plugin is initialized with the client */
-  onInit?: (client: MCPClient<any>) => Promise<void> | void;
-  
-  /** Called before the client connects to the server */
-  onBeforeConnect?: (client: MCPClient<any>) => Promise<void> | void;
-  
-  /** Called after the client successfully connects */
-  onAfterConnect?: (client: MCPClient<any>) => Promise<void> | void;
-  
-  /** Called when the client disconnects */
-  onDisconnect?: (client: MCPClient<any>) => 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 function hasOAuthConfig(
-  plugin: MCPPlugin
-): plugin is MCPPlugin & { oauth: OAuthConfig } {
-  return plugin.oauth !== undefined;
-}
-

package/src/protocol/jsonrpc.ts

@@ -1,88 +0,0 @@
-/**
- * JSON-RPC 2.0 Implementation
- */
-
-import type {
-  JSONRPCRequest,
-  JSONRPCResponse,
-  JSONRPCNotification,
-} from "./messages.js";
-
-/**
- * Generate a unique request ID
- */
-let requestIdCounter = 0;
-export function generateRequestId(): number {
-  return ++requestIdCounter;
-}
-
-/**
- * Create a JSON-RPC request
- */
-export function createRequest(
-  method: string,
-  params?: unknown
-): JSONRPCRequest {
-  return {
-    jsonrpc: "2.0",
-    id: generateRequestId(),
-    method,
-    params: params as Record<string, unknown> | unknown[] | undefined,
-  };
-}
-
-/**
- * Create a JSON-RPC notification (no response expected)
- */
-export function createNotification(
-  method: string,
-  params?: unknown
-): JSONRPCNotification {
-  return {
-    jsonrpc: "2.0",
-    method,
-    params: params as Record<string, unknown> | unknown[] | undefined,
-  };
-}
-
-/**
- * Check if a response is an error
- */
-export function isErrorResponse(
-  response: JSONRPCResponse
-): response is JSONRPCResponse & { error: NonNullable<unknown> } {
-  return "error" in response;
-}
-
-/**
- * Extract result from a successful response
- */
-export function getResult<T>(response: JSONRPCResponse<T>): T {
-  if (isErrorResponse(response)) {
-    throw new Error(
-      `JSON-RPC Error ${response.error.code}: ${response.error.message}`
-    );
-  }
-  return response.result;
-}
-
-/**
- * Parse a JSON-RPC message from string
- */
-export function parseMessage(message: string): JSONRPCResponse | JSONRPCNotification {
-  try {
-    return JSON.parse(message);
-  } catch (error) {
-    throw new Error(`Failed to parse JSON-RPC message: ${error}`);
-  }
-}
-
-/**
- * Serialize a JSON-RPC message to string
- */
-export function serializeMessage(
-  message: JSONRPCRequest | JSONRPCNotification
-): string {
-  return JSON.stringify(message);
-}
-

package/src/protocol/messages.ts

@@ -1,145 +0,0 @@
-/**
- * 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;
-  structuredContent?: Record<string, unknown>;
-  _meta?: Record<string, unknown>;
-}
-
-/**
- * MCP Protocol Methods
- */
-export 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;
-  };
-}
-

package/src/server.ts

@@ -1,117 +0,0 @@
-/**
- * Server-Side SDK
- * Use this for server-side configuration with OAuth secrets
- */
-
-import { MCPClient } from './client.js';
-import type { MCPClientConfig } from './config/types.js';
-import type { MCPPlugin } from './plugins/types.js';
-
-/**
- * Create MCP Server instance with OAuth secrets
- * 
- * This is for SERVER-SIDE ONLY - includes OAuth secrets from environment variables.
- * Use this in your server configuration file (e.g., lib/integrate-server.ts)
- * 
- * @example
- * ```typescript
- * // lib/integrate-server.ts (server-side only!)
- * import { createMCPServer, githubPlugin, gmailPlugin } from 'integrate-sdk/server';
- * 
- * export const { client: serverClient, POST, GET } = createMCPServer({
- *   plugins: [
- *     githubPlugin({
- *       clientId: process.env.GITHUB_CLIENT_ID!,
- *       clientSecret: process.env.GITHUB_CLIENT_SECRET!,
- *       scopes: ['repo', 'user'],
- *     }),
- *     gmailPlugin({
- *       clientId: process.env.GMAIL_CLIENT_ID!,
- *       clientSecret: process.env.GMAIL_CLIENT_SECRET!,
- *       scopes: ['gmail.readonly'],
- *     }),
- *   ],
- * });
- * ```
- * 
- * Then in your route file:
- * ```typescript
- * // app/api/integrate/oauth/[action]/route.ts
- * export { POST, GET } from '@/lib/integrate-server';
- * ```
- */
-export function createMCPServer<TPlugins extends readonly MCPPlugin[]>(
-  config: MCPClientConfig<TPlugins>
-) {
-  // Validate we're on the server
-  if (typeof window !== 'undefined') {
-    throw new Error(
-      'createMCPServer() should only be called on the server-side. ' +
-      'Use createMCPClient() for client-side code.'
-    );
-  }
-
-  // Extract OAuth providers from plugins
-  const providers: Record<string, {
-    clientId: string;
-    clientSecret: string;
-    redirectUri?: string;
-  }> = {};
-
-  for (const plugin of config.plugins) {
-    if (plugin.oauth) {
-      const { clientId, clientSecret, redirectUri } = plugin.oauth;
-      
-      if (!clientId || !clientSecret) {
-        console.warn(
-          `Warning: Plugin "${plugin.id}" is missing OAuth credentials. ` +
-          `Provide clientId and clientSecret in the plugin configuration.`
-        );
-        continue;
-      }
-
-      providers[plugin.id] = {
-        clientId,
-        clientSecret,
-        redirectUri,
-      };
-    }
-  }
-
-  // Create the client instance
-  const client = new MCPClient(config);
-
-  // Create route handlers with the provider configuration
-  const { POST, GET } = createOAuthRouteHandlers({ providers });
-
-  return {
-    /** Server-side MCP client instance */
-    client,
-    
-    /** OAuth POST handler - export this from your route file */
-    POST,
-    
-    /** OAuth GET handler - export this from your route file */
-    GET,
-  };
-}
-
-/**
- * Create OAuth route handlers for Next.js App Router
- * Internal function used by createMCPServer
- */
-function createOAuthRouteHandlers(config: { providers: Record<string, any> }) {
-  const { createNextOAuthHandler } = require('./adapters/nextjs.js');
-  const handler = createNextOAuthHandler(config);
-  return handler.createRoutes();
-}
-
-// Re-export plugin types for convenience
-export type { MCPPlugin } from './plugins/types.js';
-export type { MCPClientConfig } from './config/types.js';
-
-// Re-export plugins
-export { githubPlugin } from './plugins/github.js';
-export { gmailPlugin } from './plugins/gmail.js';
-export { genericOAuthPlugin, createSimplePlugin } from './plugins/generic.js';
-