@hasna/connectors 0.5.6 → 0.5.8

package/README.md

@@ -1,21 +1,42 @@
 # Connectors
 
-Open source library of 62 TypeScript API connectors. Install any connector with a single command.
+Open source library of 126 TypeScript API connectors. Set up any connector in 30 seconds.
 
-## Quick Start
+## 30-Second Quickstart
+
+```bash
+# Install globally
+bun install -g @hasna/connectors
+
+# Set up a connector (install + auth in one step)
+connectors setup stripe --key sk_test_your_key_here
+
+# Use it immediately
+connectors run stripe products list
+connectors run stripe customers create --email "test@example.com"
+
+# Discover what any connector can do
+connectors ops stripe
+connectors ops gmail
+connectors ops anthropic
+```
+
+**That's it.** `setup` installs the connector and saves your API key. `run` executes any operation. `ops` shows what's available.
+
+## Quick Start (Alternative Methods)
 
 ```bash
 # Interactive mode - browse and select connectors
 npx @hasna/connectors
 
 # Install specific connectors
-npx @hasna/connectors install figma stripe github
+connectors install figma stripe github
 
-# List all available connectors
-npx @hasna/connectors list
+# List all 126 connectors
+connectors list
 
 # Open the auth dashboard
-npx @hasna/connectors serve
+connectors serve
 ```
 
 ## Installation
@@ -69,7 +90,7 @@ connectors open                          # Open dashboard in browser
 connectors dashboard                     # Alias for serve
 ```
 
-The dashboard shows all 62 connectors with:
+The dashboard shows all 126 connectors with:
 - Install status and auth type (OAuth, API Key, Bearer)
 - Configure API keys via dialog
 - Run OAuth flows for Google connectors
@@ -93,7 +114,25 @@ Add to your MCP config:
 }
 ```
 
-Tools: `search_connectors`, `list_connectors`, `list_categories`, `connector_docs`, `connector_info`, `install_connector`, `remove_connector`, `list_installed`, `connector_auth_status`, `configure_auth`
+Tools: `search_connectors`, `list_connectors`, `list_categories`, `connector_docs`, `connector_info`, `install_connector`, `remove_connector`, `list_installed`, `connector_auth_status`, `configure_auth`, `setup_connector`, `list_connector_operations`, `run_connector_operation`
+
+### Use Connectors (ops + run)
+
+```bash
+# Discover what a connector can do
+connectors ops stripe                    # List all operations
+connectors ops stripe products           # Detailed help for products
+
+# Execute any operation
+connectors run stripe products list --limit 5
+connectors run anthropic models
+connectors run gmail messages list --limit 10
+connectors run github repo list
+
+# One-step setup (install + auth + verify)
+connectors setup anthropic --key your-anthropic-api-key
+connectors setup stripe --key sk_test_your-key
+```
 
 ### JSON Output (for scripts & agents)
 
@@ -106,7 +145,7 @@ connectors info stripe --json
 connectors docs gmail --json
 ```
 
-## Available Connectors (62)
+## Available Connectors (126)
 
 ### AI & ML (12)
 | Connector | Description |

package/bin/index.js

@@ -7185,6 +7185,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -7206,7 +7239,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";
@@ -7281,7 +7314,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.5.6").enablePositionalOptions();
+program2.name("connectors").description("Install API connectors for your project").version("0.5.8").enablePositionalOptions();
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:

package/bin/mcp.js

@@ -20676,6 +20676,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -20697,7 +20730,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";
@@ -20763,7 +20796,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.5.6"
+  version: "0.5.8"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",

package/dist/index.js

@@ -1103,6 +1103,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join3(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -1124,7 +1157,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";

package/dist/lib/runner.d.ts

@@ -6,6 +6,22 @@
  * them as subprocesses and capture stdout/stderr. This keeps the main CLI/MCP
  * lightweight while exposing every connector's full API.
  */
+/**
+ * Build the subprocess env with auto-detected credentials.
+ *
+ * For each connector we derive the "canonical" env var (e.g. EXA_API_KEY)
+ * and, if it's not already set, check common alternative patterns from the
+ * user's environment. When a match is found we inject it so the connector
+ * subprocess can read it.
+ *
+ * Patterns checked (in priority order):
+ *   1. HASNAXYZ_{NAME}_LIVE_API_KEY  → {NAME}_API_KEY
+ *   2. HASNA_{NAME}_LIVE_API_KEY     → {NAME}_API_KEY
+ *   3. {NAME}_LIVE_API_KEY           → {NAME}_API_KEY
+ *   4. {NAME}_KEY                    → {NAME}_API_KEY
+ *   5. {NAME}_TOKEN                  → {NAME}_API_KEY
+ */
+export declare function buildEnvWithCredentials(connectorName: string, baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /**
  * Get the path to a connector's CLI entry point.
  * Returns null if the connector has no CLI.

package/package.json

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