@hasna/connectors 0.4.0 → 0.4.2

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

@@ -0,0 +1,24 @@
+// Supabase Connector
+// A TypeScript wrapper for the Supabase API
+
+export { Supabase } from './api';
+export { SupabaseClient } from './api/client';
+export * from './types';
+
+// Export config utilities
+export {
+  getProjectUrl,
+  setProjectUrl,
+  getServiceRoleKey,
+  setServiceRoleKey,
+  getAnonKey,
+  setAnonKey,
+  getCurrentProfile,
+  setCurrentProfile,
+  listProfiles,
+  createProfile,
+  deleteProfile,
+  loadProfile,
+  saveProfile,
+  clearConfig,
+} from './utils/config';

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

@@ -0,0 +1,215 @@
+// Supabase Connector Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface SupabaseConfig {
+  projectUrl: string;
+  serviceRoleKey?: string;
+  anonKey?: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
+// ============================================
+// Auth Types
+// ============================================
+
+export interface User {
+  id: string;
+  aud: string;
+  role?: string;
+  email?: string;
+  email_confirmed_at?: string;
+  phone?: string;
+  phone_confirmed_at?: string;
+  confirmed_at?: string;
+  last_sign_in_at?: string;
+  app_metadata: {
+    provider?: string;
+    providers?: string[];
+    [key: string]: unknown;
+  };
+  user_metadata: Record<string, unknown>;
+  identities?: Identity[];
+  created_at: string;
+  updated_at: string;
+  is_anonymous?: boolean;
+  banned_until?: string;
+}
+
+export interface Identity {
+  id: string;
+  user_id: string;
+  identity_data: Record<string, unknown>;
+  identity_id: string;
+  provider: string;
+  created_at: string;
+  last_sign_in_at: string;
+  updated_at: string;
+}
+
+export interface Session {
+  access_token: string;
+  token_type: string;
+  expires_in: number;
+  expires_at?: number;
+  refresh_token: string;
+  user: User;
+}
+
+export interface AuthResponse {
+  user: User | null;
+  session: Session | null;
+}
+
+export interface AdminUserAttributes {
+  email?: string;
+  phone?: string;
+  password?: string;
+  email_confirm?: boolean;
+  phone_confirm?: boolean;
+  user_metadata?: Record<string, unknown>;
+  app_metadata?: Record<string, unknown>;
+  ban_duration?: string;
+  role?: string;
+}
+
+export interface ListUsersResult {
+  users: User[];
+  aud?: string;
+  nextPage?: number;
+  lastPage?: number;
+  total?: number;
+}
+
+export interface Factor {
+  id: string;
+  friendly_name?: string;
+  factor_type: 'totp' | 'phone';
+  status: 'verified' | 'unverified';
+  created_at: string;
+  updated_at: string;
+}
+
+// ============================================
+// Storage Types
+// ============================================
+
+export interface Bucket {
+  id: string;
+  name: string;
+  owner?: string;
+  created_at: string;
+  updated_at: string;
+  public: boolean;
+  file_size_limit?: number;
+  allowed_mime_types?: string[];
+}
+
+export interface FileObject {
+  id: string;
+  name: string;
+  bucket_id: string;
+  owner?: string;
+  created_at: string;
+  updated_at: string;
+  last_accessed_at?: string;
+  metadata: Record<string, unknown>;
+}
+
+export interface SignedUrl {
+  signedUrl: string;
+  token?: string;
+  path?: string;
+}
+
+export interface UploadResult {
+  id: string;
+  path: string;
+  fullPath: string;
+}
+
+// ============================================
+// Database Types (REST API)
+// ============================================
+
+export interface TableInfo {
+  table_name: string;
+  table_schema: string;
+  table_type: string;
+}
+
+export interface ColumnInfo {
+  column_name: string;
+  data_type: string;
+  is_nullable: string;
+  column_default?: string;
+  table_name: string;
+  table_schema: string;
+}
+
+// ============================================
+// Edge Functions Types
+// ============================================
+
+export interface EdgeFunction {
+  id: string;
+  slug: string;
+  name: string;
+  version: number;
+  created_at: string;
+  updated_at: string;
+  status: 'ACTIVE' | 'INACTIVE' | 'THROTTLED';
+  verify_jwt: boolean;
+}
+
+// ============================================
+// Project Settings Types
+// ============================================
+
+export interface ProjectSettings {
+  name: string;
+  ref: string;
+  organization_id: string;
+  cloud_provider: string;
+  region: string;
+  created_at: string;
+  database: {
+    host: string;
+    version: string;
+  };
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface SupabaseErrorResponse {
+  error?: string;
+  error_description?: string;
+  message?: string;
+  msg?: string;
+  code?: string;
+  hint?: string;
+  details?: string;
+}
+
+export class SupabaseApiError extends Error {
+  public readonly statusCode: number;
+  public readonly code?: string;
+  public readonly hint?: string;
+
+  constructor(message: string, statusCode: number, code?: string, hint?: string) {
+    super(message);
+    this.name = 'SupabaseApiError';
+    this.statusCode = statusCode;
+    this.code = code;
+    this.hint = hint;
+  }
+}

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

@@ -0,0 +1,219 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONNECTOR_NAME = 'connect-supabase';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  projectUrl?: string;
+  serviceRoleKey?: string;
+  anonKey?: 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));
+}
+
+// ============================================
+// Supabase Config Management
+// ============================================
+
+export function getProjectUrl(): string | undefined {
+  return process.env.SUPABASE_URL || process.env.SUPABASE_PROJECT_URL || loadProfile().projectUrl;
+}
+
+export function setProjectUrl(projectUrl: string): void {
+  const config = loadProfile();
+  config.projectUrl = projectUrl;
+  saveProfile(config);
+}
+
+export function getServiceRoleKey(): string | undefined {
+  return process.env.SUPABASE_SERVICE_ROLE_KEY || process.env.SUPABASE_SERVICE_KEY || loadProfile().serviceRoleKey;
+}
+
+export function setServiceRoleKey(serviceRoleKey: string): void {
+  const config = loadProfile();
+  config.serviceRoleKey = serviceRoleKey;
+  saveProfile(config);
+}
+
+export function getAnonKey(): string | undefined {
+  return process.env.SUPABASE_ANON_KEY || process.env.SUPABASE_KEY || loadProfile().anonKey;
+}
+
+export function setAnonKey(anonKey: string): void {
+  const config = loadProfile();
+  config.anonKey = anonKey;
+  saveProfile(config);
+}
+
+// ============================================
+// Utility Functions
+// ============================================
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getActiveProfileName(): string {
+  return getCurrentProfile();
+}

package/connectors/connect-supabase/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "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"]
+}

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

@@ -0,0 +1,11 @@
+# API Credentials
+# TODO: Update variable names and instructions for your API
+# Example: PERPLEXITY_API_KEY, OPENAI_API_KEY, etc.
+
+CONNECTOR_API_KEY=your-api-key-here
+
+# Optional: API secret (if your API requires it)
+# CONNECTOR_API_SECRET=your-api-secret-here
+
+# Optional: Custom base URL (if needed)
+# CONNECTOR_BASE_URL=https://api.example.com

package/connectors/connect-vercel/CLAUDE.md

@@ -0,0 +1,142 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with code in this repository.
+
+## Project Overview
+
+connect-vercel is a TypeScript connector for Vercel's REST API. It provides a CLI and programmatic interface for managing Vercel deployments, projects, domains, environment variables, and more.
+
+## Build & Run Commands
+
+```bash
+bun install           # Install dependencies
+bun run dev           # Run CLI in development
+bun run build         # Build for distribution
+bun run typecheck     # Type check
+```
+
+## CLI Commands
+
+```bash
+# Authentication
+connect-vercel auth login              # Set API key
+connect-vercel auth logout             # Clear API key
+connect-vercel auth status             # Check auth status
+
+# Profile management
+connect-vercel profile list            # List profiles
+connect-vercel profile use <name>      # Switch profile
+connect-vercel profile create <name>   # Create profile
+connect-vercel profile delete <name>   # Delete profile
+
+# User
+connect-vercel user                    # Get authenticated user info
+
+# Teams
+connect-vercel team list               # List teams
+connect-vercel team get <id>           # Get team details
+connect-vercel team use <id>           # Set team ID for requests
+
+# Projects
+connect-vercel project list            # List projects
+connect-vercel project get <name>      # Get project details
+connect-vercel project create <name>   # Create project
+connect-vercel project delete <name>   # Delete project
+
+# Deployments
+connect-vercel deployment list         # List deployments
+connect-vercel deployment get <id>     # Get deployment details
+connect-vercel deployment cancel <id>  # Cancel deployment
+connect-vercel deployment delete <id>  # Delete deployment
+connect-vercel deployment logs <id>    # Get deployment logs
+
+# Domains
+connect-vercel domain list             # List domains
+connect-vercel domain get <domain>     # Get domain details
+connect-vercel domain add <project> <domain>     # Add domain to project
+connect-vercel domain remove <project> <domain>  # Remove domain from project
+connect-vercel domain verify <project> <domain>  # Verify domain
+
+# Environment Variables
+connect-vercel env list <project>      # List env vars
+connect-vercel env get <project> <id>  # Get env var details
+connect-vercel env create <project>    # Create env var
+connect-vercel env delete <project> <id>  # Delete env var
+
+# Secrets (Legacy)
+connect-vercel secret list             # List secrets
+connect-vercel secret get <name>       # Get secret details
+connect-vercel secret create <name>    # Create secret
+connect-vercel secret delete <name>    # Delete secret
+
+# Aliases
+connect-vercel alias list              # List aliases
+connect-vercel alias get <id>          # Get alias details
+connect-vercel alias assign <deployment> <alias>  # Assign alias
+connect-vercel alias delete <id>       # Delete alias
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `VERCEL_TOKEN` | API token (overrides profile config) |
+| `VERCEL_TEAM_ID` | Team ID (overrides profile config) |
+
+## Authentication
+
+Uses Bearer token authentication. Get your token from:
+https://vercel.com/account/tokens
+
+## Data Storage
+
+```
+~/.connect/connect-vercel/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+Profile JSON structure:
+```json
+{
+  "apiKey": "vercel_token_xxx",
+  "teamId": "team_xxx"
+}
+```
+
+## Code Style
+
+- TypeScript with strict mode
+- ESM modules (type: module)
+- Use async/await for all async operations
+- Type annotations required everywhere
+
+## Project Structure
+
+```
+src/
+├── api/
+│   ├── client.ts     # HTTP client with Bearer auth
+│   └── index.ts      # Vercel API wrapper
+├── cli/
+│   └── index.ts      # CLI commands
+├── types/
+│   └── index.ts      # Type definitions
+├── utils/
+│   ├── config.ts     # Multi-profile configuration
+│   └── output.ts     # CLI output formatting
+└── index.ts          # Library exports
+```
+
+## API Coverage
+
+- User: Get authenticated user
+- Teams: List, get, set
+- Projects: List, get, create, update, delete
+- Deployments: List, get, create, cancel, delete, logs
+- Domains: List, get, add, remove, verify, config
+- Environment Variables: List, get, create, update, delete
+- Secrets (Legacy): List, get, create, delete
+- Aliases: List, get, assign, delete