@hasna/connectors 0.0.3 → 0.0.5

package/bin/index.js

@@ -4418,6 +4418,9 @@ function searchConnectors(query) {
   const q = query.toLowerCase();
   return CONNECTORS.filter((c) => c.name.toLowerCase().includes(q) || c.displayName.toLowerCase().includes(q) || c.description.toLowerCase().includes(q) || c.tags.some((t) => t.includes(q)));
 }
+function getConnector(name) {
+  return CONNECTORS.find((c) => c.name === name);
+}
 var versionsLoaded = false;
 function loadConnectorVersions() {
   if (versionsLoaded)
@@ -5078,7 +5081,7 @@ function Spinner({ type = "dots" }) {
 var build_default2 = Spinner;
 
 // src/lib/installer.ts
-import { existsSync as existsSync2, cpSync, mkdirSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, cpSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join2, dirname as dirname2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
@@ -5165,6 +5168,48 @@ function getInstalledConnectors(targetDir = process.cwd()) {
     return f.startsWith("connect-") && statSync(fullPath).isDirectory();
   }).map((f) => f.replace("connect-", ""));
 }
+function getConnectorDocs(name) {
+  const connectorPath = getConnectorPath(name);
+  const claudeMdPath = join2(connectorPath, "CLAUDE.md");
+  if (!existsSync2(claudeMdPath))
+    return null;
+  const raw = readFileSync2(claudeMdPath, "utf-8");
+  return {
+    overview: extractSection(raw, "Project Overview"),
+    auth: extractSection(raw, "Authentication"),
+    envVars: parseEnvVarsTable(extractSection(raw, "Environment Variables")),
+    cliCommands: extractSection(raw, "CLI Commands"),
+    dataStorage: extractSection(raw, "Data Storage"),
+    raw
+  };
+}
+function extractSection(markdown, heading) {
+  const regex = new RegExp(`^##\\s+${escapeRegex(heading)}\\s*$`, "m");
+  const match = regex.exec(markdown);
+  if (!match)
+    return "";
+  const start = match.index + match[0].length;
+  const nextHeading = markdown.slice(start).search(/^##\s/m);
+  const content = nextHeading === -1 ? markdown.slice(start) : markdown.slice(start, start + nextHeading);
+  return content.trim();
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function parseEnvVarsTable(section) {
+  if (!section)
+    return [];
+  const vars = [];
+  const lines = section.split(`
+`);
+  for (const line of lines) {
+    const match = line.match(/\|\s*`([^`]+)`\s*\|\s*(.+?)\s*\|/);
+    if (match && match[1] !== "Variable") {
+      vars.push({ variable: match[1], description: match[2].trim() });
+    }
+  }
+  return vars;
+}
 function removeConnector(name, targetDir = process.cwd()) {
   const { rmSync } = __require("fs");
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
@@ -5482,33 +5527,62 @@ function App({ initialConnectors, overwrite = false }) {
 // src/cli/index.tsx
 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.0.3");
+program2.name("connectors").description("Install API connectors for your project").version("0.0.5");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
+  if (!isTTY) {
+    console.log(`Non-interactive environment detected. Use a subcommand:
+`);
+    console.log("  connectors list              List all available connectors");
+    console.log("  connectors list --json        List as JSON (for AI agents)");
+    console.log("  connectors search <query>     Search connectors");
+    console.log("  connectors install <names...> Install connectors");
+    console.log("  connectors remove <name>      Remove a connector");
+    console.log("  connectors info <name>        Show connector details");
+    console.log("  connectors categories         List categories");
+    console.log(`
+Run 'connectors --help' for full usage.`);
+    process.exit(0);
+  }
   render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
 });
-program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", 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("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors, options) => {
   if (connectors.length === 0) {
+    if (!isTTY) {
+      console.error("Error: specify connectors to install. Example: connectors install figma stripe");
+      process.exit(1);
+    }
     render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
     return;
   }
+  const results = connectors.map((name) => installConnector(name, { overwrite: options.overwrite }));
+  if (options.json) {
+    console.log(JSON.stringify(results, null, 2));
+    process.exit(results.every((r) => r.success) ? 0 : 1);
+    return;
+  }
   console.log(chalk2.bold(`
 Installing connectors...
 `));
-  for (const name of connectors) {
-    const result = installConnector(name, { overwrite: options.overwrite });
+  for (const result of results) {
     if (result.success) {
-      console.log(chalk2.green(`\u2713 ${name}`));
+      console.log(chalk2.green(`\u2713 ${result.connector}`));
     } else {
-      console.log(chalk2.red(`\u2717 ${name}: ${result.error}`));
+      console.log(chalk2.red(`\u2717 ${result.connector}: ${result.error}`));
     }
   }
   console.log(chalk2.dim(`
 Connectors installed to .connectors/`));
+  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).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("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
   if (options.installed) {
     const installed = getInstalledConnectors();
+    if (options.json) {
+      console.log(JSON.stringify(installed));
+      return;
+    }
     if (installed.length === 0) {
       console.log(chalk2.dim("No connectors installed"));
       return;
@@ -5524,11 +5598,19 @@ Installed connectors (${installed.length}):
   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}` }));
+        process.exit(1);
+      }
       console.log(chalk2.red(`Unknown category: ${options.category}`));
       console.log(chalk2.dim(`Available: ${CATEGORIES.join(", ")}`));
       return;
     }
     const connectors = getConnectorsByCategory(category);
+    if (options.json) {
+      console.log(JSON.stringify(connectors));
+      return;
+    }
     console.log(chalk2.bold(`
 ${category} (${connectors.length}):
 `));
@@ -5539,6 +5621,10 @@ ${category} (${connectors.length}):
     }
     return;
   }
+  if (options.json) {
+    console.log(JSON.stringify(CONNECTORS));
+    return;
+  }
   console.log(chalk2.bold(`
 Available connectors (${CONNECTORS.length}):
 `));
@@ -5553,8 +5639,12 @@ Available connectors (${CONNECTORS.length}):
     console.log();
   }
 });
-program2.command("search").argument("<query>", "Search term").description("Search for connectors").action((query) => {
+program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).description("Search for connectors").action((query, options) => {
   const results = searchConnectors(query);
+  if (options.json) {
+    console.log(JSON.stringify(results));
+    return;
+  }
   if (results.length === 0) {
     console.log(chalk2.dim(`No connectors found for "${query}"`));
     return;
@@ -5568,15 +5658,139 @@ Found ${results.length} connector(s):
     console.log(`  ${chalk2.cyan(c.name.padEnd(20))}${chalk2.dim((c.version || "-").padEnd(10))}${chalk2.dim(c.category.padEnd(20))}${c.description}`);
   }
 });
-program2.command("remove").alias("rm").argument("<connector>", "Connector to remove").description("Remove an installed connector").action((connector) => {
+program2.command("info").argument("<connector>", "Connector name").option("--json", "Output as JSON", false).description("Show detailed info about a connector").action((connector, options) => {
+  const meta = getConnector(connector);
+  if (!meta) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+      process.exit(1);
+    }
+    console.log(chalk2.red(`Connector '${connector}' not found`));
+    process.exit(1);
+    return;
+  }
+  const installed = getInstalledConnectors();
+  const isInstalled = installed.includes(meta.name);
+  if (options.json) {
+    console.log(JSON.stringify({ ...meta, installed: isInstalled }));
+    return;
+  }
+  console.log(chalk2.bold(`
+${meta.displayName}`));
+  console.log(chalk2.dim(`${"\u2500".repeat(40)}`));
+  console.log(`  Name:        ${chalk2.cyan(meta.name)}`);
+  console.log(`  Version:     ${meta.version || "-"}`);
+  console.log(`  Category:    ${meta.category}`);
+  console.log(`  Description: ${meta.description}`);
+  console.log(`  Tags:        ${meta.tags.join(", ")}`);
+  console.log(`  Installed:   ${isInstalled ? chalk2.green("yes") : "no"}`);
+  console.log(`  Package:     @hasna/connect-${meta.name}`);
+});
+program2.command("docs").argument("<connector>", "Connector name").option("--json", "Output as structured JSON", false).option("--raw", "Output raw markdown", false).description("Show connector documentation (auth, env vars, API, CLI commands)").action((connector, options) => {
+  const meta = getConnector(connector);
+  if (!meta) {
+    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;
+  }
+  const docs = getConnectorDocs(connector);
+  if (!docs) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `No documentation found for '${connector}'` }));
+    } else {
+      console.log(chalk2.red(`No documentation found for '${connector}'`));
+    }
+    process.exit(1);
+    return;
+  }
+  if (options.raw) {
+    console.log(docs.raw);
+    return;
+  }
+  if (options.json) {
+    console.log(JSON.stringify({
+      name: meta.name,
+      displayName: meta.displayName,
+      version: meta.version,
+      category: meta.category,
+      description: meta.description,
+      overview: docs.overview,
+      auth: docs.auth,
+      envVars: docs.envVars,
+      cliCommands: docs.cliCommands,
+      dataStorage: docs.dataStorage
+    }, null, 2));
+    return;
+  }
+  console.log(chalk2.bold(`
+${meta.displayName} \u2014 Documentation`));
+  console.log(chalk2.dim("\u2500".repeat(50)));
+  if (docs.overview) {
+    console.log(chalk2.bold(`
+Overview`));
+    console.log(`  ${docs.overview.split(`
+`)[0]}`);
+  }
+  if (docs.auth) {
+    console.log(chalk2.bold(`
+Authentication`));
+    for (const line of docs.auth.split(`
+`).filter(Boolean)) {
+      console.log(`  ${line}`);
+    }
+  }
+  if (docs.envVars.length > 0) {
+    console.log(chalk2.bold(`
+Environment Variables`));
+    for (const v of docs.envVars) {
+      console.log(`  ${chalk2.cyan(v.variable.padEnd(30))}${v.description}`);
+    }
+  }
+  if (docs.cliCommands) {
+    console.log(chalk2.bold(`
+CLI Commands`));
+    for (const line of docs.cliCommands.split(`
+`)) {
+      console.log(`  ${line}`);
+    }
+  }
+  if (docs.dataStorage) {
+    console.log(chalk2.bold(`
+Data Storage`));
+    for (const line of docs.dataStorage.split(`
+`).filter(Boolean)) {
+      console.log(`  ${line}`);
+    }
+  }
+  console.log();
+});
+program2.command("remove").alias("rm").argument("<connector>", "Connector to remove").option("--json", "Output as JSON", false).description("Remove an installed connector").action((connector, options) => {
   const removed = removeConnector(connector);
+  if (options.json) {
+    console.log(JSON.stringify({ connector, removed }));
+    process.exit(removed ? 0 : 1);
+    return;
+  }
   if (removed) {
     console.log(chalk2.green(`\u2713 Removed ${connector}`));
   } else {
     console.log(chalk2.red(`\u2717 ${connector} is not installed`));
+    process.exit(1);
   }
 });
-program2.command("categories").description("List all categories").action(() => {
+program2.command("categories").option("--json", "Output as JSON", false).description("List all categories").action((options) => {
+  if (options.json) {
+    const data = CATEGORIES.map((category) => ({
+      name: category,
+      count: getConnectorsByCategory(category).length
+    }));
+    console.log(JSON.stringify(data));
+    return;
+  }
   console.log(chalk2.bold(`
 Categories:
 `));

package/dist/index.js

@@ -495,7 +495,7 @@ function loadConnectorVersions() {
   }
 }
 // src/lib/installer.ts
-import { existsSync as existsSync2, cpSync, mkdirSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, cpSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join2, dirname as dirname2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
@@ -588,6 +588,48 @@ function getInstalledConnectors(targetDir = process.cwd()) {
     return f.startsWith("connect-") && statSync(fullPath).isDirectory();
   }).map((f) => f.replace("connect-", ""));
 }
+function getConnectorDocs(name) {
+  const connectorPath = getConnectorPath(name);
+  const claudeMdPath = join2(connectorPath, "CLAUDE.md");
+  if (!existsSync2(claudeMdPath))
+    return null;
+  const raw = readFileSync2(claudeMdPath, "utf-8");
+  return {
+    overview: extractSection(raw, "Project Overview"),
+    auth: extractSection(raw, "Authentication"),
+    envVars: parseEnvVarsTable(extractSection(raw, "Environment Variables")),
+    cliCommands: extractSection(raw, "CLI Commands"),
+    dataStorage: extractSection(raw, "Data Storage"),
+    raw
+  };
+}
+function extractSection(markdown, heading) {
+  const regex = new RegExp(`^##\\s+${escapeRegex(heading)}\\s*$`, "m");
+  const match = regex.exec(markdown);
+  if (!match)
+    return "";
+  const start = match.index + match[0].length;
+  const nextHeading = markdown.slice(start).search(/^##\s/m);
+  const content = nextHeading === -1 ? markdown.slice(start) : markdown.slice(start, start + nextHeading);
+  return content.trim();
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function parseEnvVarsTable(section) {
+  if (!section)
+    return [];
+  const vars = [];
+  const lines = section.split(`
+`);
+  for (const line of lines) {
+    const match = line.match(/\|\s*`([^`]+)`\s*\|\s*(.+?)\s*\|/);
+    if (match && match[1] !== "Variable") {
+      vars.push({ variable: match[1], description: match[2].trim() });
+    }
+  }
+  return vars;
+}
 function removeConnector(name, targetDir = process.cwd()) {
   const { rmSync } = __require("fs");
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
@@ -609,6 +651,7 @@ export {
   getInstalledConnectors,
   getConnectorsByCategory,
   getConnectorPath,
+  getConnectorDocs,
   getConnector,
   connectorExists,
   CONNECTORS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
     "build": "bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/index.ts --outdir ./dist --target bun",
     "dev": "bun run ./src/cli/index.tsx",
     "typecheck": "tsc --noEmit",
+    "test": "bun test",
     "prepublishOnly": "bun run build"
   },
   "keywords": [