integrate-sdk 0.7.18 → 0.7.20

package/README.md

@@ -3,19 +3,19 @@
 [![Tests](https://github.com/Revyo/integrate-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/Revyo/integrate-sdk/actions/workflows/test.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A type-safe TypeScript SDK for connecting to the Integrate MCP (Model Context Protocol) server. Access GitHub, Gmail, Notion, and other integrations through a simple, plugin-based API.
+A type-safe TypeScript SDK for connecting to the Integrate MCP (Model Context Protocol) server. Access GitHub, Gmail, Notion, and other integrations through a simple, integration-based API.
 
 **📚 [Full Documentation](https://integrate.dev)** | **Server:** `https://mcp.integrate.dev/api/v1/mcp`
 
 ## Features
 
-- 🔌 **Plugin-Based Architecture** - Enable only the integrations you need
+- 🔌 **Integration-Based Architecture** - Enable only the integrations you need
 - 🔒 **Fully Typed API** - Type-safe methods with autocomplete (e.g., `client.github.createIssue()`)
 - 💡 **IntelliSense Support** - Full TypeScript support with parameter hints
 - ⚡ **Automatic Connection Management** - Lazy connection, auto-cleanup, singleton pattern
 - 🔐 **Complete OAuth Flow** - Built-in OAuth 2.0 with PKCE (popup/redirect modes)
 - 🌍 **Universal** - Works in browser and Node.js environments
-- 🛠️ **Extensible** - Configure plugins for any server-supported integration
+- 🛠️ **Extensible** - Configure integrations for any server-supported integration
 - 📦 **Zero Dependencies** - Lightweight implementation
 
 ## Installation
@@ -43,24 +43,24 @@ For production, use: `https://yourdomain.com/api/integrate/oauth/callback`
 
 ### 1. Create Server Config
 
-Define your OAuth providers once. Plugins automatically read credentials from environment variables:
+Define your OAuth providers once. Integrations automatically read credentials from environment variables:
 
 ```typescript
 // lib/integrate-server.ts (server-side only!)
 import {
   createMCPServer,
-  githubPlugin,
-  gmailPlugin,
+  githubIntegration,
+  gmailIntegration,
 } from "integrate-sdk/server";
 
-// Plugins automatically use GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, 
+// Integrations automatically use GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET,
 // GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET from environment
 export const { client: serverClient } = createMCPServer({
-  plugins: [
-    githubPlugin({
+  integrations: [
+    githubIntegration({
       scopes: ["repo", "user"],
     }),
-    gmailPlugin({
+    gmailIntegration({
       scopes: ["gmail.readonly"],
     }),
   ],
@@ -105,11 +105,11 @@ Use in your client components (no secrets needed):
 
 ```typescript
 "use client";
-import { createMCPClient, githubPlugin } from "integrate-sdk";
+import { createMCPClient, githubIntegration } from "integrate-sdk";
 
 const client = createMCPClient({
-  plugins: [
-    githubPlugin({
+  integrations: [
+    githubIntegration({
       scopes: ["repo", "user"],
       // No clientId or clientSecret needed!
     }),
@@ -150,10 +150,10 @@ The SDK automatically manages connections for you - no manual `connect()` or `di
 
 ```typescript
 // ✅ Default behavior - automatic connection
-// Plugins automatically use GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from environment
+// Integrations automatically use GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET from environment
 const client = createMCPClient({
-  plugins: [
-    githubPlugin({
+  integrations: [
+    githubIntegration({
       scopes: ["repo", "user"],
     }),
   ],
@@ -165,7 +165,7 @@ await client.github.listRepos({ username: "octocat" });
 
 // ✅ Want manual control? Use manual mode
 const manualClient = createMCPClient({
-  plugins: [githubPlugin({ scopes: ["repo"] })],
+  integrations: [githubIntegration({ scopes: ["repo"] })],
   connectionMode: "manual",
   singleton: false,
 });
@@ -189,7 +189,7 @@ See [Quick Start](#quick-start) above for complete examples.
 
 ## Why Use Integrate SDK?
 
-### Typed Plugin Methods
+### Typed Integration Methods
 
 Instead of generic tool calls, use typed methods with full autocomplete:
 
@@ -213,7 +213,7 @@ await client.gmail.sendEmail({ to: "user@example.com", subject: "Hello" });
 ### Three Ways to Call Tools
 
 ```typescript
-// 1. Typed plugin methods (recommended for built-in plugins like GitHub/Gmail)
+// 1. Typed integration methods (recommended for built-in integrations like GitHub/Gmail)
 await client.github.createIssue({
   owner: "user",
   repo: "project",
@@ -263,9 +263,9 @@ For complete OAuth setup including:
 
 See the [`/examples`](/examples) directory or [OAuth documentation](https://integrate.dev/docs/guides/oauth-flow).
 
-## Built-in Plugins
+## Built-in Integrations
 
-### GitHub Plugin
+### GitHub Integration
 
 Access GitHub repositories, issues, pull requests, and more with type-safe methods.
 
@@ -281,9 +281,9 @@ await client.github.listPullRequests({
 await client.github.listOwnRepos({});
 ```
 
-[→ GitHub plugin documentation](https://integrate.dev/docs/plugins/github)
+[→ GitHub integration documentation](https://integrate.dev/docs/integrations/github)
 
-### Gmail Plugin
+### Gmail Integration
 
 Send emails, manage labels, and search messages with type-safe methods.
 
@@ -298,17 +298,17 @@ await client.gmail.listEmails({ maxResults: 10, q: "is:unread" });
 await client.gmail.searchEmails({ query: "from:notifications@github.com" });
 ```
 
-[→ Gmail plugin documentation](https://integrate.dev/docs/plugins/gmail)
+[→ Gmail integration documentation](https://integrate.dev/docs/integrations/gmail)
 
 ### Additional Integrations
 
-Use `genericOAuthPlugin` to configure any server-supported integration:
+Use `genericOAuthIntegration` to configure any server-supported integration:
 
 ```typescript
-import { genericOAuthPlugin } from "integrate-sdk/server";
+import { genericOAuthIntegration } from "integrate-sdk/server";
 
 // Automatically uses SLACK_CLIENT_ID and SLACK_CLIENT_SECRET from environment
-const slackPlugin = genericOAuthPlugin({
+const slackIntegration = genericOAuthIntegration({
   id: "slack",
   provider: "slack",
   scopes: ["chat:write", "channels:read"],
@@ -339,7 +339,7 @@ const result = await generateText({
 });
 ```
 
-[→ View Vercel AI SDK integration guide](https://integrate.dev/docs/integrations/vercel-ai)
+[→ View Vercel AI SDK integration guide](https://integrate.dev/docs/ai/vercel-ai)
 
 ## Documentation
 
@@ -347,8 +347,8 @@ For detailed guides, API reference, and examples, visit the [complete documentat
 
 - **[Getting Started](https://integrate.dev/docs/getting-started/installation)** - Installation and quick start
 - **[OAuth Flow](https://integrate.dev/docs/guides/oauth-flow)** - OAuth 2.0 authorization guide
-- **[Plugins](https://integrate.dev/docs/plugins)** - Built-in plugins and configuration
-- **[Vercel AI SDK](https://integrate.dev/docs/integrations/vercel-ai)** - AI model integration
+- **[Integrations](https://integrate.dev/docs/integrations)** - Built-in integrations and configuration
+- **[Vercel AI SDK](https://integrate.dev/docs/ai/vercel-ai)** - AI model integration
 - **[Advanced Usage](https://integrate.dev/docs/guides/advanced-usage)** - Error handling, retries, and more
 - **[API Reference](https://integrate.dev/docs/reference/api-reference)** - Complete API documentation
 - **[Architecture](https://integrate.dev/docs/reference/architecture)** - How the SDK works

package/dist/adapters/solid-start.js

@@ -796,9 +796,9 @@ init_errors();
 function camelToSnake(str) {
   return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
 }
-function methodToToolName(methodName, pluginId) {
+function methodToToolName(methodName, integrationId) {
   const snakeCaseMethod = camelToSnake(methodName);
-  return `${pluginId}_${snakeCaseMethod}`;
+  return `${integrationId}_${snakeCaseMethod}`;
 }
 // src/oauth/window-manager.ts
 function isBrowser() {
@@ -1318,7 +1318,7 @@ var clientCache = new Map;
 var cleanupClients = new Set;
 class MCPClient {
   transport;
-  plugins;
+  integrations;
   availableTools = new Map;
   enabledToolNames = new Set;
   initialized = false;
@@ -1341,17 +1341,17 @@ class MCPClient {
     const oauthApiBase = config.oauthApiBase || "/api/integrate/oauth";
     const defaultRedirectUri = this.getDefaultRedirectUri(oauthApiBase);
     this.apiRouteBase = config.apiRouteBase || "/api/integrate";
-    this.plugins = config.plugins.map((plugin) => {
-      if (plugin.oauth && !plugin.oauth.redirectUri) {
+    this.integrations = config.integrations.map((integration) => {
+      if (integration.oauth && !integration.oauth.redirectUri) {
         return {
-          ...plugin,
+          ...integration,
           oauth: {
-            ...plugin.oauth,
+            ...integration.oauth,
             redirectUri: defaultRedirectUri
           }
         };
       }
-      return plugin;
+      return integration;
     });
     this.clientInfo = config.clientInfo || {
       name: "integrate-sdk",
@@ -1360,21 +1360,21 @@ class MCPClient {
     this.onReauthRequired = config.onReauthRequired;
     this.maxReauthRetries = config.maxReauthRetries ?? 1;
     this.oauthManager = new OAuthManager(oauthApiBase, config.oauthFlow);
-    const providers = this.plugins.filter((p) => p.oauth).map((p) => p.oauth.provider);
+    const providers = this.integrations.filter((p) => p.oauth).map((p) => p.oauth.provider);
     this.oauthManager.loadAllProviderTokens(providers);
-    for (const plugin of this.plugins) {
-      for (const toolName of plugin.tools) {
+    for (const integration of this.integrations) {
+      for (const toolName of integration.tools) {
         this.enabledToolNames.add(toolName);
       }
-      if (plugin.oauth) {
-        const hasToken = this.oauthManager.getProviderToken(plugin.oauth.provider) !== undefined;
-        this.authState.set(plugin.oauth.provider, { authenticated: hasToken });
+      if (integration.oauth) {
+        const hasToken = this.oauthManager.getProviderToken(integration.oauth.provider) !== undefined;
+        this.authState.set(integration.oauth.provider, { authenticated: hasToken });
       }
     }
-    this.github = this.createPluginProxy("github");
-    this.gmail = this.createPluginProxy("gmail");
+    this.github = this.createIntegrationProxy("github");
+    this.gmail = this.createIntegrationProxy("gmail");
     this.server = this.createServerProxy();
-    this.initializePlugins();
+    this.initializeIntegrations();
   }
   getDefaultRedirectUri(oauthApiBase) {
     if (typeof window === "undefined" || !window.location) {
@@ -1384,11 +1384,11 @@ class MCPClient {
     const normalizedPath = oauthApiBase.replace(/\/$/, "");
     return `${origin}${normalizedPath}/callback`;
   }
-  createPluginProxy(pluginId) {
+  createIntegrationProxy(integrationId) {
     return new Proxy({}, {
       get: (_target, methodName) => {
         return async (args) => {
-          const toolName = methodToToolName(methodName, pluginId);
+          const toolName = methodToToolName(methodName, integrationId);
           return await this.callToolWithRetry(toolName, args, 0);
         };
       }
@@ -1414,25 +1414,25 @@ class MCPClient {
       throw parsedError;
     }
   }
-  async initializePlugins() {
-    for (const plugin of this.plugins) {
-      if (plugin.onInit) {
-        await plugin.onInit(this);
+  async initializeIntegrations() {
+    for (const integration of this.integrations) {
+      if (integration.onInit) {
+        await integration.onInit(this);
       }
     }
   }
   async connect() {
-    for (const plugin of this.plugins) {
-      if (plugin.onBeforeConnect) {
-        await plugin.onBeforeConnect(this);
+    for (const integration of this.integrations) {
+      if (integration.onBeforeConnect) {
+        await integration.onBeforeConnect(this);
       }
     }
     await this.transport.connect();
     await this.initialize();
     await this.discoverTools();
-    for (const plugin of this.plugins) {
-      if (plugin.onAfterConnect) {
-        await plugin.onAfterConnect(this);
+    for (const integration of this.integrations) {
+      if (integration.onAfterConnect) {
+        await integration.onAfterConnect(this);
       }
     }
   }
@@ -1454,7 +1454,7 @@ class MCPClient {
       this.availableTools.set(tool.name, tool);
     }
     const enabledTools = response.tools.filter((tool) => this.enabledToolNames.has(tool.name));
-    console.log(`Discovered ${response.tools.length} tools, ${enabledTools.length} enabled by plugins`);
+    console.log(`Discovered ${response.tools.length} tools, ${enabledTools.length} enabled by integrations`);
   }
   async _callToolByName(name, args) {
     return await this.callToolWithRetry(name, args, 0);
@@ -1514,7 +1514,7 @@ class MCPClient {
   }
   async callToolWithRetry(name, args, retryCount = 0) {
     if (!this.enabledToolNames.has(name)) {
-      throw new Error(`Tool "${name}" is not enabled. Enable it by adding the appropriate plugin.`);
+      throw new Error(`Tool "${name}" is not enabled. Enable it by adding the appropriate integration.`);
     }
     const provider = this.getProviderForTool(name);
     try {
@@ -1547,9 +1547,9 @@ class MCPClient {
     }
   }
   getProviderForTool(toolName) {
-    for (const plugin of this.plugins) {
-      if (plugin.tools.includes(toolName) && plugin.oauth) {
-        return plugin.oauth.provider;
+    for (const integration of this.integrations) {
+      if (integration.tools.includes(toolName) && integration.oauth) {
+        return integration.oauth.provider;
       }
     }
     return;
@@ -1566,15 +1566,15 @@ class MCPClient {
   getEnabledTools() {
     return Array.from(this.availableTools.values()).filter((tool) => this.enabledToolNames.has(tool.name));
   }
-  getOAuthConfig(pluginId) {
-    const plugin = this.plugins.find((p) => p.id === pluginId);
-    return plugin?.oauth;
+  getOAuthConfig(integrationId) {
+    const integration = this.integrations.find((p) => p.id === integrationId);
+    return integration?.oauth;
   }
   getAllOAuthConfigs() {
     const configs = new Map;
-    for (const plugin of this.plugins) {
-      if (plugin.oauth) {
-        configs.set(plugin.id, plugin.oauth);
+    for (const integration of this.integrations) {
+      if (integration.oauth) {
+        configs.set(integration.id, integration.oauth);
       }
     }
     return configs;
@@ -1592,8 +1592,8 @@ class MCPClient {
     this.oauthManager.clearAllProviderTokens();
   }
   async disconnectProvider(provider) {
-    const plugin = this.plugins.find((p) => p.oauth?.provider === provider);
-    if (!plugin?.oauth) {
+    const integration = this.integrations.find((p) => p.oauth?.provider === provider);
+    if (!integration?.oauth) {
       throw new Error(`No OAuth configuration found for provider: ${provider}`);
     }
     try {
@@ -1612,17 +1612,17 @@ class MCPClient {
     this.clearSessionToken();
     this.oauthManager.clearAllPendingAuths();
     this.authState.clear();
-    for (const plugin of this.plugins) {
-      if (plugin.oauth) {
-        this.authState.set(plugin.oauth.provider, { authenticated: false });
+    for (const integration of this.integrations) {
+      if (integration.oauth) {
+        this.authState.set(integration.oauth.provider, { authenticated: false });
       }
     }
     this.eventEmitter.emit("auth:logout", {});
   }
   async disconnect() {
-    for (const plugin of this.plugins) {
-      if (plugin.onDisconnect) {
-        await plugin.onDisconnect(this);
+    for (const integration of this.integrations) {
+      if (integration.onDisconnect) {
+        await integration.onDisconnect(this);
       }
     }
     await this.transport.disconnect();
@@ -1646,11 +1646,11 @@ class MCPClient {
   }
   async authorizedProviders() {
     const authorized = [];
-    for (const plugin of this.plugins) {
-      if (plugin.oauth) {
-        const status = await this.oauthManager.checkAuthStatus(plugin.oauth.provider);
+    for (const integration of this.integrations) {
+      if (integration.oauth) {
+        const status = await this.oauthManager.checkAuthStatus(integration.oauth.provider);
         if (status.authorized) {
-          authorized.push(plugin.oauth.provider);
+          authorized.push(integration.oauth.provider);
         }
       }
     }
@@ -1660,15 +1660,15 @@ class MCPClient {
     return await this.oauthManager.checkAuthStatus(provider);
   }
   async authorize(provider, options) {
-    const plugin = this.plugins.find((p) => p.oauth?.provider === provider);
-    if (!plugin?.oauth) {
+    const integration = this.integrations.find((p) => p.oauth?.provider === provider);
+    if (!integration?.oauth) {
       const error = new Error(`No OAuth configuration found for provider: ${provider}`);
       this.eventEmitter.emit("auth:error", { provider, error });
       throw error;
     }
     this.eventEmitter.emit("auth:started", { provider });
     try {
-      await this.oauthManager.initiateFlow(provider, plugin.oauth, options?.returnUrl);
+      await this.oauthManager.initiateFlow(provider, integration.oauth, options?.returnUrl);
       const tokenData = this.oauthManager.getProviderToken(provider);
       if (tokenData) {
         this.eventEmitter.emit("auth:complete", {
@@ -1718,7 +1718,7 @@ class MCPClient {
   async reauthenticate(provider) {
     const state = this.authState.get(provider);
     if (!state) {
-      throw new Error(`Provider "${provider}" not found in configured plugins`);
+      throw new Error(`Provider "${provider}" not found in configured integrations`);
     }
     if (!this.onReauthRequired) {
       throw new Error("No re-authentication handler configured. Set onReauthRequired in client config.");