@hasna/connectors 0.2.5 → 0.2.6

package/README.md

@@ -34,6 +34,8 @@ npx @hasna/connectors
 
 ```bash
 connectors install figma stripe github   # Install connectors
+connectors install --preset ai           # Install a preset bundle
+connectors install --category "AI & ML"  # Install entire category
 connectors install figma --overwrite     # Overwrite existing
 connectors remove figma                  # Remove a connector
 ```
@@ -49,6 +51,10 @@ connectors info stripe                   # Connector details
 connectors docs gmail                    # Auth, env vars, CLI docs
 connectors status                        # Auth status of installed connectors
 connectors doctor                        # Health check and troubleshooting
+connectors test                          # Verify API keys with real requests
+connectors whoami                        # Show setup summary
+connectors env                           # Generate .env.example
+connectors presets                       # List preset bundles
 ```
 
 ### Dashboard

package/bin/index.js

@@ -6499,12 +6499,91 @@ init_auth();
 import { readdirSync as readdirSync4, existsSync as existsSync5, statSync as statSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4 } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join5, relative } from "path";
+
+// src/lib/test-endpoints.ts
+var TEST_ENDPOINTS = {
+  anthropic: {
+    url: "https://api.anthropic.com/v1/models",
+    headers: (key) => ({ "x-api-key": key, "anthropic-version": "2023-06-01" })
+  },
+  openai: {
+    url: "https://api.openai.com/v1/models",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  xai: {
+    url: "https://api.x.ai/v1/models",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  mistral: {
+    url: "https://api.mistral.ai/v1/models",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  github: {
+    url: "https://api.github.com/user",
+    headers: (key) => ({ Authorization: `Bearer ${key}`, "User-Agent": "connectors-cli" })
+  },
+  stripe: {
+    url: "https://api.stripe.com/v1/balance",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  figma: {
+    url: "https://api.figma.com/v1/me",
+    headers: (key) => ({ "X-Figma-Token": key })
+  },
+  discord: {
+    url: "https://discord.com/api/v10/users/@me",
+    headers: (key) => ({ Authorization: `Bot ${key}` })
+  },
+  resend: {
+    url: "https://api.resend.com/domains",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  notion: {
+    url: "https://api.notion.com/v1/users/me",
+    headers: (key) => ({ Authorization: `Bearer ${key}`, "Notion-Version": "2022-06-28" })
+  },
+  exa: {
+    url: "https://api.exa.ai/search",
+    method: "POST",
+    headers: (key) => ({ "x-api-key": key, "Content-Type": "application/json" })
+  },
+  sentry: {
+    url: "https://sentry.io/api/0/",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  huggingface: {
+    url: "https://huggingface.co/api/whoami-v2",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  elevenlabs: {
+    url: "https://api.elevenlabs.io/v1/user",
+    headers: (key) => ({ "xi-api-key": key })
+  },
+  cloudflare: {
+    url: "https://api.cloudflare.com/client/v4/user/tokens/verify",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  },
+  mixpanel: {
+    url: "https://mixpanel.com/api/app/me",
+    headers: (key) => ({ Authorization: `Bearer ${key}` })
+  }
+};
+
+// src/cli/index.tsx
 import { createInterface } from "readline";
 import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 loadConnectorVersions();
 var isTTY = process.stdout.isTTY ?? false;
+var PRESETS = {
+  fullstack: { description: "Full-stack web app essentials", connectors: ["stripe", "github", "resend", "anthropic", "figma"] },
+  ai: { description: "AI and ML models", connectors: ["anthropic", "openai", "xai", "mistral", "googlegemini", "elevenlabs"] },
+  google: { description: "Google Workspace suite", connectors: ["gmail", "googledrive", "googledocs", "googlesheets", "googlecalendar", "googletasks", "googlecontacts"] },
+  social: { description: "Social media platforms", connectors: ["x", "reddit", "youtube", "tiktok", "meta", "discord", "substack"] },
+  devtools: { description: "Developer tooling", connectors: ["github", "docker", "sentry", "cloudflare", "e2b", "firecrawl"] },
+  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.2.5");
+program2.name("connectors").description("Install API connectors for your project").version("0.2.6");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -6534,7 +6613,7 @@ function listFilesRecursive(dir, base = dir) {
   }
   return files;
 }
-program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("-d, --dry-run", "Preview what would be installed without making changes", false).option("-c, --category <category>", "Install all connectors in a category").option("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors, options) => {
+program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("-d, --dry-run", "Preview what would be installed without making changes", false).option("-c, --category <category>", "Install all connectors in a category").option("--preset <preset>", "Install a preset bundle (e.g. ai, fullstack, google)").option("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors, options) => {
   if (options.category) {
     const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
     if (!category) {
@@ -6550,6 +6629,20 @@ program2.command("install").alias("add").argument("[connectors...]", "Connectors
     const categoryConnectors = getConnectorsByCategory(category).map((c) => c.name);
     connectors.push(...categoryConnectors);
   }
+  if (options.preset) {
+    const preset = PRESETS[options.preset.toLowerCase()];
+    if (!preset) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Unknown preset: ${options.preset}. Available: ${Object.keys(PRESETS).join(", ")}` }));
+      } else {
+        console.log(chalk2.red(`Unknown preset: ${options.preset}`));
+        console.log(chalk2.dim(`Available: ${Object.keys(PRESETS).join(", ")}`));
+      }
+      process.exit(1);
+      return;
+    }
+    connectors.push(...preset.connectors);
+  }
   if (connectors.length === 0) {
     if (!isTTY) {
       console.error("Error: specify connectors to install. Example: connectors install figma stripe");
@@ -7653,7 +7746,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.2.5";
+  const currentVersion = "0.2.6";
   try {
     const res = await fetch("https://registry.npmjs.org/@hasna/connectors/latest");
     if (!res.ok)
@@ -7792,4 +7885,261 @@ complete -F _connectors connectors`);
     process.exit(1);
   }
 });
+program2.command("env").option("-o, --output <file>", "Write to file instead of stdout").option("--json", "Output as JSON", false).description("Generate .env.example from installed connectors' required env vars").action((options) => {
+  const installed = getInstalledConnectors();
+  if (installed.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ vars: [], connectors: [] }));
+    } else {
+      console.log(chalk2.dim("No connectors installed. Run: connectors install <name>"));
+    }
+    return;
+  }
+  const vars = [];
+  const seen = new Set;
+  for (const name of installed) {
+    const docs = getConnectorDocs(name);
+    if (!docs?.envVars)
+      continue;
+    for (const v of docs.envVars) {
+      if (!seen.has(v.variable)) {
+        seen.add(v.variable);
+        vars.push({ variable: v.variable, description: v.description, connector: name });
+      }
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ vars, connectors: installed }, null, 2));
+    return;
+  }
+  const lines = [
+    "# Environment Variables",
+    `# Generated by connectors env (${installed.length} installed connectors)`,
+    "#"
+  ];
+  let lastConnector = "";
+  for (const v of vars) {
+    if (v.connector !== lastConnector) {
+      lines.push("");
+      lines.push(`# ${v.connector}`);
+      lastConnector = v.connector;
+    }
+    if (v.description)
+      lines.push(`# ${v.description}`);
+    lines.push(`${v.variable}=`);
+  }
+  const output = lines.join(`
+`) + `
+`;
+  if (options.output) {
+    writeFileSync4(options.output, output);
+    console.log(chalk2.green(`\u2713 Written to ${options.output} (${vars.length} variables)`));
+  } else {
+    console.log(output);
+  }
+});
+program2.command("presets").option("--json", "Output as JSON", false).description("List available connector preset bundles").action((options) => {
+  if (options.json) {
+    console.log(JSON.stringify(Object.entries(PRESETS).map(([name, p]) => ({
+      name,
+      description: p.description,
+      connectors: p.connectors,
+      count: p.connectors.length
+    })), null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+Available presets:
+`));
+  for (const [name, preset] of Object.entries(PRESETS)) {
+    console.log(`  ${chalk2.cyan(name.padEnd(12))} ${preset.description}`);
+    console.log(chalk2.dim(`  ${"".padEnd(12)} ${preset.connectors.join(", ")}`));
+    console.log();
+  }
+  console.log(chalk2.dim(`  Install with: connectors install --preset <name>
+`));
+});
+program2.command("whoami").option("--json", "Output as JSON", false).description("Show current setup: config dir, installed connectors, auth status").action((options) => {
+  const configDir = join5(homedir3(), ".connectors");
+  const installed = getInstalledConnectors();
+  const version = "0.2.6";
+  let configured = 0;
+  let unconfigured = 0;
+  const connectorDetails = [];
+  for (const name of installed) {
+    const auth = getAuthStatus(name);
+    if (auth.configured)
+      configured++;
+    else
+      unconfigured++;
+    const connectorConfigDir = join5(configDir, name.startsWith("connect-") ? name : `connect-${name}`);
+    const currentProfileFile = join5(connectorConfigDir, "current_profile");
+    let profile = "default";
+    if (existsSync5(currentProfileFile)) {
+      try {
+        profile = readFileSync5(currentProfileFile, "utf-8").trim() || "default";
+      } catch {}
+    }
+    connectorDetails.push({ name, configured: auth.configured, authType: auth.type, profile });
+  }
+  if (options.json) {
+    console.log(JSON.stringify({
+      version,
+      configDir,
+      configDirExists: existsSync5(configDir),
+      installed: installed.length,
+      configured,
+      unconfigured,
+      connectors: connectorDetails
+    }, null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+Connectors Setup
+`));
+  console.log(`  Version:      ${chalk2.cyan(version)}`);
+  console.log(`  Config:       ${configDir}${existsSync5(configDir) ? "" : chalk2.dim(" (not created yet)")}`);
+  console.log(`  Installed:    ${installed.length} connector${installed.length !== 1 ? "s" : ""}`);
+  console.log(`  Configured:   ${chalk2.green(String(configured))} ready, ${unconfigured > 0 ? chalk2.red(String(unconfigured)) : chalk2.dim("0")} need auth`);
+  if (connectorDetails.length > 0) {
+    console.log(chalk2.bold(`
+  Connectors:
+`));
+    const nameWidth = Math.max(10, ...connectorDetails.map((c) => c.name.length)) + 2;
+    for (const c of connectorDetails) {
+      const status = c.configured ? chalk2.green("\u2713") : chalk2.red("\u2717");
+      const profileLabel = c.profile !== "default" ? chalk2.dim(` [${c.profile}]`) : "";
+      console.log(`    ${status} ${chalk2.cyan(c.name.padEnd(nameWidth))}${c.authType.padEnd(8)}${profileLabel}`);
+    }
+  }
+  console.log();
+});
+program2.command("test").argument("[connector]", "Connector to test (default: all installed)").option("--json", "Output as JSON", false).option("--timeout <ms>", "Request timeout in milliseconds", "10000").description("Verify API credentials by making a real request to the connector's API").action(async (connector, options) => {
+  const timeout = parseInt(options.timeout, 10) || 1e4;
+  const installed = getInstalledConnectors();
+  let toTest;
+  if (connector) {
+    if (!getConnector(connector)) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+      } else {
+        console.log(chalk2.red(`Connector '${connector}' not found`));
+      }
+      process.exit(1);
+      return;
+    }
+    toTest = [connector];
+  } else {
+    if (installed.length === 0) {
+      if (options.json) {
+        console.log(JSON.stringify({ results: [], tested: 0 }));
+      } else {
+        console.log(chalk2.dim("No connectors installed. Run: connectors install <name>"));
+      }
+      return;
+    }
+    toTest = installed;
+  }
+  if (!options.json)
+    console.log(chalk2.bold(`
+Testing connector credentials...
+`));
+  const results = [];
+  for (const name of toTest) {
+    const auth = getAuthStatus(name);
+    const endpoint = TEST_ENDPOINTS[name];
+    if (!auth.configured) {
+      results.push({ name, status: "no-key", message: "No credentials configured" });
+      if (!options.json)
+        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim("no credentials configured")}`);
+      continue;
+    }
+    if (!endpoint) {
+      results.push({ name, status: "skip", message: "No test endpoint defined" });
+      if (!options.json)
+        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim("no test endpoint (key exists)")}`);
+      continue;
+    }
+    const docs = getConnectorDocs(name);
+    const envVars = docs?.envVars || [];
+    let apiKey;
+    for (const v of envVars) {
+      if (process.env[v.variable]) {
+        apiKey = process.env[v.variable];
+        break;
+      }
+    }
+    if (!apiKey) {
+      const connectorConfigDir = join5(homedir3(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
+      const profileFile = join5(connectorConfigDir, "profiles", "default.json");
+      if (existsSync5(profileFile)) {
+        try {
+          const config = JSON.parse(readFileSync5(profileFile, "utf-8"));
+          apiKey = Object.values(config).find((v) => typeof v === "string" && v.length > 0);
+        } catch {}
+      }
+      if (!apiKey) {
+        const profileDirConfig = join5(connectorConfigDir, "profiles", "default", "config.json");
+        if (existsSync5(profileDirConfig)) {
+          try {
+            const config = JSON.parse(readFileSync5(profileDirConfig, "utf-8"));
+            apiKey = Object.values(config).find((v) => typeof v === "string" && v.length > 0);
+          } catch {}
+        }
+      }
+    }
+    if (!apiKey) {
+      results.push({ name, status: "no-key", message: "Credentials configured but could not extract key" });
+      if (!options.json)
+        console.log(`  ${chalk2.yellow("\u26A0")} ${chalk2.yellow(name)} \u2014 ${chalk2.dim("could not extract key")}`);
+      continue;
+    }
+    const start = Date.now();
+    try {
+      const res = await fetch(endpoint.url, {
+        method: endpoint.method || "GET",
+        headers: endpoint.headers(apiKey),
+        body: endpoint.method === "POST" ? JSON.stringify({ query: "test", num_results: 1 }) : undefined,
+        signal: AbortSignal.timeout(timeout)
+      });
+      const ms = Date.now() - start;
+      const successCodes = endpoint.successCodes || [200];
+      if (successCodes.includes(res.status) || res.status >= 200 && res.status < 300) {
+        results.push({ name, status: "pass", message: `OK (${res.status})`, ms });
+        if (!options.json)
+          console.log(`  ${chalk2.green("\u2713")} ${chalk2.green(name)} \u2014 ${chalk2.dim(`${res.status} OK`)} ${chalk2.dim(`(${ms}ms)`)}`);
+      } else {
+        const body = await res.text().catch(() => "");
+        const msg = res.status === 401 ? "Invalid or expired credentials" : `HTTP ${res.status}`;
+        results.push({ name, status: "fail", message: msg, ms });
+        if (!options.json)
+          console.log(`  ${chalk2.red("\u2717")} ${chalk2.red(name)} \u2014 ${chalk2.red(msg)} ${chalk2.dim(`(${ms}ms)`)}`);
+      }
+    } catch (e) {
+      const ms = Date.now() - start;
+      const msg = e instanceof Error ? e.message : String(e);
+      results.push({ name, status: "fail", message: msg, ms });
+      if (!options.json)
+        console.log(`  ${chalk2.red("\u2717")} ${chalk2.red(name)} \u2014 ${chalk2.red(msg)}`);
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ results, tested: results.length, passed: results.filter((r) => r.status === "pass").length }, null, 2));
+  } else {
+    const passed = results.filter((r) => r.status === "pass").length;
+    const failed = results.filter((r) => r.status === "fail").length;
+    const skipped = results.filter((r) => r.status === "skip" || r.status === "no-key").length;
+    console.log();
+    const parts = [];
+    if (passed > 0)
+      parts.push(chalk2.green(`${passed} passed`));
+    if (failed > 0)
+      parts.push(chalk2.red(`${failed} failed`));
+    if (skipped > 0)
+      parts.push(chalk2.dim(`${skipped} skipped`));
+    console.log(`  ${parts.join(", ")}
+`);
+  }
+  process.exit(results.some((r) => r.status === "fail") ? 1 : 0);
+});
 program2.parse();

package/bin/mcp.js

@@ -20275,7 +20275,7 @@ function guessKeyField(name) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.2.5"
+  version: "0.2.6"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",

package/dist/lib/test-endpoints.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Test endpoint definitions for verifying API credentials.
+ * Each entry maps a connector name to its health-check endpoint.
+ */
+export interface TestEndpoint {
+    url: string;
+    method?: string;
+    headers: (key: string) => Record<string, string>;
+    /** Expected successful status codes */
+    successCodes?: number[];
+}
+export declare const TEST_ENDPOINTS: Record<string, TestEndpoint>;

package/package.json

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