@hasna/connectors 0.0.6 → 0.2.0

package/connectors/connect-browseruse/src/index.ts

@@ -1,35 +0,0 @@
-// Browser Use Connector
-// TypeScript wrapper for the Browser Use Cloud API
-
-export { BrowserUse } from './api';
-export * from './types';
-
-// Re-export individual API classes for advanced usage
-export {
-  BrowserUseClient,
-  TasksApi,
-  SessionsApi,
-  ProfilesApi,
-  BrowsersApi,
-  SkillsApi,
-  MarketplaceApi,
-  FilesApi,
-  BillingApi,
-} from './api';
-
-// Export config utilities
-export {
-  getApiKey,
-  setApiKey,
-  getBaseUrl,
-  setBaseUrl,
-  getCurrentProfile,
-  setCurrentProfile,
-  listProfiles,
-  createProfile,
-  deleteProfile,
-  loadProfile,
-  saveProfile,
-  clearConfig,
-  hasApiKey,
-} from './utils/config';

package/connectors/connect-browseruse/src/types/index.ts

@@ -1,312 +0,0 @@
-/**
- * Browser Use API Types
- */
-
-// ============================================
-// Common Types
-// ============================================
-
-export type OutputFormat = 'json' | 'pretty';
-
-export interface PaginatedResponse<T> {
-  data: T[];
-  hasMore: boolean;
-  nextCursor?: string;
-}
-
-export class BrowserUseApiError extends Error {
-  constructor(
-    message: string,
-    public statusCode: number,
-    public details?: unknown
-  ) {
-    super(message);
-    this.name = 'BrowserUseApiError';
-  }
-}
-
-// ============================================
-// Task Types
-// ============================================
-
-export type TaskStatus =
-  | 'created'
-  | 'queued'
-  | 'running'
-  | 'paused'
-  | 'stopped'
-  | 'completed'
-  | 'failed';
-
-export interface TaskStep {
-  id: string;
-  type: string;
-  description: string;
-  status: 'pending' | 'running' | 'completed' | 'failed';
-  result?: unknown;
-  error?: string;
-  createdAt: string;
-  completedAt?: string;
-}
-
-export interface Task {
-  id: string;
-  task: string;
-  status: TaskStatus;
-  sessionId?: string;
-  steps: TaskStep[];
-  output?: unknown;
-  error?: string;
-  liveUrl?: string;
-  createdAt: string;
-  updatedAt: string;
-  completedAt?: string;
-}
-
-/**
- * Sensitive data configuration for secure credential handling.
- * The LLM only sees placeholder names (e.g., 'x_user', 'x_pass'),
- * actual values are injected directly into forms without LLM exposure.
- */
-export type SensitiveData =
-  | Record<string, string>  // Global: applies to all domains
-  | Record<string, Record<string, string>>;  // Per-domain: 'https://*.example.com': { user: '...', pass: '...' }
-
-export interface CreateTaskParams {
-  task: string;
-  sessionId?: string;
-  schema?: Record<string, unknown>;
-  save_browser_data?: boolean;
-  /**
-   * Sensitive data like credentials to handle securely.
-   * Can be global (applies everywhere) or per-domain.
-   * @example { 'x_user': 'email@example.com', 'x_pass': 'password123' }
-   * @example { 'https://*.mysite.com': { 'user': 'admin', 'pass': 'secret' } }
-   */
-  sensitive_data?: SensitiveData;
-  /** Disable vision to prevent LLM from seeing sensitive data in screenshots */
-  use_vision?: boolean;
-  /** Allowed domains to restrict agent navigation (security) */
-  allowed_domains?: string[];
-}
-
-export interface UpdateTaskParams {
-  action: 'stop' | 'pause' | 'resume' | 'stop-and-close-session';
-}
-
-export interface ListTasksParams {
-  limit?: number;
-  cursor?: string;
-  sessionId?: string;
-  status?: TaskStatus;
-}
-
-// ============================================
-// Session Types
-// ============================================
-
-export type SessionStatus = 'active' | 'inactive' | 'closed';
-
-export interface Session {
-  id: string;
-  status: SessionStatus;
-  profileId?: string;
-  liveUrl?: string;
-  connectUrl?: string;
-  proxyUrl?: string;
-  keepAlive: boolean;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface CreateSessionParams {
-  task?: string;
-  profileId?: string;
-  proxyUrl?: string;
-  keepAlive?: boolean;
-  save_browser_data?: boolean;
-}
-
-export interface ListSessionsParams {
-  limit?: number;
-  cursor?: string;
-  status?: SessionStatus;
-}
-
-export interface SessionPublicShare {
-  id: string;
-  sessionId: string;
-  publicUrl: string;
-  expiresAt: string;
-}
-
-// ============================================
-// Profile Types
-// ============================================
-
-export interface Profile {
-  id: string;
-  name: string;
-  description?: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface CreateProfileParams {
-  name: string;
-  description?: string;
-}
-
-export interface UpdateProfileParams {
-  name?: string;
-  description?: string;
-}
-
-export interface ListProfilesParams {
-  limit?: number;
-  cursor?: string;
-}
-
-// ============================================
-// Browser Session Types
-// ============================================
-
-export interface BrowserSession {
-  id: string;
-  status: 'active' | 'stopped';
-  liveUrl?: string;
-  connectUrl?: string;
-  wsUrl?: string;
-  createdAt: string;
-  stoppedAt?: string;
-}
-
-export interface CreateBrowserSessionParams {
-  profileId?: string;
-  proxyUrl?: string;
-}
-
-export interface ListBrowserSessionsParams {
-  limit?: number;
-  cursor?: string;
-}
-
-// ============================================
-// Skill Types
-// ============================================
-
-export type SkillStatus = 'draft' | 'generating' | 'ready' | 'failed';
-
-export interface SkillParameter {
-  name: string;
-  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-  description?: string;
-  required?: boolean;
-  default?: unknown;
-}
-
-export interface SkillSchema {
-  parameters: SkillParameter[];
-  output?: Record<string, unknown>;
-}
-
-export interface Skill {
-  id: string;
-  name: string;
-  description?: string;
-  status: SkillStatus;
-  schema?: SkillSchema;
-  isPublic: boolean;
-  version: number;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface CreateSkillParams {
-  name: string;
-  description?: string;
-  task: string;
-  exampleInputs?: Record<string, unknown>[];
-}
-
-export interface UpdateSkillParams {
-  name?: string;
-  description?: string;
-  isPublic?: boolean;
-}
-
-export interface ExecuteSkillParams {
-  parameters: Record<string, unknown>;
-  sessionId?: string;
-}
-
-export interface RefineSkillParams {
-  feedback: string;
-}
-
-export interface SkillExecution {
-  id: string;
-  skillId: string;
-  status: 'queued' | 'running' | 'completed' | 'failed';
-  input: Record<string, unknown>;
-  output?: unknown;
-  error?: string;
-  createdAt: string;
-  completedAt?: string;
-}
-
-export interface ListSkillsParams {
-  limit?: number;
-  cursor?: string;
-  status?: SkillStatus;
-}
-
-export interface ListSkillExecutionsParams {
-  limit?: number;
-  cursor?: string;
-}
-
-// ============================================
-// File Types
-// ============================================
-
-export interface PresignedUrl {
-  url: string;
-  expiresAt: string;
-}
-
-export interface UploadFileParams {
-  fileName: string;
-  contentType?: string;
-}
-
-// ============================================
-// Billing Types
-// ============================================
-
-export interface AccountBilling {
-  accountId: string;
-  email: string;
-  credits: number;
-  plan: 'free' | 'payg' | 'business' | 'enterprise';
-  createdAt: string;
-}
-
-// ============================================
-// Marketplace Types
-// ============================================
-
-export interface MarketplaceSkill {
-  id: string;
-  name: string;
-  description?: string;
-  author: string;
-  schema?: SkillSchema;
-  downloads: number;
-  rating?: number;
-  createdAt: string;
-}
-
-export interface CloneSkillParams {
-  name?: string;
-}

package/connectors/connect-browseruse/src/utils/config.ts

@@ -1,212 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-
-const CONNECTOR_NAME = 'connect-browseruse';
-const DEFAULT_PROFILE = 'default';
-
-export interface ProfileConfig {
-  apiKey?: string;
-  baseUrl?: string;
-}
-
-// Store for --profile flag override (set by CLI before commands run)
-let profileOverride: string | undefined;
-
-// Config directory: ~/.connect/{connector-name}/
-const CONFIG_DIR = join(homedir(), '.connect', CONNECTOR_NAME);
-const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
-const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
-
-// ============================================
-// Profile Management
-// ============================================
-
-export function setProfileOverride(profile: string | undefined): void {
-  profileOverride = profile;
-}
-
-export function ensureConfigDir(): void {
-  if (!existsSync(CONFIG_DIR)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-  }
-  if (!existsSync(PROFILES_DIR)) {
-    mkdirSync(PROFILES_DIR, { recursive: true });
-  }
-}
-
-function getProfilePath(profile: string): string {
-  return join(PROFILES_DIR, `${profile}.json`);
-}
-
-/**
- * Get the current active profile name
- */
-export function getCurrentProfile(): string {
-  if (profileOverride) {
-    return profileOverride;
-  }
-
-  ensureConfigDir();
-
-  if (existsSync(CURRENT_PROFILE_FILE)) {
-    try {
-      const profile = readFileSync(CURRENT_PROFILE_FILE, 'utf-8').trim();
-      if (profile && profileExists(profile)) {
-        return profile;
-      }
-    } catch {
-      // Fall through to default
-    }
-  }
-
-  return DEFAULT_PROFILE;
-}
-
-/**
- * Set the current active profile
- */
-export function setCurrentProfile(profile: string): void {
-  ensureConfigDir();
-
-  if (!profileExists(profile) && profile !== DEFAULT_PROFILE) {
-    throw new Error(`Profile "${profile}" does not exist`);
-  }
-
-  writeFileSync(CURRENT_PROFILE_FILE, profile);
-}
-
-/**
- * Check if a profile exists
- */
-export function profileExists(profile: string): boolean {
-  return existsSync(getProfilePath(profile));
-}
-
-/**
- * List all available profiles
- */
-export function listProfiles(): string[] {
-  ensureConfigDir();
-
-  if (!existsSync(PROFILES_DIR)) {
-    return [];
-  }
-
-  return readdirSync(PROFILES_DIR)
-    .filter(f => f.endsWith('.json'))
-    .map(f => f.replace('.json', ''))
-    .sort();
-}
-
-/**
- * Create a new profile
- */
-export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
-  ensureConfigDir();
-
-  if (profileExists(profile)) {
-    return false;
-  }
-
-  // Validate profile name
-  if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
-    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
-  }
-
-  writeFileSync(getProfilePath(profile), JSON.stringify(config, null, 2));
-  return true;
-}
-
-/**
- * Delete a profile
- */
-export function deleteProfile(profile: string): boolean {
-  if (profile === DEFAULT_PROFILE) {
-    return false;
-  }
-
-  if (!profileExists(profile)) {
-    return false;
-  }
-
-  // Switch to default if deleting current profile
-  if (getCurrentProfile() === profile) {
-    setCurrentProfile(DEFAULT_PROFILE);
-  }
-
-  rmSync(getProfilePath(profile));
-  return true;
-}
-
-/**
- * Load profile config
- */
-export function loadProfile(profile?: string): ProfileConfig {
-  ensureConfigDir();
-  const profileName = profile || getCurrentProfile();
-  const profilePath = getProfilePath(profileName);
-
-  if (!existsSync(profilePath)) {
-    return {};
-  }
-
-  try {
-    return JSON.parse(readFileSync(profilePath, 'utf-8'));
-  } catch {
-    return {};
-  }
-}
-
-/**
- * Save profile config
- */
-export function saveProfile(config: ProfileConfig, profile?: string): void {
-  ensureConfigDir();
-  const profileName = profile || getCurrentProfile();
-  writeFileSync(getProfilePath(profileName), JSON.stringify(config, null, 2));
-}
-
-// ============================================
-// Browser Use Credentials Management
-// ============================================
-
-export function getApiKey(): string | undefined {
-  return process.env.BROWSER_USE_API_KEY || loadProfile().apiKey;
-}
-
-export function setApiKey(apiKey: string): void {
-  const config = loadProfile();
-  config.apiKey = apiKey;
-  saveProfile(config);
-}
-
-export function getBaseUrl(): string {
-  return process.env.BROWSER_USE_BASE_URL || loadProfile().baseUrl || 'https://api.browser-use.com/api/v2';
-}
-
-export function setBaseUrl(baseUrl: string): void {
-  const config = loadProfile();
-  config.baseUrl = baseUrl;
-  saveProfile(config);
-}
-
-// ============================================
-// Utility Functions
-// ============================================
-
-export function clearConfig(): void {
-  saveProfile({});
-}
-
-export function getConfigDir(): string {
-  return CONFIG_DIR;
-}
-
-export function getActiveProfileName(): string {
-  return getCurrentProfile();
-}
-
-export function hasApiKey(): boolean {
-  return !!getApiKey();
-}

package/connectors/connect-browseruse/src/utils/output.ts

@@ -1,119 +0,0 @@
-import chalk from 'chalk';
-
-export type OutputFormat = 'json' | 'table' | 'pretty';
-
-export function formatOutput(data: unknown, format: OutputFormat = 'pretty'): string {
-  switch (format) {
-    case 'json':
-      return JSON.stringify(data, null, 2);
-    case 'table':
-      return formatAsTable(data);
-    case 'pretty':
-    default:
-      return formatPretty(data);
-  }
-}
-
-function formatAsTable(data: unknown): string {
-  if (!Array.isArray(data)) {
-    data = [data];
-  }
-
-  const items = data as Record<string, unknown>[];
-  if (items.length === 0) {
-    return 'No data';
-  }
-
-  const firstItem = items[0];
-  if (!firstItem || typeof firstItem !== 'object') {
-    return 'No data';
-  }
-
-  const keys = Object.keys(firstItem);
-  const colWidths = keys.map(key => {
-    const maxValue = Math.max(
-      key.length,
-      ...items.map(item => String(item[key] ?? '').length)
-    );
-    return Math.min(maxValue, 40);
-  });
-
-  const header = keys.map((key, i) => key.padEnd(colWidths[i] ?? 10)).join(' | ');
-  const separator = colWidths.map(w => '-'.repeat(w)).join('-+-');
-
-  const rows = items.map(item =>
-    keys.map((key, i) => {
-      const value = String(item[key] ?? '');
-      const width = colWidths[i] ?? 10;
-      return value.length > width
-        ? value.substring(0, width - 3) + '...'
-        : value.padEnd(width);
-    }).join(' | ')
-  );
-
-  return [header, separator, ...rows].join('\n');
-}
-
-function formatPretty(data: unknown): string {
-  if (Array.isArray(data)) {
-    return data.map((item, i) => `${chalk.cyan(`[${i + 1}]`)} ${formatPrettyItem(item)}`).join('\n\n');
-  }
-  return formatPrettyItem(data);
-}
-
-function formatPrettyItem(item: unknown, indent = 0): string {
-  if (item === null || item === undefined) {
-    return chalk.gray('null');
-  }
-
-  if (typeof item !== 'object') {
-    return String(item);
-  }
-
-  const spaces = '  '.repeat(indent);
-  const entries = Object.entries(item as Record<string, unknown>);
-
-  return entries
-    .map(([key, value]) => {
-      if (Array.isArray(value)) {
-        if (value.length === 0) {
-          return `${spaces}${chalk.blue(key)}: ${chalk.gray('[]')}`;
-        }
-        if (typeof value[0] === 'object') {
-          return `${spaces}${chalk.blue(key)}:\n${value.map(v => formatPrettyItem(v, indent + 1)).join('\n')}`;
-        }
-        return `${spaces}${chalk.blue(key)}: ${value.join(', ')}`;
-      }
-
-      if (typeof value === 'object' && value !== null) {
-        return `${spaces}${chalk.blue(key)}:\n${formatPrettyItem(value, indent + 1)}`;
-      }
-
-      return `${spaces}${chalk.blue(key)}: ${chalk.white(String(value))}`;
-    })
-    .join('\n');
-}
-
-export function success(message: string): void {
-  console.log(chalk.green('✓'), message);
-}
-
-export function error(message: string): void {
-  console.error(chalk.red('✗'), message);
-}
-
-export function warn(message: string): void {
-  console.warn(chalk.yellow('⚠'), message);
-}
-
-export function info(message: string): void {
-  console.log(chalk.blue('ℹ'), message);
-}
-
-export function heading(message: string): void {
-  console.log(chalk.bold.cyan(`\n${message}\n`));
-}
-
-export function print(data: unknown, format: OutputFormat = 'pretty'): void {
-  console.log(formatOutput(data, format));
-}

package/connectors/connect-browseruse/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "esModuleInterop": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["bun-types"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "bin"]
-}