@hasna/connectors 1.2.1 → 1.3.0

package/bin/serve.js

@@ -135,6 +135,22 @@ function migrate(db) {
       created_at TEXT NOT NULL
     )
   `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_usage (
+      id TEXT PRIMARY KEY,
+      connector TEXT NOT NULL,
+      action TEXT NOT NULL,
+      agent_id TEXT,
+      timestamp TEXT NOT NULL
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_usage_connector ON connector_usage(connector, timestamp DESC)`);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS connector_promotions (
+      connector TEXT UNIQUE NOT NULL,
+      promoted_at TEXT NOT NULL
+    )
+  `);
 }
 var DB_DIR, DB_PATH, _db = null;
 var init_database = __esm(() => {
@@ -483,6 +499,75 @@ var init_scheduler = __esm(() => {
   init_strip();
 });
 
+// src/db/usage.ts
+var exports_usage = {};
+__export(exports_usage, {
+  logUsage: () => logUsage,
+  getUsageStats: () => getUsageStats,
+  getUsageMap: () => getUsageMap,
+  getTopConnectors: () => getTopConnectors,
+  cleanOldUsage: () => cleanOldUsage
+});
+function logUsage(connector, action, agentId, db) {
+  const d = db ?? getDatabase();
+  d.run("INSERT INTO connector_usage (id, connector, action, agent_id, timestamp) VALUES (?, ?, ?, ?, ?)", [shortUuid(), connector, action, agentId ?? null, now()]);
+}
+function getUsageStats(connector, db) {
+  const d = db ?? getDatabase();
+  const total = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ?").get(connector).c;
+  const d7 = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+  const last7d = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ? AND timestamp > ?").get(connector, d7).c;
+  const d1 = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+  const last24h = d.query("SELECT COUNT(*) as c FROM connector_usage WHERE connector = ? AND timestamp > ?").get(connector, d1).c;
+  return { connector, total, last7d, last24h };
+}
+function getTopConnectors(limit = 10, days = 7, db) {
+  const d = db ?? getDatabase();
+  const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  return d.query("SELECT connector, COUNT(*) as count FROM connector_usage WHERE timestamp > ? GROUP BY connector ORDER BY count DESC LIMIT ?").all(since, limit);
+}
+function getUsageMap(days = 7, db) {
+  const top = getTopConnectors(100, days, db);
+  return new Map(top.map((t) => [t.connector, t.count]));
+}
+function cleanOldUsage(days = 30, db) {
+  const d = db ?? getDatabase();
+  const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  return d.run("DELETE FROM connector_usage WHERE timestamp < ?", [cutoff]).changes;
+}
+var init_usage = __esm(() => {
+  init_database();
+});
+
+// src/db/promotions.ts
+var exports_promotions = {};
+__export(exports_promotions, {
+  promoteConnector: () => promoteConnector,
+  isPromoted: () => isPromoted,
+  getPromotedConnectors: () => getPromotedConnectors,
+  demoteConnector: () => demoteConnector
+});
+function promoteConnector(name, db) {
+  const d = db ?? getDatabase();
+  d.run("INSERT OR REPLACE INTO connector_promotions (connector, promoted_at) VALUES (?, ?)", [name, now()]);
+}
+function demoteConnector(name, db) {
+  const d = db ?? getDatabase();
+  return d.run("DELETE FROM connector_promotions WHERE connector = ?", [name]).changes > 0;
+}
+function getPromotedConnectors(db) {
+  const d = db ?? getDatabase();
+  return d.query("SELECT connector FROM connector_promotions ORDER BY promoted_at DESC").all().map((r) => r.connector);
+}
+function isPromoted(name, db) {
+  const d = db ?? getDatabase();
+  const row = d.query("SELECT 1 FROM connector_promotions WHERE connector = ?").get(name);
+  return !!row;
+}
+var init_promotions = __esm(() => {
+  init_database();
+});
+
 // src/server/serve.ts
 import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync6 } from "fs";
 
@@ -6982,6 +7067,16 @@ function loadTokens(name) {
       return null;
     }
   }
+  const profileConfig = loadProfileConfig(name);
+  if (profileConfig.refreshToken || profileConfig.accessToken) {
+    return {
+      accessToken: profileConfig.accessToken,
+      refreshToken: profileConfig.refreshToken,
+      expiresAt: profileConfig.expiresAt,
+      tokenType: profileConfig.tokenType,
+      scope: profileConfig.scope
+    };
+  }
   return null;
 }
 function getAuthStatus(name) {
@@ -7560,6 +7655,30 @@ Dashboard not found at: ${dashboardDir}`);
       if (path === "/api/activity" && method === "GET") {
         return json(activityLog, 200, port);
       }
+      if (path === "/api/hot" && method === "GET") {
+        const { getTopConnectors: getTopConnectors2 } = await Promise.resolve().then(() => (init_usage(), exports_usage));
+        const { getPromotedConnectors: getPromotedConnectors2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+        const limit = parseInt(url2.searchParams.get("limit") || "10", 10);
+        const days = parseInt(url2.searchParams.get("days") || "7", 10);
+        const db = getDatabase2();
+        const top = getTopConnectors2(limit, days, db);
+        const promoted = new Set(getPromotedConnectors2(db));
+        return json(top.map((t) => ({ ...t, promoted: promoted.has(t.connector) })), 200, port);
+      }
+      const promoteMatch = path.match(/^\/api\/connectors\/([^/]+)\/promote$/);
+      if (promoteMatch && method === "POST") {
+        const name = promoteMatch[1];
+        if (!getConnector(name))
+          return json({ error: "Connector not found" }, 404, port);
+        const { promoteConnector: promoteConnector2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+        promoteConnector2(name, getDatabase2());
+        return json({ success: true, connector: name }, 200, port);
+      }
+      if (promoteMatch && method === "DELETE") {
+        const { demoteConnector: demoteConnector2 } = await Promise.resolve().then(() => (init_promotions(), exports_promotions));
+        const removed = demoteConnector2(promoteMatch[1], getDatabase2());
+        return json({ success: removed, connector: promoteMatch[1] }, 200, port);
+      }
       if (path === "/api/llm" && method === "GET") {
         const config = getLlmConfig();
         if (!config)

package/dist/db/promotions.d.ts

@@ -0,0 +1,5 @@
+import type { Database } from "bun:sqlite";
+export declare function promoteConnector(name: string, db?: Database): void;
+export declare function demoteConnector(name: string, db?: Database): boolean;
+export declare function getPromotedConnectors(db?: Database): string[];
+export declare function isPromoted(name: string, db?: Database): boolean;

package/dist/db/promotions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/db/usage.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from "bun:sqlite";
+export declare function logUsage(connector: string, action: string, agentId?: string, db?: Database): void;
+export interface UsageStats {
+    connector: string;
+    total: number;
+    last7d: number;
+    last24h: number;
+}
+export declare function getUsageStats(connector: string, db?: Database): UsageStats;
+export interface TopConnector {
+    connector: string;
+    count: number;
+}
+export declare function getTopConnectors(limit?: number, days?: number, db?: Database): TopConnector[];
+/** Get usage counts as a Map for search context */
+export declare function getUsageMap(days?: number, db?: Database): Map<string, number>;
+export declare function cleanOldUsage(days?: number, db?: Database): number;

package/dist/db/usage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -7,6 +7,6 @@
  * Or use the interactive CLI:
  *   npx @hasna/connectors
  */
-export { CONNECTORS, CATEGORIES, getConnector, getConnectorsByCategory, searchConnectors, loadConnectorVersions, type ConnectorMeta, type Category, } from "./lib/registry.js";
+export { CONNECTORS, CATEGORIES, getConnector, getConnectorsByCategory, searchConnectors, loadConnectorVersions, type ConnectorMeta, type Category, type ScoredResult, type SearchContext, } from "./lib/registry.js";
 export { installConnector, installConnectors, getInstalledConnectors, removeConnector, connectorExists, getConnectorPath, getConnectorDocs, type InstallResult, type InstallOptions, type ConnectorDocs, } from "./lib/installer.js";
 export { runConnectorCommand, getConnectorOperations, getConnectorCommandHelp, getConnectorCliPath, getConnectorsWithCli, type RunResult, } from "./lib/runner.js";

package/dist/index.js

@@ -5,6 +5,94 @@ var __require = import.meta.require;
 import { existsSync, readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
+
+// src/lib/fuzzy.ts
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0)
+    return n;
+  if (n === 0)
+    return m;
+  let prev = new Array(n + 1);
+  let curr = new Array(n + 1);
+  for (let j = 0;j <= n; j++)
+    prev[j] = j;
+  for (let i = 1;i <= m; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[n];
+}
+function bestFuzzyScore(token, candidates, maxDistance = 2) {
+  if (token.length < 3)
+    return 0;
+  let bestDist = maxDistance + 1;
+  for (const c of candidates) {
+    if (Math.abs(token.length - c.length) > maxDistance)
+      continue;
+    const d = levenshtein(token, c);
+    if (d < bestDist)
+      bestDist = d;
+    if (d === 0)
+      return maxDistance + 1;
+  }
+  if (bestDist > maxDistance)
+    return 0;
+  return maxDistance - bestDist + 1;
+}
+
+// src/lib/synonyms.ts
+var SYNONYM_MAP = {
+  email: ["smtp", "mail", "inbox", "resend", "ses"],
+  chat: ["messaging", "im", "slack", "discord", "teams"],
+  sms: ["text", "twilio", "messaging"],
+  payment: ["billing", "invoicing", "commerce", "checkout", "stripe"],
+  payments: ["billing", "invoicing", "commerce", "checkout", "stripe"],
+  ecommerce: ["shop", "store", "commerce", "shopify"],
+  finance: ["banking", "accounting", "invoicing"],
+  crypto: ["blockchain", "web3", "wallet"],
+  ai: ["llm", "ml", "model", "gpt", "claude", "anthropic", "openai"],
+  llm: ["ai", "model", "gpt", "claude"],
+  auth: ["oauth", "sso", "login", "identity", "authentication"],
+  database: ["db", "sql", "nosql", "postgres", "mongo", "supabase"],
+  deploy: ["hosting", "infrastructure", "ci", "cd", "vercel"],
+  storage: ["files", "drive", "s3", "bucket", "upload"],
+  cloud: ["aws", "gcp", "azure", "infrastructure"],
+  api: ["rest", "graphql", "endpoint", "webhook"],
+  monitoring: ["logs", "observability", "alerting", "datadog", "sentry"],
+  ci: ["cd", "deploy", "pipeline", "github", "actions"],
+  crm: ["sales", "leads", "contacts", "hubspot", "salesforce"],
+  analytics: ["data", "metrics", "tracking", "mixpanel", "amplitude"],
+  project: ["task", "issue", "board", "jira", "linear", "asana"],
+  docs: ["documentation", "wiki", "notion", "confluence"],
+  design: ["figma", "sketch", "ui", "ux"],
+  security: ["auth", "encryption", "compliance", "vault"]
+};
+function expandQuery(tokens) {
+  const synonyms = new Set;
+  for (const token of tokens) {
+    const matches = SYNONYM_MAP[token];
+    if (matches) {
+      for (const syn of matches) {
+        if (!tokens.includes(syn))
+          synonyms.add(syn);
+      }
+    }
+    for (const [key, values] of Object.entries(SYNONYM_MAP)) {
+      if (values.includes(token) && !tokens.includes(key)) {
+        synonyms.add(key);
+      }
+    }
+  }
+  return { original: tokens, expanded: [...synonyms] };
+}
+
+// src/lib/registry.ts
 var CATEGORIES = [
   "AI & ML",
   "Developer Tools",
@@ -5923,9 +6011,152 @@ var CONNECTORS = [
 function getConnectorsByCategory(category) {
   return CONNECTORS.filter((c) => c.category === category);
 }
-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 searchConnectors(query, context) {
+  const tokens = query.toLowerCase().trim().split(/\s+/).filter(Boolean);
+  if (tokens.length === 0)
+    return [];
+  const limit = context?.limit ?? 20;
+  const installed = new Set(context?.installed ?? []);
+  const promoted = new Set(context?.promoted ?? []);
+  const usage = context?.usage ?? new Map;
+  const results = [];
+  for (const c of CONNECTORS) {
+    const nameLow = c.name.toLowerCase();
+    const displayLow = c.displayName.toLowerCase();
+    const descLow = c.description.toLowerCase();
+    const tagsLow = c.tags.map((t) => t.toLowerCase());
+    let score = 0;
+    const matchReasons = [];
+    let allTokensMatch = true;
+    for (const token of tokens) {
+      let tokenMatched = false;
+      if (nameLow === token) {
+        score += 100;
+        matchReasons.push(`name="${token}"`);
+        tokenMatched = true;
+      } else if (nameLow.includes(token)) {
+        score += 10;
+        matchReasons.push(`name~${token}`);
+        tokenMatched = true;
+      }
+      if (tagsLow.includes(token)) {
+        score += 8;
+        if (!tokenMatched)
+          matchReasons.push(`tag="${token}"`);
+        tokenMatched = true;
+      } else if (tagsLow.some((t) => t.includes(token))) {
+        score += 5;
+        if (!tokenMatched)
+          matchReasons.push(`tag~${token}`);
+        tokenMatched = true;
+      }
+      if (displayLow.includes(token)) {
+        score += 3;
+        if (!tokenMatched)
+          matchReasons.push(`display~${token}`);
+        tokenMatched = true;
+      }
+      if (descLow.includes(token)) {
+        score += 1;
+        if (!tokenMatched)
+          matchReasons.push(`desc~${token}`);
+        tokenMatched = true;
+      }
+      if (!tokenMatched && token.length >= 3) {
+        const nameFuzzy = bestFuzzyScore(token, [nameLow], 1);
+        if (nameFuzzy > 0) {
+          score += nameFuzzy * 6;
+          matchReasons.push(`fuzzy:name\u2248${token}`);
+          tokenMatched = true;
+        }
+        if (!tokenMatched) {
+          const tagFuzzy = bestFuzzyScore(token, tagsLow, 2);
+          if (tagFuzzy > 0) {
+            score += tagFuzzy * 3;
+            matchReasons.push(`fuzzy:tag\u2248${token}`);
+            tokenMatched = true;
+          }
+        }
+        if (!tokenMatched) {
+          const displayFuzzy = bestFuzzyScore(token, [displayLow], 2);
+          if (displayFuzzy > 0) {
+            score += displayFuzzy * 2;
+            matchReasons.push(`fuzzy:display\u2248${token}`);
+            tokenMatched = true;
+          }
+        }
+      }
+      if (!tokenMatched) {
+        allTokensMatch = false;
+        break;
+      }
+    }
+    if (!allTokensMatch)
+      continue;
+    const badges = [];
+    if (installed.has(c.name)) {
+      score += 50;
+      badges.push("installed");
+    }
+    if (promoted.has(c.name)) {
+      score += 30;
+      badges.push("promoted");
+    }
+    const usageCount = usage.get(c.name) ?? 0;
+    if (usageCount > 0) {
+      score += Math.min(usageCount * 2, 40);
+      if (usageCount >= 5)
+        badges.push("hot");
+    }
+    results.push({ ...c, score, matchReasons, badges });
+  }
+  const matchedNames = new Set(results.map((r) => r.name));
+  if (results.length < limit) {
+    const { expanded } = expandQuery(tokens);
+    if (expanded.length > 0) {
+      for (const c of CONNECTORS) {
+        if (matchedNames.has(c.name))
+          continue;
+        const nameLow2 = c.name.toLowerCase();
+        const tagsLow2 = c.tags.map((t) => t.toLowerCase());
+        const descLow2 = c.description.toLowerCase();
+        let synScore = 0;
+        const synReasons = [];
+        for (const syn of expanded) {
+          if (nameLow2.includes(syn)) {
+            synScore += 2;
+            synReasons.push(`syn:name~${syn}`);
+          } else if (tagsLow2.some((t) => t.includes(syn))) {
+            synScore += 1;
+            synReasons.push(`syn:tag~${syn}`);
+          } else if (descLow2.includes(syn)) {
+            synScore += 1;
+            synReasons.push(`syn:desc~${syn}`);
+          }
+        }
+        if (synScore > 0) {
+          const badges = [];
+          if (installed.has(c.name)) {
+            synScore += 50;
+            badges.push("installed");
+          }
+          if (promoted.has(c.name)) {
+            synScore += 30;
+            badges.push("promoted");
+          }
+          const usageCount = usage.get(c.name) ?? 0;
+          if (usageCount > 0) {
+            synScore += Math.min(usageCount * 2, 40);
+            if (usageCount >= 5)
+              badges.push("hot");
+          }
+          results.push({ ...c, score: synScore, matchReasons: synReasons, badges });
+        }
+      }
+    }
+  }
+  results.sort((a, b) => b.score - a.score);
+  return results.slice(0, limit);
 }
 function getConnector(name) {
   return CONNECTORS.find((c) => c.name === name);

package/dist/lib/fuzzy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Levenshtein distance for fuzzy connector search.
+ * No dependencies — pure implementation.
+ */
+/** Compute edit distance between two strings */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * Check if token fuzzy-matches target within maxDistance.
+ * Only applies to tokens >= 3 chars to avoid false positives.
+ */
+export declare function fuzzyMatch(token: string, target: string, maxDistance?: number): boolean;
+/**
+ * Find best fuzzy match score for a token against a list of candidates.
+ * Returns 0 if no match within threshold.
+ */
+export declare function bestFuzzyScore(token: string, candidates: string[], maxDistance?: number): number;

package/dist/lib/fuzzy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/registry.d.ts

@@ -13,6 +13,27 @@ export declare const CATEGORIES: readonly ["AI & ML", "Developer Tools", "Design
 export type Category = (typeof CATEGORIES)[number];
 export declare const CONNECTORS: ConnectorMeta[];
 export declare function getConnectorsByCategory(category: Category): ConnectorMeta[];
-export declare function searchConnectors(query: string): ConnectorMeta[];
+export interface SearchContext {
+    installed?: string[];
+    promoted?: string[];
+    usage?: Map<string, number>;
+}
+export interface ScoredResult extends ConnectorMeta {
+    score: number;
+    matchReasons: string[];
+    badges: string[];
+}
+/**
+ * Ranked connector search with multi-token AND, scoring, and context signals.
+ *
+ * Score formula:
+ *   relevance (name/tag/displayName/description matches)
+ *   + installed boost (+50)
+ *   + promoted boost (+30)
+ *   + usage boost (min(count * 2, 40))
+ */
+export declare function searchConnectors(query: string, context?: SearchContext & {
+    limit?: number;
+}): ScoredResult[];
 export declare function getConnector(name: string): ConnectorMeta | undefined;
 export declare function loadConnectorVersions(): void;

package/dist/lib/synonyms.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Synonym expansion for connector search.
+ * Domain-specific terms only — not a general thesaurus.
+ */
+/**
+ * Expand search tokens with domain synonyms.
+ * Returns original tokens + synonym tokens (deduplicated).
+ */
+export declare function expandQuery(tokens: string[]): {
+    original: string[];
+    expanded: string[];
+};

package/dist/lib/synonyms.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

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