@hasna/connectors 0.3.1 → 0.3.2

package/bin/index.js

@@ -4519,9 +4519,9 @@ var exports_serve = {};
 __export(exports_serve, {
   startServer: () => startServer
 });
-import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
-import { join as join4, dirname as dirname3, extname, basename } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { join as join5, dirname as dirname4, extname, basename } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
 import { homedir as homedir2 } from "os";
 function logActivity(action, connector, detail) {
   activityLog.unshift({ action, connector, timestamp: Date.now(), detail });
@@ -4532,21 +4532,21 @@ function logActivity(action, connector, detail) {
 function resolveDashboardDir() {
   const candidates = [];
   try {
-    const scriptDir = dirname3(fileURLToPath3(import.meta.url));
-    candidates.push(join4(scriptDir, "..", "dashboard", "dist"));
-    candidates.push(join4(scriptDir, "..", "..", "dashboard", "dist"));
+    const scriptDir = dirname4(fileURLToPath4(import.meta.url));
+    candidates.push(join5(scriptDir, "..", "dashboard", "dist"));
+    candidates.push(join5(scriptDir, "..", "..", "dashboard", "dist"));
   } catch {}
   if (process.argv[1]) {
-    const mainDir = dirname3(process.argv[1]);
-    candidates.push(join4(mainDir, "..", "dashboard", "dist"));
-    candidates.push(join4(mainDir, "..", "..", "dashboard", "dist"));
+    const mainDir = dirname4(process.argv[1]);
+    candidates.push(join5(mainDir, "..", "dashboard", "dist"));
+    candidates.push(join5(mainDir, "..", "..", "dashboard", "dist"));
   }
-  candidates.push(join4(process.cwd(), "dashboard", "dist"));
+  candidates.push(join5(process.cwd(), "dashboard", "dist"));
   for (const candidate of candidates) {
-    if (existsSync4(candidate))
+    if (existsSync5(candidate))
       return candidate;
   }
-  return join4(process.cwd(), "dashboard", "dist");
+  return join5(process.cwd(), "dashboard", "dist");
 }
 function json(data, status = 200, port) {
   return new Response(JSON.stringify(data), {
@@ -4594,7 +4594,7 @@ function errorPage(title, message, hint) {
   </body></html>`;
 }
 function serveStaticFile(filePath) {
-  if (!existsSync4(filePath))
+  if (!existsSync5(filePath))
     return null;
   const ext = extname(filePath);
   const contentType = MIME_TYPES[ext] || "application/octet-stream";
@@ -4618,7 +4618,7 @@ async function startServer(requestedPort, options) {
   const shouldOpen = options?.open ?? true;
   loadConnectorVersions();
   const dashboardDir = resolveDashboardDir();
-  const dashboardExists = existsSync4(dashboardDir);
+  const dashboardExists = existsSync5(dashboardDir);
   if (!dashboardExists) {
     console.error(`
 Dashboard not found at: ${dashboardDir}`);
@@ -4774,10 +4774,10 @@ Dashboard not found at: ${dashboardDir}`);
           return json({ error: "Invalid connector name" }, 400, port);
         try {
           const profiles = listProfiles(name);
-          const configDir = join4(homedir2(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
-          const currentProfileFile = join4(configDir, "current_profile");
+          const configDir = join5(homedir2(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
+          const currentProfileFile = join5(configDir, "current_profile");
           let current = "default";
-          if (existsSync4(currentProfileFile)) {
+          if (existsSync5(currentProfileFile)) {
             try {
               current = readFileSync4(currentProfileFile, "utf-8").trim() || "default";
             } catch {}
@@ -4826,16 +4826,16 @@ Dashboard not found at: ${dashboardDir}`);
       }
       if (path === "/api/export" && method === "GET") {
         try {
-          const connectDir = join4(homedir2(), ".connectors");
+          const connectDir = join5(homedir2(), ".connectors");
           const result = {};
-          if (existsSync4(connectDir)) {
+          if (existsSync5(connectDir)) {
             const entries = readdirSync3(connectDir, { withFileTypes: true });
             for (const entry of entries) {
               if (!entry.isDirectory() || !entry.name.startsWith("connect-"))
                 continue;
               const connectorName = entry.name.replace(/^connect-/, "");
-              const profilesDir = join4(connectDir, entry.name, "profiles");
-              if (!existsSync4(profilesDir))
+              const profilesDir = join5(connectDir, entry.name, "profiles");
+              if (!existsSync5(profilesDir))
                 continue;
               const profiles = {};
               const profileEntries = readdirSync3(profilesDir, { withFileTypes: true });
@@ -4843,13 +4843,13 @@ Dashboard not found at: ${dashboardDir}`);
                 if (pEntry.isFile() && pEntry.name.endsWith(".json")) {
                   const profileName = basename(pEntry.name, ".json");
                   try {
-                    const config = JSON.parse(readFileSync4(join4(profilesDir, pEntry.name), "utf-8"));
+                    const config = JSON.parse(readFileSync4(join5(profilesDir, pEntry.name), "utf-8"));
                     profiles[profileName] = config;
                   } catch {}
                 }
                 if (pEntry.isDirectory()) {
-                  const configPath = join4(profilesDir, pEntry.name, "config.json");
-                  if (existsSync4(configPath)) {
+                  const configPath = join5(profilesDir, pEntry.name, "config.json");
+                  if (existsSync5(configPath)) {
                     try {
                       const config = JSON.parse(readFileSync4(configPath, "utf-8"));
                       profiles[pEntry.name] = config;
@@ -4886,19 +4886,19 @@ Dashboard not found at: ${dashboardDir}`);
             return json({ error: "Invalid import format: missing 'connectors' object" }, 400, port);
           }
           let imported = 0;
-          const connectDir = join4(homedir2(), ".connectors");
+          const connectDir = join5(homedir2(), ".connectors");
           for (const [connectorName, data] of Object.entries(body.connectors)) {
             if (!isValidConnectorName(connectorName))
               continue;
             if (!data.profiles || typeof data.profiles !== "object")
               continue;
-            const connectorDir = join4(connectDir, `connect-${connectorName}`);
-            const profilesDir = join4(connectorDir, "profiles");
+            const connectorDir = join5(connectDir, `connect-${connectorName}`);
+            const profilesDir = join5(connectorDir, "profiles");
             for (const [profileName, config] of Object.entries(data.profiles)) {
               if (!config || typeof config !== "object")
                 continue;
               mkdirSync3(profilesDir, { recursive: true });
-              const profileFile = join4(profilesDir, `${profileName}.json`);
+              const profileFile = join5(profilesDir, `${profileName}.json`);
               writeFileSync3(profileFile, JSON.stringify(config, null, 2));
               imported++;
             }
@@ -4965,12 +4965,12 @@ Dashboard not found at: ${dashboardDir}`);
       }
       if (dashboardExists && (method === "GET" || method === "HEAD")) {
         if (path !== "/") {
-          const filePath = join4(dashboardDir, path);
+          const filePath = join5(dashboardDir, path);
           const res2 = serveStaticFile(filePath);
           if (res2)
             return res2;
         }
-        const indexPath = join4(dashboardDir, "index.html");
+        const indexPath = join5(dashboardDir, "index.html");
         const res = serveStaticFile(indexPath);
         if (res)
           return res;
@@ -6513,9 +6513,9 @@ function App({ initialConnectors, overwrite = false }) {
 init_registry();
 init_installer();
 init_auth();
-import { readdirSync as readdirSync4, existsSync as existsSync5, statSync as statSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4 } from "fs";
+import { readdirSync as readdirSync4, existsSync as existsSync6, 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 { join as join6, relative } from "path";
 
 // src/lib/test-endpoints.ts
 var TEST_ENDPOINTS = {
@@ -6588,6 +6588,107 @@ var TEST_ENDPOINTS = {
 
 // src/cli/index.tsx
 import { createInterface } from "readline";
+
+// src/lib/runner.ts
+import { existsSync as existsSync4 } from "fs";
+import { join as join4, dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { spawn } from "child_process";
+var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
+function resolveConnectorsDir2() {
+  const fromBin = join4(__dirname3, "..", "connectors");
+  if (existsSync4(fromBin))
+    return fromBin;
+  const fromSrc = join4(__dirname3, "..", "..", "connectors");
+  if (existsSync4(fromSrc))
+    return fromSrc;
+  return fromBin;
+}
+var CONNECTORS_DIR2 = resolveConnectorsDir2();
+function getConnectorCliPath(name) {
+  const safeName = name.replace(/[^a-z0-9-]/g, "");
+  const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
+  const cliPath = join4(connectorDir, "src", "cli", "index.ts");
+  if (existsSync4(cliPath))
+    return cliPath;
+  return null;
+}
+function runConnectorCommand(name, args, timeoutMs = 30000) {
+  const cliPath = getConnectorCliPath(name);
+  if (!cliPath) {
+    return Promise.resolve({
+      stdout: "",
+      stderr: `Connector '${name}' not found or has no CLI.`,
+      exitCode: 1,
+      success: false
+    });
+  }
+  return new Promise((resolve) => {
+    const proc = spawn("bun", ["run", cliPath, ...args], {
+      timeout: timeoutMs,
+      env: { ...process.env },
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    proc.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    proc.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    proc.on("close", (code) => {
+      resolve({
+        stdout: stdout.trim(),
+        stderr: stderr.trim(),
+        exitCode: code ?? 1,
+        success: code === 0
+      });
+    });
+    proc.on("error", (err) => {
+      resolve({
+        stdout: "",
+        stderr: err.message,
+        exitCode: 1,
+        success: false
+      });
+    });
+  });
+}
+async function getConnectorOperations(name) {
+  const cliPath = getConnectorCliPath(name);
+  if (!cliPath) {
+    return { commands: [], helpText: "", hasCli: false };
+  }
+  const result = await runConnectorCommand(name, ["--help"]);
+  const helpText = result.stdout || result.stderr;
+  const commands = [];
+  const lines = helpText.split(`
+`);
+  let inCommands = false;
+  for (const line of lines) {
+    if (line.trim().startsWith("Commands:")) {
+      inCommands = true;
+      continue;
+    }
+    if (inCommands) {
+      const match = line.match(/^\s{2,}(\S+)/);
+      if (match && match[1] !== "help") {
+        commands.push(match[1]);
+      }
+      if (line.trim() === "" && commands.length > 0) {
+        inCommands = false;
+      }
+    }
+  }
+  return { commands, helpText, hasCli: true };
+}
+async function getConnectorCommandHelp(name, command) {
+  const result = await runConnectorCommand(name, [command, "--help"]);
+  return result.stdout || result.stderr;
+}
+
+// src/cli/index.tsx
 import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 loadConnectorVersions();
 var isTTY = process.stdout.isTTY ?? false;
@@ -6600,7 +6701,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.1");
+program2.name("connectors").description("Install API connectors for your project").version("0.3.2");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -6621,7 +6722,7 @@ Run 'connectors --help' for full usage.`);
 function listFilesRecursive(dir, base = dir) {
   const files = [];
   for (const entry of readdirSync4(dir)) {
-    const fullPath = join5(dir, entry);
+    const fullPath = join6(dir, entry);
     if (statSync3(fullPath).isDirectory()) {
       files.push(...listFilesRecursive(fullPath, base));
     } else {
@@ -6670,7 +6771,7 @@ program2.command("install").alias("add").argument("[connectors...]", "Connectors
   }
   if (options.dryRun) {
     const installed = getInstalledConnectors();
-    const destDir = join5(process.cwd(), ".connectors");
+    const destDir = join6(process.cwd(), ".connectors");
     const actions = [];
     for (const name of connectors) {
       if (!/^[a-z0-9-]+$/.test(name)) {
@@ -6688,7 +6789,7 @@ program2.command("install").alias("add").argument("[connectors...]", "Connectors
       }
       const connectorDirName = name.startsWith("connect-") ? name : `connect-${name}`;
       const sourcePath = getConnectorPath(name);
-      const destPath = join5(destDir, connectorDirName);
+      const destPath = join6(destDir, connectorDirName);
       const alreadyInstalled = installed.includes(name);
       const files = listFilesRecursive(sourcePath);
       const importLine = `export * as ${name} from './${connectorDirName}/src/index.js';`;
@@ -7661,27 +7762,27 @@ Next steps:
   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 connectDir = join6(homedir3(), ".connectors");
   const result = {};
-  if (existsSync5(connectDir)) {
+  if (existsSync6(connectDir)) {
     for (const entry of readdirSync4(connectDir)) {
-      const entryPath = join5(connectDir, entry);
+      const entryPath = join6(connectDir, entry);
       if (!statSync3(entryPath).isDirectory() || !entry.startsWith("connect-"))
         continue;
       const connectorName = entry.replace(/^connect-/, "");
-      const profilesDir = join5(entryPath, "profiles");
-      if (!existsSync5(profilesDir))
+      const profilesDir = join6(entryPath, "profiles");
+      if (!existsSync6(profilesDir))
         continue;
       const profiles = {};
       for (const pEntry of readdirSync4(profilesDir)) {
-        const pPath = join5(profilesDir, pEntry);
+        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 = join5(pPath, "config.json");
-          if (existsSync5(configPath)) {
+          const configPath = join6(pPath, "config.json");
+          if (existsSync6(configPath)) {
             try {
               profiles[pEntry] = JSON.parse(readFileSync5(configPath, "utf-8"));
             } catch {}
@@ -7708,7 +7809,7 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
       chunks.push(chunk.toString());
     raw = chunks.join("");
   } else {
-    if (!existsSync5(file)) {
+    if (!existsSync6(file)) {
       if (options.json) {
         console.log(JSON.stringify({ error: `File not found: ${file}` }));
       } else {
@@ -7740,19 +7841,19 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
     process.exit(1);
     return;
   }
-  const connectDir = join5(homedir3(), ".connectors");
+  const connectDir = join6(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");
+    const profilesDir = join6(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));
+      writeFileSync4(join6(profilesDir, `${profileName}.json`), JSON.stringify(config, null, 2));
       imported++;
     }
   }
@@ -7977,7 +8078,7 @@ Available presets:
 `));
 });
 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 configDir = join6(homedir3(), ".connectors");
   const installed = getInstalledConnectors();
   const version = "0.3.1";
   let configured = 0;
@@ -7989,10 +8090,10 @@ program2.command("whoami").option("--json", "Output as JSON", false).description
       configured++;
     else
       unconfigured++;
-    const connectorConfigDir = join5(configDir, name.startsWith("connect-") ? name : `connect-${name}`);
-    const currentProfileFile = join5(connectorConfigDir, "current_profile");
+    const connectorConfigDir = join6(configDir, name.startsWith("connect-") ? name : `connect-${name}`);
+    const currentProfileFile = join6(connectorConfigDir, "current_profile");
     let profile = "default";
-    if (existsSync5(currentProfileFile)) {
+    if (existsSync6(currentProfileFile)) {
       try {
         profile = readFileSync5(currentProfileFile, "utf-8").trim() || "default";
       } catch {}
@@ -8003,7 +8104,7 @@ program2.command("whoami").option("--json", "Output as JSON", false).description
     console.log(JSON.stringify({
       version,
       configDir,
-      configDirExists: existsSync5(configDir),
+      configDirExists: existsSync6(configDir),
       installed: installed.length,
       configured,
       unconfigured,
@@ -8015,7 +8116,7 @@ program2.command("whoami").option("--json", "Output as JSON", false).description
 Connectors Setup
 `));
   console.log(`  Version:      ${chalk2.cyan(version)}`);
-  console.log(`  Config:       ${configDir}${existsSync5(configDir) ? "" : chalk2.dim(" (not created yet)")}`);
+  console.log(`  Config:       ${configDir}${existsSync6(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) {
@@ -8087,17 +8188,17 @@ Testing connector credentials...
       }
     }
     if (!apiKey) {
-      const connectorConfigDir = join5(homedir3(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
-      const profileFile = join5(connectorConfigDir, "profiles", "default.json");
-      if (existsSync5(profileFile)) {
+      const connectorConfigDir = join6(homedir3(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
+      const profileFile = join6(connectorConfigDir, "profiles", "default.json");
+      if (existsSync6(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)) {
+        const profileDirConfig = join6(connectorConfigDir, "profiles", "default", "config.json");
+        if (existsSync6(profileDirConfig)) {
           try {
             const config = JSON.parse(readFileSync5(profileDirConfig, "utf-8"));
             apiKey = Object.values(config).find((v) => typeof v === "string" && v.length > 0);
@@ -8159,4 +8260,73 @@ Testing connector credentials...
   }
   process.exit(results.some((r) => r.status === "fail") ? 1 : 0);
 });
+program2.command("ops").description("List available API operations for a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[command]", "Get detailed help for a specific subcommand").option("--json", "Output as JSON").action(async (name, command, options) => {
+  const meta = getConnector(name);
+  if (!meta) {
+    console.error(chalk2.red(`Connector '${name}' not found.`));
+    process.exit(1);
+  }
+  if (!getConnectorCliPath(name)) {
+    console.error(chalk2.red(`Connector '${name}' does not have a CLI.`));
+    process.exit(1);
+  }
+  if (command) {
+    const help = await getConnectorCommandHelp(name, command);
+    if (options.json) {
+      console.log(JSON.stringify({ connector: name, command, help }, null, 2));
+    } else {
+      console.log(chalk2.bold(`
+${meta.displayName} \u2192 ${command}
+`));
+      console.log(help);
+    }
+    return;
+  }
+  const ops = await getConnectorOperations(name);
+  if (options.json) {
+    console.log(JSON.stringify({
+      connector: name,
+      displayName: meta.displayName,
+      commands: ops.commands
+    }, null, 2));
+  } else {
+    console.log(chalk2.bold(`
+${meta.displayName} operations:
+`));
+    if (ops.commands.length > 0) {
+      for (const cmd of ops.commands) {
+        console.log(`  ${chalk2.cyan(cmd)}`);
+      }
+      console.log(chalk2.dim(`
+  Run ${chalk2.white(`connectors ops ${name} <command>`)} for details`));
+      console.log(chalk2.dim(`  Run ${chalk2.white(`connectors run ${name} <command> [args...]`)} to execute
+`));
+    } else {
+      console.log(ops.helpText);
+    }
+  }
+});
+program2.command("run").description("Execute an API operation on a connector").argument("<name>", "Connector name (e.g. stripe, gmail)").argument("[args...]", "Command arguments (e.g. products list --limit 5)").option("--timeout <ms>", "Timeout in milliseconds", "30000").allowUnknownOption(true).action(async (name, args, options) => {
+  const meta = getConnector(name);
+  if (!meta) {
+    console.error(chalk2.red(`Connector '${name}' not found.`));
+    process.exit(1);
+  }
+  if (!getConnectorCliPath(name)) {
+    console.error(chalk2.red(`Connector '${name}' does not have a CLI.`));
+    process.exit(1);
+  }
+  if (args.length === 0) {
+    console.error(chalk2.yellow(`No command specified. Run ${chalk2.white(`connectors ops ${name}`)} to see available operations.`));
+    process.exit(1);
+  }
+  const result = await runConnectorCommand(name, args, parseInt(options.timeout));
+  if (result.stdout) {
+    console.log(result.stdout);
+  }
+  if (result.stderr) {
+    console.error(result.stderr);
+  }
+  process.exit(result.exitCode);
+});
 program2.parse();