pal-explorer-cli 0.4.14 → 0.4.15

package/bin/pal.js

@@ -3,9 +3,13 @@
 // Enable V8 code caching for faster subsequent boots
 import 'v8-compile-cache-lib';
 
+import { createRequire } from 'module';
 import { program } from 'commander';
 import chalk from 'chalk';
 
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+
 // Utility for lazy loading commands
 const lazy = (path) => async (program) => {
   const mod = await import(path);
@@ -49,7 +53,7 @@ logger.applyGlobalOverride();
 program
   .name('pal')
   .description('p2p file sharing for friends')
-  .version('0.4.0')
+  .version(version)
   .option('--json', 'output in JSON format')
   .option('--log-level <level>', 'set log level (debug, info, warn, error, silent)');
 
@@ -98,6 +102,10 @@ const commands = [
   ['network', '../lib/commands/network.js'],
   ['search', '../lib/commands/search.js'],
   ['connect', '../lib/commands/connect.js'],
+  ['disconnect', '../lib/commands/connect.js'],
+  ['login', '../lib/commands/user.js'],
+  ['logout', '../lib/commands/user.js'],
+  ['verify', '../lib/commands/register.js'],
   ['protocol', '../lib/commands/protocol.js'],
   ['workspace', '../lib/commands/workspace.js'],
   ['favorite', '../lib/commands/favorite.js'],
@@ -170,7 +178,7 @@ ${chalk.cyan.bold('Command Groups:')}
 
   ${chalk.yellow('Identity:')}     init, whoami, register, verify, recover
   ${chalk.yellow('Users:')}        user list/add/remove/promote, login
-  ${chalk.yellow('Sharing:')}      share, list, revoke, serve, download, share-link, share-rename, permissions
+  ${chalk.yellow('Sharing:')}      share, list, revoke, serve, download, share-link, permissions
   ${chalk.yellow('Sync:')}         sync push/pull/status/watch/list/remove/diff
   ${chalk.yellow('Files:')}        file ls/tree/info/copy/move/rename/mkdir/delete/search/open/reveal/audit
   ${chalk.yellow('Remote:')}       remote browse/files/download
@@ -291,7 +299,7 @@ if (!process.argv.slice(2).length) {
 }
 
 // keytar's native D-Bus handles block the event loop on headless Linux
-const longRunning = new Set(['serve', 'nearby', 'stream']);
+const longRunning = new Set(['serve', 'nearby', 'stream', 'download']);
 if (!longRunning.has(currentCmd)) {
   // Flush analytics and run shutdown hooks before exiting
   if (extensionsLoaded) {

package/lib/commands/backup.js

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
 import { createBackup, restoreBackup } from '../core/backup.js';
+import { isPro } from '../core/pro.js';
 
 export default function backupCommand(program) {
   const cmd = program
@@ -25,6 +26,11 @@ Examples:
     .option('-p, --password <password>', 'Encryption password')
     .action(async (opts) => {
       try {
+        if (!isPro()) {
+          console.log(chalk.red('Backup requires a Pro plan. Upgrade with `pal upgrade`.'));
+          process.exitCode = 1;
+          return;
+        }
         const password = opts.password || process.env.PAL_BACKUP_PASSWORD;
         if (!password) {
           console.log(chalk.red('Password required. Use --password or PAL_BACKUP_PASSWORD env var.'));

package/lib/commands/chat.js

@@ -19,9 +19,24 @@ Examples:
       const chatStore = config.get('chatHistory') || {};
       const keys = Object.keys(chatStore);
       if (keys.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray('No conversations yet. Use `pal chat send <handle> "message"` to start one.'));
         return;
       }
+
+      if (program.opts().json) {
+        const conversations = keys.map(key => {
+          const msgs = chatStore[key] || [];
+          const last = msgs[msgs.length - 1];
+          return { handle: key, messageCount: msgs.length, lastMessage: last || null };
+        });
+        console.log(JSON.stringify(conversations, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Conversations:'));
       for (const key of keys) {
@@ -108,11 +123,21 @@ Examples:
       const chatStore = config.get('chatHistory') || {};
       const msgs = chatStore[handle] || [];
       if (msgs.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray(`No messages with ${handle}.`));
         return;
       }
       const limit = parseInt(opts.limit) || 20;
       const shown = msgs.slice(-limit);
+
+      if (program.opts().json) {
+        console.log(JSON.stringify(shown, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan(`Chat with ${handle} (${shown.length}/${msgs.length}):`));
       for (const m of shown) {

package/lib/commands/device.js

@@ -31,7 +31,7 @@ Examples:
     console.log(chalk.cyan('This Device:'));
     console.log(`  Device Name: ${chalk.white(device.name)}`);
     console.log(`  Device ID:   ${chalk.gray(device.id)}`);
-    console.log(`  Identity:    ${chalk.white(identity.name)}${identity.handle ? chalk.cyan(` @${identity.handle}`) : ''}`);
+    console.log(`  Identity:    ${chalk.white(identity.name)}${identity.handle ? chalk.cyan(` ${identity.handle.startsWith('@') ? identity.handle : '@' + identity.handle}`) : ''}`);
     console.log(`  Public Key:  ${chalk.gray(identity.publicKey)}`);
     console.log(`  Created At:  ${chalk.gray(device.createdAt)}`);
     console.log('');
@@ -103,8 +103,17 @@ Examples:
         const id = config.get('identity');
         handle = id?.handle;
         if (!handle) {
-          console.log(chalk.yellow('No handle registered. Provide one: pal device list <handle>'));
-          process.exitCode = 1;
+          const device = getDeviceInfo();
+          if (program.opts().json) {
+            console.log(JSON.stringify({ devices: [{ deviceName: device.name, deviceId: device.id, status: 'local', updatedAt: device.createdAt }] }, null, 2));
+            return;
+          }
+          console.log('');
+          console.log(chalk.cyan('Local device (no handle registered):'));
+          console.log(`  ${chalk.white(device.name)}  [${chalk.green('local')}]  ${chalk.gray(device.id)}`);
+          console.log(`    Created: ${chalk.gray(device.createdAt)}`);
+          console.log('');
+          console.log(chalk.gray('Register a handle to see remote devices: pal device register <handle>'));
           return;
         }
       }
@@ -124,7 +133,7 @@ Examples:
             console.log(JSON.stringify({ handle, devices: [] }, null, 2));
             return;
           }
-          console.log(chalk.gray(`No devices found for @${handle}.`));
+          console.log(chalk.gray(`No devices found for ${handle.startsWith('@') ? handle : '@' + handle}.`));
           return;
         }
         if (program.opts().json) {
@@ -132,7 +141,7 @@ Examples:
           return;
         }
         console.log('');
-        console.log(chalk.cyan(`Devices for @${handle}:`));
+        console.log(chalk.cyan(`Devices for ${handle.startsWith('@') ? handle : '@' + handle}:`));
         devices.forEach(d => {
           const status = d.status === 'online' ? chalk.green('online') : chalk.gray(d.status || 'offline');
           console.log(`  ${chalk.white(d.deviceName)}  [${status}]  ${chalk.gray(d.deviceId)}`);

package/lib/commands/download.js

@@ -18,7 +18,11 @@ function startMdnsIfNeeded() {
   if (identity?.publicKey) {
     const pidPath = path.join(path.dirname(config.path), 'serve.pid');
     const daemonRunning = fs.existsSync(pidPath);
-    startMdns(identity, { advertise: !daemonRunning });
+    try {
+      startMdns(identity, { advertise: !daemonRunning });
+    } catch (e) {
+      logger.warn(`mDNS start failed (port in use?): ${e.message}`);
+    }
   }
 }
 
@@ -51,7 +55,7 @@ Examples:
 
       if (allMagnets.length > 1) {
         console.log(chalk.blue(`Batch downloading ${allMagnets.length} items...`));
-        const client = new WebTorrent();
+        const client = new WebTorrent({ utp: false, lsd: false });
         let completed = 0;
         let failed = 0;
 
@@ -80,11 +84,14 @@ Examples:
                 });
               });
 
-              // Inject LAN peers and manual peer
-              if (lanPeers.length > 0) injectLanPeers(t, lanPeers);
-              if (opts.peer) {
-                try { t.addPeer(opts.peer); } catch (e) { console.error(chalk.yellow(`  Warning: Could not add peer ${opts.peer}: ${e.message}`)); }
-              }
+              // Inject LAN peers and manual peer after infoHash resolves
+              const injectBatchPeers = () => {
+                if (lanPeers.length > 0) injectLanPeers(t, lanPeers);
+                if (opts.peer) {
+                  try { t.addPeer(opts.peer); } catch (e) { console.error(chalk.yellow(`  Warning: Could not add peer ${opts.peer}: ${e.message}`)); }
+                }
+              };
+              if (t.infoHash) { injectBatchPeers(); } else { t.once('infoHash', injectBatchPeers); }
 
               client.on('error', (err) => { clearTimeout(timeout); reject(err); });
             });
@@ -151,7 +158,7 @@ Examples:
       }
       const spinner = ora('Finding peers...').start();
 
-      const client = new WebTorrent();
+      const client = new WebTorrent({ utp: false, lsd: false });
 
       const peerTimeout = setTimeout(() => {
         const torrents = client.torrents;
@@ -165,21 +172,23 @@ Examples:
       const addOpts = { path: dlDir };
       const torrentSrc = opts.lanOnly ? magnet : magnet;
 
+      const pendingPeer = opts.peer || null;
       client.add(torrentSrc, addOpts, (torrent) => {
         clearTimeout(peerTimeout);
         spinner.succeed(chalk.green(`Connected! Downloading: ${torrent.name}`));
-
         // Track transfer, storing the encrypted key if provided
         trackTransfer(magnet, torrent.name, dlDir, opts.key || null);
 
         const progressSpinner = ora('Downloading... 0%').start();
+        // Keep event loop alive until download completes (Node may exit early otherwise)
+        const keepAlive = setInterval(() => {}, 1000);
 
         torrent.on('download', (bytes) => {
           const progress = (torrent.progress * 100).toFixed(1);
           progressSpinner.text = `Downloading... ${progress}% (${(torrent.downloaded / 1024 / 1024).toFixed(2)} MB / ${(torrent.length / 1024 / 1024).toFixed(2)} MB)`;
         });
 
-        torrent.on('done', async () => {
+        const onDone = async () => {
           logger.info(`Download complete: ${torrent.name}`, { size: torrent.length });
           progressSpinner.succeed(chalk.green('Download Complete!'));
           const downloadedDir = path.join(dlDir, torrent.name);
@@ -208,25 +217,39 @@ Examples:
           }
 
           completeTransfer(magnet);
-          client.destroy();
-          process.exit(0);
-        });
+          clearInterval(keepAlive);
+          // Wait for file system writes to flush before exiting
+          setTimeout(() => {
+            client.destroy();
+            setTimeout(() => process.exit(0), 500);
+          }, 1000);
+        };
+        torrent.on('done', onDone);
+        // For small files, done may fire before handler is registered
+        if (torrent.progress === 1) onDone();
       });
 
-      // Inject LAN peers into the torrent right after adding
+      // Inject LAN peers and manual peer after infoHash is resolved
       const currentTorrent = client.torrents[client.torrents.length - 1];
       if (currentTorrent) {
-        if (lanPeers.length > 0) {
-          const injected = injectLanPeers(currentTorrent, lanPeers);
-          if (injected > 0) logger.info(`Injected ${injected} LAN peer(s) into torrent`);
-        }
-        if (opts.peer) {
-          try {
-            currentTorrent.addPeer(opts.peer);
-            logger.info(`Injected manual peer ${opts.peer} into torrent`);
-          } catch (e) {
-            console.error(chalk.yellow(`Warning: Could not add peer ${opts.peer}: ${e.message}`));
+        const injectPeers = () => {
+          if (lanPeers.length > 0) {
+            const injected = injectLanPeers(currentTorrent, lanPeers);
+            if (injected > 0) logger.info(`Injected ${injected} LAN peer(s) into torrent`);
+          }
+          if (pendingPeer) {
+            try {
+              currentTorrent.addPeer(pendingPeer);
+              logger.info(`Injected manual peer ${pendingPeer} into torrent`);
+            } catch (e) {
+              console.error(chalk.yellow(`Warning: Could not add peer ${pendingPeer}: ${e.message}`));
+            }
           }
+        };
+        if (currentTorrent.infoHash) {
+          injectPeers();
+        } else {
+          currentTorrent.once('infoHash', injectPeers);
         }
       }
 

package/lib/commands/extension.js

@@ -46,13 +46,13 @@ Examples:
   $ pal ext audit                         Security audit all extensions
 `)
       .action(async () => {
-        await listExtensions();
+        await listExtensions(program);
       });
 
     cmd
       .command('list')
       .description('list installed extensions')
-      .action(async () => { await listExtensions(); });
+      .action(async () => { await listExtensions(program); });
 
     cmd
       .command('install <source>')
@@ -426,7 +426,7 @@ Examples:
             const stars = '\u2605'.repeat(Math.round(ext.rating || 0)) + '\u2606'.repeat(5 - Math.round(ext.rating || 0));
             console.log(`  ${chalk.white(ext.name)} v${ext.version}${verified}${pro}`);
             console.log(`    ${chalk.gray(ext.description || '')}`);
-            console.log(`    ${chalk.yellow(stars)} (${ext.reviewCount || 0}) \u00b7 ${chalk.cyan(ext.downloads || 0)} downloads \u00b7 by ${chalk.blue('@' + (ext.authorHandle || 'unknown'))}`);
+            console.log(`    ${chalk.yellow(stars)} (${ext.reviewCount || 0}) \u00b7 ${chalk.cyan(ext.downloads || 0)} downloads \u00b7 by ${chalk.blue((ext.authorHandle?.startsWith('@') ? ext.authorHandle : '@' + (ext.authorHandle || 'unknown')))}`);
             console.log('');
           }
           console.log(chalk.gray('Install: pal ext install-remote <name>'));
@@ -1035,16 +1035,32 @@ Why this tier?
       });
 }
 
-async function listExtensions() {
+async function listExtensions(program) {
   const { getInstalledExtensions } = await import('../core/extensions.js');
   const extensions = getInstalledExtensions();
   if (extensions.length === 0) {
+    if (program?.opts().json) {
+      console.log(JSON.stringify([], null, 2));
+      return;
+    }
     console.log(chalk.gray('No extensions installed.'));
     console.log(chalk.gray('  pal ext install <path|git-url>'));
     console.log(chalk.gray('  pal ext create <name>'));
     return;
   }
 
+  if (program?.opts().json) {
+    console.log(JSON.stringify(extensions.map(ext => ({
+      name: ext.name,
+      version: ext.version,
+      enabled: ext.enabled,
+      bundled: !!ext.bundled,
+      tier: ext.tier || (ext.pro ? 'pro' : 'free'),
+      description: ext.description || null,
+    })), null, 2));
+    return;
+  }
+
   console.log('');
   console.log(chalk.cyan('Extensions:'));
   for (const ext of extensions) {

package/lib/commands/group.js

@@ -135,7 +135,7 @@ Examples:
         const members = getGroupMembers(groupName);
         checkLimit('maxGroupMembers', members.length);
         addMemberToGroup(groupName, pal);
-        console.log(chalk.green(`Added '${pal.name}' to '${groupName}'.`));
+        console.log(chalk.green(`Added '${pal.name || pal.publicKey?.substring(0, 8) + '...' || palName}' to '${groupName}'.`));
       } catch (err) {
         console.log(chalk.red(err.message));
         process.exitCode = 1;
@@ -188,7 +188,7 @@ Examples:
       for (const g of groups) {
         console.log(`  ${chalk.white(g.name)}  ${chalk.gray(`(${g.members.length} members)`)}`);
         for (const m of g.members) {
-          console.log(`    - ${m.name}${m.handle ? chalk.gray(` @${m.handle}`) : ''}`);
+          console.log(`    - ${m.name || m.publicKey?.substring(0, 8) + '...' || 'unknown'}${m.handle ? chalk.gray(` ${m.handle.startsWith('@') ? m.handle : '@' + m.handle}`) : ''}`);
         }
       }
       console.log('');
@@ -245,11 +245,11 @@ Examples:
             if (res.ok) {
               sent++;
             } else {
-              console.log(chalk.yellow(`  Failed to send to @${handle}`));
+              console.log(chalk.yellow(`  Failed to send to ${handle.startsWith('@') ? handle : '@' + handle}`));
               failed++;
             }
           } catch {
-            console.log(chalk.yellow(`  Failed to send to @${handle}`));
+            console.log(chalk.yellow(`  Failed to send to ${handle.startsWith('@') ? handle : '@' + handle}`));
             failed++;
           }
         }

package/lib/commands/log.js

@@ -78,6 +78,14 @@ Examples:
       const count = parseInt(opts.lines, 10) || 20;
       lines = lines.slice(-count);
 
+      if (program.opts().json) {
+        const entries = lines.map(line => {
+          try { return JSON.parse(line); } catch { return { raw: line }; }
+        });
+        console.log(JSON.stringify(entries, null, 2));
+        return;
+      }
+
       for (const line of lines) {
         console.log(formatEntry(line));
       }

package/lib/commands/network.js

@@ -152,7 +152,7 @@ Examples:
         console.log(chalk.cyan('Members:'));
         for (const m of members) {
           const role = m.role ? chalk.yellow(` [${m.role}]`) : '';
-          const handle = m.handle ? chalk.gray(` @${m.handle}`) : '';
+          const handle = m.handle ? chalk.gray(` ${m.handle.startsWith('@') ? m.handle : '@' + m.handle}`) : '';
           console.log(`  ${chalk.white(m.name || m.userId)}${handle}${role}`);
         }
         console.log('');

package/lib/commands/pal.js

@@ -375,10 +375,19 @@ Examples:
 
       const profile = getProfile();
       if (!profile) {
+        if (program.opts().json) {
+          console.log(JSON.stringify(null, null, 2));
+          return;
+        }
         console.log(chalk.yellow('No identity found. Run `pal init` first.'));
         return;
       }
 
+      if (program.opts().json) {
+        console.log(JSON.stringify(profile, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Your Profile:'));
       const rows = [

package/lib/commands/permissions.js

@@ -33,7 +33,7 @@ Examples:
       const summary = getShareSummary();
       const groups = getGroups();
 
-      if (opts.json) {
+      if (opts.json || program.opts().json) {
         console.log(JSON.stringify(summary, null, 2));
         return;
       }

package/lib/commands/protocol.js

@@ -31,6 +31,23 @@ Examples:
         const { getRelayLimits } = await import('../protocol/router.js');
         const { FREE_POLICY_LIMITS, PRO_POLICY_LIMITS } = await import('../protocol/policy.js');
 
+        if (program.opts().json) {
+          const caps = ['share', 'sync', 'chat', 'relay'];
+          if (isPro()) caps.push('delta-sync', 'receipts');
+          const limits = getRelayLimits();
+          const pl = isPro() ? PRO_POLICY_LIMITS : FREE_POLICY_LIMITS;
+          console.log(JSON.stringify({
+            protocol: PROTOCOL_NAME,
+            version: PROTOCOL_VERSION,
+            tier: isPro() ? 'pro' : 'free',
+            capabilities: caps,
+            relayLimits: limits,
+            policyLimits: pl,
+            identity: identity ? { publicKey: identity.publicKey, handle: identity.handle || null } : null,
+          }, null, 2));
+          return;
+        }
+
         console.log('');
         console.log(chalk.cyan.bold('PAL Protocol'));
         console.log(`  Protocol:      ${chalk.white(PROTOCOL_NAME)}`);

package/lib/commands/serve.js

@@ -47,6 +47,7 @@ export default function serveCommand(program) {
     .option('--web-port <port>', 'Web dashboard port (default: 8585)', '8585')
     .option('--lan', 'Bind web server to 0.0.0.0 for LAN access')
     .option('--public-ip <ip>', 'Public IP/hostname for serveUrl announcement (for VPS/cloud)')
+    .option('--torrent-port <port>', 'BitTorrent listening port (default: random)')
     .addHelpText('after', `
 Examples:
   $ pal serve                        Start seeding in foreground
@@ -95,6 +96,7 @@ Examples:
           if (opts.lan) args.push('--lan');
           if (opts.publicIp) args.push('--public-ip', opts.publicIp);
         }
+        if (opts.torrentPort) args.push('--torrent-port', opts.torrentPort);
         const child = spawn(process.execPath, args, {
           detached: true,
           stdio: 'ignore'
@@ -207,7 +209,9 @@ Examples:
         console.log(chalk.gray('No active shares to seed. Signaling server still running.'));
       }
 
-      const client = new WebTorrent();
+      const wtOpts = {};
+      if (opts.torrentPort) wtOpts.torrentPort = parseInt(opts.torrentPort, 10);
+      const client = new WebTorrent(wtOpts);
       client.setMaxListeners(Math.max(shares.length, 10) + 20);
 
       // Auto-expire old shares before seeding

package/lib/commands/server.js

@@ -232,9 +232,26 @@ Examples:
     .description('list all configured discovery servers with health status and roles')
     .action(async () => {
       const servers = getServers();
+      const checks = await Promise.all(servers.map(s => checkServer(s)));
+
+      if (program.opts().json) {
+        const result = checks.map((c, i) => {
+          const meta = getServerRoles(c.url);
+          return {
+            url: c.url,
+            reachable: c.reachable,
+            primary: i === 0,
+            roles: meta.roles,
+            addedBy: meta.addedBy,
+            writeTrusted: isWriteTrusted(c.url),
+          };
+        });
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan('Discovery Servers:'));
-      const checks = await Promise.all(servers.map(s => checkServer(s)));
       for (let i = 0; i < checks.length; i++) {
         const c = checks[i];
         const primary = i === 0 ? chalk.cyan(' (primary)') : '';

package/lib/commands/share-link.js

@@ -128,8 +128,20 @@ Examples:
       try {
         const identity = await getIdentity();
         if (!identity?.handle) {
-          console.log(chalk.red('You must register a handle first: pal register'));
-          process.exitCode = 1;
+          const shares = listShares();
+          const sharedLinks = shares.filter(s => s.magnet);
+          if (sharedLinks.length === 0) {
+            console.log(chalk.gray('No share links. Register a handle to manage server-side links: pal register'));
+          } else {
+            console.log('');
+            console.log(chalk.cyan('Local shares with magnets:'));
+            for (const s of sharedLinks) {
+              console.log(`  ${chalk.white(s.name || s.id)}`);
+              console.log(`    Magnet: ${chalk.gray(s.magnet.substring(0, 60) + '...')}`);
+            }
+            console.log('');
+            console.log(chalk.gray('Register a handle to create web share links: pal register'));
+          }
           return;
         }
 

package/lib/commands/sync.js

@@ -480,14 +480,23 @@ async function watchSync(dirPath, palName, opts) {
 
 // --- pal sync status <path> ---
 
-async function syncStatus(dirPath) {
+async function syncStatus(dirPath, program) {
   if (!dirPath) {
     const pairs = getSyncPairs();
     if (pairs.length === 0) {
+      if (program?.opts().json) {
+        console.log(JSON.stringify([], null, 2));
+        return;
+      }
       console.log(chalk.gray('No sync pairs configured. Use `pal sync <path> <pal>` to start.'));
       return;
     }
 
+    if (program?.opts().json) {
+      console.log(JSON.stringify(pairs, null, 2));
+      return;
+    }
+
     const friends = getFriends();
     console.log('');
     console.log(chalk.cyan.bold('Sync Pairs'));
@@ -674,14 +683,14 @@ export default function syncCommand(program) {
     .command('status [path]')
     .description('show sync status and changes since last sync')
     .action((syncPath) => {
-      syncStatus(syncPath);
+      syncStatus(syncPath, program);
     });
 
   cmd
     .command('list')
     .description('list all sync pairs')
     .action(() => {
-      syncStatus();
+      syncStatus(undefined, program);
     });
 
   cmd

package/lib/commands/transfers.js

@@ -129,11 +129,17 @@ Examples:
       const days = parseInt(opts.days, 10) || 90;
       pruneOldHistory(days);
       const stats = getTransferStats(days);
+
+      if (program.opts().json) {
+        console.log(JSON.stringify(stats, null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan(`Transfer Stats (last ${days} days):`));
       console.log(`  Total transfers:  ${chalk.white(stats.totalTransfers)}`);
       console.log(`  Total data:       ${chalk.white(formatBytes(stats.totalBytes))}`);
-      console.log(`  Avg speed:        ${chalk.white(formatBytes(stats.avgSpeed) + '/s')}`);
+      console.log(`  Avg speed:        ${chalk.white(formatSpeed(stats.avgSpeed))}`);
       if (Object.keys(stats.perDay).length > 0) {
         console.log('');
         console.log(chalk.cyan('  Per day:'));
@@ -145,8 +151,12 @@ Examples:
 }
 
 function formatBytes(bytes) {
-  if (bytes === 0) return '0 B';
+  if (!bytes || !isFinite(bytes) || bytes <= 0) return '0 B';
   const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  const i = Math.max(0, Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1));
   return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
 }
+
+function formatSpeed(bytesPerSec) {
+  return formatBytes(bytesPerSec) + '/s';
+}

package/lib/commands/user.js

@@ -28,10 +28,26 @@ export default function userCommand(program) {
       const active = getActiveUser();
 
       if (profiles.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify([], null, 2));
+          return;
+        }
         console.log(chalk.gray('No profiles. Run `pal init <name>` to create one.'));
         return;
       }
 
+      if (program.opts().json) {
+        console.log(JSON.stringify(profiles.map(p => ({
+          name: p.name,
+          handle: p.handle || null,
+          role: p.role,
+          publicKey: p.publicKey,
+          lastLogin: p.lastLogin || null,
+          active: active?.publicKey === p.publicKey,
+        })), null, 2));
+        return;
+      }
+
       console.log('');
       console.log(chalk.cyan.bold('User Profiles'));
       console.log('');

package/lib/commands/workspace.js

@@ -19,14 +19,14 @@ Examples:
   $ pal workspace remove <wsId> <shareId>  Remove share from workspace
 `)
     .action(() => {
-      printWorkspaces();
+      printWorkspaces(program);
     });
 
   cmd
     .command('list')
     .description('list all workspaces')
     .action(() => {
-      printWorkspaces();
+      printWorkspaces(program);
     });
 
   cmd
@@ -105,12 +105,22 @@ Examples:
     });
 }
 
-function printWorkspaces() {
+function printWorkspaces(program) {
   const workspaces = config.get('workspaces') || [];
   if (workspaces.length === 0) {
+    if (program?.opts().json) {
+      console.log(JSON.stringify([], null, 2));
+      return;
+    }
     console.log(chalk.gray('No workspaces. Use `pal workspace create <name>` to create one.'));
     return;
   }
+
+  if (program?.opts().json) {
+    console.log(JSON.stringify(workspaces, null, 2));
+    return;
+  }
+
   console.log('');
   console.log(chalk.cyan('Workspaces:'));
   for (const ws of workspaces) {

package/lib/core/networks.js

@@ -3,11 +3,13 @@ import { getIdentity } from './identity.js';
 import { getPrimaryServer } from './discoveryClient.js';
 
 async function authHeaders() {
-  const identity = await getIdentity();
+  const token = config.get('ext.@palexplorer/auth-email')?.verifiedToken;
+  if (!token) {
+    throw new Error('Not authenticated. Run `pal auth login` first to link your account.');
+  }
   return {
     'Content-Type': 'application/json',
-    'X-Public-Key': identity?.publicKey || '',
-    'X-Handle': identity?.handle || '',
+    'Authorization': `Bearer ${token}`,
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pal-explorer-cli",
-  "version": "0.4.14",
+  "version": "0.4.15",
   "description": "P2P encrypted file sharing CLI — share files directly with friends, not with the cloud",
   "main": "bin/pal.js",
   "bin": {