@launchframe/cli 1.0.0-beta.26 → 1.0.0-beta.28

package/.claude/settings.local.json

@@ -5,7 +5,8 @@
       "WebFetch(domain:developer.mixpanel.com)",
       "Bash(node -c:*)",
       "Bash(node:*)",
-      "Bash(git checkout:*)"
+      "Bash(git checkout:*)",
+      "Bash(grep:*)"
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchframe/cli",
-  "version": "1.0.0-beta.26",
+  "version": "1.0.0-beta.28",
   "description": "Production-ready B2B SaaS boilerplate with subscriptions, credits, and multi-tenancy",
   "main": "src/index.js",
   "bin": {
@@ -40,7 +40,9 @@
     "access": "public"
   },
   "dependencies": {
+    "bcryptjs": "^2.4.3",
     "chalk": "^4.1.2",
+    "dotenv": "^17.3.1",
     "fs-extra": "^11.1.1",
     "inquirer": "^8.2.5"
   }

package/src/commands/database-console.js

@@ -0,0 +1,84 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const inquirer = require('inquirer');
+const { spawnSync } = require('child_process');
+const { requireProject, getProjectConfig } = require('../utils/project-helpers');
+
+async function databaseConsole({ remote = false } = {}) {
+  requireProject();
+
+  const infrastructurePath = path.join(process.cwd(), 'infrastructure');
+
+  if (!fs.existsSync(infrastructurePath)) {
+    console.error(chalk.red('\n❌ Error: infrastructure/ directory not found'));
+    console.log(chalk.gray('Make sure you are in the root of your LaunchFrame project.\n'));
+    process.exit(1);
+  }
+
+  if (remote) {
+    // 1. Check deployment is configured
+    const config = getProjectConfig();
+
+    if (!config.deployConfigured || !config.deployment) {
+      console.error(chalk.red('\n❌ Deployment is not configured.'));
+      console.log(chalk.gray('Run deploy:configure first.\n'));
+      process.exit(1);
+    }
+
+    const { vpsUser, vpsHost, vpsAppFolder } = config.deployment;
+
+    // 2. Warn before connecting to production
+    console.log(chalk.yellow.bold('\n⚠️  You are about to connect to the PRODUCTION database.\n'));
+    console.log(chalk.gray(`  Host: ${vpsHost}`));
+    console.log(chalk.gray(`  Folder: ${vpsAppFolder}\n`));
+
+    const { confirmed } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirmed',
+        message: 'Are you sure you want to open a console to the production database?',
+        default: false
+      }
+    ]);
+
+    if (!confirmed) {
+      console.log(chalk.gray('\nAborted.\n'));
+      process.exit(0);
+    }
+
+    console.log(chalk.blue.bold('\n🔌 Connecting to production database...\n'));
+
+    // 3. Let the shell inside the container expand $POSTGRES_USER / $POSTGRES_DB.
+    //    Pass the remote command as a single ssh argument (spawnSync array form)
+    //    so the local shell never touches it.
+    const remoteCmd = `cd ${vpsAppFolder}/infrastructure && docker compose -f docker-compose.yml -f docker-compose.prod.yml exec -it database sh -c 'psql -U $POSTGRES_USER $POSTGRES_DB'`;
+
+    const result = spawnSync('ssh', ['-t', `${vpsUser}@${vpsHost}`, remoteCmd], { stdio: 'inherit' });
+
+    if (result.status !== 0) {
+      console.error(chalk.red('\n❌ Could not connect to the production database.'));
+      console.log(chalk.gray('Check that the VPS is reachable and services are running.\n'));
+      process.exit(1);
+    }
+  } else {
+    console.log(chalk.blue.bold('\n🗄️  Opening local database console...\n'));
+
+    // Let the shell inside the container expand $POSTGRES_USER / $POSTGRES_DB
+    const psqlCmd = [
+      'compose', '-f', 'docker-compose.yml', '-f', 'docker-compose.dev.yml',
+      'exec', 'database', 'sh', '-c', 'psql -U $POSTGRES_USER $POSTGRES_DB'
+    ];
+
+    const result = spawnSync('docker', psqlCmd, { cwd: infrastructurePath, stdio: 'inherit' });
+
+    if (result.status !== 0) {
+      console.error(chalk.red('\n❌ Could not connect to the local database container.'));
+      console.log(chalk.gray('Make sure services are running:'));
+      console.log(chalk.white('  launchframe docker:up\n'));
+      process.exit(1);
+    }
+  }
+}
+
+module.exports = { databaseConsole };

package/src/commands/dev-add-user.js

@@ -0,0 +1,165 @@
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const chalk = require('chalk');
+const bcrypt = require('bcryptjs');
+const { spawnSync } = require('child_process');
+const { requireProject, getProjectConfig } = require('../utils/project-helpers');
+
+const FIRST_NAMES = [
+  'Alice', 'Bob', 'Carol', 'David', 'Eve', 'Frank', 'Grace', 'Henry',
+  'Iris', 'Jack', 'Karen', 'Leo', 'Mia', 'Nathan', 'Olivia'
+];
+
+const LAST_NAMES = [
+  'Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller',
+  'Davis', 'Wilson', 'Moore', 'Taylor', 'Anderson', 'Thomas', 'Jackson', 'White'
+];
+
+function randomElement(arr) {
+  return arr[Math.floor(Math.random() * arr.length)];
+}
+
+function generateDummyUser() {
+  const firstName = randomElement(FIRST_NAMES);
+  const lastName = randomElement(LAST_NAMES);
+  const suffix = String(Math.floor(1000 + Math.random() * 9000));
+  const email = `${firstName.toLowerCase()}.${lastName.toLowerCase()}${suffix}@example.com`;
+  return { firstName, lastName, name: `${firstName} ${lastName}`, email, suffix };
+}
+
+function checkEmailExists(infrastructurePath, email) {
+  const composeArgs = [
+    'compose', '-f', 'docker-compose.yml', '-f', 'docker-compose.dev.yml',
+    'exec', '-T', 'database', 'sh', '-c', 'psql -U $POSTGRES_USER $POSTGRES_DB -t -c "SELECT COUNT(*) FROM users WHERE email = \'__EMAIL__\'"'
+      .replace('__EMAIL__', email.replace(/'/g, "''"))
+  ];
+
+  const result = spawnSync('docker', composeArgs, { cwd: infrastructurePath, encoding: 'utf8' });
+  if (result.status !== 0) return false;
+  const count = parseInt((result.stdout || '').trim(), 10);
+  return count > 0;
+}
+
+async function devAddUser() {
+  requireProject();
+
+  const infrastructurePath = path.join(process.cwd(), 'infrastructure');
+
+  if (!fs.existsSync(infrastructurePath)) {
+    console.error(chalk.red('\n❌ Error: infrastructure/ directory not found'));
+    console.log(chalk.gray('Make sure you are in the root of your LaunchFrame project.\n'));
+    process.exit(1);
+  }
+
+  // Check database container is running
+  const psResult = spawnSync(
+    'docker',
+    [
+      'compose', '-f', 'docker-compose.yml', '-f', 'docker-compose.dev.yml',
+      'ps', '--status', 'running', '-q', 'database'
+    ],
+    { cwd: infrastructurePath, encoding: 'utf8' }
+  );
+
+  if (!psResult.stdout || psResult.stdout.trim() === '') {
+    console.error(chalk.red('\n❌ Database container is not running.'));
+    console.log(chalk.gray('Start local services first:'));
+    console.log(chalk.white('  launchframe docker:up\n'));
+    process.exit(1);
+  }
+
+  // Generate user with unique email (up to 5 attempts)
+  let user = null;
+  for (let attempt = 0; attempt < 5; attempt++) {
+    const candidate = generateDummyUser();
+    if (!checkEmailExists(infrastructurePath, candidate.email)) {
+      user = candidate;
+      break;
+    }
+  }
+
+  if (!user) {
+    console.error(chalk.red('\n❌ Could not generate a unique email after 5 attempts.'));
+    process.exit(1);
+  }
+
+  const config = getProjectConfig();
+  const isMultiTenant = config.variants?.tenancy === 'multi-tenant';
+
+  const passwordHash = await bcrypt.hash('test123', 10);
+  const accountId = crypto.randomUUID();
+
+  const projectTitle = `Demo Project`;
+  const projectSlug = `demo-project-${user.suffix}`;
+
+  const projectInsert = isMultiTenant ? `
+  INSERT INTO projects (user_id, title, slug, description, created_at, updated_at)
+  VALUES (
+    new_user_id,
+    '${projectTitle}',
+    '${projectSlug}',
+    'Auto-generated demo project',
+    NOW(),
+    NOW()
+  );` : '';
+
+  const sqlScript = `
+DO $$
+DECLARE
+  new_user_id INT;
+BEGIN
+  INSERT INTO users (email, name, role, email_verified, is_active, created_at, updated_at)
+  VALUES (
+    '${user.email.replace(/'/g, "''")}',
+    '${user.name.replace(/'/g, "''")}',
+    'business_user',
+    true,
+    true,
+    NOW(),
+    NOW()
+  )
+  RETURNING id INTO new_user_id;
+
+  INSERT INTO accounts (id, user_id, account_id, provider_id, password, created_at, updated_at)
+  VALUES (
+    '${accountId}',
+    new_user_id,
+    new_user_id::text,
+    'credential',
+    '${passwordHash.replace(/'/g, "''")}',
+    NOW(),
+    NOW()
+  );
+${projectInsert}
+END $$;
+`;
+
+  const execResult = spawnSync(
+    'docker',
+    [
+      'compose', '-f', 'docker-compose.yml', '-f', 'docker-compose.dev.yml',
+      'exec', '-T', 'database', 'sh', '-c', 'psql -v ON_ERROR_STOP=1 -U $POSTGRES_USER $POSTGRES_DB'
+    ],
+    { cwd: infrastructurePath, input: sqlScript, encoding: 'utf8' }
+  );
+
+  if (execResult.status !== 0) {
+    console.error(chalk.red('\n❌ Failed to insert user into database.'));
+    if (execResult.stderr) {
+      console.error(chalk.gray(execResult.stderr));
+    }
+    process.exit(1);
+  }
+
+  console.log(chalk.green('\n✅ User created!'));
+  console.log(chalk.gray(`   Name:     ${user.name}`));
+  console.log(chalk.gray(`   Email:    ${user.email}`));
+  console.log(chalk.gray(`   Password: test123`));
+  if (isMultiTenant) {
+    console.log(chalk.gray(`   Project:  ${projectTitle} (${projectSlug})`));
+  }
+  console.log();
+}
+
+module.exports = { devAddUser };

package/src/commands/help.js

@@ -41,6 +41,9 @@ function help() {
     console.log(chalk.gray('  migration:run              Run pending database migrations'));
     console.log(chalk.gray('  migration:create           Create new database migration'));
     console.log(chalk.gray('  migration:revert           Revert last database migration\n'));
+    console.log(chalk.white('Database:'));
+    console.log(chalk.gray('  database:console           Open a PostgreSQL console (local)'));
+    console.log(chalk.gray('    --remote                 Connect to the production database\n'));
 
     console.log(chalk.white('Service Management:'));
     console.log(chalk.gray('  service:add <name>     Add an optional service to your project'));
@@ -52,6 +55,8 @@ function help() {
     console.log(chalk.gray('  cache:info        Show cache location, size, and cached services'));
     console.log(chalk.gray('  cache:update      Force update cache to latest version'));
     console.log(chalk.gray('  cache:clear       Delete cache (re-download on next use)\n'));
+    console.log(chalk.white('Dev Helpers:'));
+    console.log(chalk.gray('  dev:add-user      Generate and insert a random test user into the local database\n'));
     console.log(chalk.white('Other commands:'));
     console.log(chalk.gray('  doctor            Check project health and configuration'));
     console.log(chalk.gray('  telemetry         Show telemetry status'));

package/src/index.js

@@ -32,6 +32,7 @@ const { dockerLogs } = require('./commands/docker-logs');
 const { migrateRun } = require('./commands/migration-run');
 const { migrateCreate } = require('./commands/migration-create');
 const { migrateRevert } = require('./commands/migration-revert');
+const { databaseConsole } = require('./commands/database-console');
 const { dockerDestroy } = require('./commands/docker-destroy');
 const { doctor } = require('./commands/doctor');
 const { help } = require('./commands/help');
@@ -41,6 +42,7 @@ const {
   serviceRemove
 } = require('./commands/service');
 const { cacheClear, cacheInfo, cacheUpdate } = require('./commands/cache');
+const { devAddUser } = require('./commands/dev-add-user');
 
 // Get command and arguments
 const command = process.argv[2];
@@ -160,6 +162,9 @@ async function main() {
     case 'migration:revert':
       await migrateRevert();
       break;
+    case 'database:console':
+      await databaseConsole({ remote: flags.remote });
+      break;
     case 'doctor':
       await doctor();
       break;
@@ -191,6 +196,9 @@ async function main() {
     case 'cache:update':
       await cacheUpdate();
       break;
+    case 'dev:add-user':
+      await devAddUser();
+      break;
     case 'telemetry':
       if (flags.disable) {
         setTelemetryEnabled(false);