@hasna/connectors 0.1.0 → 0.2.1

package/connectors/connect-twilio/package.json

@@ -30,11 +30,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   },
-  "homepage": "https://github.com/hasna/opensource-connectors#readme",
+  "homepage": "https://github.com/hasna/connectors#readme",
   "bugs": {
-    "url": "https://github.com/hasna/opensource-connectors/issues"
+    "url": "https://github.com/hasna/connectors/issues"
   },
   "keywords": [
     "twilio",
@@ -51,7 +51,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"

package/connectors/connect-uspto/package.json

@@ -34,7 +34,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"
@@ -49,6 +49,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/connectors/connect-x/package.json

@@ -39,7 +39,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"
@@ -54,6 +54,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/connectors/connect-xads/package.json

@@ -29,7 +29,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0"
@@ -47,6 +47,6 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/connectors/connect-xai/package.json

@@ -41,7 +41,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"
@@ -55,6 +55,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/connectors/connect-youtube/package.json

@@ -42,7 +42,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"
@@ -56,6 +56,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/connectors/connect-zoom/package.json

@@ -32,7 +32,7 @@
     "hasna"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "typescript": "^5"
@@ -46,6 +46,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
+    "url": "git+https://github.com/hasna/connectors.git"
   }
 }

package/dist/cli/cli.test.d.ts

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

package/dist/cli/components/App.d.ts

@@ -0,0 +1,6 @@
+interface AppProps {
+    initialConnectors?: string[];
+    overwrite?: boolean;
+}
+export declare function App({ initialConnectors, overwrite }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/CategorySelect.d.ts

@@ -0,0 +1,6 @@
+interface CategorySelectProps {
+    onSelect: (category: string) => void;
+    onBack?: () => void;
+}
+export declare function CategorySelect({ onSelect, onBack }: CategorySelectProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/ConnectorSelect.d.ts

@@ -0,0 +1,10 @@
+import { ConnectorMeta } from "../../lib/registry.js";
+interface ConnectorSelectProps {
+    connectors: ConnectorMeta[];
+    selected: Set<string>;
+    onToggle: (name: string) => void;
+    onConfirm: () => void;
+    onBack: () => void;
+}
+export declare function ConnectorSelect({ connectors, selected, onToggle, onConfirm, onBack, }: ConnectorSelectProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/Header.d.ts

@@ -0,0 +1,6 @@
+interface HeaderProps {
+    title?: string;
+    subtitle?: string;
+}
+export declare function Header({ title, subtitle }: HeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/InstallProgress.d.ts

@@ -0,0 +1,8 @@
+import { InstallResult } from "../../lib/installer.js";
+interface InstallProgressProps {
+    connectors: string[];
+    overwrite?: boolean;
+    onComplete: (results: InstallResult[]) => void;
+}
+export declare function InstallProgress({ connectors, overwrite, onComplete, }: InstallProgressProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/SearchView.d.ts

@@ -0,0 +1,8 @@
+interface SearchViewProps {
+    selected: Set<string>;
+    onToggle: (name: string) => void;
+    onConfirm: () => void;
+    onBack: () => void;
+}
+export declare function SearchView({ selected, onToggle, onConfirm, onBack, }: SearchViewProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/components/components.test.d.ts

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @hasna/connectors - Open source connector library
+ *
+ * Install API connectors with a single command:
+ *   npx @hasna/connectors install figma stripe github
+ *
+ * Or use the interactive CLI:
+ *   npx @hasna/connectors
+ */
+export { CONNECTORS, CATEGORIES, getConnector, getConnectorsByCategory, searchConnectors, loadConnectorVersions, type ConnectorMeta, type Category, } from "./lib/registry.js";
+export { installConnector, installConnectors, getInstalledConnectors, removeConnector, connectorExists, getConnectorPath, getConnectorDocs, type InstallResult, type InstallOptions, type ConnectorDocs, } from "./lib/installer.js";

package/dist/index.js

@@ -1,6 +1,4 @@
 // @bun
-var __require = import.meta.require;
-
 // src/lib/registry.ts
 import { existsSync, readFileSync } from "fs";
 import { join, dirname } from "path";
@@ -159,13 +157,6 @@ var CONNECTORS = [
     category: "Developer Tools",
     tags: ["scraping", "web"]
   },
-  {
-    name: "browseruse",
-    displayName: "Browser Use",
-    description: "Browser automation for AI",
-    category: "Developer Tools",
-    tags: ["browser", "automation"]
-  },
   {
     name: "shadcn",
     displayName: "shadcn/ui",
@@ -435,9 +426,9 @@ var CONNECTORS = [
   {
     name: "tinker",
     displayName: "Tinker",
-    description: "Internal tooling",
-    category: "Business Tools",
-    tags: ["internal", "tools"]
+    description: "LLM fine-tuning and training API",
+    category: "AI & ML",
+    tags: ["ai", "llm", "fine-tuning"]
   },
   {
     name: "sedo",
@@ -495,7 +486,7 @@ function loadConnectorVersions() {
   }
 }
 // src/lib/installer.ts
-import { existsSync as existsSync2, cpSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { existsSync as existsSync2, cpSync, mkdirSync, readFileSync as readFileSync2, writeFileSync, readdirSync, statSync, rmSync } from "fs";
 import { join as join2, dirname as dirname2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
@@ -518,6 +509,13 @@ function connectorExists(name) {
 }
 function installConnector(name, options = {}) {
   const { targetDir = process.cwd(), overwrite = false } = options;
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    return {
+      connector: name,
+      success: false,
+      error: `Invalid connector name '${name}'`
+    };
+  }
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
   const sourcePath = getConnectorPath(name);
   const destDir = join2(targetDir, ".connectors");
@@ -561,7 +559,6 @@ function installConnectors(names, options = {}) {
 }
 function updateConnectorsIndex(connectorsDir) {
   const indexPath = join2(connectorsDir, "index.ts");
-  const { readdirSync } = __require("fs");
   const connectors = readdirSync(connectorsDir).filter((f) => f.startsWith("connect-") && !f.includes("."));
   const exports = connectors.map((c) => {
     const name = c.replace("connect-", "");
@@ -582,7 +579,6 @@ function getInstalledConnectors(targetDir = process.cwd()) {
   if (!existsSync2(connectorsDir)) {
     return [];
   }
-  const { readdirSync, statSync } = __require("fs");
   return readdirSync(connectorsDir).filter((f) => {
     const fullPath = join2(connectorsDir, f);
     return f.startsWith("connect-") && statSync(fullPath).isDirectory();
@@ -631,7 +627,6 @@ function parseEnvVarsTable(section) {
   return vars;
 }
 function removeConnector(name, targetDir = process.cwd()) {
-  const { rmSync } = __require("fs");
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
   const connectorsDir = join2(targetDir, ".connectors");
   const connectorPath = join2(connectorsDir, connectorName);

package/dist/lib/installer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Connector installer - handles copying connectors to user projects
+ */
+export interface InstallResult {
+    connector: string;
+    success: boolean;
+    error?: string;
+    path?: string;
+}
+export interface InstallOptions {
+    targetDir?: string;
+    overwrite?: boolean;
+}
+/**
+ * Get the path to a connector in the package
+ */
+export declare function getConnectorPath(name: string): string;
+/**
+ * Check if a connector exists in the package
+ */
+export declare function connectorExists(name: string): boolean;
+/**
+ * Install a single connector to the target directory
+ */
+export declare function installConnector(name: string, options?: InstallOptions): InstallResult;
+/**
+ * Install multiple connectors
+ */
+export declare function installConnectors(names: string[], options?: InstallOptions): InstallResult[];
+/**
+ * Get list of installed connectors in a directory
+ */
+export declare function getInstalledConnectors(targetDir?: string): string[];
+/**
+ * Parsed documentation from a connector's CLAUDE.md
+ */
+export interface ConnectorDocs {
+    overview: string;
+    auth: string;
+    envVars: {
+        variable: string;
+        description: string;
+    }[];
+    cliCommands: string;
+    dataStorage: string;
+    raw: string;
+}
+/**
+ * Read and parse a connector's documentation (CLAUDE.md)
+ */
+export declare function getConnectorDocs(name: string): ConnectorDocs | null;
+/**
+ * Remove an installed connector
+ */
+export declare function removeConnector(name: string, targetDir?: string): boolean;

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

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

package/dist/lib/registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Connector registry - metadata about all available connectors
+ */
+export interface ConnectorMeta {
+    name: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags: string[];
+    version?: string;
+}
+export declare const CATEGORIES: readonly ["AI & ML", "Developer Tools", "Design & Content", "Communication", "Social Media", "Commerce & Finance", "Google Workspace", "Data & Analytics", "Business Tools", "Patents & IP", "Advertising"];
+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 declare function getConnector(name: string): ConnectorMeta | undefined;
+export declare function loadConnectorVersions(): void;

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

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/mcp/mcp.test.d.ts

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

package/dist/server/auth.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Auth status detection and token management for the dashboard server.
+ * Reads connector CLAUDE.md files to determine auth type, checks profile
+ * directories for stored credentials, and handles token operations.
+ */
+export type AuthType = "oauth" | "apikey" | "bearer";
+export interface AuthStatus {
+    type: AuthType;
+    configured: boolean;
+    tokenExpiry?: number;
+    hasRefreshToken?: boolean;
+    envVars: {
+        variable: string;
+        description: string;
+        set: boolean;
+    }[];
+}
+export interface OAuthTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    tokenType?: string;
+    scope?: string;
+}
+/**
+ * Get the auth type for a connector by parsing its CLAUDE.md
+ */
+export declare function getAuthType(name: string): AuthType;
+/**
+ * Get the full auth status for a connector
+ */
+export declare function getAuthStatus(name: string): AuthStatus;
+/**
+ * Get required env var names from a connector's CLAUDE.md
+ */
+export declare function getEnvVars(name: string): {
+    variable: string;
+    description: string;
+}[];
+/**
+ * Save an API key to a connector's profile
+ */
+export declare function saveApiKey(name: string, key: string, field?: string): void;
+/**
+ * Get OAuth client credentials for a connector
+ */
+export declare function getOAuthConfig(name: string): {
+    clientId?: string;
+    clientSecret?: string;
+};
+/**
+ * Build OAuth authorization URL for a connector
+ */
+export declare function getOAuthStartUrl(name: string, redirectUri: string): string | null;
+/**
+ * Validate and consume an OAuth state token (CSRF protection)
+ */
+export declare function validateOAuthState(state: string | null, expectedConnector: string): boolean;
+/**
+ * Exchange an OAuth authorization code for tokens
+ */
+export declare function exchangeOAuthCode(name: string, code: string, redirectUri: string): Promise<OAuthTokens>;
+/**
+ * Refresh an OAuth token using the stored refresh token
+ */
+export declare function refreshOAuthToken(name: string): Promise<OAuthTokens>;
+/**
+ * Get token expiry time for an OAuth connector
+ */
+export declare function getTokenExpiry(name: string): number | null;

package/dist/server/dashboard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTML dashboard template for the connector auth management server.
+ * Single-file HTML with embedded CSS/JS — no frameworks.
+ */
+export declare function getDashboardHtml(port: number): string;

package/dist/server/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * Standalone entry point for the connector auth dashboard server.
+ * Usage: connectors-serve [--port 19426]
+ */
+export {};

package/dist/server/serve.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reusable server starter for the connector auth dashboard.
+ * Used by both the CLI `serve` command and the standalone `connectors-serve` binary.
+ * Serves the Vite-built React/shadcn dashboard from dashboard/dist/.
+ */
+export interface ServeOptions {
+    port: number;
+    open?: boolean;
+}
+export declare function startServer(port: number, options?: {
+    open?: boolean;
+}): Promise<void>;

package/dist/server/server.test.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {
@@ -24,12 +24,13 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "cd dashboard && bun run build && cd .. && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/serve.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun",
+    "build": "cd dashboard && bun run build && cd .. && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk --external conf && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/serve.js --target bun && bun build ./src/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --outDir ./dist",
     "build:dashboard": "cd dashboard && bun run build",
+    "postinstall": "cd dashboard && bun install",
     "dev": "bun run ./src/cli/index.tsx",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun test && bun run build"
   },
   "keywords": [
     "connectors",
@@ -45,7 +46,7 @@
     "model-context-protocol"
   ],
   "author": "Hasna",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/bun": "latest",
     "@types/react": "^18.2.0",

package/connectors/connect-browseruse/.env.example

@@ -1,7 +0,0 @@
-# Browser Use Cloud API
-# Set these environment variables or use profile configuration
-
-BROWSER_USE_API_KEY=bu_your_api_key_here
-
-# Optional: Base URL (defaults to https://api.browser-use.com)
-# BROWSER_USE_BASE_URL=https://api.browser-use.com

package/connectors/connect-browseruse/.npmrc.example

@@ -1,2 +0,0 @@
-@hasna:registry=https://registry.npmjs.org/
-//registry.npmjs.org/:_authToken=${NPM_TOKEN}