@hasna/connectors 0.9.3 → 1.0.1

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

@@ -0,0 +1,419 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync, renameSync, cpSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import type { CliConfig, OAuth2Tokens } from '../types';
+
+const DEFAULT_PROFILE = 'default';
+const CURRENT_PROFILE_FILE = 'current_profile';
+const PROFILES_DIR = 'profiles';
+
+// Store for --profile flag override (set by CLI before commands run)
+let profileOverride: string | undefined;
+
+// Store config in ~/.connect/connect-googlephotos/ (always in home directory)
+function resolveBaseConfigDir(): string {
+  return join(homedir(), '.connect', 'connect-googlephotos');
+}
+
+const BASE_CONFIG_DIR = resolveBaseConfigDir();
+
+// ============================================
+// Profile Management
+// ============================================
+
+export function setProfileOverride(profile: string | undefined): void {
+  profileOverride = profile;
+}
+
+export function getProfileOverride(): string | undefined {
+  return profileOverride;
+}
+
+function ensureBaseConfigDir(): void {
+  if (!existsSync(BASE_CONFIG_DIR)) {
+    mkdirSync(BASE_CONFIG_DIR, { recursive: true });
+  }
+}
+
+function getProfilesDir(): string {
+  return join(BASE_CONFIG_DIR, PROFILES_DIR);
+}
+
+function getCurrentProfileFile(): string {
+  return join(BASE_CONFIG_DIR, CURRENT_PROFILE_FILE);
+}
+
+/**
+ * Migrate old config structure to new profile-based structure
+ */
+function migrateToProfileStructure(): void {
+  const profilesDir = getProfilesDir();
+  const defaultProfileDir = join(profilesDir, DEFAULT_PROFILE);
+
+  // If profiles directory already exists, no migration needed
+  if (existsSync(profilesDir)) {
+    return;
+  }
+
+  // Check if old structure exists (config.json directly in base dir)
+  const oldConfigFile = join(BASE_CONFIG_DIR, 'config.json');
+  const oldTokensFile = join(BASE_CONFIG_DIR, 'tokens.json');
+
+  const hasOldStructure = existsSync(oldConfigFile) || existsSync(oldTokensFile);
+
+  if (!hasOldStructure) {
+    // Fresh install, just create the profiles directory
+    mkdirSync(profilesDir, { recursive: true });
+    return;
+  }
+
+  // Migrate to default profile
+  mkdirSync(defaultProfileDir, { recursive: true });
+
+  // Move files to default profile
+  if (existsSync(oldConfigFile)) {
+    renameSync(oldConfigFile, join(defaultProfileDir, 'config.json'));
+  }
+  if (existsSync(oldTokensFile)) {
+    renameSync(oldTokensFile, join(defaultProfileDir, 'tokens.json'));
+  }
+
+  // Set default as current profile
+  writeFileSync(getCurrentProfileFile(), DEFAULT_PROFILE);
+}
+
+/**
+ * Get the current active profile name
+ */
+export function getCurrentProfile(): string {
+  // CLI override takes priority
+  if (profileOverride) {
+    return profileOverride;
+  }
+
+  ensureBaseConfigDir();
+  migrateToProfileStructure();
+
+  const currentProfileFile = getCurrentProfileFile();
+  if (existsSync(currentProfileFile)) {
+    try {
+      const profile = readFileSync(currentProfileFile, '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 {
+  ensureBaseConfigDir();
+  migrateToProfileStructure();
+
+  if (!profileExists(profile)) {
+    throw new Error(`Profile "${profile}" does not exist. Create it first with "profile create ${profile}"`);
+  }
+
+  writeFileSync(getCurrentProfileFile(), profile);
+}
+
+/**
+ * Check if a profile exists
+ */
+export function profileExists(profile: string): boolean {
+  const profileDir = join(getProfilesDir(), profile);
+  return existsSync(profileDir);
+}
+
+/**
+ * List all available profiles
+ */
+export function listProfiles(): string[] {
+  ensureBaseConfigDir();
+  migrateToProfileStructure();
+
+  const profilesDir = getProfilesDir();
+  if (!existsSync(profilesDir)) {
+    return [];
+  }
+
+  return readdirSync(profilesDir, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory())
+    .map(dirent => dirent.name)
+    .sort();
+}
+
+/**
+ * Create a new profile
+ */
+export function createProfile(profile: string): void {
+  ensureBaseConfigDir();
+  migrateToProfileStructure();
+
+  if (profileExists(profile)) {
+    throw new Error(`Profile "${profile}" already exists`);
+  }
+
+  // Validate profile name
+  if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
+    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
+  }
+
+  const profileDir = join(getProfilesDir(), profile);
+  mkdirSync(profileDir, { recursive: true });
+}
+
+/**
+ * Delete a profile
+ */
+export function deleteProfile(profile: string): void {
+  if (profile === DEFAULT_PROFILE) {
+    throw new Error('Cannot delete the default profile');
+  }
+
+  if (!profileExists(profile)) {
+    throw new Error(`Profile "${profile}" does not exist`);
+  }
+
+  const currentProfile = getCurrentProfile();
+  if (currentProfile === profile) {
+    // Switch to default before deleting
+    setCurrentProfile(DEFAULT_PROFILE);
+  }
+
+  const profileDir = join(getProfilesDir(), profile);
+  rmSync(profileDir, { recursive: true });
+}
+
+/**
+ * Get the config directory for the current profile
+ */
+function resolveConfigDir(): string {
+  ensureBaseConfigDir();
+  migrateToProfileStructure();
+
+  const profile = getCurrentProfile();
+  const profileDir = join(getProfilesDir(), profile);
+
+  // Ensure profile directory exists
+  if (!existsSync(profileDir)) {
+    mkdirSync(profileDir, { recursive: true });
+  }
+
+  return profileDir;
+}
+
+// Always compute config dir dynamically (no caching - profiles can change)
+function getConfigDirInternal(): string {
+  return resolveConfigDir();
+}
+
+export function getConfigDir(): string {
+  return getConfigDirInternal();
+}
+
+export function getBaseConfigDir(): string {
+  return BASE_CONFIG_DIR;
+}
+
+export function ensureConfigDir(): void {
+  const configDir = getConfigDirInternal();
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+}
+
+// ============================================
+// Downloads Directory
+// ============================================
+
+export function getDownloadsDir(): string {
+  return join(getConfigDirInternal(), 'downloads');
+}
+
+export function ensureDownloadsDir(): string {
+  const dir = getDownloadsDir();
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+export function loadConfig(): CliConfig {
+  ensureConfigDir();
+  const configFile = join(getConfigDirInternal(), 'config.json');
+
+  if (!existsSync(configFile)) {
+    return {};
+  }
+
+  try {
+    const content = readFileSync(configFile, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(config: CliConfig): void {
+  ensureConfigDir();
+  const configFile = join(getConfigDirInternal(), 'config.json');
+  writeFileSync(configFile, JSON.stringify(config, null, 2));
+}
+
+// ============================================
+// OAuth2 Credentials (Client ID/Secret) - Stored at BASE level (shared across profiles)
+// ============================================
+
+function loadBaseConfig(): CliConfig {
+  ensureBaseConfigDir();
+  const configFile = join(BASE_CONFIG_DIR, 'credentials.json');
+
+  if (!existsSync(configFile)) {
+    // Migration: check if credentials exist in any profile and copy to base
+    const profiles = listProfiles();
+    for (const profile of profiles) {
+      // Read directly from profile's config file (not via loadConfig which uses current profile)
+      const profileConfigFile = join(getProfilesDir(), profile, 'config.json');
+      if (existsSync(profileConfigFile)) {
+        try {
+          const content = readFileSync(profileConfigFile, 'utf-8');
+          const profileConfig = JSON.parse(content) as CliConfig;
+          if (profileConfig.clientId && profileConfig.clientSecret) {
+            // Found credentials in a profile, save to base
+            writeFileSync(configFile, JSON.stringify({
+              clientId: profileConfig.clientId,
+              clientSecret: profileConfig.clientSecret,
+            }, null, 2));
+            return { clientId: profileConfig.clientId, clientSecret: profileConfig.clientSecret };
+          }
+        } catch {
+          // Continue to next profile
+        }
+      }
+    }
+    return {};
+  }
+
+  try {
+    const content = readFileSync(configFile, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+
+function saveBaseConfig(config: CliConfig): void {
+  ensureBaseConfigDir();
+  const configFile = join(BASE_CONFIG_DIR, 'credentials.json');
+  writeFileSync(configFile, JSON.stringify(config, null, 2));
+}
+
+export function getClientId(): string | undefined {
+  return process.env.GOOGLE_PHOTOS_CLIENT_ID || loadBaseConfig().clientId;
+}
+
+export function getClientSecret(): string | undefined {
+  return process.env.GOOGLE_PHOTOS_CLIENT_SECRET || loadBaseConfig().clientSecret;
+}
+
+export function setClientId(clientId: string): void {
+  const config = loadBaseConfig();
+  config.clientId = clientId;
+  saveBaseConfig(config);
+}
+
+export function setClientSecret(clientSecret: string): void {
+  const config = loadBaseConfig();
+  config.clientSecret = clientSecret;
+  saveBaseConfig(config);
+}
+
+export function setCredentials(clientId: string, clientSecret: string): void {
+  const config = loadBaseConfig();
+  config.clientId = clientId;
+  config.clientSecret = clientSecret;
+  saveBaseConfig(config);
+}
+
+// ============================================
+// OAuth2 Tokens (Access/Refresh)
+// ============================================
+
+export function loadTokens(): OAuth2Tokens | null {
+  ensureConfigDir();
+  const tokensFile = join(getConfigDirInternal(), 'tokens.json');
+
+  if (!existsSync(tokensFile)) {
+    return null;
+  }
+
+  try {
+    const content = readFileSync(tokensFile, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+export function saveTokens(tokens: OAuth2Tokens): void {
+  ensureConfigDir();
+  const tokensFile = join(getConfigDirInternal(), 'tokens.json');
+  writeFileSync(tokensFile, JSON.stringify(tokens, null, 2), { mode: 0o600 });
+}
+
+export function getAccessToken(): string | undefined {
+  return process.env.GOOGLE_PHOTOS_ACCESS_TOKEN || loadTokens()?.accessToken;
+}
+
+export function getRefreshToken(): string | undefined {
+  return process.env.GOOGLE_PHOTOS_REFRESH_TOKEN || loadTokens()?.refreshToken;
+}
+
+export function isTokenExpired(): boolean {
+  const tokens = loadTokens();
+  if (!tokens) return true;
+  // Add 5 minute buffer
+  return Date.now() >= tokens.expiresAt - 5 * 60 * 1000;
+}
+
+// ============================================
+// User Profile
+// ============================================
+
+export function getUserEmail(): string | undefined {
+  return loadConfig().userEmail;
+}
+
+export function setUserEmail(email: string): void {
+  const config = loadConfig();
+  config.userEmail = email;
+  saveConfig(config);
+}
+
+// ============================================
+// Clear Config
+// ============================================
+
+export function clearTokens(): void {
+  const tokensFile = join(getConfigDirInternal(), 'tokens.json');
+  if (existsSync(tokensFile)) {
+    writeFileSync(tokensFile, '{}');
+  }
+}
+
+export function clearConfig(): void {
+  saveConfig({});
+  clearTokens();
+}
+
+export function isAuthenticated(): boolean {
+  const tokens = loadTokens();
+  return tokens !== null && tokens.accessToken !== undefined && tokens.refreshToken !== undefined;
+}

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

@@ -0,0 +1,239 @@
+import chalk from 'chalk';
+
+export type OutputFormat = 'json' | 'table' | 'pretty';
+
+/**
+ * Print success message
+ */
+export function success(message: string): void {
+  console.log(chalk.green('✓'), message);
+}
+
+/**
+ * Print error message
+ */
+export function error(message: string): void {
+  console.error(chalk.red('✗'), message);
+}
+
+/**
+ * Print info message
+ */
+export function info(message: string): void {
+  console.log(chalk.blue('ℹ'), message);
+}
+
+/**
+ * Print warning message
+ */
+export function warn(message: string): void {
+  console.log(chalk.yellow('⚠'), message);
+}
+
+/**
+ * Print data in specified format
+ */
+export function print(data: unknown, format: OutputFormat = 'pretty'): void {
+  switch (format) {
+    case 'json':
+      console.log(JSON.stringify(data, null, 2));
+      break;
+    case 'table':
+      printTable(data);
+      break;
+    case 'pretty':
+    default:
+      printPretty(data);
+      break;
+  }
+}
+
+/**
+ * Print data as table
+ */
+function printTable(data: unknown): void {
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log('No data');
+      return;
+    }
+
+    // Get all unique keys from all objects
+    const keys = Array.from(
+      new Set(data.flatMap(item => (typeof item === 'object' && item ? Object.keys(item) : [])))
+    );
+
+    if (keys.length === 0) {
+      console.log(data);
+      return;
+    }
+
+    // Calculate column widths
+    const widths: Record<string, number> = {};
+    for (const key of keys) {
+      widths[key] = Math.max(
+        key.length,
+        ...data.map(item => {
+          const val = (item as Record<string, unknown>)?.[key];
+          return String(val ?? '').substring(0, 50).length;
+        })
+      );
+    }
+
+    // Print header
+    const header = keys.map(k => k.padEnd(widths[k])).join(' | ');
+    console.log(chalk.bold(header));
+    console.log(keys.map(k => '-'.repeat(widths[k])).join('-+-'));
+
+    // Print rows
+    for (const item of data) {
+      const row = keys.map(k => {
+        const val = (item as Record<string, unknown>)?.[k];
+        return String(val ?? '').substring(0, 50).padEnd(widths[k]);
+      }).join(' | ');
+      console.log(row);
+    }
+  } else if (typeof data === 'object' && data !== null) {
+    const entries = Object.entries(data);
+    const maxKeyLen = Math.max(...entries.map(([k]) => k.length));
+
+    for (const [key, value] of entries) {
+      const displayValue = typeof value === 'object' ? JSON.stringify(value) : String(value);
+      console.log(`${chalk.cyan(key.padEnd(maxKeyLen))}: ${displayValue}`);
+    }
+  } else {
+    console.log(data);
+  }
+}
+
+/**
+ * Print data in pretty format
+ */
+function printPretty(data: unknown): void {
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log('No data');
+      return;
+    }
+
+    for (let i = 0; i < data.length; i++) {
+      if (i > 0) console.log('');
+      printPrettyObject(data[i], i + 1);
+    }
+  } else if (typeof data === 'object' && data !== null) {
+    printPrettyObject(data);
+  } else {
+    console.log(data);
+  }
+}
+
+/**
+ * Print a single object in pretty format
+ */
+function printPrettyObject(obj: unknown, index?: number): void {
+  if (typeof obj !== 'object' || obj === null) {
+    console.log(obj);
+    return;
+  }
+
+  const entries = Object.entries(obj);
+
+  if (index !== undefined) {
+    console.log(chalk.gray(`[${index}]`));
+  }
+
+  for (const [key, value] of entries) {
+    const displayKey = formatKey(key);
+    const displayValue = formatValue(value);
+    console.log(`  ${chalk.cyan(displayKey)}: ${displayValue}`);
+  }
+}
+
+/**
+ * Format a key for display
+ */
+function formatKey(key: string): string {
+  // Convert camelCase to Title Case
+  return key
+    .replace(/([A-Z])/g, ' $1')
+    .replace(/^./, str => str.toUpperCase())
+    .trim();
+}
+
+/**
+ * Format a value for display
+ */
+function formatValue(value: unknown): string {
+  if (value === null || value === undefined) {
+    return chalk.gray('—');
+  }
+
+  if (typeof value === 'boolean') {
+    return value ? chalk.green('Yes') : chalk.red('No');
+  }
+
+  if (typeof value === 'number') {
+    return chalk.yellow(String(value));
+  }
+
+  if (typeof value === 'string') {
+    // Check if it's a URL
+    if (value.startsWith('http://') || value.startsWith('https://')) {
+      return chalk.blue(value);
+    }
+    // Check if it's a date
+    if (/^\d{4}-\d{2}-\d{2}/.test(value)) {
+      return chalk.magenta(value);
+    }
+    // Truncate long strings
+    if (value.length > 100) {
+      return value.substring(0, 100) + chalk.gray('...');
+    }
+    return value;
+  }
+
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return chalk.gray('[]');
+    }
+    return chalk.gray(`[${value.length} items]`);
+  }
+
+  if (typeof value === 'object') {
+    const keys = Object.keys(value);
+    if (keys.length === 0) {
+      return chalk.gray('{}');
+    }
+    return chalk.gray(`{${keys.join(', ')}}`);
+  }
+
+  return String(value);
+}
+
+/**
+ * Format bytes to human readable
+ */
+export function formatBytes(bytes: number): string {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${sizes[i]}`;
+}
+
+/**
+ * Format duration in seconds to human readable
+ */
+export function formatDuration(seconds: number): string {
+  if (seconds < 60) {
+    return `${seconds}s`;
+  }
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = seconds % 60;
+  if (minutes < 60) {
+    return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
+  }
+  const hours = Math.floor(minutes / 60);
+  const remainingMinutes = minutes % 60;
+  return `${hours}h ${remainingMinutes}m`;
+}

package/connectors/connect-googlephotos/tsconfig.json

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

package/connectors/connect-googleslides/.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