@hasna/connectors 0.9.0 → 0.9.2

package/connectors/connect-digicert/src/utils/storage.ts

@@ -0,0 +1,198 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { getConfigDir } from './config';
+
+// ============================================
+// Generic Data Storage Utility
+// ============================================
+
+/**
+ * Base interface for storable entities
+ * All stored entities should have an id field
+ */
+export interface Storable {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+/**
+ * Get the storage directory for an entity type
+ */
+function getStorageDir(entityType: string): string {
+  const dir = join(getConfigDir(), 'data', entityType);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+/**
+ * Convert an ID to a safe filename
+ */
+function idToFilename(id: string): string {
+  return id.toLowerCase().replace(/[^a-z0-9]/g, '_') + '.json';
+}
+
+/**
+ * Get the file path for an entity
+ */
+function getEntityPath(entityType: string, id: string): string {
+  return join(getStorageDir(entityType), idToFilename(id));
+}
+
+/**
+ * Save an entity to storage
+ */
+export function saveEntity<T extends Storable>(entityType: string, entity: T): void {
+  const filepath = getEntityPath(entityType, entity.id);
+  const now = new Date().toISOString();
+
+  const existing = getEntity<T>(entityType, entity.id);
+
+  const data: T = {
+    ...entity,
+    createdAt: existing?.createdAt || now,
+    updatedAt: now,
+  };
+
+  writeFileSync(filepath, JSON.stringify(data, null, 2));
+}
+
+/**
+ * Get an entity by ID
+ */
+export function getEntity<T extends Storable>(entityType: string, id: string): T | null {
+  const filepath = getEntityPath(entityType, id);
+
+  if (!existsSync(filepath)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(filepath, 'utf-8');
+    return JSON.parse(content) as T;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if an entity exists
+ */
+export function entityExists(entityType: string, id: string): boolean {
+  return existsSync(getEntityPath(entityType, id));
+}
+
+/**
+ * Get all entities of a type
+ */
+export function getAllEntities<T extends Storable>(entityType: string): T[] {
+  const storageDir = getStorageDir(entityType);
+  const files = readdirSync(storageDir).filter(f => f.endsWith('.json'));
+
+  const entities: T[] = [];
+  for (const file of files) {
+    try {
+      const content = readFileSync(join(storageDir, file), 'utf-8');
+      entities.push(JSON.parse(content) as T);
+    } catch {
+      // Skip invalid files
+    }
+  }
+
+  return entities.sort((a, b) => a.id.localeCompare(b.id));
+}
+
+/**
+ * Delete an entity
+ */
+export function deleteEntity(entityType: string, id: string): boolean {
+  const filepath = getEntityPath(entityType, id);
+
+  if (existsSync(filepath)) {
+    unlinkSync(filepath);
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Search entities by a predicate function
+ */
+export function searchEntities<T extends Storable>(
+  entityType: string,
+  predicate: (entity: T) => boolean
+): T[] {
+  const all = getAllEntities<T>(entityType);
+  return all.filter(predicate);
+}
+
+/**
+ * Search entities by text match across all string fields
+ */
+export function searchEntitiesByText<T extends Storable>(
+  entityType: string,
+  query: string,
+  fields?: (keyof T)[]
+): T[] {
+  const all = getAllEntities<T>(entityType);
+  const q = query.toLowerCase();
+
+  return all.filter(entity => {
+    const searchFields = fields || (Object.keys(entity) as (keyof T)[]);
+    return searchFields.some(field => {
+      const value = entity[field];
+      if (typeof value === 'string') {
+        return value.toLowerCase().includes(q);
+      }
+      return false;
+    });
+  });
+}
+
+/**
+ * Count entities of a type
+ */
+export function countEntities(entityType: string): number {
+  const storageDir = getStorageDir(entityType);
+  if (!existsSync(storageDir)) {
+    return 0;
+  }
+  return readdirSync(storageDir).filter(f => f.endsWith('.json')).length;
+}
+
+/**
+ * Clear all entities of a type
+ */
+export function clearEntities(entityType: string): number {
+  const storageDir = getStorageDir(entityType);
+  if (!existsSync(storageDir)) {
+    return 0;
+  }
+
+  const files = readdirSync(storageDir).filter(f => f.endsWith('.json'));
+  for (const file of files) {
+    unlinkSync(join(storageDir, file));
+  }
+
+  return files.length;
+}
+
+/**
+ * Create a typed storage helper for a specific entity type
+ * This provides a cleaner API for working with a single entity type
+ */
+export function createStorage<T extends Storable>(entityType: string) {
+  return {
+    save: (entity: T) => saveEntity<T>(entityType, entity),
+    get: (id: string) => getEntity<T>(entityType, id),
+    exists: (id: string) => entityExists(entityType, id),
+    getAll: () => getAllEntities<T>(entityType),
+    delete: (id: string) => deleteEntity(entityType, id),
+    search: (predicate: (entity: T) => boolean) => searchEntities<T>(entityType, predicate),
+    searchByText: (query: string, fields?: (keyof T)[]) => searchEntitiesByText<T>(entityType, query, fields),
+    count: () => countEntities(entityType),
+    clear: () => clearEntities(entityType),
+  };
+}

package/connectors/connect-digicert/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-digitalocean/.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-digitalocean/CLAUDE.md

@@ -0,0 +1,197 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with code in this repository.
+
+## Project Overview
+
+connect-digitalocean is a TypeScript connector for DigitalOcean's REST API. It provides a CLI and programmatic interface for managing droplets, volumes, databases, domains, Kubernetes clusters, 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-digitalocean config set-key <key>   # Set API key
+connect-digitalocean config show            # Show current config
+connect-digitalocean config clear           # Clear config
+
+# Profile management
+connect-digitalocean profile list           # List profiles
+connect-digitalocean profile use <name>     # Switch profile
+connect-digitalocean profile create <name>  # Create profile
+connect-digitalocean profile delete <name>  # Delete profile
+
+# Account
+connect-digitalocean account                # Get account info
+
+# Regions and Sizes
+connect-digitalocean regions                # List regions
+connect-digitalocean sizes                  # List sizes
+
+# Droplets
+connect-digitalocean droplet list           # List droplets
+connect-digitalocean droplet get <id>       # Get droplet details
+connect-digitalocean droplet create         # Create droplet
+connect-digitalocean droplet delete <id>    # Delete droplet
+connect-digitalocean droplet action <id>    # Perform action
+
+# Images
+connect-digitalocean image list             # List images
+connect-digitalocean image get <id>         # Get image details
+connect-digitalocean image delete <id>      # Delete image
+
+# SSH Keys
+connect-digitalocean ssh-key list           # List SSH keys
+connect-digitalocean ssh-key get <id>       # Get key details
+connect-digitalocean ssh-key create         # Create SSH key
+connect-digitalocean ssh-key delete <id>    # Delete SSH key
+
+# Volumes
+connect-digitalocean volume list            # List volumes
+connect-digitalocean volume get <id>        # Get volume details
+connect-digitalocean volume create          # Create volume
+connect-digitalocean volume delete <id>     # Delete volume
+connect-digitalocean volume attach <id> <dropletId>   # Attach volume
+connect-digitalocean volume detach <id> <dropletId>   # Detach volume
+
+# Domains
+connect-digitalocean domain list            # List domains
+connect-digitalocean domain get <domain>    # Get domain details
+connect-digitalocean domain create <domain> # Create domain
+connect-digitalocean domain delete <domain> # Delete domain
+connect-digitalocean domain records <domain>    # List records
+connect-digitalocean domain record-create <domain>  # Create record
+connect-digitalocean domain record-delete <domain> <recordId>  # Delete record
+
+# Firewalls
+connect-digitalocean firewall list          # List firewalls
+connect-digitalocean firewall get <id>      # Get firewall details
+connect-digitalocean firewall delete <id>   # Delete firewall
+
+# Load Balancers
+connect-digitalocean load-balancer list     # List load balancers
+connect-digitalocean load-balancer get <id> # Get load balancer details
+connect-digitalocean load-balancer delete <id>  # Delete load balancer
+
+# Databases
+connect-digitalocean database list          # List databases
+connect-digitalocean database get <id>      # Get database details
+connect-digitalocean database create        # Create database cluster
+connect-digitalocean database delete <id>   # Delete database cluster
+
+# Kubernetes
+connect-digitalocean kubernetes list        # List K8s clusters
+connect-digitalocean kubernetes get <id>    # Get cluster details
+connect-digitalocean kubernetes delete <id> # Delete cluster
+connect-digitalocean kubernetes kubeconfig <id>  # Get kubeconfig
+
+# Projects
+connect-digitalocean project list           # List projects
+connect-digitalocean project get <id>       # Get project details
+connect-digitalocean project create         # Create project
+connect-digitalocean project delete <id>    # Delete project
+connect-digitalocean project default        # Get default project
+
+# Snapshots
+connect-digitalocean snapshot list          # List snapshots
+connect-digitalocean snapshot get <id>      # Get snapshot details
+connect-digitalocean snapshot delete <id>   # Delete snapshot
+
+# Floating IPs
+connect-digitalocean floating-ip list       # List floating IPs
+connect-digitalocean floating-ip get <ip>   # Get floating IP details
+connect-digitalocean floating-ip create     # Create floating IP
+connect-digitalocean floating-ip delete <ip>  # Delete floating IP
+
+# VPCs
+connect-digitalocean vpc list               # List VPCs
+connect-digitalocean vpc get <id>           # Get VPC details
+connect-digitalocean vpc create             # Create VPC
+connect-digitalocean vpc delete <id>        # Delete VPC
+
+# Actions
+connect-digitalocean action list            # List all actions
+connect-digitalocean action get <id>        # Get action details
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DIGITALOCEAN_TOKEN` | API token (overrides profile) |
+| `DIGITALOCEAN_ACCESS_TOKEN` | Alias for DIGITALOCEAN_TOKEN |
+
+## Authentication
+
+Uses Bearer token authentication. Get your token from:
+https://cloud.digitalocean.com/account/api/tokens
+
+## Data Storage
+
+```
+~/.connect/connect-digitalocean/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+Profile JSON structure:
+```json
+{
+  "apiKey": "dop_v1_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      # DigitalOcean 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
+
+- Account: Get account info
+- Regions: List
+- Sizes: List
+- Droplets: List, get, create, delete, actions
+- Images: List, get, delete
+- SSH Keys: List, get, create, delete
+- Volumes: List, get, create, delete, attach, detach
+- Domains: List, get, create, delete
+- Domain Records: List, get, create, update, delete
+- Firewalls: List, get, create, update, delete
+- Load Balancers: List, get, delete
+- Databases: List, get, create, delete
+- Kubernetes: List, get, delete, kubeconfig
+- Projects: List, get, create, update, delete, default
+- Snapshots: List, get, delete
+- Floating IPs: List, get, create, delete
+- VPCs: List, get, create, update, delete
+- Actions: List, get

package/connectors/connect-digitalocean/README.md

@@ -0,0 +1,146 @@
+# connect-digitalocean
+
+DigitalOcean connector - Manage droplets, volumes, databases, domains, and more
+
+## Installation
+
+```bash
+bun install -g @hasna/connect-digitalocean
+```
+
+## Quick Start
+
+```bash
+# Set your API key
+connect-digitalocean config set-key YOUR_API_KEY
+
+# Or use environment variable
+export DIGITALOCEAN_TOKEN=YOUR_API_KEY
+```
+
+## CLI Commands
+
+### Account & Infrastructure
+```bash
+connect-digitalocean account                # Get account info
+connect-digitalocean regions                # List regions
+connect-digitalocean sizes                  # List sizes
+```
+
+### Droplets
+```bash
+connect-digitalocean droplet list           # List droplets
+connect-digitalocean droplet get <id>       # Get droplet details
+connect-digitalocean droplet create         # Create droplet
+connect-digitalocean droplet delete <id>    # Delete droplet
+connect-digitalocean droplet action <id>    # Perform action
+```
+
+### Volumes
+```bash
+connect-digitalocean volume list            # List volumes
+connect-digitalocean volume get <id>        # Get volume details
+connect-digitalocean volume create          # Create volume
+connect-digitalocean volume delete <id>     # Delete volume
+connect-digitalocean volume attach <id> <dropletId>   # Attach volume
+connect-digitalocean volume detach <id> <dropletId>   # Detach volume
+```
+
+### Domains
+```bash
+connect-digitalocean domain list            # List domains
+connect-digitalocean domain get <domain>    # Get domain details
+connect-digitalocean domain create <domain> # Create domain
+connect-digitalocean domain delete <domain> # Delete domain
+connect-digitalocean domain records <domain>    # List records
+```
+
+### Databases
+```bash
+connect-digitalocean database list          # List databases
+connect-digitalocean database get <id>      # Get database details
+connect-digitalocean database create        # Create database cluster
+connect-digitalocean database delete <id>   # Delete database cluster
+```
+
+### Kubernetes
+```bash
+connect-digitalocean kubernetes list        # List K8s clusters
+connect-digitalocean kubernetes get <id>    # Get cluster details
+connect-digitalocean kubernetes delete <id> # Delete cluster
+connect-digitalocean kubernetes kubeconfig <id>  # Get kubeconfig
+```
+
+### Profile & Config
+```bash
+connect-digitalocean profile list           # List profiles
+connect-digitalocean profile use <name>     # Switch profile
+connect-digitalocean profile create <name>  # Create profile
+connect-digitalocean config set-key <key>   # Set API key
+connect-digitalocean config show            # Show config
+connect-digitalocean config clear           # Clear config
+```
+
+## Profile Management
+
+```bash
+# Create profiles for different accounts
+connect-digitalocean profile create work --api-key xxx --use
+connect-digitalocean profile create personal --api-key yyy
+
+# Switch profiles
+connect-digitalocean profile use work
+
+# Use profile for single command
+connect-digitalocean -p personal <command>
+
+# List profiles
+connect-digitalocean profile list
+```
+
+## Library Usage
+
+```typescript
+import { DigitalOcean } from '@hasna/connect-digitalocean';
+
+const client = new DigitalOcean({ apiKey: 'YOUR_API_KEY' });
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DIGITALOCEAN_TOKEN` | API token (overrides profile) |
+| `DIGITALOCEAN_ACCESS_TOKEN` | Alias for DIGITALOCEAN_TOKEN |
+
+## Data Storage
+
+Configuration stored in `~/.connect/connect-digitalocean/`:
+
+```
+~/.connect/connect-digitalocean/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run CLI in development
+bun run dev
+
+# Build
+bun run build
+
+# Type check
+bun run typecheck
+```
+
+## License
+
+Apache-2.0

package/connectors/connect-digitalocean/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hasna/connect-digitalocean",
+  "version": "0.0.1",
+  "description": "DigitalOcean connector - Manage droplets, volumes, databases, domains, and more",
+  "type": "module",
+  "bin": {
+    "connect-digitalocean": "./bin/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun && bun build ./src/cli/index.ts --outdir ./bin --target bun",
+    "dev": "bun run ./src/cli/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "digitalocean",
+    "droplets",
+    "cloud",
+    "vps",
+    "infrastructure",
+    "kubernetes",
+    "databases",
+    "connector",
+    "cli",
+    "typescript",
+    "bun"
+  ],
+  "author": "Hasna",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hasna/connectors.git"
+  }
+}