@hasna/connectors 0.2.4 → 0.2.5

package/bin/index.js

@@ -6496,14 +6496,15 @@ function App({ initialConnectors, overwrite = false }) {
 init_registry();
 init_installer();
 init_auth();
-import { readdirSync as readdirSync4, statSync as statSync3 } from "fs";
+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";
 import { createInterface } from "readline";
 import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 loadConnectorVersions();
 var isTTY = process.stdout.isTTY ?? false;
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.2.4");
+program2.name("connectors").description("Install API connectors for your project").version("0.2.5");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -6533,7 +6534,22 @@ 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("--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("--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) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Unknown category: ${options.category}. Available: ${CATEGORIES.join(", ")}` }));
+      } else {
+        console.log(chalk2.red(`Unknown category: ${options.category}`));
+        console.log(chalk2.dim(`Available: ${CATEGORIES.join(", ")}`));
+      }
+      process.exit(1);
+      return;
+    }
+    const categoryConnectors = getConnectorsByCategory(category).map((c) => c.name);
+    connectors.push(...categoryConnectors);
+  }
   if (connectors.length === 0) {
     if (!isTTY) {
       console.error("Error: specify connectors to install. Example: connectors install figma stripe");
@@ -6665,7 +6681,41 @@ Next steps:`));
   }
   process.exit(results.every((r) => r.success) ? 0 : 1);
 });
-program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available connectors", false).option("-i, --installed", "Show only installed connectors", false).option("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
+program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available connectors", false).option("-i, --installed", "Show only installed connectors", false).option("-b, --brief", "Output only connector names", false).option("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
+  if (options.brief) {
+    if (options.installed) {
+      const installed = getInstalledConnectors();
+      if (options.json) {
+        console.log(JSON.stringify(installed));
+      } else {
+        for (const name of installed)
+          console.log(name);
+      }
+    } else if (options.category) {
+      const category = CATEGORIES.find((c) => c.toLowerCase() === options.category.toLowerCase());
+      if (!category) {
+        console.error(`Unknown category: ${options.category}`);
+        process.exit(1);
+        return;
+      }
+      const names = getConnectorsByCategory(category).map((c) => c.name);
+      if (options.json) {
+        console.log(JSON.stringify(names));
+      } else {
+        for (const n of names)
+          console.log(n);
+      }
+    } else {
+      const names = CONNECTORS.map((c) => c.name);
+      if (options.json) {
+        console.log(JSON.stringify(names));
+      } else {
+        for (const n of names)
+          console.log(n);
+      }
+    }
+    return;
+  }
   if (options.installed) {
     const installed = getInstalledConnectors();
     if (installed.length === 0) {
@@ -7284,13 +7334,10 @@ Open this URL to authenticate:
         connector,
         authType,
         configured: statusAfter2.configured,
-        field: options.field || null
+        field: options.field || "apiKey"
       }));
     } else {
-      console.log(chalk2.green(`\u2713 API key saved for ${meta.displayName}`));
-      if (options.field) {
-        console.log(chalk2.dim(`  Field: ${options.field}`));
-      }
+      console.log(chalk2.green(`\u2713 Saved ${options.field || "apiKey"} for ${meta.displayName}`));
     }
     process.exit(0);
     return;
@@ -7503,4 +7550,246 @@ Next steps:
   console.log();
   process.exit(results.every((r) => r.success) ? 0 : 1);
 });
+program2.command("export").option("-o, --output <file>", "Write to file instead of stdout").description("Export all connector credentials as JSON backup").action((options) => {
+  const connectDir = join5(homedir3(), ".connectors");
+  const result = {};
+  if (existsSync5(connectDir)) {
+    for (const entry of readdirSync4(connectDir)) {
+      const entryPath = join5(connectDir, entry);
+      if (!statSync3(entryPath).isDirectory() || !entry.startsWith("connect-"))
+        continue;
+      const connectorName = entry.replace(/^connect-/, "");
+      const profilesDir = join5(entryPath, "profiles");
+      if (!existsSync5(profilesDir))
+        continue;
+      const profiles = {};
+      for (const pEntry of readdirSync4(profilesDir)) {
+        const pPath = join5(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 = join5(pPath, "config.json");
+          if (existsSync5(configPath)) {
+            try {
+              profiles[pEntry] = JSON.parse(readFileSync5(configPath, "utf-8"));
+            } catch {}
+          }
+        }
+      }
+      if (Object.keys(profiles).length > 0)
+        result[connectorName] = { profiles };
+    }
+  }
+  const exportData = JSON.stringify({ connectors: result, exportedAt: new Date().toISOString() }, null, 2);
+  if (options.output) {
+    writeFileSync4(options.output, exportData);
+    console.log(chalk2.green(`\u2713 Exported to ${options.output}`));
+  } else {
+    console.log(exportData);
+  }
+});
+program2.command("import").argument("<file>", "JSON backup file to import (use - for stdin)").option("--json", "Output as JSON", false).description("Import connector credentials from a JSON backup").action(async (file, options) => {
+  let raw;
+  if (file === "-") {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+      chunks.push(chunk.toString());
+    raw = chunks.join("");
+  } else {
+    if (!existsSync5(file)) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `File not found: ${file}` }));
+      } else {
+        console.log(chalk2.red(`File not found: ${file}`));
+      }
+      process.exit(1);
+      return;
+    }
+    raw = readFileSync5(file, "utf-8");
+  }
+  let data;
+  try {
+    data = JSON.parse(raw);
+  } catch {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "Invalid JSON" }));
+    } else {
+      console.log(chalk2.red("Invalid JSON in import file"));
+    }
+    process.exit(1);
+    return;
+  }
+  if (!data.connectors || typeof data.connectors !== "object") {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "Invalid format: missing 'connectors' object" }));
+    } else {
+      console.log(chalk2.red("Invalid format: missing 'connectors' object"));
+    }
+    process.exit(1);
+    return;
+  }
+  const connectDir = join5(homedir3(), ".connectors");
+  let imported = 0;
+  for (const [connectorName, connData] of Object.entries(data.connectors)) {
+    if (!/^[a-z0-9-]+$/.test(connectorName))
+      continue;
+    if (!connData.profiles || typeof connData.profiles !== "object")
+      continue;
+    const profilesDir = join5(connectDir, `connect-${connectorName}`, "profiles");
+    for (const [profileName, config] of Object.entries(connData.profiles)) {
+      if (!config || typeof config !== "object")
+        continue;
+      mkdirSync4(profilesDir, { recursive: true });
+      writeFileSync4(join5(profilesDir, `${profileName}.json`), JSON.stringify(config, null, 2));
+      imported++;
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ success: true, imported }));
+  } else {
+    console.log(chalk2.green(`\u2713 Imported ${imported} profile(s)`));
+  }
+});
+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";
+  try {
+    const res = await fetch("https://registry.npmjs.org/@hasna/connectors/latest");
+    if (!res.ok)
+      throw new Error(`npm registry returned ${res.status}`);
+    const data = await res.json();
+    const latestVersion = data.version;
+    const isUpToDate = currentVersion === latestVersion;
+    if (options.json) {
+      console.log(JSON.stringify({ current: currentVersion, latest: latestVersion, upToDate: isUpToDate }));
+      if (options.check) {
+        process.exit(isUpToDate ? 0 : 1);
+        return;
+      }
+    } else {
+      console.log(`
+  Current: ${chalk2.cyan(currentVersion)}`);
+      console.log(`  Latest:  ${chalk2.cyan(latestVersion)}`);
+      if (isUpToDate) {
+        console.log(chalk2.green(`
+  Already up to date!
+`));
+        process.exit(0);
+        return;
+      }
+      console.log(chalk2.yellow(`
+  Update available: ${currentVersion} \u2192 ${latestVersion}`));
+    }
+    if (options.check) {
+      if (!options.json)
+        console.log(chalk2.dim(`
+  Run 'connectors upgrade' to install.
+`));
+      process.exit(isUpToDate ? 0 : 1);
+      return;
+    }
+    if (!options.json)
+      console.log(chalk2.dim(`
+  Upgrading...`));
+    const { execSync } = await import("child_process");
+    try {
+      execSync(`bun install -g @hasna/connectors@${latestVersion}`, { stdio: options.json ? "pipe" : "inherit" });
+    } catch {
+      try {
+        execSync(`npm install -g @hasna/connectors@${latestVersion}`, { stdio: options.json ? "pipe" : "inherit" });
+      } catch (e) {
+        if (options.json) {
+          console.log(JSON.stringify({ error: "Failed to upgrade. Try manually: bun install -g @hasna/connectors@latest" }));
+        } else {
+          console.log(chalk2.red(`
+  Failed to upgrade. Try manually:`));
+          console.log(chalk2.dim(`  bun install -g @hasna/connectors@latest
+`));
+        }
+        process.exit(1);
+        return;
+      }
+    }
+    if (options.json) {
+      console.log(JSON.stringify({ upgraded: true, from: currentVersion, to: latestVersion }));
+    } else {
+      console.log(chalk2.green(`
+  Upgraded to ${latestVersion}!
+`));
+    }
+  } catch (e) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: e instanceof Error ? e.message : "Failed to check for updates" }));
+    } else {
+      console.log(chalk2.red(`
+  Failed to check for updates: ${e instanceof Error ? e.message : e}
+`));
+    }
+    process.exit(1);
+  }
+});
+program2.command("completions").argument("<shell>", "Shell type: bash, zsh, or fish").description("Output shell completion script").action((shell) => {
+  const commands = ["interactive", "install", "list", "search", "info", "docs", "remove", "categories", "serve", "update", "status", "doctor", "auth", "init", "export", "import", "upgrade", "completions"];
+  const connectorNames = CONNECTORS.map((c) => c.name);
+  const categoryNames = CATEGORIES.map((c) => `"${c}"`);
+  if (shell === "zsh") {
+    console.log(`#compdef connectors
+_connectors() {
+  local -a commands connectors categories
+  commands=(${commands.join(" ")})
+  connectors=(${connectorNames.join(" ")})
+  categories=(${categoryNames.map((c) => c.replace(/"/g, "\\\"")).join(" ")})
+
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+  elif (( CURRENT == 3 )); then
+    case "\${words[2]}" in
+      install|add|info|docs|remove|rm|auth)
+        _describe 'connector' connectors ;;
+      search) _message 'search query' ;;
+      list|ls) _arguments '--category[Filter by category]:category:(${CATEGORIES.join(" ").replace(/&/g, "\\&")})' '--installed' '--json' '--brief' ;;
+      *) ;;
+    esac
+  fi
+}
+compdef _connectors connectors`);
+  } else if (shell === "bash") {
+    console.log(`_connectors() {
+  local cur prev commands connectors
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  commands="${commands.join(" ")}"
+  connectors="${connectorNames.join(" ")}"
+
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+  elif [[ \${COMP_CWORD} -eq 2 ]]; then
+    case "\${prev}" in
+      install|add|info|docs|remove|rm|auth)
+        COMPREPLY=( $(compgen -W "\${connectors}" -- "\${cur}") ) ;;
+    esac
+  fi
+}
+complete -F _connectors connectors`);
+  } else if (shell === "fish") {
+    let script = `# Fish completions for connectors
+`;
+    for (const cmd of commands) {
+      script += `complete -c connectors -n "__fish_use_subcommand" -a "${cmd}"
+`;
+    }
+    script += `# Connector names for install/info/docs/remove/auth
+`;
+    for (const name of connectorNames) {
+      script += `complete -c connectors -n "__fish_seen_subcommand_from install add info docs remove rm auth" -a "${name}"
+`;
+    }
+    console.log(script);
+  } else {
+    console.error(`Unknown shell: ${shell}. Supported: bash, zsh, fish`);
+    process.exit(1);
+  }
+});
 program2.parse();

package/bin/mcp.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
   "scripts": {
     "build": "cd dashboard && bun run build && cd .. && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/serve.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --outDir ./dist",
     "build:dashboard": "cd dashboard && bun run build",
-    "postinstall": "cd dashboard && bun install",
+    "postinstall": "[ \"$SKIP_DASHBOARD\" = \"1\" ] || [ -d dashboard/node_modules ] || (cd dashboard && bun install)",
     "dev": "bun run ./src/cli/index.tsx",
     "typecheck": "tsc --noEmit",
     "test": "bun test",