@hasna/connectors 0.0.1

package/connectors/connect-docker/src/cli/index.ts

@@ -0,0 +1,318 @@
+#!/usr/bin/env bun
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { Docker } from '../api';
+import {
+  getAccessToken,
+  setAccessToken,
+  getUsername,
+  setUsername,
+  getPassword,
+  setPassword,
+  clearConfig,
+  getConfigDir,
+  setProfileOverride,
+  getCurrentProfile,
+  setCurrentProfile,
+  listProfiles,
+  createProfile,
+  deleteProfile,
+  profileExists,
+  loadProfile,
+} from '../utils/config';
+import type { OutputFormat } from '../utils/output';
+import { success, error, info, print, warn } from '../utils/output';
+
+// Docker Hub connector
+const CONNECTOR_NAME = 'docker';
+const VERSION = '0.1.0';
+
+const program = new Command();
+
+program
+  .name(CONNECTOR_NAME)
+  .description('Docker Hub API connector CLI')
+  .version(VERSION)
+  .option('-t, --token <token>', 'Access token (overrides config)')
+  .option('-u, --username <username>', 'Docker Hub username')
+  .option('-f, --format <format>', 'Output format (json, pretty)', 'pretty')
+  .option('-p, --profile <profile>', 'Use a specific profile')
+  .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    // Set profile override before any command runs
+    if (opts.profile) {
+      if (!profileExists(opts.profile)) {
+        error(`Profile "${opts.profile}" does not exist. Create it with "${CONNECTOR_NAME} profile create ${opts.profile}"`);
+        process.exit(1);
+      }
+      setProfileOverride(opts.profile);
+    }
+    // Set credentials from flags if provided
+    if (opts.token) {
+      process.env.DOCKER_ACCESS_TOKEN = opts.token;
+    }
+    if (opts.username) {
+      process.env.DOCKER_USERNAME = opts.username;
+    }
+  });
+
+// Helper to get output format
+function getFormat(cmd: Command): OutputFormat {
+  const parent = cmd.parent;
+  return (parent?.opts().format || 'pretty') as OutputFormat;
+}
+
+// Helper to get authenticated client
+function getClient(): Docker {
+  const accessToken = getAccessToken();
+  const username = getUsername();
+  const password = getPassword();
+
+  if (accessToken) {
+    return new Docker({ accessToken });
+  }
+
+  if (username && password) {
+    return new Docker({ username, password });
+  }
+
+  error(`No credentials configured. Run "${CONNECTOR_NAME} config set-token <token>" or set DOCKER_ACCESS_TOKEN environment variable.`);
+  process.exit(1);
+}
+
+// ============================================
+// Profile Commands
+// ============================================
+const profileCmd = program
+  .command('profile')
+  .description('Manage configuration profiles');
+
+profileCmd
+  .command('list')
+  .description('List all profiles')
+  .action(() => {
+    const profiles = listProfiles();
+    const current = getCurrentProfile();
+
+    if (profiles.length === 0) {
+      info('No profiles found. Use "profile create <name>" to create one.');
+      return;
+    }
+
+    success(`Profiles:`);
+    profiles.forEach(p => {
+      const isActive = p === current ? chalk.green(' (active)') : '';
+      console.log(`  ${p}${isActive}`);
+    });
+  });
+
+profileCmd
+  .command('use <name>')
+  .description('Switch to a profile')
+  .action((name: string) => {
+    if (!profileExists(name)) {
+      error(`Profile "${name}" does not exist. Create it with "profile create ${name}"`);
+      process.exit(1);
+    }
+    setCurrentProfile(name);
+    success(`Switched to profile: ${name}`);
+  });
+
+profileCmd
+  .command('create <name>')
+  .description('Create a new profile')
+  .option('--token <token>', 'Access token')
+  .option('--username <username>', 'Docker Hub username')
+  .option('--password <password>', 'Docker Hub password')
+  .option('--use', 'Switch to this profile after creation')
+  .action((name: string, opts) => {
+    if (profileExists(name)) {
+      error(`Profile "${name}" already exists`);
+      process.exit(1);
+    }
+
+    createProfile(name, {
+      accessToken: opts.token,
+      username: opts.username,
+      password: opts.password,
+    });
+    success(`Profile "${name}" created`);
+
+    if (opts.use) {
+      setCurrentProfile(name);
+      info(`Switched to profile: ${name}`);
+    }
+  });
+
+profileCmd
+  .command('delete <name>')
+  .description('Delete a profile')
+  .action((name: string) => {
+    if (name === 'default') {
+      error('Cannot delete the default profile');
+      process.exit(1);
+    }
+    if (deleteProfile(name)) {
+      success(`Profile "${name}" deleted`);
+    } else {
+      error(`Profile "${name}" not found`);
+      process.exit(1);
+    }
+  });
+
+profileCmd
+  .command('show [name]')
+  .description('Show profile configuration')
+  .action((name?: string) => {
+    const profileName = name || getCurrentProfile();
+    const config = loadProfile(profileName);
+    const active = getCurrentProfile();
+
+    console.log(chalk.bold(`Profile: ${profileName}${profileName === active ? chalk.green(' (active)') : ''}`));
+    info(`Username: ${config.username || chalk.gray('not set')}`);
+    info(`Access Token: ${config.accessToken ? `${config.accessToken.substring(0, 8)}...` : chalk.gray('not set')}`);
+    info(`Password: ${config.password ? '********' : chalk.gray('not set')}`);
+  });
+
+// ============================================
+// Config Commands
+// ============================================
+const configCmd = program
+  .command('config')
+  .description('Manage CLI configuration (for active profile)');
+
+configCmd
+  .command('set-token <token>')
+  .description('Set access token')
+  .action((token: string) => {
+    setAccessToken(token);
+    success(`Access token saved to profile: ${getCurrentProfile()}`);
+  });
+
+configCmd
+  .command('set-username <username>')
+  .description('Set Docker Hub username')
+  .action((username: string) => {
+    setUsername(username);
+    success(`Username saved to profile: ${getCurrentProfile()}`);
+  });
+
+configCmd
+  .command('set-password <password>')
+  .description('Set Docker Hub password')
+  .action((password: string) => {
+    setPassword(password);
+    success(`Password saved to profile: ${getCurrentProfile()}`);
+  });
+
+configCmd
+  .command('show')
+  .description('Show current configuration')
+  .action(() => {
+    const profileName = getCurrentProfile();
+    const accessToken = getAccessToken();
+    const username = getUsername();
+
+    console.log(chalk.bold(`Active Profile: ${profileName}`));
+    info(`Config directory: ${getConfigDir()}`);
+    info(`Username: ${username || chalk.gray('not set')}`);
+    info(`Access Token: ${accessToken ? `${accessToken.substring(0, 8)}...` : chalk.gray('not set')}`);
+  });
+
+configCmd
+  .command('clear')
+  .description('Clear configuration for active profile')
+  .action(() => {
+    clearConfig();
+    success(`Configuration cleared for profile: ${getCurrentProfile()}`);
+  });
+
+// ============================================
+// Repository Commands
+// ============================================
+const repoCmd = program
+  .command('repo')
+  .description('Manage Docker Hub repositories');
+
+repoCmd
+  .command('list <namespace>')
+  .description('List repositories for a namespace')
+  .option('--page <number>', 'Page number', '1')
+  .option('--page-size <number>', 'Results per page', '25')
+  .action(async (namespace: string, opts) => {
+    try {
+      const client = getClient();
+      const result = await client.repositories.list(namespace, {
+        page: parseInt(opts.page),
+        pageSize: parseInt(opts.pageSize),
+      });
+      print(result, getFormat(repoCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
+  });
+
+repoCmd
+  .command('get <namespace> <repository>')
+  .description('Get repository details')
+  .action(async (namespace: string, repository: string) => {
+    try {
+      const client = getClient();
+      const result = await client.repositories.get(namespace, repository);
+      print(result, getFormat(repoCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
+  });
+
+repoCmd
+  .command('tags <namespace> <repository>')
+  .description('List tags for a repository')
+  .option('--page <number>', 'Page number', '1')
+  .option('--page-size <number>', 'Results per page', '25')
+  .action(async (namespace: string, repository: string, opts) => {
+    try {
+      const client = getClient();
+      const result = await client.repositories.listTags(namespace, repository, {
+        page: parseInt(opts.page),
+        pageSize: parseInt(opts.pageSize),
+      });
+      print(result, getFormat(repoCmd));
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
+  });
+
+repoCmd
+  .command('delete-tag <namespace> <repository> <tag>')
+  .description('Delete a tag from a repository')
+  .action(async (namespace: string, repository: string, tag: string) => {
+    try {
+      const client = getClient();
+      await client.repositories.deleteTag(namespace, repository, tag);
+      success(`Tag "${tag}" deleted from ${namespace}/${repository}`);
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
+  });
+
+repoCmd
+  .command('delete <namespace> <repository>')
+  .description('Delete a repository')
+  .action(async (namespace: string, repository: string) => {
+    try {
+      const client = getClient();
+      await client.repositories.delete(namespace, repository);
+      success(`Repository ${namespace}/${repository} deleted`);
+    } catch (err) {
+      error(String(err));
+      process.exit(1);
+    }
+  });
+
+// Parse and execute
+program.parse();

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

@@ -0,0 +1,30 @@
+// Docker Hub API Connector
+// A TypeScript wrapper for Docker Hub API
+
+export { Docker, Connector } from './api';
+export * from './types';
+
+// Re-export individual API classes for advanced usage
+export { DockerClient, ConnectorClient, RepositoriesApi, ExampleApi } from './api';
+
+// Export config utilities
+export {
+  getAccessToken,
+  setAccessToken,
+  getUsername,
+  setUsername,
+  getPassword,
+  setPassword,
+  getApiKey,
+  setApiKey,
+  getApiSecret,
+  setApiSecret,
+  getCurrentProfile,
+  setCurrentProfile,
+  listProfiles,
+  createProfile,
+  deleteProfile,
+  loadProfile,
+  saveProfile,
+  clearConfig,
+} from './utils/config';

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

@@ -0,0 +1,172 @@
+// Docker Hub API Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface DockerConfig {
+  username?: string;
+  password?: string;
+  accessToken?: string;
+  baseUrl?: string; // Override default base URL
+}
+
+// Legacy alias for compatibility
+export type ConnectorConfig = DockerConfig;
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
+export interface PaginatedResponse<T> {
+  count: number;
+  next: string | null;
+  previous: string | null;
+  results: T[];
+}
+
+// ============================================
+// Repository Types
+// ============================================
+
+export interface Repository {
+  user: string;
+  name: string;
+  namespace: string;
+  repository_type: string;
+  status: number;
+  status_description: string;
+  description: string;
+  is_private: boolean;
+  is_automated: boolean;
+  star_count: number;
+  pull_count: number;
+  last_updated: string;
+  date_registered: string;
+  collaborator_count: number;
+  affiliation: string | null;
+  hub_user: string;
+  has_starred: boolean;
+  full_description: string;
+  permissions: {
+    read: boolean;
+    write: boolean;
+    admin: boolean;
+  };
+}
+
+export interface RepositoryListResponse {
+  count: number;
+  next: string | null;
+  previous: string | null;
+  results: Repository[];
+}
+
+// ============================================
+// Tag Types
+// ============================================
+
+export interface TagImage {
+  architecture: string;
+  features: string;
+  variant: string | null;
+  digest: string;
+  os: string;
+  os_features: string;
+  os_version: string | null;
+  size: number;
+  status: string;
+  last_pulled: string | null;
+  last_pushed: string | null;
+}
+
+export interface Tag {
+  creator: number;
+  id: number;
+  images: TagImage[];
+  last_updated: string;
+  last_updater: number;
+  last_updater_username: string;
+  name: string;
+  repository: number;
+  full_size: number;
+  v2: boolean;
+  tag_status: string;
+  tag_last_pulled: string | null;
+  tag_last_pushed: string | null;
+  media_type: string;
+  content_type: string;
+  digest: string;
+}
+
+export interface TagListResponse {
+  count: number;
+  next: string | null;
+  previous: string | null;
+  results: Tag[];
+}
+
+// ============================================
+// User Types
+// ============================================
+
+export interface User {
+  id: string;
+  username: string;
+  full_name: string;
+  location: string;
+  company: string;
+  profile_url: string;
+  date_joined: string;
+  gravatar_url: string;
+  gravatar_email: string;
+  type: string;
+}
+
+// ============================================
+// Example Resource Types (for compatibility)
+// ============================================
+
+export interface ExampleResource {
+  id: string;
+  name: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ExampleListResponse {
+  items: ExampleResource[];
+  nextPageToken?: string;
+  total?: number;
+}
+
+export interface ExampleCreateParams {
+  name: string;
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface ApiErrorDetail {
+  code: string;
+  message: string;
+  field?: string;
+}
+
+export class DockerApiError extends Error {
+  public readonly statusCode: number;
+  public readonly errors?: ApiErrorDetail[];
+
+  constructor(message: string, statusCode: number, errors?: ApiErrorDetail[]) {
+    super(message);
+    this.name = 'DockerApiError';
+    this.statusCode = statusCode;
+    this.errors = errors;
+  }
+}
+
+// Legacy alias for compatibility
+export { DockerApiError as ConnectorApiError };