@hasna/connectors 0.3.14 → 0.3.15

package/bin/index.js

@@ -6833,7 +6833,7 @@ var PRESETS = {
   commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
 };
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.3.14").enablePositionalOptions();
+program2.name("connectors").description("Install API connectors for your project").version("0.3.15").enablePositionalOptions();
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -8569,4 +8569,150 @@ program2.command("run").description("Execute an API operation on a connector").a
   }
   process.exit(result.exitCode);
 });
+program2.command("setup").argument("<name>", "Connector name to set up").option("-k, --key <value>", "API key or bearer token value").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("-o, --overwrite", "Overwrite existing installation", false).option("--json", "Output as JSON", false).description("Install, configure auth, and verify a connector in one step").action(async (name, options) => {
+  const meta = getConnector(name);
+  if (!meta) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `Connector '${name}' not found` }));
+    } else {
+      console.log(chalk2.red(`Connector '${name}' not found`));
+    }
+    process.exit(1);
+    return;
+  }
+  if (!options.json) {
+    console.log(chalk2.bold(`
+Setting up ${meta.displayName}...
+`));
+  }
+  const installed = getInstalledConnectors();
+  const alreadyInstalled = installed.includes(meta.name);
+  let installResult;
+  if (alreadyInstalled && !options.overwrite) {
+    installResult = { success: true, path: join6(process.cwd(), ".connectors", `connect-${meta.name}`) };
+    if (!options.json) {
+      console.log(`  ${chalk2.green("\u2713")} Already installed`);
+    }
+  } else {
+    const result = installConnector(name, { overwrite: options.overwrite });
+    installResult = { success: result.success, path: result.path, error: result.error };
+    if (!options.json) {
+      if (result.success) {
+        console.log(`  ${chalk2.green("\u2713")} Installed \u2192 ${chalk2.dim(result.path)}`);
+      } else {
+        console.log(`  ${chalk2.red("\u2717")} Install failed: ${result.error}`);
+        process.exit(1);
+        return;
+      }
+    } else if (!result.success) {
+      console.log(JSON.stringify({ error: `Install failed: ${result.error}` }));
+      process.exit(1);
+      return;
+    }
+  }
+  const authType = getAuthType(name);
+  let authConfigured = false;
+  if (authType === "oauth") {
+    if (options.key) {
+      saveApiKey(name, options.key, options.field || undefined);
+      authConfigured = true;
+      if (!options.json) {
+        console.log(`  ${chalk2.green("\u2713")} Token saved`);
+      }
+    } else {
+      const statusBefore = getAuthStatus(name);
+      if (statusBefore.configured) {
+        authConfigured = true;
+        if (!options.json) {
+          console.log(`  ${chalk2.green("\u2713")} OAuth already configured`);
+        }
+      } else {
+        if (options.json) {
+          const summary = {
+            connector: name,
+            displayName: meta.displayName,
+            installed: installResult.success,
+            path: installResult.path,
+            authType: "oauth",
+            authConfigured: false,
+            message: "OAuth requires browser-based authentication. Use 'connectors serve' or pass --key to set tokens manually."
+          };
+          console.log(JSON.stringify(summary, null, 2));
+          process.exit(0);
+          return;
+        }
+        console.log(`  ${chalk2.yellow("\u27F3")} OAuth authentication required \u2014 starting server...`);
+        try {
+          const port = 19426;
+          const { startServer: startServer2 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
+          await startServer2(port, { open: false });
+          const oauthUrl = `http://localhost:${port}/oauth/${name}/start`;
+          console.log(`
+  ${chalk2.bold("Open this URL to authenticate:")}`);
+          console.log(`  ${chalk2.cyan(oauthUrl)}
+`);
+          try {
+            const { exec } = await import("child_process");
+            const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+            exec(`${openCmd} "${oauthUrl}"`);
+            console.log(chalk2.dim(`  Browser opened. Complete the OAuth flow, then press Ctrl+C.
+`));
+          } catch {
+            console.log(chalk2.dim(`  Open the URL above in your browser.
+`));
+          }
+          await new Promise(() => {});
+        } catch (err) {
+          console.log(`  ${chalk2.red("\u2717")} OAuth flow failed: ${err}`);
+          console.log(chalk2.dim("  Try 'connectors serve' to use the full dashboard."));
+        }
+        process.exit(0);
+        return;
+      }
+    }
+  } else {
+    if (options.key) {
+      saveApiKey(name, options.key, options.field || undefined);
+      authConfigured = true;
+      if (!options.json) {
+        console.log(`  ${chalk2.green("\u2713")} ${authType === "bearer" ? "Bearer token" : "API key"} saved`);
+      }
+    } else {
+      const statusBefore = getAuthStatus(name);
+      if (statusBefore.configured) {
+        authConfigured = true;
+        if (!options.json) {
+          console.log(`  ${chalk2.green("\u2713")} Auth already configured (${authType === "bearer" ? "bearer token" : "API key"})`);
+        }
+      } else {
+        if (!options.json) {
+          console.log(`  ${chalk2.yellow("\u26A0")} No API key provided. Use --key <value> to configure auth.`);
+        }
+      }
+    }
+  }
+  const finalStatus = getAuthStatus(name);
+  if (options.json) {
+    const summary = {
+      connector: name,
+      displayName: meta.displayName,
+      installed: installResult.success,
+      path: installResult.path,
+      authType: finalStatus.type,
+      authConfigured: finalStatus.configured,
+      envVars: finalStatus.envVars,
+      tokenExpiry: finalStatus.tokenExpiry
+    };
+    console.log(JSON.stringify(summary, null, 2));
+  } else {
+    console.log();
+    console.log(chalk2.bold("  Summary"));
+    console.log(`  \u251C\u2500 Connector: ${meta.displayName}`);
+    console.log(`  \u251C\u2500 Installed: ${chalk2.green("yes")}`);
+    console.log(`  \u251C\u2500 Auth type: ${finalStatus.type === "oauth" ? "OAuth" : finalStatus.type === "apikey" ? "API Key" : "Bearer Token"}`);
+    console.log(`  \u2514\u2500 Auth:      ${finalStatus.configured ? chalk2.green("configured") : chalk2.red("not configured")}`);
+    console.log();
+  }
+  process.exit(0);
+});
 program2.parse();

package/bin/mcp.js

@@ -20315,7 +20315,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.3.14"
+  version: "0.3.15"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
@@ -20671,6 +20671,86 @@ ${result.stderr}`;
     ]
   };
 });
+server.registerTool("setup_connector", {
+  title: "Setup Connector",
+  description: "Install a connector and configure auth in one step. Installs if not already present, saves API key if provided, and returns install + auth status.",
+  inputSchema: {
+    name: exports_external.string().describe("Connector name (e.g. stripe, gmail, anthropic)"),
+    key: exports_external.string().optional().describe("API key or bearer token to save"),
+    field: exports_external.string().optional().describe("Which field to save the key as (for multi-field connectors)"),
+    overwrite: exports_external.boolean().optional().describe("Overwrite existing installation (default: false)")
+  }
+}, async ({ name, key, field, overwrite }) => {
+  const meta = getConnector(name);
+  if (!meta) {
+    return {
+      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      isError: true
+    };
+  }
+  const installed = getInstalledConnectors();
+  const alreadyInstalled = installed.includes(meta.name);
+  let installStatus;
+  if (alreadyInstalled && !overwrite) {
+    installStatus = { installed: true, path: `.connectors/connect-${meta.name}` };
+  } else {
+    const result = installConnector(name, { overwrite: overwrite ?? false });
+    if (!result.success) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              connector: name,
+              installed: false,
+              error: result.error
+            }, null, 2)
+          }
+        ],
+        isError: true
+      };
+    }
+    installStatus = { installed: true, path: result.path };
+  }
+  if (key) {
+    try {
+      saveApiKey(name, key, field);
+    } catch (error2) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              connector: name,
+              installed: installStatus.installed,
+              path: installStatus.path,
+              authError: error2 instanceof Error ? error2.message : String(error2)
+            }, null, 2)
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+  const authStatus = getAuthStatus(name);
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({
+          connector: name,
+          displayName: meta.displayName,
+          installed: installStatus.installed,
+          path: installStatus.path,
+          authType: authStatus.type,
+          authConfigured: authStatus.configured,
+          tokenExpiry: authStatus.tokenExpiry,
+          envVars: authStatus.envVars
+        }, null, 2)
+      }
+    ]
+  };
+});
 server.registerTool("search_tools", {
   title: "Search Tools",
   description: "List tool names, optionally filtered by keyword.",
@@ -20686,6 +20766,7 @@ server.registerTool("search_tools", {
     "connector_info",
     "connector_auth_status",
     "configure_auth",
+    "setup_connector",
     "list_categories",
     "list_connector_operations",
     "run_connector_operation",
@@ -20710,6 +20791,7 @@ server.registerTool("describe_tools", {
     connector_info: "Get metadata and install status. Params: name",
     connector_auth_status: "Check auth status and env vars. Params: name",
     configure_auth: "Save API key or token. Params: name, key, field?",
+    setup_connector: "Install + configure auth + verify in one call. Params: name, key?, field?, overwrite?",
     list_categories: "List connector categories with counts.",
     list_connector_operations: "Discover available API operations for a connector. Params: name, command?",
     run_connector_operation: "Execute an API operation on a connector. Params: name, args[], format?, timeout?"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {