integrate-sdk 0.9.56 → 0.9.61

package/dist/index.js

@@ -1675,6 +1675,25 @@ function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
   };
 }
 
+// src/database/token-store.ts
+var USABLE_ACCESS_TOKEN_BUFFER_MS = 30 * 1000;
+var MIN_MEANINGFUL_EXPIRY_MS = Date.UTC(2000, 0, 1);
+async function listConnectedProviders(configuredIntegrationIds, getProviderToken, context) {
+  if (!context.userId || configuredIntegrationIds.length === 0) {
+    return [];
+  }
+  const connected = [];
+  await Promise.all(configuredIntegrationIds.map(async (provider) => {
+    try {
+      const token = await getProviderToken(provider, undefined, context);
+      if (token?.accessToken || typeof token?.refreshToken === "string" && token.refreshToken.length > 0) {
+        connected.push(provider);
+      }
+    } catch {}
+  }));
+  return connected.sort();
+}
+
 // src/client.ts
 init_errors();
 
@@ -3645,7 +3664,7 @@ class MCPClientBase {
     logger5.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
@@ -3824,20 +3843,32 @@ class MCPClientBase {
   getEnabledTools() {
     return Array.from(this.availableTools.values()).filter((tool) => this.enabledToolNames.has(tool.name));
   }
-  async getEnabledToolsAsync() {
-    if (this.isConnected() && this.availableTools.size > 0) {
-      return this.getEnabledTools();
+  async getEnabledToolsAsync(options) {
+    const targetIntegrationIds = await this.resolveTargetIntegrationIds(options);
+    if (targetIntegrationIds.size === 0) {
+      return [];
     }
-    if (this.availableTools.size > 0) {
-      return this.getEnabledTools();
+    const filterToTargets = (tools2) => this.filterToolsToIntegrations(tools2, targetIntegrationIds);
+    const hasCompleteCache = () => {
+      for (const integration of this.integrations) {
+        if (!targetIntegrationIds.has(integration.id))
+          continue;
+        for (const toolName of integration.tools) {
+          if (!this.enabledToolNames.has(toolName))
+            continue;
+          if (!this.availableTools.has(toolName))
+            return false;
+        }
+      }
+      return this.availableTools.size > 0;
+    };
+    if (this.availableTools.size > 0 && hasCompleteCache()) {
+      return filterToTargets(this.getEnabledTools());
     }
     const tools = [];
-    const integrationIds = new Set;
-    for (const integration of this.integrations) {
-      integrationIds.add(integration.id);
-    }
     const { parallelWithLimit: parallelWithLimit2 } = await Promise.resolve().then(() => exports_concurrency);
-    const integrationToolsResults = await parallelWithLimit2(Array.from(integrationIds), async (integrationId) => {
+    const concurrency = options?.fetchConcurrency ?? 8;
+    const integrationToolsResults = await parallelWithLimit2(Array.from(targetIntegrationIds), async (integrationId) => {
       try {
         const response = await this.callServerToolInternal("list_tools_by_integration", {
           integration: integrationId
@@ -3848,25 +3879,14 @@ class MCPClientBase {
             if (item.type === "text" && item.text) {
               try {
                 const parsed = JSON.parse(item.text);
-                if (Array.isArray(parsed)) {
-                  for (const tool of parsed) {
-                    if (tool.name && tool.inputSchema) {
-                      integrationTools.push({
-                        name: tool.name,
-                        description: tool.description,
-                        inputSchema: tool.inputSchema
-                      });
-                    }
-                  }
-                } else if (parsed.tools && Array.isArray(parsed.tools)) {
-                  for (const tool of parsed.tools) {
-                    if (tool.name && tool.inputSchema) {
-                      integrationTools.push({
-                        name: tool.name,
-                        description: tool.description,
-                        inputSchema: tool.inputSchema
-                      });
-                    }
+                const parsedTools = Array.isArray(parsed) ? parsed : parsed.tools && Array.isArray(parsed.tools) ? parsed.tools : [];
+                for (const tool of parsedTools) {
+                  if (tool.name && tool.inputSchema) {
+                    integrationTools.push({
+                      name: tool.name,
+                      description: tool.description,
+                      inputSchema: tool.inputSchema
+                    });
                   }
                 }
               } catch {}
@@ -3878,14 +3898,40 @@ class MCPClientBase {
         logger5.error(`Failed to fetch tools for integration ${integrationId}:`, error);
         return [];
       }
-    }, 3);
+    }, concurrency);
     for (const integrationTools of integrationToolsResults) {
       tools.push(...integrationTools);
     }
     for (const tool of tools) {
       this.availableTools.set(tool.name, tool);
     }
-    return tools.filter((tool) => this.enabledToolNames.has(tool.name));
+    return filterToTargets(tools.filter((tool) => this.enabledToolNames.has(tool.name)));
+  }
+  async resolveTargetIntegrationIds(options) {
+    const configuredIds = this.integrations.map((integration) => integration.id);
+    const configuredSet = new Set(configuredIds);
+    if (options?.integrationIds && options.integrationIds.length > 0) {
+      return new Set(options.integrationIds.filter((id) => configuredSet.has(id)));
+    }
+    if (options?.connectedOnly && options.context?.userId) {
+      const connected = await listConnectedProviders(configuredIds, (provider, email, context) => this.oauthManager.getProviderToken(provider, email, context), options.context);
+      return new Set(connected);
+    }
+    return configuredSet;
+  }
+  filterToolsToIntegrations(tools, integrationIds) {
+    if (integrationIds.size === 0) {
+      return [];
+    }
+    const allowedNames = new Set;
+    for (const integration of this.integrations) {
+      if (!integrationIds.has(integration.id))
+        continue;
+      for (const toolName of integration.tools) {
+        allowedNames.add(toolName);
+      }
+    }
+    return tools.filter((tool) => this.enabledToolNames.has(tool.name) && allowedNames.has(tool.name));
   }
   getOAuthConfig(integrationId) {
     const integration = this.integrations.find((p) => p.id === integrationId);
@@ -14114,6 +14160,68 @@ function createSimpleIntegration(config) {
     onDisconnect: config.onDisconnect
   };
 }
+// src/utils/parse-tool-result.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getBooleanProperty(value, key) {
+  const property = value[key];
+  return typeof property === "boolean" ? property : undefined;
+}
+function getStringProperty(value, key) {
+  const property = value[key];
+  if (typeof property !== "string") {
+    return;
+  }
+  const trimmed = property.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function getStructuredContent(result) {
+  const structuredContent = result.structuredContent;
+  return isRecord(structuredContent) ? structuredContent : undefined;
+}
+function getContentText(result) {
+  const content = result.content;
+  if (!Array.isArray(content)) {
+    return;
+  }
+  for (const item of content) {
+    if (!isRecord(item)) {
+      continue;
+    }
+    const text = getStringProperty(item, "text");
+    if (text) {
+      return text;
+    }
+  }
+  return;
+}
+function isMCPToolError(result) {
+  return parseMCPToolResult(result).ok === false;
+}
+function parseMCPToolResult(result) {
+  if (!isRecord(result)) {
+    return {
+      ok: true,
+      data: result,
+      raw: result
+    };
+  }
+  const structuredContent = getStructuredContent(result);
+  const failed = getBooleanProperty(result, "isError") === true || getBooleanProperty(result, "success") === false || getBooleanProperty(structuredContent ?? {}, "isError") === true || getBooleanProperty(structuredContent ?? {}, "success") === false;
+  if (!failed) {
+    return {
+      ok: true,
+      data: structuredContent ?? result,
+      raw: result
+    };
+  }
+  return {
+    ok: false,
+    error: getStringProperty(result, "error") ?? getStringProperty(structuredContent ?? {}, "error") ?? getContentText(result) ?? "Tool returned an error result",
+    raw: result
+  };
+}
 // index.ts
 var client = createMCPClient({
   integrations: [
@@ -14326,6 +14434,7 @@ export {
   paypalIntegration,
   parseState,
   parseServerError,
+  parseMCPToolResult,
   paperIntegration,
   pandadocIntegration,
   outlookIntegration,
@@ -14360,6 +14469,7 @@ export {
   kickIntegration,
   jiraIntegration,
   isTokenExpiredError,
+  isMCPToolError,
   isAuthorizationError,
   isAuthError,
   intercomIntegration,

package/dist/integrations.js

@@ -1675,6 +1675,25 @@ function toConfiguredIntegrationWithToolMetadata(integration, toolMetadata) {
   };
 }
 
+// src/database/token-store.ts
+var USABLE_ACCESS_TOKEN_BUFFER_MS = 30 * 1000;
+var MIN_MEANINGFUL_EXPIRY_MS = Date.UTC(2000, 0, 1);
+async function listConnectedProviders(configuredIntegrationIds, getProviderToken, context) {
+  if (!context.userId || configuredIntegrationIds.length === 0) {
+    return [];
+  }
+  const connected = [];
+  await Promise.all(configuredIntegrationIds.map(async (provider) => {
+    try {
+      const token = await getProviderToken(provider, undefined, context);
+      if (token?.accessToken || typeof token?.refreshToken === "string" && token.refreshToken.length > 0) {
+        connected.push(provider);
+      }
+    } catch {}
+  }));
+  return connected.sort();
+}
+
 // src/client.ts
 init_errors();
 
@@ -3645,7 +3664,7 @@ class MCPClientBase {
     logger5.debug(`Discovered ${totalDiscovered} tools, ${enabledCount} enabled by integrations`);
   }
   async _callToolByName(name, args, options) {
-    return await this.callToolWithRetry(name, args, 0, options);
+    return await this.callTool(name, args, options);
   }
   async callTool(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
@@ -3824,20 +3843,32 @@ class MCPClientBase {
   getEnabledTools() {
     return Array.from(this.availableTools.values()).filter((tool) => this.enabledToolNames.has(tool.name));
   }
-  async getEnabledToolsAsync() {
-    if (this.isConnected() && this.availableTools.size > 0) {
-      return this.getEnabledTools();
+  async getEnabledToolsAsync(options) {
+    const targetIntegrationIds = await this.resolveTargetIntegrationIds(options);
+    if (targetIntegrationIds.size === 0) {
+      return [];
     }
-    if (this.availableTools.size > 0) {
-      return this.getEnabledTools();
+    const filterToTargets = (tools2) => this.filterToolsToIntegrations(tools2, targetIntegrationIds);
+    const hasCompleteCache = () => {
+      for (const integration of this.integrations) {
+        if (!targetIntegrationIds.has(integration.id))
+          continue;
+        for (const toolName of integration.tools) {
+          if (!this.enabledToolNames.has(toolName))
+            continue;
+          if (!this.availableTools.has(toolName))
+            return false;
+        }
+      }
+      return this.availableTools.size > 0;
+    };
+    if (this.availableTools.size > 0 && hasCompleteCache()) {
+      return filterToTargets(this.getEnabledTools());
     }
     const tools = [];
-    const integrationIds = new Set;
-    for (const integration of this.integrations) {
-      integrationIds.add(integration.id);
-    }
     const { parallelWithLimit: parallelWithLimit2 } = await Promise.resolve().then(() => exports_concurrency);
-    const integrationToolsResults = await parallelWithLimit2(Array.from(integrationIds), async (integrationId) => {
+    const concurrency = options?.fetchConcurrency ?? 8;
+    const integrationToolsResults = await parallelWithLimit2(Array.from(targetIntegrationIds), async (integrationId) => {
       try {
         const response = await this.callServerToolInternal("list_tools_by_integration", {
           integration: integrationId
@@ -3848,25 +3879,14 @@ class MCPClientBase {
             if (item.type === "text" && item.text) {
               try {
                 const parsed = JSON.parse(item.text);
-                if (Array.isArray(parsed)) {
-                  for (const tool of parsed) {
-                    if (tool.name && tool.inputSchema) {
-                      integrationTools.push({
-                        name: tool.name,
-                        description: tool.description,
-                        inputSchema: tool.inputSchema
-                      });
-                    }
-                  }
-                } else if (parsed.tools && Array.isArray(parsed.tools)) {
-                  for (const tool of parsed.tools) {
-                    if (tool.name && tool.inputSchema) {
-                      integrationTools.push({
-                        name: tool.name,
-                        description: tool.description,
-                        inputSchema: tool.inputSchema
-                      });
-                    }
+                const parsedTools = Array.isArray(parsed) ? parsed : parsed.tools && Array.isArray(parsed.tools) ? parsed.tools : [];
+                for (const tool of parsedTools) {
+                  if (tool.name && tool.inputSchema) {
+                    integrationTools.push({
+                      name: tool.name,
+                      description: tool.description,
+                      inputSchema: tool.inputSchema
+                    });
                   }
                 }
               } catch {}
@@ -3878,14 +3898,40 @@ class MCPClientBase {
         logger5.error(`Failed to fetch tools for integration ${integrationId}:`, error);
         return [];
       }
-    }, 3);
+    }, concurrency);
     for (const integrationTools of integrationToolsResults) {
       tools.push(...integrationTools);
     }
     for (const tool of tools) {
       this.availableTools.set(tool.name, tool);
     }
-    return tools.filter((tool) => this.enabledToolNames.has(tool.name));
+    return filterToTargets(tools.filter((tool) => this.enabledToolNames.has(tool.name)));
+  }
+  async resolveTargetIntegrationIds(options) {
+    const configuredIds = this.integrations.map((integration) => integration.id);
+    const configuredSet = new Set(configuredIds);
+    if (options?.integrationIds && options.integrationIds.length > 0) {
+      return new Set(options.integrationIds.filter((id) => configuredSet.has(id)));
+    }
+    if (options?.connectedOnly && options.context?.userId) {
+      const connected = await listConnectedProviders(configuredIds, (provider, email, context) => this.oauthManager.getProviderToken(provider, email, context), options.context);
+      return new Set(connected);
+    }
+    return configuredSet;
+  }
+  filterToolsToIntegrations(tools, integrationIds) {
+    if (integrationIds.size === 0) {
+      return [];
+    }
+    const allowedNames = new Set;
+    for (const integration of this.integrations) {
+      if (!integrationIds.has(integration.id))
+        continue;
+      for (const toolName of integration.tools) {
+        allowedNames.add(toolName);
+      }
+    }
+    return tools.filter((tool) => this.enabledToolNames.has(tool.name) && allowedNames.has(tool.name));
   }
   getOAuthConfig(integrationId) {
     const integration = this.integrations.find((p) => p.id === integrationId);
@@ -14114,6 +14160,68 @@ function createSimpleIntegration(config) {
     onDisconnect: config.onDisconnect
   };
 }
+// src/utils/parse-tool-result.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getBooleanProperty(value, key) {
+  const property = value[key];
+  return typeof property === "boolean" ? property : undefined;
+}
+function getStringProperty(value, key) {
+  const property = value[key];
+  if (typeof property !== "string") {
+    return;
+  }
+  const trimmed = property.trim();
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function getStructuredContent(result) {
+  const structuredContent = result.structuredContent;
+  return isRecord(structuredContent) ? structuredContent : undefined;
+}
+function getContentText(result) {
+  const content = result.content;
+  if (!Array.isArray(content)) {
+    return;
+  }
+  for (const item of content) {
+    if (!isRecord(item)) {
+      continue;
+    }
+    const text = getStringProperty(item, "text");
+    if (text) {
+      return text;
+    }
+  }
+  return;
+}
+function isMCPToolError(result) {
+  return parseMCPToolResult(result).ok === false;
+}
+function parseMCPToolResult(result) {
+  if (!isRecord(result)) {
+    return {
+      ok: true,
+      data: result,
+      raw: result
+    };
+  }
+  const structuredContent = getStructuredContent(result);
+  const failed = getBooleanProperty(result, "isError") === true || getBooleanProperty(result, "success") === false || getBooleanProperty(structuredContent ?? {}, "isError") === true || getBooleanProperty(structuredContent ?? {}, "success") === false;
+  if (!failed) {
+    return {
+      ok: true,
+      data: structuredContent ?? result,
+      raw: result
+    };
+  }
+  return {
+    ok: false,
+    error: getStringProperty(result, "error") ?? getStringProperty(structuredContent ?? {}, "error") ?? getContentText(result) ?? "Tool returned an error result",
+    raw: result
+  };
+}
 export {
   zoomIntegration,
   zohoWriterIntegration,
@@ -14212,6 +14320,7 @@ export {
   paypalIntegration,
   parseState,
   parseServerError,
+  parseMCPToolResult,
   paperIntegration,
   pandadocIntegration,
   outlookIntegration,
@@ -14246,6 +14355,7 @@ export {
   kickIntegration,
   jiraIntegration,
   isTokenExpiredError,
+  isMCPToolError,
   isAuthorizationError,
   isAuthError,
   intercomIntegration,

package/dist/react.d.ts

@@ -3,6 +3,6 @@
  *
  * @packageDocumentation
  */
-export { useIntegrateTokens, useIntegrateAI } from "./src/react/hooks.js";
-export type { UseIntegrateTokensResult, UseIntegrateAIOptions } from "./src/react/hooks.js";
+export { useIntegrateTokens, useIntegrateAI, useIntegrateAuth, } from "./src/react/hooks.js";
+export type { UseIntegrateTokensResult, UseIntegrateAIOptions, UseIntegrateAuthResult, } from "./src/react/hooks.js";
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC"}

package/dist/react.js

@@ -202,7 +202,93 @@ function useIntegrateAI(client, options = {}) {
     };
   }, [client, apiPattern, debug]);
 }
+function useIntegrateAuth(client, provider, options) {
+  const [isAuthorized, setIsAuthorized] = useState(false);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refresh = async () => {
+    if (!client) {
+      setIsAuthorized(false);
+      setIsLoading(false);
+      return;
+    }
+    try {
+      const authorized = await client.isAuthorized(provider, options?.email);
+      setIsAuthorized(authorized);
+      setError(null);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  useEffect(() => {
+    if (!client || !isReactHooksAvailable()) {
+      setIsLoading(false);
+      return;
+    }
+    refresh();
+    const onChange = () => {
+      refresh();
+    };
+    const onError = (event) => {
+      const payload = event;
+      if (payload.provider === provider) {
+        setError(payload.error ?? "Authorization failed");
+      }
+    };
+    client.on("auth:complete", onChange);
+    client.on("auth:disconnect", onChange);
+    client.on("auth:logout", onChange);
+    client.on("auth:error", onError);
+    return () => {
+      client.off("auth:complete", onChange);
+      client.off("auth:disconnect", onChange);
+      client.off("auth:logout", onChange);
+      client.off("auth:error", onError);
+    };
+  }, [client, provider, options?.email]);
+  const authorize = async () => {
+    if (!client)
+      return;
+    setError(null);
+    setIsLoading(true);
+    try {
+      await client.authorize(provider, options?.returnUrl ? { returnUrl: options.returnUrl } : undefined);
+      await refresh();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setIsLoading(false);
+    }
+  };
+  const disconnect = async (email) => {
+    if (!client)
+      return;
+    setError(null);
+    setIsLoading(true);
+    try {
+      if (email) {
+        await client.disconnectAccount(provider, email);
+      } else {
+        await client.disconnectProvider(provider);
+      }
+      await refresh();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : String(err));
+      setIsLoading(false);
+    }
+  };
+  return {
+    isAuthorized,
+    isLoading,
+    error,
+    authorize,
+    disconnect,
+    refresh
+  };
+}
 export {
   useIntegrateTokens,
+  useIntegrateAuth,
   useIntegrateAI
 };