@orcapt/cli 1.0.0

package/src/commands/db.js

@@ -0,0 +1,248 @@
+/**
+ * Orca Database Commands
+ * Manage PostgreSQL databases via Orca Deploy API
+ */
+
+const chalk = require('chalk');
+const ora = require('ora');
+const https = require('https');
+const http = require('http');
+const { getCredentials } = require('./login');
+const { API_BASE_URL, API_ENDPOINTS } = require('../config');
+
+/**
+ * Make API request to Orca Deploy API
+ */
+function makeApiRequest(method, path, credentials) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(path, API_BASE_URL);
+    const isHttps = url.protocol === 'https:';
+    const httpModule = isHttps ? https : http;
+
+    const options = {
+      hostname: url.hostname,
+      port: url.port || (isHttps ? 443 : 80),
+      path: url.pathname,
+      method: method,
+      headers: {
+        'x-workspace': credentials.workspace,
+        'x-token': credentials.token,
+        'Content-Type': 'application/json',
+        'x-mode' : credentials.mode
+      }
+    };
+
+    const req = httpModule.request(options, (res) => {
+      let data = '';
+
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+
+      res.on('end', () => {
+        try {
+          const response = JSON.parse(data);
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            resolve(response);
+          } else {
+            reject({ statusCode: res.statusCode, response });
+          }
+        } catch (error) {
+          reject(new Error(`Invalid response: ${data}`));
+        }
+      });
+    });
+
+    req.on('error', (error) => {
+      reject(error);
+    });
+
+    req.end();
+  });
+}
+
+/**
+ * DB Create Command - Create a new PostgreSQL database
+ */
+async function dbCreate(options) {
+  console.log(chalk.cyan('\n============================================================'));
+  console.log(chalk.cyan('🗄️  Creating PostgreSQL Database'));
+  console.log(chalk.cyan('============================================================\n'));
+
+  // Get credentials from login
+  const credentials = getCredentials();
+  if (!credentials) {
+    console.log(chalk.red('✗ Not authenticated'));
+    console.log(chalk.cyan('Please run:'), chalk.yellow('orca login'), chalk.cyan('first\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.white('Workspace:'), chalk.yellow(credentials.workspace));
+  console.log(chalk.white('API:      '), chalk.yellow(API_BASE_URL));
+
+  const spinner = ora('Creating database...').start();
+
+  try {
+    // Hybrid DB API endpoint: creates/uses workspace DB and creates a schema
+    const response = await makeApiRequest('POST', API_ENDPOINTS.DB_CREATE, credentials);
+
+    spinner.succeed(chalk.green('Database created successfully!'));
+
+    console.log(chalk.cyan('\n============================================================'));
+    console.log(chalk.green('✓ Database Ready'));
+    console.log(chalk.cyan('============================================================'));
+    // Show actual DB and schema
+    console.log(chalk.white('Database:  '), chalk.yellow(response.database_name));
+    console.log(chalk.white('Schema:    '), chalk.yellow(response.schema_name));
+    console.log(chalk.white('Username:  '), chalk.yellow(response.username));
+    console.log(chalk.white('Password:  '), chalk.yellow(response.password));
+    console.log(chalk.white('Workspace: '), chalk.yellow(response.workspace_name));
+    
+    console.log(chalk.cyan('\n📋 Connection String:'));
+    // Use the connection string from the response if available
+    const connString = response.connection_info?.connection_string || 
+      `postgresql://${response.username}:${response.password}@localhost:6432/${response.database_name}?options=-csearch_path%3D${response.schema_name}`;
+    console.log(chalk.yellow(`   ${connString}`));
+    
+    console.log(chalk.cyan('\n💡 Save these credentials - they won\'t be shown again!'));
+    console.log(chalk.cyan('============================================================\n'));
+
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to create database'));
+    
+    if (error.statusCode === 401) {
+      console.log(chalk.red('\n✗ Authentication failed'));
+      console.log(chalk.yellow('Your session may have expired. Please run:'), chalk.white('orca login\n'));
+    } else if (error.response && error.response.detail) {
+      console.log(chalk.red(`\n✗ ${error.response.detail}\n`));
+    } else {
+      console.log(chalk.red(`\n✗ ${error.message}\n`));
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * DB List Command - List all databases for workspace
+ */
+async function dbList() {
+  console.log(chalk.cyan('\n============================================================'));
+  console.log(chalk.cyan('📋 Listing Databases'));
+  console.log(chalk.cyan('============================================================\n'));
+
+  // Get credentials from login
+  const credentials = getCredentials();
+  if (!credentials) {
+    console.log(chalk.red('✗ Not authenticated'));
+    console.log(chalk.cyan('Please run:'), chalk.yellow('orca login'), chalk.cyan('first\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.white('Workspace:'), chalk.yellow(credentials.workspace));
+
+  const spinner = ora('Fetching databases...').start();
+
+  try {
+    // DB API endpoint (returns list of { database_name, schema_name })
+    const response = await makeApiRequest('GET', API_ENDPOINTS.DB_LIST, credentials);
+
+    spinner.succeed(chalk.green('Databases retrieved'));
+
+    console.log(chalk.cyan('\n============================================================'));
+    
+    if (response.count === 0) {
+      console.log(chalk.yellow('No databases found'));
+      console.log(chalk.cyan('\nCreate one with:'), chalk.white('orca db create --postgres'));
+    } else {
+      console.log(chalk.green(`✓ Found ${response.count} database${response.count > 1 ? 's' : ''}`));
+      console.log(chalk.cyan('============================================================\n'));
+      
+      // Show schemas as databases to avoid confusion
+      const items = response.databases || response.schemas || [];
+      items.forEach((item, index) => {
+        const name = typeof item === 'string' ? item : (item.schema_name || item.database_name);
+        console.log(chalk.white(`  ${index + 1}. ${name}`));
+      });
+    }
+    
+    console.log(chalk.cyan('============================================================\n'));
+
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to list databases'));
+    
+    if (error.statusCode === 401) {
+      console.log(chalk.red('\n✗ Authentication failed'));
+      console.log(chalk.yellow('Your session may have expired. Please run:'), chalk.white('orca login\n'));
+    } else if (error.response && error.response.detail) {
+      console.log(chalk.red(`\n✗ ${error.response.detail}\n`));
+    } else {
+      console.log(chalk.red(`\n✗ ${error.message}\n`));
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * DB Remove Command - Delete a database
+ */
+async function dbRemove(databaseName) {
+  if (!databaseName) {
+    console.log(chalk.red('\n✗ Database name is required'));
+    console.log(chalk.cyan('Usage:'), chalk.white('orca db remove <database-name>\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.cyan('\n============================================================'));
+  console.log(chalk.cyan('🗑️  Removing Database'));
+  console.log(chalk.cyan('============================================================\n'));
+
+  // Get credentials from login
+  const credentials = getCredentials();
+  if (!credentials) {
+    console.log(chalk.red('✗ Not authenticated'));
+    console.log(chalk.cyan('Please run:'), chalk.yellow('orca login'), chalk.cyan('first\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.white('Database: '), chalk.yellow(databaseName));
+  console.log(chalk.white('Workspace:'), chalk.yellow(credentials.workspace));
+
+  const spinner = ora('Deleting database...').start();
+
+  try {
+    // Delete a single schema under the workspace database
+    const response = await makeApiRequest('DELETE', `${API_ENDPOINTS.DB_DELETE}/${databaseName}`, credentials);
+
+    spinner.succeed(chalk.green('Database deleted successfully!'));
+
+    console.log(chalk.cyan('\n============================================================'));
+    console.log(chalk.green('✓ Database Removed'));
+    console.log(chalk.cyan('============================================================'));
+    // Present schema as database name
+    console.log(chalk.white('Database:  '), chalk.yellow(response.schema_name || databaseName));
+    console.log(chalk.white('Workspace: '), chalk.yellow(response.workspace_name));
+    console.log(chalk.cyan('============================================================\n'));
+
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to delete database'));
+    
+    if (error.statusCode === 401) {
+      console.log(chalk.red('\n✗ Authentication failed'));
+      console.log(chalk.yellow('Your session may have expired. Please run:'), chalk.white('orca login\n'));
+    } else if (error.statusCode === 404) {
+      console.log(chalk.red(`\n✗ Database '${databaseName}' not found or doesn't belong to your workspace\n`));
+    } else if (error.response && error.response.detail) {
+      console.log(chalk.red(`\n✗ ${error.response.detail}\n`));
+    } else {
+      console.log(chalk.red(`\n✗ ${error.message}\n`));
+    }
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  dbCreate,
+  dbList,
+  dbRemove
+};
+

package/src/commands/fetch-doc.js

@@ -0,0 +1,220 @@
+/**
+ * Fetch Documentation Command
+ * Downloads Orca SDK documentation based on project type
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+const ora = require('ora');
+const https = require('https');
+const { DOCS_URLS } = require('../config');
+
+// Map project types to config keys
+const DOCS_MAP = {
+  python: DOCS_URLS.PYTHON,
+  nodejs: DOCS_URLS.NODEJS
+};
+
+/**
+ * Detect project type based on files in current directory
+ * @returns {Promise<string|null>} 'python', 'nodejs', or null
+ */
+async function detectProjectType() {
+  try {
+    const files = await fs.readdir(process.cwd());
+    
+    // Check for Python project indicators
+    const hasPythonFiles = files.some(file => 
+      file === 'requirements.txt' || 
+      file === 'setup.py' || 
+      file === 'pyproject.toml' ||
+      file === 'Pipfile'
+    );
+    
+    if (hasPythonFiles) {
+      return 'python';
+    }
+    
+    // Check for Node.js project indicators
+    const hasNodeFiles = files.some(file => 
+      file === 'package.json' || 
+      file === 'package-lock.json' ||
+      file === 'yarn.lock'
+    );
+    
+    if (hasNodeFiles) {
+      return 'nodejs';
+    }
+    
+    return null;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Check if we're in a project root directory
+ * @returns {Promise<{isRoot: boolean, detectedType: string|null}>}
+ */
+async function checkProjectRoot() {
+  const detectedType = await detectProjectType();
+  return {
+    isRoot: detectedType !== null,
+    detectedType
+  };
+}
+
+/**
+ * Download file from URL
+ * @param {string} url - URL to download from
+ * @param {string} destPath - Destination path
+ * @returns {Promise<void>}
+ */
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    https.get(url, (response) => {
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        // Handle redirects
+        downloadFile(response.headers.location, destPath)
+          .then(resolve)
+          .catch(reject);
+        return;
+      }
+      
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+        return;
+      }
+      
+      let data = '';
+      response.on('data', (chunk) => {
+        data += chunk;
+      });
+      
+      response.on('end', async () => {
+        try {
+          await fs.writeFile(destPath, data, 'utf8');
+          resolve();
+        } catch (error) {
+          reject(error);
+        }
+      });
+    }).on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+/**
+ * Ensure docs directory exists
+ * @returns {Promise<string>} Path to docs directory
+ */
+async function ensureDocsDirectory() {
+  const docsPath = path.join(process.cwd(), 'docs');
+  
+  try {
+    await fs.access(docsPath);
+  } catch (error) {
+    // Directory doesn't exist, create it
+    await fs.mkdir(docsPath, { recursive: true });
+    console.log(chalk.green('✓ Created docs directory'));
+  }
+  
+  return docsPath;
+}
+
+/**
+ * Download documentation for a specific type
+ * @param {string} type - 'python' or 'nodejs'
+ * @returns {Promise<void>}
+ */
+async function downloadDocumentation(type) {
+  const spinner = ora(`Downloading Orca ${type === 'python' ? 'Python' : 'Node.js'} SDK documentation...`).start();
+  
+  try {
+    const docsPath = await ensureDocsDirectory();
+    const fileName = type === 'python' ? 'ORCA_PYTHON_SDK.md' : 'ORCA_NODEJS_SDK.md';
+    const filePath = path.join(docsPath, fileName);
+    
+    await downloadFile(DOCS_MAP[type], filePath);
+    
+    spinner.succeed(chalk.green('Documentation downloaded successfully!'));
+    
+    console.log(chalk.cyan('\n============================================================'));
+    console.log(chalk.green('✓ Documentation Ready'));
+    console.log(chalk.cyan('============================================================'));
+    console.log(chalk.white('📄 File:'), chalk.yellow(path.relative(process.cwd(), filePath)));
+    console.log(chalk.white('📦 Type:'), chalk.yellow(type === 'python' ? 'Python SDK' : 'Node.js SDK'));
+    console.log(chalk.white('📂 Location:'), chalk.yellow(docsPath));
+    console.log(chalk.cyan('============================================================\n'));
+    
+    return filePath;
+  } catch (error) {
+    spinner.fail(chalk.red('Failed to download documentation'));
+    throw error;
+  }
+}
+
+/**
+ * Main fetch-doc command
+ */
+async function fetchDoc() {
+  try {
+    console.log(chalk.cyan('\n============================================================'));
+    console.log(chalk.cyan('📚 Orca - Fetch Documentation'));
+    console.log(chalk.cyan('============================================================\n'));
+    
+    // Check if we're in a project root
+    const { isRoot, detectedType } = await checkProjectRoot();
+    
+    let selectedType;
+    
+    if (!isRoot) {
+      // Not in project root - show warning and ask user
+      console.log(chalk.yellow('⚠ Warning: Could not detect project type'));
+      console.log(chalk.white('We recommend running this command in the root directory of your project.'));
+      console.log(chalk.gray('(Looking for requirements.txt, package.json, etc.)\n'));
+      
+      const { choice } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'choice',
+          message: 'Which documentation would you like to download?',
+          choices: [
+            { name: '🐍 Python SDK Documentation', value: 'python' },
+            { name: '📦 Node.js SDK Documentation', value: 'nodejs' },
+            { name: '❌ Skip, cancel', value: 'none' }
+          ]
+        }
+      ]);
+      
+      if (choice === 'none') {
+        console.log(chalk.yellow('\n⚠ Cancelled\n'));
+        return;
+      }
+      
+      selectedType = choice;
+    } else {
+      // In project root - auto-detect
+      console.log(chalk.green('✓ Project detected:'), chalk.yellow(detectedType === 'python' ? 'Python' : 'Node.js'));
+      console.log();
+      
+      selectedType = detectedType;
+    }
+    
+    // Download documentation
+    await downloadDocumentation(selectedType);
+    
+  } catch (error) {
+    console.log(chalk.red(`\n✗ Error: ${error.message}\n`));
+    if (process.env.DEBUG) {
+      console.error(error);
+    }
+    process.exit(1);
+  }
+}
+
+module.exports = fetchDoc;
+