@hasna/connectors 0.3.13 → 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.13").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:
@@ -7951,27 +7951,48 @@ program2.command("export").option("-o, --output <file>", "Write to file instead
       if (!statSync3(entryPath).isDirectory() || !entry.startsWith("connect-"))
         continue;
       const connectorName = entry.replace(/^connect-/, "");
+      let credentials = undefined;
+      const credentialsPath = join6(entryPath, "credentials.json");
+      if (existsSync6(credentialsPath)) {
+        try {
+          credentials = JSON.parse(readFileSync5(credentialsPath, "utf-8"));
+        } catch {}
+      }
       const profilesDir = join6(entryPath, "profiles");
-      if (!existsSync6(profilesDir))
+      if (!existsSync6(profilesDir) && !credentials)
         continue;
       const profiles = {};
-      for (const pEntry of readdirSync4(profilesDir)) {
-        const pPath = join6(profilesDir, pEntry);
-        if (statSync3(pPath).isFile() && pEntry.endsWith(".json")) {
-          try {
-            profiles[pEntry.replace(/\.json$/, "")] = JSON.parse(readFileSync5(pPath, "utf-8"));
-          } catch {}
-        } else if (statSync3(pPath).isDirectory()) {
-          const configPath = join6(pPath, "config.json");
-          if (existsSync6(configPath)) {
+      if (existsSync6(profilesDir)) {
+        for (const pEntry of readdirSync4(profilesDir)) {
+          const pPath = join6(profilesDir, pEntry);
+          if (statSync3(pPath).isFile() && pEntry.endsWith(".json")) {
             try {
-              profiles[pEntry] = JSON.parse(readFileSync5(configPath, "utf-8"));
+              profiles[pEntry.replace(/\.json$/, "")] = JSON.parse(readFileSync5(pPath, "utf-8"));
             } catch {}
+          } else if (statSync3(pPath).isDirectory()) {
+            const configPath = join6(pPath, "config.json");
+            const tokensPath = join6(pPath, "tokens.json");
+            let merged = {};
+            if (existsSync6(configPath)) {
+              try {
+                merged = { ...merged, ...JSON.parse(readFileSync5(configPath, "utf-8")) };
+              } catch {}
+            }
+            if (existsSync6(tokensPath)) {
+              try {
+                merged = { ...merged, ...JSON.parse(readFileSync5(tokensPath, "utf-8")) };
+              } catch {}
+            }
+            if (Object.keys(merged).length > 0)
+              profiles[pEntry] = merged;
           }
         }
       }
-      if (Object.keys(profiles).length > 0)
-        result[connectorName] = { profiles };
+      const connectorData = { profiles };
+      if (credentials)
+        connectorData.credentials = credentials;
+      if (Object.keys(profiles).length > 0 || credentials)
+        result[connectorName] = connectorData;
     }
   }
   const exportPayload = options.includeSecrets ? { connectors: result, exportedAt: new Date().toISOString() } : { connectors: redactSecrets(result), exportedAt: new Date().toISOString(), redacted: true };
@@ -8031,9 +8052,15 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
   for (const [connectorName, connData] of Object.entries(data.connectors)) {
     if (!/^[a-z0-9-]+$/.test(connectorName))
       continue;
+    const connectorDir = join6(connectDir, `connect-${connectorName}`);
+    if (connData.credentials && typeof connData.credentials === "object") {
+      mkdirSync4(connectorDir, { recursive: true });
+      writeFileSync4(join6(connectorDir, "credentials.json"), JSON.stringify(connData.credentials, null, 2));
+      imported++;
+    }
     if (!connData.profiles || typeof connData.profiles !== "object")
       continue;
-    const profilesDir = join6(connectDir, `connect-${connectorName}`, "profiles");
+    const profilesDir = join6(connectorDir, "profiles");
     for (const [profileName, config] of Object.entries(connData.profiles)) {
       if (!config || typeof config !== "object")
         continue;
@@ -8049,7 +8076,7 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
   }
 });
 program2.command("upgrade").alias("self-update").option("--check", "Only check for updates, don't install", false).option("--json", "Output as JSON", false).description("Check for updates and upgrade to the latest version").action(async (options) => {
-  const currentVersion = "0.3.1";
+  const currentVersion = program2.version();
   try {
     const res = await fetch("https://registry.npmjs.org/@hasna/connectors/latest");
     if (!res.ok)
@@ -8542,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.13"
+  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/connectors/connect-mistral/src/utils/config.ts

@@ -77,10 +77,10 @@ export function setCurrentProfile(profile: string): void {
 }
 
 /**
- * Check if a profile exists
+ * Check if a profile exists (flat file or directory pattern)
  */
 export function profileExists(profile: string): boolean {
-  return existsSync(getProfilePath(profile));
+  return existsSync(getProfilePath(profile)) || existsSync(join(PROFILES_DIR, profile));
 }
 
 /**
@@ -93,10 +93,16 @@ export function listProfiles(): string[] {
     return [];
   }
 
-  return readdirSync(PROFILES_DIR)
-    .filter(f => f.endsWith('.json'))
-    .map(f => f.replace('.json', ''))
-    .sort();
+  const seen = new Set<string>();
+  const entries = readdirSync(PROFILES_DIR, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      seen.add(entry.name);
+    } else if (entry.name.endsWith('.json')) {
+      seen.add(entry.name.replace('.json', ''));
+    }
+  }
+  return Array.from(seen).sort();
 }
 
 /**
@@ -135,27 +141,53 @@ export function deleteProfile(profile: string): boolean {
     setCurrentProfile(DEFAULT_PROFILE);
   }
 
-  rmSync(getProfilePath(profile));
+  // Remove flat file pattern
+  const flatPath = getProfilePath(profile);
+  if (existsSync(flatPath)) {
+    rmSync(flatPath);
+  }
+
+  // Remove directory pattern
+  const dirPath = join(PROFILES_DIR, profile);
+  if (existsSync(dirPath)) {
+    rmSync(dirPath, { recursive: true });
+  }
+
   return true;
 }
 
 /**
- * Load profile config
+ * Load profile config.
+ * Checks both flat (profiles/<name>.json) and directory (profiles/<name>/config.json)
+ * patterns. Flat pattern takes precedence when both exist.
  */
 export function loadProfile(profile?: string): ProfileConfig {
   ensureConfigDir();
   const profileName = profile || getCurrentProfile();
-  const profilePath = getProfilePath(profileName);
 
-  if (!existsSync(profilePath)) {
-    return {};
+  let config: ProfileConfig = {};
+
+  // Pattern 2: profiles/<name>/config.json (directory pattern, used by dashboard)
+  const dirConfigPath = join(PROFILES_DIR, profileName, 'config.json');
+  if (existsSync(dirConfigPath)) {
+    try {
+      config = JSON.parse(readFileSync(dirConfigPath, 'utf-8'));
+    } catch {
+      // ignore
+    }
   }
 
-  try {
-    return JSON.parse(readFileSync(profilePath, 'utf-8'));
-  } catch {
-    return {};
+  // Pattern 1: profiles/<name>.json (flat pattern, used by CLI)
+  const profilePath = getProfilePath(profileName);
+  if (existsSync(profilePath)) {
+    try {
+      config = { ...config, ...JSON.parse(readFileSync(profilePath, 'utf-8')) };
+    } catch {
+      // ignore
+    }
   }
+
+  return config;
 }
 
 /**

package/package.json

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