mbkbucket 3.8.1 → 3.8.3

package/README.md

@@ -111,65 +111,41 @@ The Express app includes:
 
 ## CLI Usage 💻
 
-> **⚠️ Under active development.** The CLI is functional but some features may change.
+mbkbucket includes a CLI for running the dashboard and API as a standalone Node.js server application.
 
-mbkbucket ships with a command-line interface for managing buckets directly from the terminal.
-
-### Setup
+### Run Standalone Server
 
 ```bash
-# Set your mbkauthe server URL (one-time)
-mbkbucket config set serverUrl https://your-server.example.com
-
-# Set your API token profile key (one-time, optional)
-mbkbucket config set profileKey your-profile-key
+# Run using npx
+npx mbkbucket
 
-# Authenticate via device flow
-mbkbucket login
+# Or after installing globally / locally
+mbkbucket
 ```
 
-### Commands
+### CLI Options
 
-| Command | Alias | Description |
+| Option | Shorthand | Description |
 |---|---|---|
-| `mbkbucket login` | — | Authenticate via mbkauthe device flow |
-| `mbkbucket logout` | — | Clear stored credentials |
-| `mbkbucket whoami` | — | Show login status |
-| | | |
-| `mbkbucket list [prefix]` | `ls` | List files and folders |
-| `mbkbucket upload <file> [key]` | `up` | Upload a file or folder |
-| `mbkbucket download <key> [dest]` | `dl` | Download a file or folder |
-| `mbkbucket delete <key>` | `rm` | Delete a file |
-| `mbkbucket delete-folder <prefix>` | `rmdir` | Recursively delete a folder |
-| `mbkbucket info <key>` | `stat` | Show file metadata (size, type, etc.) |
-| `mbkbucket signed-url <key>` | `sign` | Generate a pre-signed download URL |
-| | | |
-| `mbkbucket config` | `cfg` | Show all config values |
-| `mbkbucket config get <key>` | — | Get a specific config value |
-| `mbkbucket config set <k> <v>` | — | Set a config value |
-| `mbkbucket config unset <key>` | — | Remove a config value |
-| `mbkbucket config path` | — | Show config file location |
-| `mbkbucket config reset` | — | Reset to demo values |
-| `mbkbucket config edit` | — | Open config file in editor |
-
-### Global Options
-
-| Flag | Description |
-|---|---|
-| `--app`, `-a <name>` | Override `APP_NAME` for key prefix isolation |
-| `--bucket`, `-b <name>` | Override default bucket name |
-| `--help`, `-h` | Show help |
-
-### Login Options
+| `--port <number>` | `-p` | Port to listen on (default: `3004` or `$PORT`) |
+| `--host <host>` | `-H` | Host address to bind to (default: `0.0.0.0` or `$HOST`) |
+| `--app <name>` | `-a` | Override `APP_NAME` for bucket key prefix isolation |
+| `--bucket <name>` | `-b` | Override default bucket name |
+| `--env <path>` | `-e` | Load environment variables from a custom `.env` file |
+| `--dev` | `-d` | Run in development mode (`NODE_ENV=dev`) |
+| `--open` | `-o` | Automatically open dashboard in default browser |
+| `--version` | `-v` | Show version number |
+| `--help` | `-h` | Show help text |
+
+### Examples
 
-| Flag | Description |
-|---|---|
-| `--server <url>` | mbkauthe server URL |
-| `--profile-key <k>` | API token profile key |
-
-### Config File
+```bash
+# Start server on custom port and open browser
+mbkbucket -p 8080 --open
 
-CLI configuration is stored at `~/.mbkbucket/config.json`. A demo config is created automatically on first use.
+# Start with a specific .env file and application prefix
+mbkbucket --env ./configs/.env.prod -a myapp
+```
 
 ---
 

package/lib/cli.js

@@ -8,643 +8,232 @@
  */
 
 /**
- * mbkbucket CLI — Manage S3/R2 buckets from the command line.
+ * mbkbucket CLI — Standalone server runner for MBKBucket web application.
  */
 
 import dotenv from 'dotenv';
 import path from 'node:path';
-import fs from 'node:fs';
-import { formatBytes, formatDate, streamToBuffer, getMimeType, trimSlashes, nowIso } from './src/utils/helpers.js';
-import { readConfig, clearConfig, updateConfig, writeConfig, isLoggedIn, deviceFlowLogin, CONFIG_FILE, CONFIG_DIR } from './src/cli/auth-helper.js';
+import os from 'node:os';
+import { createApp } from './src/app.js';
+import { packageJson, checkVersion } from './src/config/index.js';
+import { checkHealth, getAvailableBucketNames } from './src/services/s3.service.js';
 
-dotenv.config();
+// ---------------------------------------------------------------------------
+// ANSI Color helpers
+// ---------------------------------------------------------------------------
+const c = {
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+};
 
 // ---------------------------------------------------------------------------
 // Parse CLI arguments
 // ---------------------------------------------------------------------------
 const args = process.argv.slice(2);
-const VALUE_FLAGS = new Set(['server', 'app', 'bucket', 'profile-key', 'expires']);
 
-function findFlag(name) {
+function findFlag(name, shortChar) {
   const long = `--${name}`;
-  const short = `-${name[0]}`;
+  const short = shortChar ? `-${shortChar}` : `-${name[0]}`;
   for (let i = 0; i < args.length; i++) {
     if (args[i] === long || args[i] === short) {
-      return args[i + 1] !== undefined && !args[i + 1].startsWith('-') ? args[i + 1] : true;
-    }
-  }
-  return undefined;
-}
-
-const hasFlag = name => args.includes(`--${name}`) || args.includes(`-${name[0]}`);
-
-function getPositionalArgs() {
-  const positional = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith('-')) {
-      const flagName = args[i].replace(/^-+/, '');
-      if (VALUE_FLAGS.has(flagName) && i + 1 < args.length && !args[i + 1].startsWith('-')) {
-        i++;
+      if (args[i + 1] !== undefined && !args[i + 1].startsWith('-')) {
+        return args[i + 1];
       }
-    } else {
-      positional.push(args[i]);
+      return true;
     }
   }
-  return positional;
+  return undefined;
 }
 
-const positionalArgs = getPositionalArgs();
-const command = positionalArgs[0] || 'help';
-const cmdArgs = positionalArgs.slice(1);
+const hasFlag = (name, shortChar) => {
+  const long = `--${name}`;
+  const short = shortChar ? `-${shortChar}` : `-${name[0]}`;
+  return args.includes(long) || args.includes(short);
+};
 
 // ---------------------------------------------------------------------------
-// Help text & S3 helper
+// Help & Version
 // ---------------------------------------------------------------------------
 function showHelp() {
   console.log(`
-  mbkbucket — S3/R2 bucket CLI
-
-  USAGE:
-    mbkbucket <command> [options] [arguments]
-
-  COMMANDS:
-    login              Authenticate with mbkauthe device flow
-    logout             Clear stored credentials
-    whoami             Show current login status
-
-    config             Show all config values
-    config get <key>   Get a specific config value
-    config set <k> <v> Set a config value
-    config unset <key> Remove a config value
-    config path        Show config file path
-    config reset       Reset to demo values
-    config edit        Open config file in editor
-
-    list [prefix]      List files and folders
-    upload <file> [key]   Upload a file or folder
-    download <key> [dest] Download a file or folder
-    delete <key>          Delete a file
-    delete-folder <prefix>  Recursively delete a folder
-    info <key>            Show file metadata
-    signed-url <key>      Generate a pre-signed download URL
-
-  GLOBAL OPTIONS:
-    --app, -a <name>   Override APP_NAME for key prefixing
-    --bucket, -b <name> Override default bucket name
-    --help, -h         Show this help
-
-  LOGIN OPTIONS:
-    --server <url>     mbkauthe server URL (required for login)
-    --profile-key <k>  API token profile key
-
-  SIGNED-URL OPTIONS:
-    --expires <sec>    Expiration in seconds (default: 3600)
-
-  ENVIRONMENT:
-    BucketConnection   JSON mapping of bucket name → S3 credentials
-    APP_NAME           Application name for key prefix isolation
-    PORT               Server port (default: 3004)
+  ${c.cyan(c.bold('⚡ mbkbucket'))} ${c.dim(`v${packageJson.version}`)}
+  Standalone S3/R2 Bucket Management Server
+
+  ${c.bold('USAGE:')}
+    mbkbucket [options]
+    npx mbkbucket [options]
+
+  ${c.bold('OPTIONS:')}
+    -p, --port <number>    Port to listen on (default: 3004 or $PORT)
+    -H, --host <host>      Host address to bind (default: 0.0.0.0 or $HOST)
+    -a, --app <name>       Override APP_NAME for bucket key prefix isolation
+    -b, --bucket <name>    Override default bucket name (MBKAUTHE_BUCKET)
+    -e, --env <path>       Load environment variables from a custom .env file
+    -d, --dev              Run in development mode (NODE_ENV=dev)
+    -o, --open             Automatically open the dashboard in default browser
+    -v, --version          Show version number
+    -h, --help             Show this help message
+
+  ${c.bold('ENVIRONMENT VARIABLES:')}
+    PORT                   Server port (default: 3004)
+    HOST                   Server host (default: 0.0.0.0)
+    NODE_ENV               Environment mode ('production' | 'dev')
+    BucketConnection       JSON mapping of bucket name -> S3 credentials
+    mbkautheVar            mbkauthe configuration JSON
+    mbkbucketVar           mbkbucket configuration JSON
+
+  ${c.bold('EXAMPLES:')}
+    $ mbkbucket
+    $ mbkbucket -p 8080 --open
+    $ mbkbucket --env ./configs/.env.prod -a myapp
 `);
 }
 
-let _s3Module = null;
-async function getS3() {
-  if (_s3Module) return _s3Module;
-  const appFlag = findFlag('app');
-  if (appFlag && typeof appFlag === 'string') process.env.APP_NAME = appFlag;
-  _s3Module = await import('./src/services/s3.service.js');
-  return _s3Module;
-}
-
-function walkDir(dir) {
-  return fs.readdirSync(dir, { withFileTypes: true }).flatMap(dirent => {
-    const fullPath = path.join(dir, dirent.name);
-    return dirent.isDirectory() ? walkDir(fullPath) : [fullPath];
-  });
-}
-
-function promptLine() {
-  return new Promise((resolve) => {
-    const { stdin, stdout } = process;
-    stdin.resume();
-    stdout.write('> ');
-    stdin.once('data', (data) => {
-      stdin.pause();
-      resolve(data.toString().trim());
-    });
-  });
+function showVersion() {
+  console.log(`mbkbucket v${packageJson.version}`);
 }
 
-// ---------------------------------------------------------------------------
-// Command Implementations
-// ---------------------------------------------------------------------------
-
-async function cmdLogin() {
-  const storedCfg = readConfig();
-  const server_url = findFlag('server') || storedCfg.server_url;
-
-  if (!server_url || typeof server_url !== 'string') {
-    console.error('❌ --server <url> is required for login.\n   Example: mbkbucket login --server https://myapp.example.com\n\n💡 Tip: Set it once with:\n   mbkbucket config set server_url https://your-server.com\n   Then just run: mbkbucket login');
-    process.exit(1);
-  }
-
-  const profile_key = findFlag('profile-key') || storedCfg.profile_key;
-  updateConfig({ server_url });
-
+function getNetworkIp() {
   try {
-    const result = await deviceFlowLogin({
-      server_url,
-      profile_key: typeof profile_key === 'string' ? profile_key : undefined,
-    });
-
-    updateConfig({
-      token: result.token,
-      token_prefix: result.token_prefix,
-      username: result.username,
-      server_url,
-      profile: result.profile || null,
-      logged_in_at: nowIso(),
-    });
-
-    console.log('\n✅ Credentials saved. You are now logged in.\n   Run "mbkbucket whoami" to verify.');
-  } catch (err) {
-    const msg = err.message || '';
-    console.error(`❌ Login failed: ${msg}`);
-    if (msg.includes('profile_key') || msg.includes('profile_id')) {
-      console.error('\n💡 An API token profile is required. Create one in mbkauthe admin panel and pass --profile-key.');
-    } else if (msg.includes('fetch') || msg.includes('ECONNREFUSED') || msg.includes('ENOTFOUND')) {
-      console.error(`\n💡 Could not reach server "${server_url}". Verify it is running and CLI_AUTH_ENABLED=true.`);
-    }
-    process.exit(1);
-  }
-}
-
-function cmdLogout() {
-  if (!isLoggedIn()) return console.log('ℹ️  Not logged in.');
-  const { username = 'user' } = readConfig();
-  clearConfig();
-  console.log(`👋 Logged out. Goodbye, ${username}!`);
-}
-
-function cmdWhoami() {
-  if (!isLoggedIn()) return console.log('ℹ️  Not logged in. Run "mbkbucket login --server <url>" to authenticate.');
-  const cfg = readConfig();
-  console.log(`✅ Logged in as: ${cfg.username}`);
-  console.log(`   Server:      ${cfg.server_url}`);
-  console.log(`   Token:       ${cfg.token_prefix}...`);
-  if (cfg.profile) console.log(`   Profile:     ${cfg.profile.name} (scope: ${cfg.profile.scope || 'full'})`);
-  console.log(`   Since:       ${formatDate(cfg.logged_in_at)}`);
-}
-
-async function cmdList() {
-  const prefix = cmdArgs[0] || '';
-  const bucketName = findFlag('bucket');
-
-  try {
-    const s3 = await getS3();
-    const result = await s3.listfiles(prefix, { bucketName, delimiter: '/' });
-
-    if (!result.Contents?.length) {
-      return console.log(`📭 No files found${prefix ? ` with prefix "${prefix}"` : ''}.`);
-    }
-
-    console.log(`\n📁 Files${prefix ? ` matching "${prefix}"` : ''} (${result.KeyCount || result.Contents.length} items):\n` + '─'.repeat(80));
-
-    if (result.CommonPrefixes?.length) {
-      for (const cp of result.CommonPrefixes) {
-        const folderName = cp.Prefix.replace(/\/$/, '').split('/').pop() || cp.Prefix;
-        console.log(`  📂 ${folderName}/`);
+    const nets = os.networkInterfaces();
+    for (const name of Object.keys(nets)) {
+      for (const net of nets[name] ?? []) {
+        if (net.family === 'IPv4' && !net.internal) return net.address;
       }
-      if (result.Contents.length > 0) console.log('');
-    }
-
-    for (const obj of result.Contents) {
-      const name = obj.Key || '';
-      const displayName = name.length > 60 ? `...${name.slice(-57)}` : name;
-      console.log(`  ${displayName.padEnd(62)} ${formatBytes(obj.Size).padStart(10)}  ${formatDate(obj.LastModified)}`);
     }
+  } catch {}
+  return undefined;
+}
 
-    console.log('─'.repeat(80));
-    if (result.hasMore) console.log('  ... more files available (use --prefix to narrow down)');
-    console.log('');
-  } catch (err) {
-    console.error(`❌ List failed: ${err.message}`);
-    process.exit(1);
-  }
+function openBrowser(url) {
+  const platform = process.platform;
+  let cmd = '';
+  if (platform === 'darwin') cmd = `open "${url}"`;
+  else if (platform === 'win32') cmd = `start "" "${url}"`;
+  else cmd = `xdg-open "${url}"`;
+  import('node:child_process').then(({ exec }) => {
+    exec(cmd, () => {});
+  }).catch(() => {});
 }
 
-async function cmdUpload() {
-  const filePath = cmdArgs[0];
-  if (!filePath) {
-    console.error('❌ Usage: mbkbucket upload <file> [key]\n   Example: mbkbucket upload ./photo.jpg images/photo.jpg');
-    process.exit(1);
+// ---------------------------------------------------------------------------
+// Main Runner
+// ---------------------------------------------------------------------------
+async function main() {
+  if (hasFlag('help', 'h')) {
+    showHelp();
+    process.exit(0);
   }
 
-  const resolved = path.resolve(filePath);
-  if (!fs.existsSync(resolved)) {
-    console.error(`❌ File not found: ${filePath}`);
-    process.exit(1);
+  if (hasFlag('version', 'v')) {
+    showVersion();
+    process.exit(0);
   }
 
-  if (fs.statSync(resolved).isDirectory()) {
-    await uploadFolder(resolved);
+  // Load custom or default .env
+  const envPath = findFlag('env', 'e');
+  if (typeof envPath === 'string') {
+    dotenv.config({ path: path.resolve(process.cwd(), envPath) });
   } else {
-    await uploadSingleFile(resolved);
+    dotenv.config();
   }
-}
 
-async function uploadSingleFile(filePath) {
-  const bucketName = findFlag('bucket');
-  const stat = fs.statSync(filePath);
-  const fileName = path.basename(filePath);
-  const key = cmdArgs[1] || fileName;
-  const contentType = getMimeType(fileName);
-
-  console.log(`⬆️  Uploading: ${fileName} (${formatBytes(stat.size)}) → ${key}`);
-  try {
-    const s3 = await getS3();
-    const result = await s3.uploadFile(key, fs.readFileSync(filePath), contentType, { bucketName });
-    console.log(`✅ Uploaded: ${result.key} (${formatBytes(result.fileSize)})`);
-  } catch (err) {
-    console.error(`❌ Upload failed: ${err.message}`);
-    process.exit(1);
+  // Handle environment overrides from flags
+  const appFlag = findFlag('app', 'a');
+  if (typeof appFlag === 'string') {
+    process.env.APP_NAME = appFlag;
   }
-}
-
-async function uploadFolder(folderPath) {
-  const bucketName = findFlag('bucket');
-  const prefix = cmdArgs[1] || path.basename(folderPath);
-  const files = walkDir(folderPath);
-
-  if (!files.length) return console.log('📭 No files found in folder.');
-
-  console.log(`📁 Uploading folder: ${folderPath} (${files.length} files) → ${prefix}/\n`);
-  let uploaded = 0;
-  let failed = 0;
 
-  for (const file of files) {
-    const rel = path.relative(folderPath, file).replace(/\\/g, '/');
-    const key = `${prefix}/${rel}`;
-    try {
-      const s3 = await getS3();
-      await s3.uploadFile(key, fs.readFileSync(file), getMimeType(file), { bucketName });
-      console.log(`  ✅ ${rel}`);
-      uploaded++;
-    } catch (err) {
-      console.error(`  ❌ ${rel}: ${err.message}`);
-      failed++;
-    }
+  const bucketFlag = findFlag('bucket', 'b');
+  if (typeof bucketFlag === 'string') {
+    process.env.MBKAUTHE_BUCKET = bucketFlag;
   }
 
-  console.log(`\nDone: ${uploaded} uploaded, ${failed} failed.`);
-  if (failed > 0) process.exit(1);
-}
-
-async function cmdDownload() {
-  const key = cmdArgs[0];
-  if (!key) {
-    console.error('❌ Usage: mbkbucket download <key> [destination]');
-    process.exit(1);
+  if (hasFlag('dev', 'd')) {
+    process.env.NODE_ENV = 'dev';
   }
 
-  const dest = cmdArgs[1] || path.basename(key);
-  const bucketName = findFlag('bucket');
+  const port = parseInt(findFlag('port', 'p') || process.env.PORT || '3004', 10);
+  const host = findFlag('host', 'H') || process.env.HOST || '0.0.0.0';
+  const shouldOpen = hasFlag('open', 'o');
 
-  try {
-    const s3 = await getS3();
-    if (key.endsWith('/')) return downloadFolder(s3, key, dest, bucketName);
+  // Check version in background
+  await checkVersion();
 
-    console.log(`⬇️  Downloading: ${key} → ${dest}`);
-    const result = await s3.downloadFile(key, { bucketName });
-    if (result.notModified) return console.log('ℹ️  File not modified.');
-
-    const body = await streamToBuffer(result.Body);
-    const destDir = path.dirname(path.resolve(dest));
-    if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
-    fs.writeFileSync(path.resolve(dest), body);
-
-    console.log(`✅ Downloaded: ${dest} (${formatBytes(body.length)})`);
+  // Test S3 connectivity
+  let healthResult = null;
+  try {
+    healthResult = await checkHealth();
   } catch (err) {
-    console.error(`❌ Download failed: ${err.message}`);
-    process.exit(1);
+    healthResult = { status: 'unhealthy', error: err.message };
   }
-}
 
-async function downloadFolder(s3, prefix, destDir, bucketName) {
-  const allFiles = [];
-  let token = null;
-  const resolvedDest = path.resolve(destDir);
+  // Create express application
+  const app = createApp();
 
-  do {
-    const result = await s3.listfiles(prefix, { bucketName, continuationToken: token });
-    (result.Contents || []).forEach(obj => {
-      if (obj.Key && obj.Key !== prefix) allFiles.push(obj.Key);
-    });
-    token = result.IsTruncated ? result.NextContinuationToken : null;
-  } while (token);
+  const server = app.listen(port, host, () => {
+    const isAnyHost = host === '0.0.0.0' || host === '::' || host === '';
+    const displayHost = isAnyHost ? 'localhost' : host;
+    const localUrl = `http://${displayHost}:${port}/mbkbucket`;
 
-  if (!allFiles.length) return console.log(`📭 No files found with prefix "${prefix}".`);
+    console.log();
+    console.log(`  ${c.cyan(c.bold('⚡ MBKBucket'))} ${c.dim(`v${packageJson.version}`)}`);
+    console.log();
+    console.log(`  ${c.green('➜')}  ${c.bold('Local:')}    ${c.cyan(localUrl)}`);
 
-  console.log(`📁 Downloading ${allFiles.length} files to ${resolvedDest}/\n`);
-  let downloaded = 0;
-  let failed = 0;
-
-  for (const fileKey of allFiles) {
-    const relativePath = fileKey.startsWith(prefix) ? fileKey.slice(prefix.length) : fileKey;
-    const filePath = path.join(resolvedDest, relativePath);
-    try {
-      const result = await s3.downloadFile(fileKey, { bucketName });
-      if (!result.notModified) {
-        const body = await streamToBuffer(result.Body);
-        const fileDir = path.dirname(filePath);
-        if (!fs.existsSync(fileDir)) fs.mkdirSync(fileDir, { recursive: true });
-        fs.writeFileSync(filePath, body);
+    if (isAnyHost) {
+      const netIp = getNetworkIp();
+      if (netIp) {
+        console.log(`  ${c.green('➜')}  ${c.bold('Network:')}  ${c.cyan(`http://${netIp}:${port}/mbkbucket`)}`);
       }
-      console.log(`  ✅ ${relativePath}`);
-      downloaded++;
-    } catch (err) {
-      console.error(`  ❌ ${relativePath}: ${err.message}`);
-      failed++;
     }
-  }
 
-  console.log(`\nDone: ${downloaded} downloaded, ${failed} failed.`);
-  if (failed > 0) process.exit(1);
-}
+    const appName = process.env.APP_NAME || 'root';
+    console.log(`  ${c.green('➜')}  ${c.bold('App Name:')} ${appName}`);
 
-async function cmdDelete() {
-  const key = cmdArgs[0];
-  if (!key) {
-    console.error('❌ Usage: mbkbucket delete <key>');
-    process.exit(1);
-  }
-
-  try {
-    const s3 = await getS3();
-    console.log(`🗑️  Deleting: ${key}`);
-    const result = await s3.deleteFile(key, findFlag('bucket'));
-    console.log(`✅ Deleted: ${result.key}`);
-  } catch (err) {
-    console.error(`❌ Delete failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-async function cmdDeleteFolder() {
-  const prefix = cmdArgs[0];
-  if (!prefix) {
-    console.error('❌ Usage: mbkbucket delete-folder <prefix>');
-    process.exit(1);
-  }
-
-  const cleaned = trimSlashes(prefix);
-  console.log(`⚠️  This will delete ALL files under "${cleaned}/".\n   Are you sure? Type "yes" to confirm:`);
-
-  const confirmed = await promptLine();
-  if (confirmed.trim().toLowerCase() !== 'yes') return console.log('Cancelled.');
-
-  try {
-    const s3 = await getS3();
-    console.log(`🗑️  Deleting folder: ${cleaned}/`);
-    const result = await s3.deleteFolder(cleaned, findFlag('bucket'));
-    console.log(`✅ Deleted ${result.deletedCount} file(s) under "${cleaned}/".`);
-  } catch (err) {
-    console.error(`❌ Delete folder failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-async function cmdInfo() {
-  const key = cmdArgs[0];
-  if (!key) {
-    console.error('❌ Usage: mbkbucket info <key>');
-    process.exit(1);
-  }
+    let bucketNames = [];
+    try {
+      bucketNames = getAvailableBucketNames();
+    } catch {}
 
-  try {
-    const s3 = await getS3();
-    const meta = await s3.getFileMetadata(key, findFlag('bucket'));
-    if (!meta.exists) {
-      console.log(`❌ File not found: ${key}`);
-      process.exit(1);
+    if (bucketNames.length > 0) {
+      console.log(`  ${c.green('➜')}  ${c.bold('Buckets:')}  ${bucketNames.join(', ')}`);
     }
 
-    console.log(`\n📄 ${meta.key}\n` + '─'.repeat(60));
-    console.log(`  Size:          ${formatBytes(meta.ContentLength)}`);
-    console.log(`  Type:          ${meta.ContentType || 'unknown'}`);
-    console.log(`  Last Modified: ${formatDate(meta.LastModified)}`);
-    console.log(`  ETag:          ${meta.ETag || '—'}`);
-    console.log(`  Cache-Control: ${meta.CacheControl || '—'}`);
-    if (meta.Metadata && Object.keys(meta.Metadata).length > 0) {
-      console.log('  Metadata:');
-      for (const [k, v] of Object.entries(meta.Metadata)) console.log(`    ${k}: ${v}`);
+    if (healthResult?.status === 'healthy') {
+      console.log(`  ${c.green('➜')}  ${c.bold('Storage:')}  ${c.green('✓ Connected')} (${healthResult.bucket} in ${healthResult.responseTime}ms)`);
+    } else if (healthResult?.error) {
+      console.log(`  ${c.yellow('➜')}  ${c.bold('Storage:')}  ${c.yellow('⚠ Connection warning')} (${healthResult.error})`);
     }
-    console.log('');
-  } catch (err) {
-    console.error(`❌ Info failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-async function cmdSignedUrl() {
-  const key = cmdArgs[0];
-  if (!key) {
-    console.error('❌ Usage: mbkbucket signed-url <key> [--expires <seconds>]');
-    process.exit(1);
-  }
-
-  const expires = parseInt(findFlag('expires'), 10) || 3600;
-  try {
-    const s3 = await getS3();
-    console.log(`🔗 Generating signed URL (expires in ${expires}s)...`);
-    const result = await s3.generateSignedUrl(key, 'getObject', expires, findFlag('bucket'));
-    console.log(`\n${result.url || result}`);
-  } catch (err) {
-    console.error(`❌ Signed URL failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Config Commands
-// ---------------------------------------------------------------------------
-const DEMO_CONFIG = {
-  token: 'mbk_demo_token_replace_with_real_one_from_login',
-  token_prefix: 'mbk_demo',
-  username: 'demo-user',
-  server_url: 'https://your-app.example.com',
-  profile: { name: 'Default CLI Profile', scope: 'read-write', allowed_apps: ['mbkbucket'] },
-  logged_in_at: nowIso(),
-};
-
-const VALID_CONFIG_KEYS = ['token', 'token_prefix', 'username', 'server_url', 'profile', 'profile_key', 'logged_in_at'];
-
-async function cmdConfig() {
-  const [sub, key, value] = cmdArgs;
-  switch (sub) {
-    case 'get': return cmdConfigGet(key);
-    case 'set': return cmdConfigSet(key, value);
-    case 'unset':
-    case 'del':
-    case 'delete': return cmdConfigUnset(key);
-    case 'path': return cmdConfigPath();
-    case 'reset': return cmdConfigReset();
-    case 'edit': return cmdConfigEdit();
-    default: return cmdConfigShow();
-  }
-}
-
-function cmdConfigShow() {
-  const cfg = readConfig();
-  const entries = Object.keys(cfg).filter(k => !k.startsWith('_'));
-
-  if (!entries.length) {
-    console.log(`📭 No config values set.\n   File: ${CONFIG_FILE}\n   Run "mbkbucket config reset" to populate demo values.`);
-    return;
-  }
-
-  console.log(`\n📋 Config (${CONFIG_FILE}):\n` + '─'.repeat(60));
-  for (const k of entries.sort()) {
-    const v = cfg[k];
-    const display = typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v);
-    const masked = (k === 'token' && display.length > 12)
-      ? `${display.slice(0, 8)}...${display.slice(-4)}`
-      : display.length > 55 ? `${display.slice(0, 52)}...` : display;
-    console.log(`  ${k.padEnd(14)} ${masked}`);
-  }
-  console.log('─'.repeat(60) + '\n  Run "mbkbucket config set <key> <value>" to change a value.\n  Run "mbkbucket config edit" to open in your editor.\n');
-}
-
-function cmdConfigGet(key) {
-  if (!key || !VALID_CONFIG_KEYS.includes(key)) {
-    console.error(`❌ Usage: mbkbucket config get <key>\n   Valid keys: ${VALID_CONFIG_KEYS.join(', ')}`);
-    process.exit(1);
-  }
-  const cfg = readConfig();
-  if (!(key in cfg)) {
-    console.error(`❌ Key not found: ${key}\n   Valid keys: ${VALID_CONFIG_KEYS.join(', ')}`);
-    process.exit(1);
-  }
-  const v = cfg[key];
-  console.log(typeof v === 'object' && v !== null ? JSON.stringify(v, null, 2) : String(v));
-}
-
-function cmdConfigSet(key, value) {
-  if (!key || value === undefined || !VALID_CONFIG_KEYS.includes(key)) {
-    console.error(`❌ Usage: mbkbucket config set <key> <value>\n   Valid keys: ${VALID_CONFIG_KEYS.join(', ')}`);
-    process.exit(1);
-  }
-
-  let parsed = value;
-  if (/^[{\[].*[}\]]$/.test(value)) {
-    try { parsed = JSON.parse(value); } catch {}
-  }
-
-  updateConfig({ [key]: parsed });
-  console.log(`✅ Set ${key} = ${typeof parsed === 'object' ? JSON.stringify(parsed) : parsed}`);
-}
-
-function cmdConfigUnset(key) {
-  if (!key) {
-    console.error(`❌ Usage: mbkbucket config unset <key>\n   Valid keys: ${VALID_CONFIG_KEYS.join(', ')}`);
-    process.exit(1);
-  }
-  const cfg = readConfig();
-  if (!(key in cfg)) {
-    console.error(`❌ Key not found: ${key}`);
-    process.exit(1);
-  }
-  delete cfg[key];
-  writeConfig(cfg);
-  console.log(`🗑️  Removed: ${key}`);
-}
-
-function cmdConfigPath() {
-  console.log(`📁 Config directory: ${CONFIG_DIR}\n📄 Config file:      ${CONFIG_FILE}`);
-  if (fs.existsSync(CONFIG_FILE)) {
-    const stat = fs.statSync(CONFIG_FILE);
-    console.log(`   Size:             ${formatBytes(stat.size)}\n   Modified:         ${formatDate(stat.mtime.toISOString())}`);
-  }
-}
-
-async function cmdConfigReset() {
-  console.log('⚠️  This will overwrite your current config with demo values.\n   Are you sure? Type "yes" to confirm:');
-  const confirmed = await promptLine();
-  if (confirmed.trim().toLowerCase() !== 'yes') return console.log('Cancelled.');
-  writeConfig({ ...DEMO_CONFIG });
-  console.log('✅ Config reset to demo values.\n   Run "mbkbucket config" to view.');
-}
-
-async function cmdConfigEdit() {
-  const editor = process.env.EDITOR || process.env.VISUAL || 'notepad';
-  if (!fs.existsSync(CONFIG_DIR)) fs.mkdirSync(CONFIG_DIR, { recursive: true });
-  if (!fs.existsSync(CONFIG_FILE)) writeConfig({ ...DEMO_CONFIG });
 
-  console.log(`✏️  Opening ${CONFIG_FILE} with ${editor}...`);
-  const { spawn } = await import('node:child_process');
-  const child = spawn(editor, [CONFIG_FILE], { stdio: 'inherit', shell: true });
+    console.log();
+    console.log(`  ${c.dim('Press Ctrl+C to stop the server')}`);
+    console.log();
 
-  return new Promise((resolve) => {
-    child.on('exit', (code) => {
-      if (code === 0) console.log('✅ Editor closed.');
-      else console.error(`⚠️  Editor exited with code ${code}.`);
-      resolve();
-    });
-    child.on('error', (err) => {
-      console.error(`❌ Could not open editor (${editor}): ${err.message}`);
-      resolve();
-    });
+    if (shouldOpen) {
+      openBrowser(localUrl);
+    }
   });
-}
 
-// ---------------------------------------------------------------------------
-// Main Router
-// ---------------------------------------------------------------------------
-const COMMANDS = {
-  login: cmdLogin,
-  logout: cmdLogout,
-  whoami: cmdWhoami,
-  list: cmdList,
-  ls: cmdList,
-  upload: cmdUpload,
-  up: cmdUpload,
-  download: cmdDownload,
-  dl: cmdDownload,
-  delete: cmdDelete,
-  rm: cmdDelete,
-  'delete-folder': cmdDeleteFolder,
-  rmdir: cmdDeleteFolder,
-  info: cmdInfo,
-  stat: cmdInfo,
-  'signed-url': cmdSignedUrl,
-  sign: cmdSignedUrl,
-  config: cmdConfig,
-  cfg: cmdConfig,
-  help: showHelp,
-  '--help': showHelp,
-  '-h': showHelp,
-};
-
-async function main() {
-  if (hasFlag('help')) return showHelp();
-
-  const appFlag = findFlag('app');
-  if (appFlag && typeof appFlag === 'string') process.env.APP_NAME = appFlag;
-
-  const bucketFlag = findFlag('bucket');
-  if (bucketFlag && typeof bucketFlag === 'string') process.env.MBKAUTHE_BUCKET = bucketFlag;
-
-  const handler = COMMANDS[command];
-  if (!handler) {
-    console.error(`❌ Unknown command: ${command}\n   Run "mbkbucket --help" for usage information.`);
-    process.exit(1);
-  }
+  const shutdown = (signal) => {
+    console.log(`\n  ${c.dim(`Received ${signal}, shutting down...`)}`);
+    server.close(() => {
+      console.log(`  ${c.green('✓')} ${c.dim('MBKBucket server stopped.')}\n`);
+      process.exit(0);
+    });
+    setTimeout(() => process.exit(0), 2000).unref();
+  };
 
-  await handler();
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
 }
 
 main().catch((err) => {
-  console.error(`❌ Unexpected error: ${err.message}`);
+  console.error(`\n${c.red(c.bold('Error starting mbkbucket:'))} ${err.message}`);
   if (process.env.DEBUG) console.error(err);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mbkbucket",
-  "version": "3.8.1",
-  "description": "Flexible S3/R2 bucket management — library, Express router, and CLI for mbktech.org applications. Provides upload, download, listing, multipart utilities, signed URLs, and a command-line interface with built-in configuration validation and health checks",
+  "version": "3.8.3",
+  "description": "Flexible S3/R2 bucket management — library, Express router, and standalone server CLI for mbktech.org applications. Provides upload, download, listing, multipart utilities, signed URLs, and a standalone server runner with built-in configuration validation and health checks",
   "author": "Muhammad Bin Khalid",
   "homepage": "https://github.com/MIbnEKhalid/mbkbucket#readme",
   "license": "MIT",
@@ -12,6 +12,7 @@
     "mbkbucket": "./lib/cli.js"
   },
   "scripts": {
+    "start": "node lib/cli.js",
     "dev": "cross-env NODE_ENV=dev nodemon index.js",
     "publish": "node scripts/publish.js",
     "test": "vitest run"
@@ -23,22 +24,22 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1127.0",
     "@aws-sdk/s3-request-presigner": "^3.1127.0",
-    "compression": "^1.8.0",
+    "compression": "^1.8.2",
     "debug": "^4.4.3",
-    "dotenv": "^16.6.1",
-    "express": "^5.1.0",
+    "dotenv": "^18.0.5",
+    "express": "^5.2.1",
     "express-handlebars": "^9.0.1",
     "express-rate-limit": "^7.5.1",
-    "mbkauthe": "6.2.0",
-    "multer": "^2.0.2",
-    "pg": "^8.16.3"
+    "mbkauthe": "^6.2.3",
+    "multer": "^2.4.0"
   },
   "devDependencies": {
     "@types/supertest": "^7.2.1",
     "cross-env": "^7.0.3",
     "nodemon": "^3.1.14",
-    "supertest": "^7.2.2",
-    "vitest": "^4.1.11"
+    "supertest": "^7.3.1",
+    "vite": "^8.3.2",
+    "vitest": "5.0.3"
   },
   "overrides": {
     "csurf": {
@@ -56,8 +57,6 @@
     "lib",
     "views",
     ".env.example",
-    ".mbkbucket.config.example.json",
-    "cli.js",
     "index.js",
     "LICENSE",
     "package.json",

package/.mbkbucket.config.example.json

@@ -1,14 +0,0 @@
-{
-  "_schema": "mbkbucket CLI config — stored at ~/.mbkbucket/config.json",
-
-  "token": "mbk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
-  "tokenPrefix": "mbk_xxxx",
-  "username": "your-username",
-  "serverUrl": "https://your-app.example.com",
-  "profile": {
-    "name": "Read-Write CLI",
-    "scope": "read-write",
-    "allowedApps": ["mbkbucket"]
-  },
-  "loggedInAt": "2026-01-01T00:00:00.000Z"
-}

package/lib/src/cli/auth-helper.js

@@ -1,141 +0,0 @@
-/**
- * CLI Authentication Helper
- * Handles mbkauthe device-flow login for the mbkbucket CLI.
- * Stores credentials in ~/.mbkbucket/config.json
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import { createLogger } from '#logger';
-
-const debugCli = createLogger('cli:auth');
-
-export const CONFIG_DIR = path.join(os.homedir(), '.mbkbucket');
-export const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
-const MAX_POLL_TIME_MS = 15 * 60 * 1000; // 15 minutes
-const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
-
-export function readConfig() {
-  try {
-    return fs.existsSync(CONFIG_FILE) ? JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8')) : {};
-  } catch (err) {
-    debugCli('Failed to read config: %s', err.message);
-    return {};
-  }
-}
-
-export function writeConfig(config) {
-  try {
-    if (!fs.existsSync(CONFIG_DIR)) fs.mkdirSync(CONFIG_DIR, { recursive: true });
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { mode: 0o600 });
-  } catch (err) {
-    console.error(`❌ Failed to write config: ${err.message}`);
-    throw err;
-  }
-}
-
-export function clearConfig() {
-  try {
-    if (fs.existsSync(CONFIG_FILE)) fs.unlinkSync(CONFIG_FILE);
-    return true;
-  } catch (err) {
-    debugCli('Failed to clear config: %s', err.message);
-    return false;
-  }
-}
-
-export function updateConfig(partial) {
-  const updated = { ...readConfig(), ...partial };
-  writeConfig(updated);
-  return updated;
-}
-
-export function isLoggedIn() {
-  const { token, server_url } = readConfig();
-  return Boolean(token && server_url);
-}
-
-export const getStoredToken = () => readConfig().token || null;
-export const getStoredServerUrl = () => readConfig().server_url || null;
-
-export async function deviceFlowLogin({ server_url, profile_key }) {
-  const baseUrl = String(server_url).replace(/\/+$/, '');
-  console.log(`🔑 Requesting device login from ${baseUrl} ...`);
-
-  let deviceResp;
-  try {
-    const res = await fetch(`${baseUrl}/api/cli/device`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        client_name: `mbkbucket-cli-${os.hostname()}`,
-        ...(profile_key && { profile_key }),
-      }),
-    });
-    deviceResp = await res.json();
-    if (!deviceResp.success) throw new Error(deviceResp.message || 'Failed to initiate device login');
-  } catch (err) {
-    if (err.message.includes('Failed to initiate') || err.message.includes('fetch')) {
-      throw new Error(`Could not reach mbkauthe server at ${baseUrl}/api/cli/device.\nVerify the server URL and that CLI_AUTH_ENABLED=true on the server.`);
-    }
-    throw err;
-  }
-
-  const { verification_url = '', user_code = '', device_code, expires_in = 900, interval = 5, profile } = deviceResp;
-
-  console.log('\n┌─────────────────────────────────────────────────────────┐');
-  console.log('│                                                         │');
-  console.log('│   🌐 Open this URL in your browser to approve:           │');
-  console.log(`│   ${verification_url.padEnd(53)}│`);
-  console.log('│                                                         │');
-  console.log(`│   🔢 Or enter this code:  ${user_code.padEnd(30)}│`);
-  console.log('│                                                         │');
-  console.log('└─────────────────────────────────────────────────────────┘\n');
-
-  if (profile) console.log(`   Profile: ${profile.name} (scope: ${profile.scope || 'full'})`);
-  console.log(`   Waiting for approval (expires in ${Math.floor(expires_in / 60)} minutes)...\n`);
-
-  const pollInterval = interval * 1000;
-  const deadline = Date.now() + MAX_POLL_TIME_MS;
-  let attempts = 0;
-
-  while (Date.now() < deadline) {
-    await sleep(pollInterval);
-    attempts++;
-
-    try {
-      const pollRes = await fetch(`${baseUrl}/api/cli/device/token`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ device_code }),
-      });
-
-      const pollBody = await pollRes.json();
-
-      if (pollBody.status === 'approved' && pollBody.success) {
-        const token_prefix = pollBody.token_prefix || '';
-        console.log(`✅ Login approved! Welcome, ${pollBody.username}.`);
-        console.log(`   Token prefix: ${token_prefix}...`);
-        return {
-          token: pollBody.token,
-          token_prefix,
-          username: pollBody.username,
-          profile: profile || null,
-        };
-      }
-
-      if (pollBody.status === 'denied') throw new Error('Login request was denied.');
-      if (pollBody.status === 'expired') throw new Error('Login request expired. Please try again.');
-      if (pollBody.status === 'completed') throw new Error('This login session has already been completed.');
-
-      if (attempts % 5 === 0) process.stdout.write('.');
-    } catch (err) {
-      if (['denied', 'expired', 'completed'].some(k => err.message.includes(k))) throw err;
-      debugCli('Poll error (will retry): %s', err.message);
-    }
-  }
-
-  throw new Error('Login timed out. Please try again.');
-}
-