@hasna/connectors 1.3.15 → 1.3.17

package/bin/index.js

@@ -20991,7 +20991,7 @@ __export(exports_database, {
   getConnectorsHome: () => getConnectorsHome,
   closeDatabase: () => closeDatabase
 });
-import { join as join7 } from "path";
+import { dirname as dirname3, join as join7 } from "path";
 import { homedir as homedir6 } from "os";
 import { mkdirSync as mkdirSync4, existsSync as existsSync7, readdirSync as readdirSync4, copyFileSync as copyFileSync2, statSync } from "fs";
 function getConnectorsHome() {
@@ -21016,11 +21016,19 @@ function getConnectorsHome() {
   return newDir;
 }
 function getDatabase(path) {
-  if (_db)
-    return _db;
   const dbPath = path ?? DB_PATH;
-  mkdirSync4(join7(dbPath, ".."), { recursive: true });
+  if (_db) {
+    if (_dbPath === dbPath)
+      return _db;
+    _db.close();
+    _db = null;
+    _dbPath = null;
+  }
+  if (dbPath !== ":memory:") {
+    mkdirSync4(dirname3(dbPath), { recursive: true });
+  }
   _db = new SqliteAdapter(dbPath);
+  _dbPath = dbPath;
   _db.run("PRAGMA journal_mode = WAL");
   migrate(_db);
   return _db;
@@ -21028,6 +21036,7 @@ function getDatabase(path) {
 function closeDatabase() {
   _db?.close();
   _db = null;
+  _dbPath = null;
 }
 function now() {
   return new Date().toISOString();
@@ -21141,7 +21150,7 @@ function migrate(db) {
     )
   `);
 }
-var DB_DIR, DB_PATH, _db = null;
+var DB_DIR, DB_PATH, _db = null, _dbPath = null;
 var init_database2 = __esm(() => {
   init_dist();
   DB_DIR = getConnectorsHome();
@@ -21160,7 +21169,7 @@ __export(exports_installer, {
   connectorExists: () => connectorExists
 });
 import { existsSync as existsSync9, cpSync, mkdirSync as mkdirSync6, readFileSync as readFileSync3, writeFileSync as writeFileSync3, readdirSync as readdirSync6, statSync as statSync2, rmSync } from "fs";
-import { join as join9, dirname as dirname3 } from "path";
+import { join as join9, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveConnectorsDir() {
   const fromBin = join9(__dirname2, "..", "connectors");
@@ -21325,7 +21334,7 @@ function removeConnector(name, targetDir = process.cwd()) {
 var __dirname2, CONNECTORS_DIR;
 var init_installer = __esm(() => {
   init_database2();
-  __dirname2 = dirname3(fileURLToPath2(import.meta.url));
+  __dirname2 = dirname4(fileURLToPath2(import.meta.url));
   CONNECTORS_DIR = resolveConnectorsDir();
 });
 
@@ -22451,7 +22460,7 @@ __export(exports_serve, {
   startServer: () => startServer
 });
 import { existsSync as existsSync13, readdirSync as readdirSync9, readFileSync as readFileSync6, writeFileSync as writeFileSync7, mkdirSync as mkdirSync10 } from "fs";
-import { join as join14, dirname as dirname4, extname, basename } from "path";
+import { join as join14, dirname as dirname5, extname, basename } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 function logActivity(action, connector, detail) {
   activityLog.unshift({ action, connector, timestamp: Date.now(), detail });
@@ -22462,12 +22471,12 @@ function logActivity(action, connector, detail) {
 function resolveDashboardDir() {
   const candidates = [];
   try {
-    const scriptDir = dirname4(fileURLToPath3(import.meta.url));
+    const scriptDir = dirname5(fileURLToPath3(import.meta.url));
     candidates.push(join14(scriptDir, "..", "dashboard", "dist"));
     candidates.push(join14(scriptDir, "..", "..", "dashboard", "dist"));
   } catch {}
   if (process.argv[1]) {
-    const mainDir = dirname4(process.argv[1]);
+    const mainDir = dirname5(process.argv[1]);
     candidates.push(join14(mainDir, "..", "dashboard", "dist"));
     candidates.push(join14(mainDir, "..", "..", "dashboard", "dist"));
   }
@@ -23169,7 +23178,7 @@ var {
 // package.json
 var package_default = {
   name: "@hasna/connectors",
-  version: "1.3.15",
+  version: "1.3.17",
   description: "Open source connector library - Install API connectors with a single command",
   type: "module",
   bin: {
@@ -24996,11 +25005,38 @@ init_registry();
 init_installer();
 init_auth();
 import chalk3 from "chalk";
+function parseNonNegativeInt(raw, flag) {
+  if (raw === undefined)
+    return { value: undefined };
+  if (!/^\d+$/.test(raw)) {
+    return { value: undefined, error: `Invalid value for ${flag}: '${raw}'. Expected a non-negative integer.` };
+  }
+  return { value: parseInt(raw, 10) };
+}
 function registerCommands2(program2) {
-  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) => {
+  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("--limit <n>", "Limit results").option("--offset <n>", "Skip first N results").option("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
+    const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
+    const parsedOffset = parseNonNegativeInt(options.offset, "--offset");
+    if (parsedLimit.error || parsedOffset.error) {
+      const error = parsedLimit.error || parsedOffset.error || "Invalid pagination options";
+      if (options.json) {
+        console.log(JSON.stringify({ error }));
+      } else {
+        console.log(chalk3.red(error));
+      }
+      process.exit(1);
+      return;
+    }
+    const limit = parsedLimit.value;
+    const offset = parsedOffset.value ?? 0;
+    const page = (items) => {
+      if (limit === undefined)
+        return items.slice(offset);
+      return items.slice(offset, offset + limit);
+    };
     if (options.brief) {
       if (options.installed) {
-        const installed = getInstalledConnectors();
+        const installed = page(getInstalledConnectors());
         if (options.json) {
           console.log(JSON.stringify(installed));
         } else {
@@ -25014,7 +25050,7 @@ function registerCommands2(program2) {
           process.exit(1);
           return;
         }
-        const names = getConnectorsByCategory(category).map((c) => c.name);
+        const names = page(getConnectorsByCategory(category).map((c) => c.name));
         if (options.json) {
           console.log(JSON.stringify(names));
         } else {
@@ -25022,7 +25058,7 @@ function registerCommands2(program2) {
             console.log(n);
         }
       } else {
-        const names = CONNECTORS.map((c) => c.name);
+        const names = page(CONNECTORS.map((c) => c.name));
         if (options.json) {
           console.log(JSON.stringify(names));
         } else {
@@ -25033,7 +25069,7 @@ function registerCommands2(program2) {
       return;
     }
     if (options.installed) {
-      const installed = getInstalledConnectors();
+      const installed = page(getInstalledConnectors());
       if (installed.length === 0) {
         if (options.json) {
           console.log(JSON.stringify([]));
@@ -25116,22 +25152,35 @@ Installed connectors (${installed.length}):
         return;
       }
       const connectors18 = getConnectorsByCategory(category);
+      const pagedConnectors = page(connectors18);
       if (options.json) {
-        console.log(JSON.stringify(connectors18));
+        console.log(JSON.stringify(pagedConnectors));
         return;
       }
       console.log(chalk3.bold(`
-${category} (${connectors18.length}):
+${category} (${pagedConnectors.length}):
 `));
       console.log(`  ${chalk3.dim("Name".padEnd(20))}${chalk3.dim("Version".padEnd(10))}${chalk3.dim("Description")}`);
       console.log(chalk3.dim(`  ${"\u2500".repeat(60)}`));
-      for (const c of connectors18) {
+      for (const c of pagedConnectors) {
         console.log(`  ${chalk3.cyan(c.name.padEnd(20))}${chalk3.dim((c.version || "-").padEnd(10))}${c.description}`);
       }
       return;
     }
     if (options.json) {
-      console.log(JSON.stringify(CONNECTORS));
+      console.log(JSON.stringify(page(CONNECTORS)));
+      return;
+    }
+    if (options.limit || options.offset) {
+      const connectors18 = page(CONNECTORS);
+      console.log(chalk3.bold(`
+Available connectors (${connectors18.length}):
+`));
+      console.log(`  ${chalk3.dim("Name".padEnd(20))}${chalk3.dim("Version".padEnd(10))}${chalk3.dim("Category".padEnd(24))}${chalk3.dim("Description")}`);
+      console.log(chalk3.dim(`  ${"\u2500".repeat(96)}`));
+      for (const c of connectors18) {
+        console.log(`  ${chalk3.cyan(c.name.padEnd(20))}` + `${chalk3.dim((c.version || "-").padEnd(10))}` + `${chalk3.dim(c.category.padEnd(24))}` + `${c.description}`);
+      }
       return;
     }
     console.log(chalk3.bold(`
@@ -25149,6 +25198,17 @@ Available connectors (${CONNECTORS.length}):
     }
   });
   program2.command("search").argument("<query>", "Search term").option("--json", "Output as JSON", false).option("--limit <n>", "Max results", "20").description("Search for connectors (ranked with fuzzy matching)").action((query, options) => {
+    const parsedLimit = parseNonNegativeInt(options.limit, "--limit");
+    if (parsedLimit.error || parsedLimit.value === undefined) {
+      const error = parsedLimit.error || "Invalid --limit value";
+      if (options.json) {
+        console.log(JSON.stringify({ error }));
+      } else {
+        console.log(chalk3.red(error));
+      }
+      process.exit(1);
+      return;
+    }
     const installed = getInstalledConnectors();
     const { getPromotedConnectors: getPromotedConnectors2 } = (init_promotions(), __toCommonJS(exports_promotions));
     const { getUsageMap: getUsageMap2 } = (init_usage(), __toCommonJS(exports_usage));
@@ -25156,7 +25216,7 @@ Available connectors (${CONNECTORS.length}):
       installed,
       promoted: getPromotedConnectors2(),
       usage: getUsageMap2(),
-      limit: parseInt(options.limit)
+      limit: parsedLimit.value
     });
     if (options.json) {
       console.log(JSON.stringify(results.map((c) => ({ name: c.name, displayName: c.displayName, version: c.version, category: c.category, description: c.description, score: c.score, badges: c.badges, matchReasons: c.matchReasons }))));
@@ -25206,7 +25266,7 @@ ${meta.displayName}`));
     console.log(`  Installed:   ${isInstalled ? chalk3.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) => {
+  program2.command("docs").argument("<connector>", "Connector name").option("--json", "Output as structured JSON", false).option("--raw", "Output raw markdown", false).option("--essential", "Show auth and env vars only (no full docs)", false).description("Show connector documentation (auth, env vars, API, CLI commands)").action((connector, options) => {
     const meta = getConnector(connector);
     if (!meta) {
       if (options.json) {
@@ -25233,6 +25293,32 @@ ${meta.displayName}`));
       console.log(docs.raw);
       return;
     }
+    if (options.essential) {
+      if (options.json) {
+        console.log(JSON.stringify({ name: meta.name, auth: docs.auth, envVars: docs.envVars }, null, 2));
+      } else {
+        console.log(chalk3.bold(`
+${meta.displayName} \u2014 Auth & Env Vars`));
+        console.log(chalk3.dim("\u2500".repeat(50)));
+        if (docs.auth) {
+          console.log(chalk3.bold(`
+Authentication`));
+          for (const line of docs.auth.split(`
+`).filter(Boolean)) {
+            console.log(`  ${line}`);
+          }
+        }
+        if (docs.envVars.length > 0) {
+          console.log(chalk3.bold(`
+Environment Variables`));
+          for (const v of docs.envVars) {
+            console.log(`  ${chalk3.cyan(v.variable.padEnd(30))}${v.description}`);
+          }
+        }
+        console.log();
+      }
+      return;
+    }
     if (options.json) {
       console.log(JSON.stringify({
         name: meta.name,
@@ -26836,10 +26922,10 @@ import chalk7 from "chalk";
 
 // src/lib/runner.ts
 import { existsSync as existsSync17 } from "fs";
-import { join as join18, dirname as dirname5 } from "path";
+import { join as join18, dirname as dirname6 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { spawn as spawn3 } from "child_process";
-var __dirname3 = dirname5(fileURLToPath4(import.meta.url));
+var __dirname3 = dirname6(fileURLToPath4(import.meta.url));
 function resolveConnectorsDir2() {
   const fromBin = join18(__dirname3, "..", "connectors");
   if (existsSync17(fromBin))

package/bin/mcp.js

@@ -16556,7 +16556,7 @@ __export(exports_database, {
   getConnectorsHome: () => getConnectorsHome,
   closeDatabase: () => closeDatabase
 });
-import { join as join5 } from "path";
+import { dirname as dirname3, join as join5 } from "path";
 import { homedir as homedir6 } from "os";
 import { mkdirSync as mkdirSync3, existsSync as existsSync4, readdirSync as readdirSync3, copyFileSync as copyFileSync2, statSync } from "fs";
 function getConnectorsHome() {
@@ -16581,11 +16581,19 @@ function getConnectorsHome() {
   return newDir;
 }
 function getDatabase(path) {
-  if (_db)
-    return _db;
   const dbPath = path ?? DB_PATH;
-  mkdirSync3(join5(dbPath, ".."), { recursive: true });
+  if (_db) {
+    if (_dbPath === dbPath)
+      return _db;
+    _db.close();
+    _db = null;
+    _dbPath = null;
+  }
+  if (dbPath !== ":memory:") {
+    mkdirSync3(dirname3(dbPath), { recursive: true });
+  }
   _db = new SqliteAdapter(dbPath);
+  _dbPath = dbPath;
   _db.run("PRAGMA journal_mode = WAL");
   migrate(_db);
   return _db;
@@ -16593,6 +16601,7 @@ function getDatabase(path) {
 function closeDatabase() {
   _db?.close();
   _db = null;
+  _dbPath = null;
 }
 function now() {
   return new Date().toISOString();
@@ -16706,7 +16715,7 @@ function migrate(db) {
     )
   `);
 }
-var DB_DIR, DB_PATH, _db = null;
+var DB_DIR, DB_PATH, _db = null, _dbPath = null;
 var init_database = __esm(() => {
   init_dist();
   DB_DIR = getConnectorsHome();
@@ -16725,7 +16734,7 @@ __export(exports_installer, {
   connectorExists: () => connectorExists
 });
 import { existsSync as existsSync6, cpSync, mkdirSync as mkdirSync5, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync as readdirSync5, statSync as statSync2, rmSync } from "fs";
-import { join as join7, dirname as dirname3 } from "path";
+import { join as join7, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveConnectorsDir() {
   const fromBin = join7(__dirname2, "..", "connectors");
@@ -16890,7 +16899,7 @@ function removeConnector(name, targetDir = process.cwd()) {
 var __dirname2, CONNECTORS_DIR;
 var init_installer = __esm(() => {
   init_database();
-  __dirname2 = dirname3(fileURLToPath2(import.meta.url));
+  __dirname2 = dirname4(fileURLToPath2(import.meta.url));
   CONNECTORS_DIR = resolveConnectorsDir();
 });
 
@@ -37006,10 +37015,10 @@ function guessKeyField(name) {
 
 // src/lib/runner.ts
 import { existsSync as existsSync9 } from "fs";
-import { join as join10, dirname as dirname4 } from "path";
+import { join as join10, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { spawn } from "child_process";
-var __dirname3 = dirname4(fileURLToPath3(import.meta.url));
+var __dirname3 = dirname5(fileURLToPath3(import.meta.url));
 function resolveConnectorsDir2() {
   const fromBin = join10(__dirname3, "..", "connectors");
   if (existsSync9(fromBin))
@@ -37281,7 +37290,7 @@ init_dist();
 // package.json
 var package_default = {
   name: "@hasna/connectors",
-  version: "1.3.15",
+  version: "1.3.17",
   description: "Open source connector library - Install API connectors with a single command",
   type: "module",
   bin: {

package/bin/serve.js

@@ -9409,7 +9409,7 @@ __export(exports_database, {
   getConnectorsHome: () => getConnectorsHome,
   closeDatabase: () => closeDatabase
 });
-import { join as join5 } from "path";
+import { dirname as dirname2, join as join5 } from "path";
 import { homedir as homedir6 } from "os";
 import { mkdirSync as mkdirSync3, existsSync as existsSync4, readdirSync as readdirSync3, copyFileSync as copyFileSync2, statSync } from "fs";
 function getConnectorsHome() {
@@ -9434,11 +9434,19 @@ function getConnectorsHome() {
   return newDir;
 }
 function getDatabase(path) {
-  if (_db)
-    return _db;
   const dbPath = path ?? DB_PATH;
-  mkdirSync3(join5(dbPath, ".."), { recursive: true });
+  if (_db) {
+    if (_dbPath === dbPath)
+      return _db;
+    _db.close();
+    _db = null;
+    _dbPath = null;
+  }
+  if (dbPath !== ":memory:") {
+    mkdirSync3(dirname2(dbPath), { recursive: true });
+  }
   _db = new SqliteAdapter(dbPath);
+  _dbPath = dbPath;
   _db.run("PRAGMA journal_mode = WAL");
   migrate(_db);
   return _db;
@@ -9446,6 +9454,7 @@ function getDatabase(path) {
 function closeDatabase() {
   _db?.close();
   _db = null;
+  _dbPath = null;
 }
 function now() {
   return new Date().toISOString();
@@ -9559,7 +9568,7 @@ function migrate(db) {
     )
   `);
 }
-var DB_DIR, DB_PATH, _db = null;
+var DB_DIR, DB_PATH, _db = null, _dbPath = null;
 var init_database = __esm(() => {
   init_dist();
   DB_DIR = getConnectorsHome();
@@ -10208,12 +10217,12 @@ async function runWorkflow(workflow) {
 
 // src/server/serve.ts
 init_database();
-import { join as join12, dirname as dirname4, extname, basename } from "path";
+import { join as join12, dirname as dirname5, extname, basename } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/lib/registry.ts
 import { existsSync as existsSync7, readFileSync as readFileSync3 } from "fs";
-import { join as join8, dirname as dirname2 } from "path";
+import { join as join8, dirname as dirname3 } from "path";
 import { fileURLToPath } from "url";
 
 // src/lib/connectors/ai-ml.ts
@@ -16213,7 +16222,7 @@ function loadConnectorVersions() {
   if (versionsLoaded)
     return;
   versionsLoaded = true;
-  const thisDir = dirname2(fileURLToPath(import.meta.url));
+  const thisDir = dirname3(fileURLToPath(import.meta.url));
   const candidates = [
     join8(thisDir, "..", "connectors"),
     join8(thisDir, "..", "..", "connectors")
@@ -16235,9 +16244,9 @@ function loadConnectorVersions() {
 // src/lib/installer.ts
 init_database();
 import { existsSync as existsSync8, cpSync, mkdirSync as mkdirSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync3, readdirSync as readdirSync5, statSync as statSync2, rmSync } from "fs";
-import { join as join9, dirname as dirname3 } from "path";
+import { join as join9, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
+var __dirname2 = dirname4(fileURLToPath2(import.meta.url));
 function resolveConnectorsDir() {
   const fromBin = join9(__dirname2, "..", "connectors");
   if (existsSync8(fromBin))
@@ -16869,12 +16878,12 @@ function logActivity(action, connector, detail) {
 function resolveDashboardDir() {
   const candidates = [];
   try {
-    const scriptDir = dirname4(fileURLToPath3(import.meta.url));
+    const scriptDir = dirname5(fileURLToPath3(import.meta.url));
     candidates.push(join12(scriptDir, "..", "dashboard", "dist"));
     candidates.push(join12(scriptDir, "..", "..", "dashboard", "dist"));
   } catch {}
   if (process.argv[1]) {
-    const mainDir = dirname4(process.argv[1]);
+    const mainDir = dirname5(process.argv[1]);
     candidates.push(join12(mainDir, "..", "dashboard", "dist"));
     candidates.push(join12(mainDir, "..", "..", "dashboard", "dist"));
   }

package/dist/index.js

@@ -6278,7 +6278,7 @@ function loadConnectorVersions() {
 }
 // src/lib/installer.ts
 import { existsSync as existsSync6, cpSync, mkdirSync as mkdirSync5, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync as readdirSync5, statSync as statSync2, rmSync } from "fs";
-import { join as join7, dirname as dirname3 } from "path";
+import { join as join7, dirname as dirname4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // node_modules/@hasna/cloud/dist/index.js
@@ -15807,7 +15807,7 @@ init_dotfile();
 init_adapter();
 
 // src/db/database.ts
-import { join as join5 } from "path";
+import { dirname as dirname3, join as join5 } from "path";
 import { homedir as homedir6 } from "os";
 import { mkdirSync as mkdirSync3, existsSync as existsSync4, readdirSync as readdirSync3, copyFileSync as copyFileSync2, statSync } from "fs";
 function getConnectorsHome() {
@@ -15835,7 +15835,7 @@ var DB_DIR = getConnectorsHome();
 var DB_PATH = join5(DB_DIR, "connectors.db");
 
 // src/lib/installer.ts
-var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
+var __dirname2 = dirname4(fileURLToPath2(import.meta.url));
 function resolveConnectorsDir() {
   const fromBin = join7(__dirname2, "..", "connectors");
   if (existsSync6(fromBin))
@@ -15999,10 +15999,10 @@ function removeConnector(name, targetDir = process.cwd()) {
 }
 // src/lib/runner.ts
 import { existsSync as existsSync7 } from "fs";
-import { join as join8, dirname as dirname4 } from "path";
+import { join as join8, dirname as dirname5 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { spawn } from "child_process";
-var __dirname3 = dirname4(fileURLToPath3(import.meta.url));
+var __dirname3 = dirname5(fileURLToPath3(import.meta.url));
 function resolveConnectorsDir2() {
   const fromBin = join8(__dirname3, "..", "connectors");
   if (existsSync7(fromBin))

package/package.json

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