@launchframe/cli 1.0.0-beta.25 → 1.0.0-beta.27

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LaunchFrame
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launchframe/cli",
-  "version": "1.0.0-beta.25",
+  "version": "1.0.0-beta.27",
   "description": "Production-ready B2B SaaS boilerplate with subscriptions, credits, and multi-tenancy",
   "main": "src/index.js",
   "bin": {
@@ -41,6 +41,7 @@
   },
   "dependencies": {
     "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/help.js

@@ -37,6 +37,14 @@ function help() {
     console.log(chalk.gray('  docker:logs [service]       View logs from all services or specific service'));
     console.log(chalk.gray('  docker:destroy              Remove all resources (containers, volumes, images)'));
     console.log(chalk.gray('    --force, -f               Skip confirmation prompt\n'));
+    console.log(chalk.white('Database Migrations:'));
+    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'));
     console.log(chalk.gray('  service:list           List available services'));
@@ -77,9 +85,6 @@ function help() {
   } else {
     console.log(chalk.white('Available commands:'));
     console.log(chalk.gray('  init                        Initialize a new LaunchFrame project'));
-    console.log(chalk.gray('    --project-name <name>     Project name (skips prompt)'));
-    console.log(chalk.gray('    --tenancy <single|multi>  Tenancy model (skips prompt)'));
-    console.log(chalk.gray('    --user-model <b2b|b2b2c>  User model (skips prompt)'));
     console.log(chalk.gray('  help                        Show this help message\n'));
     console.log(chalk.white('Telemetry:'));
     console.log(chalk.gray('  telemetry                   Show telemetry status'));
@@ -90,10 +95,7 @@ function help() {
     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('Examples:'));
-    console.log(chalk.gray('  # Interactive mode'));
     console.log(chalk.gray('  launchframe init\n'));
-    console.log(chalk.gray('  # Non-interactive mode'));
-    console.log(chalk.gray('  launchframe init --project-name my-saas --tenancy single --user-model b2b\n'));
     console.log(chalk.gray('  # With verbose output'));
     console.log(chalk.gray('  launchframe init --verbose\n'));
   }

package/src/commands/migration-create.js

@@ -0,0 +1,40 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const { requireProject } = require('../utils/project-helpers');
+
+async function migrateCreate() {
+  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);
+  }
+
+  const migrationName = process.argv[3];
+
+  if (!migrationName) {
+    console.error(chalk.red('\n❌ Error: migration name is required'));
+    console.log(chalk.gray('Usage: launchframe migrate:create <name>\n'));
+    process.exit(1);
+  }
+
+  console.log(chalk.blue.bold(`\n🗄️  Creating migration: ${migrationName}\n`));
+
+  try {
+    execSync(`docker compose -f docker-compose.yml -f docker-compose.dev.yml exec backend npm run migration:create -- ${migrationName}`, {
+      cwd: infrastructurePath,
+      stdio: 'inherit'
+    });
+    console.log(chalk.green.bold('\n✅ Migration created successfully.\n'));
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error creating migration:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { migrateCreate };

package/src/commands/migration-revert.js

@@ -0,0 +1,32 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const { requireProject } = require('../utils/project-helpers');
+
+async function migrateRevert() {
+  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);
+  }
+
+  console.log(chalk.blue.bold('\n🗄️  Reverting last database migration\n'));
+
+  try {
+    execSync('docker compose -f docker-compose.yml -f docker-compose.dev.yml exec backend npm run migration:revert', {
+      cwd: infrastructurePath,
+      stdio: 'inherit'
+    });
+    console.log(chalk.green.bold('\n✅ Migration reverted successfully.\n'));
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error reverting migration:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { migrateRevert };

package/src/commands/migration-run.js

@@ -0,0 +1,32 @@
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { execSync } = require('child_process');
+const { requireProject } = require('../utils/project-helpers');
+
+async function migrateRun() {
+  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);
+  }
+
+  console.log(chalk.blue.bold('\n🗄️  Running database migrations\n'));
+
+  try {
+    execSync('docker compose -f docker-compose.yml -f docker-compose.dev.yml exec backend npm run migration:run', {
+      cwd: infrastructurePath,
+      stdio: 'inherit'
+    });
+    console.log(chalk.green.bold('\n✅ Migrations completed successfully.\n'));
+  } catch (error) {
+    console.error(chalk.red('\n❌ Error running migrations:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { migrateRun };

package/src/index.js

@@ -8,7 +8,8 @@ const { initTelemetry, trackEvent, sanitize, setTelemetryEnabled, showTelemetryS
 // Detect locally linked version: npm link installs to global node_modules
 // as a symlink. When running from a real install, __dirname is inside the
 // global node_modules folder. When linked, it resolves to the source directory.
-if (!__dirname.includes('node_modules')) {
+const isDevMode = !__dirname.includes('node_modules');
+if (isDevMode) {
   const packageJson = require('../package.json');
   console.log(chalk.yellow(`⚠ Running locally linked CLI v${packageJson.version} (${__dirname})`));
 }
@@ -28,6 +29,10 @@ const { dockerBuild } = require('./commands/docker-build');
 const { dockerUp } = require('./commands/docker-up');
 const { dockerDown } = require('./commands/docker-down');
 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');
@@ -99,7 +104,7 @@ async function main() {
   // Route commands
   switch (command) {
     case 'init':
-      await init({ 
+      await init({
         projectName: flags['project-name'],
         tenancy: flags['tenancy'],
         userModel: flags['user-model']
@@ -147,6 +152,18 @@ async function main() {
     case 'docker:destroy':
       await dockerDestroy({ force: flags.force || flags.f });
       break;
+    case 'migration:run':
+      await migrateRun();
+      break;
+    case 'migration:create':
+      await migrateCreate();
+      break;
+    case 'migration:revert':
+      await migrateRevert();
+      break;
+    case 'database:console':
+      await databaseConsole({ remote: flags.remote });
+      break;
     case 'doctor':
       await doctor();
       break;

package/src/utils/telemetry.js

@@ -63,11 +63,20 @@ function isDisabledByEnv() {
   return process.env.DO_NOT_TRACK === '1' || process.env.LAUNCHFRAME_TELEMETRY_DISABLED === '1';
 }
 
+/**
+ * Check if running from a locally linked (dev) version
+ * @returns {boolean} True if running via npm link
+ */
+function isDevMode() {
+  return !__dirname.includes('node_modules');
+}
+
 /**
  * Check if telemetry is enabled
  * @returns {boolean} True if telemetry is enabled
  */
 function isEnabled() {
+  if (isDevMode()) return false;
   if (isDisabledByEnv()) return false;
   if (!config || !config.telemetry) return false;
   return config.telemetry.enabled !== false;
@@ -96,7 +105,7 @@ function initTelemetry() {
       writeConfig(config);
     }
 
-    if (!config.telemetry.noticeShown && !isDisabledByEnv()) {
+    if (!config.telemetry.noticeShown && !isDisabledByEnv() && !isDevMode()) {
       console.log(
         chalk.gray(
           '\nLaunchFrame collects anonymous usage data to improve the CLI.\n' +