@nometria-ai/nom 0.2.9 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nometria-ai/nom",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Deploy any project to any cloud from your terminal. One command, zero config.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -29,6 +29,11 @@ import { domain } from './commands/domain.js';
 import { env } from './commands/env.js';
 import { scan } from './commands/scan.js';
 import { setup } from './commands/setup.js';
+import { list } from './commands/list.js';
+import { rollback } from './commands/rollback.js';
+import { ssh } from './commands/ssh.js';
+import { db } from './commands/db.js';
+import { cron } from './commands/cron.js';
 
 const { values, positionals } = parseArgs({
   allowPositionals: true,
@@ -41,6 +46,9 @@ const { values, positionals } = parseArgs({
     from:      { type: 'string' },
     'api-key': { type: 'boolean', default: false },
     token:     { type: 'boolean', default: false },
+    'dry-run': { type: 'boolean', default: false },
+    preview:   { type: 'boolean', default: false },
+    production:{ type: 'boolean', default: false },
     message:   { type: 'string', short: 'm' },
   },
   strict: false,
@@ -86,6 +94,11 @@ const commands = {
   env,
   scan,
   setup,
+  list,
+  rollback,
+  ssh,
+  db,
+  cron,
 };
 
 const handler = commands[command];
@@ -99,12 +112,25 @@ try {
   await handler(values, positionals.slice(1));
 } catch (err) {
   if (err.code === 'ERR_AUTH') {
-    console.error(`\n  Not authenticated. Run: nom login\n`);
+    console.error(`\n  Not authenticated. Run: nom login`);
+    console.error(`  Get your API key at: https://nometria.com/settings/api-keys\n`);
   } else if (err.code === 'ERR_CONFIG') {
-    console.error(`\n  No nometria.json found. Run: nom init\n`);
+    console.error(`\n  No nometria.json found. Run: nom init`);
+    console.error(`  Docs: https://docs.nometria.com/cli/install\n`);
+  } else if (err.status === 402) {
+    console.error(`\n  Payment required. Upgrade your plan:`);
+    console.error(`  https://nometria.com/pricing\n`);
+  } else if (err.status === 404) {
+    console.error(`\n  App not found. List your apps: nom list`);
+    console.error(`  Dashboard: https://nometria.com/dashboard\n`);
+  } else if (err.status === 429) {
+    console.error(`\n  Rate limited. Wait a moment and try again.\n`);
   } else {
-    console.error(`\n  Error: ${err.message}\n`);
+    console.error(`\n  Error: ${err.message}`);
+    console.error(`  Docs: https://docs.nometria.com`);
+    console.error(`  Dashboard: https://nometria.com/dashboard`);
     if (process.env.NOM_DEBUG) console.error(err.stack);
+    console.error();
   }
   process.exit(1);
 }
@@ -121,6 +147,8 @@ function printHelp() {
     deploy              Deploy to production (default)
     preview             Deploy a staging preview
     status              Check deployment status
+    list                List all your apps
+    rollback [id]       Roll back to a previous deployment
     logs [-f]           View deployment logs
     login               Sign in via browser (or --api-key)
     whoami              Show current user
@@ -134,12 +162,21 @@ function printHelp() {
     stop                Stop a running instance
     terminate           Terminate instance permanently
     upgrade <size>      Upgrade instance (2gb/4gb/8gb/16gb)
+    ssh [command]       Connect to instance or run remote command
+
+    db backup           Create a database backup
+    db restore <id>     Restore from a backup
+    db shell            Show database connection details
+    db migrate          Run pending migrations
 
     domain add <domain> Add custom domain
     env set KEY=VALUE   Set environment variables
     env list            List environment variables
     env delete KEY      Delete environment variable
     scan                Run AI security scan
+    cron add <s> <cmd>  Add a scheduled task
+    cron list           List cron jobs
+    cron delete <id>    Delete a cron job
 
   Options:
     -h, --help       Show this help
@@ -148,6 +185,9 @@ function printHelp() {
     -f, --follow     Follow logs in real-time
     -m, --message    Commit message (for github push)
     --json           Output as JSON
+    --dry-run        Validate config and build without deploying
+    --preview        Target preview environment (for nom env)
+    --production     Target production environment (for nom env)
     --api-key        Login with API key paste instead of browser
     --from <url>     Deploy from a GitHub URL
 

package/src/commands/cron.js

@@ -0,0 +1,162 @@
+/**
+ * nom cron — Manage scheduled tasks on deployed instances.
+ *
+ * Subcommands:
+ *   add <schedule> <command>   Add a cron job (e.g., nom cron add "0 3 * * *" "npm run cleanup")
+ *   list                      List active cron jobs
+ *   delete <id>               Delete a cron job
+ */
+import { readConfig } from '../lib/config.js';
+import { requireApiKey } from '../lib/auth.js';
+import { apiRequest } from '../lib/api.js';
+
+export async function cron(flags, positionals) {
+  const sub = positionals[0];
+
+  switch (sub) {
+    case 'add':
+      return cronAdd(flags, positionals.slice(1));
+    case 'list':
+    case 'ls':
+      return cronList(flags);
+    case 'delete':
+    case 'rm':
+      return cronDelete(flags, positionals[1]);
+    default:
+      console.log(`
+  Usage: nom cron <command>
+
+  Commands:
+    add <schedule> <cmd>   Add a cron job
+    list                   List active cron jobs
+    delete <id>            Delete a cron job
+
+  Schedule format: standard cron expression
+    "0 3 * * *"            Daily at 3am UTC
+    "*/15 * * * *"         Every 15 minutes
+    "0 0 * * 0"            Weekly on Sunday
+
+  Examples:
+    nom cron add "0 3 * * *" "npm run cleanup"
+    nom cron add "*/5 * * * *" "curl -sf https://myapp.com/health"
+    nom cron list
+    nom cron delete cron_abc123
+
+  Help: https://docs.nometria.com/deploy/environment
+`);
+  }
+}
+
+async function cronAdd(flags, args) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json. Deploy first: nom deploy\n');
+    process.exit(1);
+  }
+
+  if (args.length < 2) {
+    console.error('\n  Usage: nom cron add "<schedule>" "<command>"');
+    console.error('  Example: nom cron add "0 3 * * *" "npm run cleanup"\n');
+    process.exit(1);
+  }
+
+  const schedule = args[0];
+  const command = args.slice(1).join(' ');
+
+  // Basic cron validation
+  const parts = schedule.split(/\s+/);
+  if (parts.length < 5 || parts.length > 6) {
+    console.error(`\n  Invalid cron schedule: "${schedule}"`);
+    console.error('  Expected format: "minute hour day month weekday"');
+    console.error('  Example: "0 3 * * *" (daily at 3am UTC)\n');
+    process.exit(1);
+  }
+
+  try {
+    const result = await apiRequest('/cli/cron', {
+      apiKey,
+      body: { app_id: appId, action: 'add', schedule, command },
+    });
+
+    console.log(`\n  Cron job added: ${result.cron_id || 'pending'}`);
+    console.log(`  Schedule: ${schedule}`);
+    console.log(`  Command:  ${command}`);
+    console.log(`  Timezone: UTC\n`);
+  } catch (err) {
+    console.error(`\n  Failed to add cron job: ${err.message}`);
+    console.error('  Help: https://docs.nometria.com/deploy/environment\n');
+    process.exit(1);
+  }
+}
+
+async function cronList(flags) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  try {
+    const result = await apiRequest('/cli/cron', {
+      apiKey,
+      body: { app_id: appId, action: 'list' },
+    });
+
+    const jobs = result.jobs || [];
+    if (!jobs.length) {
+      console.log('\n  No cron jobs configured. Add one: nom cron add "0 3 * * *" "npm run cleanup"\n');
+      return;
+    }
+
+    if (flags.json) {
+      console.log(JSON.stringify(jobs, null, 2));
+      return;
+    }
+
+    console.log(`\n  Cron jobs (${jobs.length}):\n`);
+    for (const job of jobs) {
+      console.log(`  ${job.id || '—'}`);
+      console.log(`    Schedule: ${job.schedule}`);
+      console.log(`    Command:  ${job.command}`);
+      if (job.last_run) console.log(`    Last run: ${job.last_run}`);
+      console.log();
+    }
+  } catch (err) {
+    console.error(`\n  Failed to list cron jobs: ${err.message}\n`);
+    process.exit(1);
+  }
+}
+
+async function cronDelete(flags, cronId) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  if (!cronId) {
+    console.error('\n  Usage: nom cron delete <cron_id>');
+    console.error('  List jobs first: nom cron list\n');
+    process.exit(1);
+  }
+
+  try {
+    await apiRequest('/cli/cron', {
+      apiKey,
+      body: { app_id: appId, action: 'delete', cron_id: cronId },
+    });
+    console.log(`\n  Cron job ${cronId} deleted.\n`);
+  } catch (err) {
+    console.error(`\n  Failed to delete cron job: ${err.message}\n`);
+    process.exit(1);
+  }
+}

package/src/commands/db.js

@@ -0,0 +1,267 @@
+/**
+ * nom db — Database management commands.
+ *
+ * Subcommands:
+ *   backup          Create a database backup
+ *   restore <id>    Restore from a backup
+ *   shell           Show connection instructions
+ *   migrate         Run pending migrations
+ */
+import { readConfig } from '../lib/config.js';
+import { requireApiKey } from '../lib/auth.js';
+import { apiRequest } from '../lib/api.js';
+
+export async function db(flags, positionals) {
+  const sub = positionals[0];
+
+  switch (sub) {
+    case 'backup':
+      return dbBackup(flags);
+    case 'restore':
+      return dbRestore(flags, positionals[1]);
+    case 'shell':
+      return dbShell(flags);
+    case 'migrate':
+      return dbMigrate(flags);
+    case 'ownership':
+    case 'own':
+      return dbOwnership(flags);
+    default:
+      console.log(`
+  Usage: nom db <command>
+
+  Commands:
+    backup            Create a database backup
+    restore <id>      Restore from a backup
+    shell             Show database connection details
+    migrate           Run pending migrations
+    ownership         Transfer database to your own Supabase project
+
+  Help: https://docs.nometria.com/deploy/environment
+`);
+  }
+}
+
+async function dbBackup(flags) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json. Deploy first: nom deploy\n');
+    process.exit(1);
+  }
+
+  console.log('\n  Creating database backup...\n');
+  try {
+    const result = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'backup' },
+    });
+
+    if (flags.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    console.log(`  Backup created: ${result.backup_id || 'pending'}`);
+    if (result.size) console.log(`  Size: ${result.size}`);
+    if (result.s3_path) console.log(`  Stored: ${result.s3_path}`);
+    console.log();
+  } catch (err) {
+    console.error(`\n  Backup failed: ${err.message}`);
+    console.error('  This may require the app to have a running database.');
+    console.error('  Help: https://docs.nometria.com/deploy/environment\n');
+    process.exit(1);
+  }
+}
+
+async function dbRestore(flags, backupId) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  if (!backupId) {
+    // List available backups
+    console.log('\n  Fetching available backups...\n');
+    try {
+      const result = await apiRequest('/cli/db', {
+        apiKey,
+        body: { app_id: appId, action: 'list_backups' },
+      });
+      const backups = result.backups || [];
+      if (!backups.length) {
+        console.log('  No backups found. Create one: nom db backup\n');
+        return;
+      }
+      console.log('  Available backups:\n');
+      for (const b of backups) {
+        console.log(`  ${b.id}  ${b.created_at || '—'}  ${b.size || '—'}`);
+      }
+      console.log('\n  Restore: nom db restore <backup_id>\n');
+    } catch (err) {
+      console.error(`\n  Failed to list backups: ${err.message}\n`);
+    }
+    return;
+  }
+
+  console.log(`\n  Restoring from backup: ${backupId}...\n`);
+  try {
+    const result = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'restore', backup_id: backupId },
+    });
+    console.log(`  Restore ${result.success ? 'completed' : 'failed'}.`);
+    if (result.message) console.log(`  ${result.message}`);
+    console.log();
+  } catch (err) {
+    console.error(`\n  Restore failed: ${err.message}\n`);
+    process.exit(1);
+  }
+}
+
+async function dbShell(flags) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  // Get instance details for connection info
+  try {
+    const result = await apiRequest('/checkAwsStatus', {
+      apiKey,
+      body: { app_id: appId },
+    });
+    const ip = result.data?.ipAddress;
+
+    console.log(`\n  Database connection for: ${appId}\n`);
+    console.log('  Via SSH tunnel (recommended):');
+    if (ip) {
+      console.log(`    ssh -L 5432:localhost:5432 ubuntu@${ip}`);
+      console.log('    psql postgresql://postgres:postgres@localhost:5432/postgres\n');
+    }
+    console.log('  Via SSM:');
+    const instanceId = result.data?.instanceId;
+    if (instanceId) {
+      console.log(`    aws ssm start-session --target ${instanceId} \\`);
+      console.log('      --document-name AWS-StartPortForwardingSession \\');
+      console.log("      --parameters '{\"portNumber\":[\"5432\"],\"localPortNumber\":[\"5432\"]}'\n");
+    }
+    console.log('  Direct on instance:');
+    console.log('    psql postgresql://postgres:postgres@localhost:5432/postgres\n');
+  } catch (err) {
+    console.error(`\n  Could not fetch instance details: ${err.message}\n`);
+    process.exit(1);
+  }
+}
+
+async function dbMigrate(flags) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  console.log('\n  Running database migrations...\n');
+  try {
+    const result = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'migrate' },
+    });
+    console.log(`  ${result.message || 'Migrations complete.'}\n`);
+  } catch (err) {
+    console.error(`\n  Migration failed: ${err.message}`);
+    console.error('  Check migration files in db/seeds/ or schema.sql\n');
+    process.exit(1);
+  }
+}
+
+async function dbOwnership(flags) {
+  const apiKey = requireApiKey();
+  const config = readConfig();
+  const appId = config.app_id;
+
+  if (!appId) {
+    console.error('\n  No app_id in nometria.json.\n');
+    process.exit(1);
+  }
+
+  console.log(`
+  Database Ownership Transfer
+  ═══════════════════════════
+
+  This transfers your app's database to a Supabase project YOU own.
+
+  What happens:
+    1. Export schema + data from current managed database
+    2. Create a new Supabase project under your account
+    3. Import schema + data into your project
+    4. Update your app's .env to point to your Supabase
+    5. Resync the app to use the new database
+
+  After transfer:
+    - You own the Supabase project directly
+    - You control backups, scaling, and access
+    - Nometria no longer manages the database
+    - Your app keeps running with no downtime
+`);
+
+  try {
+    console.log('  Step 1: Exporting current database...');
+    const exportResult = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'export_schema' },
+    });
+    console.log(`  Exported: ${exportResult.tables || '?'} tables, ${exportResult.rows || '?'} rows`);
+
+    console.log('  Step 2: Creating your Supabase project...');
+    const createResult = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'create_owned_supabase' },
+    });
+    const supaUrl = createResult.supabase_url;
+    console.log(`  Supabase project: ${supaUrl || 'pending'}`);
+
+    console.log('  Step 3: Importing schema + data...');
+    const importResult = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'import_to_owned', supabase_url: supaUrl },
+    });
+    console.log(`  Imported: ${importResult.message || 'complete'}`);
+
+    console.log('  Step 4: Updating app configuration...');
+    const updateResult = await apiRequest('/cli/db', {
+      apiKey,
+      body: { app_id: appId, action: 'switch_to_owned', supabase_url: supaUrl },
+    });
+    console.log(`  ${updateResult.message || 'Configuration updated'}`);
+
+    console.log(`
+  Database ownership transferred!
+
+  Your Supabase project: ${supaUrl || 'See Supabase dashboard'}
+  Dashboard: https://supabase.com/dashboard
+  App: https://nometria.com/AppDetails?app_id=${appId}
+
+  Your app is now using YOUR Supabase project.
+  You have full control over backups, scaling, and access.
+`);
+  } catch (err) {
+    console.error(`\n  Ownership transfer failed: ${err.message}`);
+    console.error('  This feature requires a running instance with Supabase.');
+    console.error('  Help: https://docs.nometria.com/deploy/environment\n');
+    process.exit(1);
+  }
+}