@hasna/connectors 0.0.4 → 0.0.6

package/bin/index.js

@@ -5081,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));
@@ -5168,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}`;
@@ -5487,7 +5529,7 @@ 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.4");
+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:
@@ -5644,6 +5686,88 @@ ${meta.displayName}`));
   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) {