pal-explorer-cli 0.4.0

package/lib/commands/favorite.js

@@ -0,0 +1,90 @@
+import chalk from 'chalk';
+import config from '../utils/config.js';
+
+function genId() {
+  return Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+}
+
+export default function favoriteCommand(program) {
+  const cmd = program
+    .command('favorite')
+    .description('manage favorite shares and explorer paths')
+    .addHelpText('after', `
+Examples:
+  $ pe favorite                    List all favorites
+  $ pe favorite list               List all favorites
+  $ pe favorite add <shareId>      Add a share to favorites
+  $ pe favorite remove <id>        Remove from favorites
+`)
+    .action(() => {
+      printFavorites();
+    });
+
+  cmd
+    .command('list')
+    .description('list all favorites')
+    .action(() => {
+      printFavorites();
+    });
+
+  cmd
+    .command('add <shareId>')
+    .description('add a share to favorites')
+    .option('--name <name>', 'Display name for the favorite')
+    .action((shareId, opts) => {
+      const favs = config.get('shareFavorites') || [];
+      if (favs.some(f => f.shareId === shareId)) {
+        console.log(chalk.yellow('Share already in favorites.'));
+        return;
+      }
+      const fav = {
+        id: genId(),
+        shareId,
+        name: opts.name || shareId,
+        addedAt: new Date().toISOString(),
+      };
+      favs.push(fav);
+      config.set('shareFavorites', favs);
+      console.log(chalk.green(`\u2714 Added to favorites: ${fav.name}`));
+    });
+
+  cmd
+    .command('remove <id>')
+    .description('remove from favorites')
+    .action((id) => {
+      const favs = config.get('shareFavorites') || [];
+      const fav = favs.find(f => f.id === id || f.shareId === id);
+      if (!fav) {
+        console.log(chalk.red('Favorite not found.'));
+        process.exitCode = 1;
+        return;
+      }
+      config.set('shareFavorites', favs.filter(f => f.id !== fav.id));
+      console.log(chalk.green(`\u2714 Removed from favorites.`));
+    });
+}
+
+function printFavorites() {
+  const shareFavs = config.get('shareFavorites') || [];
+  const explorerFavs = config.get('explorerFavorites') || [];
+
+  if (shareFavs.length === 0 && explorerFavs.length === 0) {
+    console.log(chalk.gray('No favorites. Use `pe favorite add <shareId>` to add one.'));
+    return;
+  }
+
+  console.log('');
+  if (shareFavs.length > 0) {
+    console.log(chalk.cyan('Share Favorites:'));
+    for (const f of shareFavs) {
+      console.log(`  ${chalk.white(f.id)}  ${chalk.yellow(f.name || f.shareId)}  ${chalk.gray(f.addedAt || '')}`);
+    }
+  }
+
+  if (explorerFavs.length > 0) {
+    console.log(chalk.cyan('Explorer Favorites:'));
+    for (const f of explorerFavs) {
+      console.log(`  ${chalk.white(f.id)}  ${chalk.yellow(f.path || f.name || '')}  ${chalk.gray(f.createdAt || '')}`);
+    }
+  }
+}

package/lib/commands/federation.js

@@ -0,0 +1,270 @@
+import chalk from 'chalk';
+
+export default function federationCommand(program) {
+  const cmd = program
+    .command('federation')
+    .description('manage federation between discovery servers (Enterprise)')
+    .addHelpText('after', `
+Examples:
+  $ pe federation registry add https://discovery2.example.com
+  $ pe federation registry list
+  $ pe federation registry resolve @user@server.com
+  $ pe federation bridge add https://network2.example.com
+  $ pe federation bridge stats
+`)
+    .action(() => { cmd.outputHelp(); });
+
+  // --- Registry subcommands ---
+  const registry = cmd
+    .command('registry')
+    .description('manage federated discovery server registry')
+    .action(() => { registry.outputHelp(); });
+
+  registry
+    .command('add <url>')
+    .description('add a discovery server to federation registry')
+    .option('--trust <level>', 'trust level: trusted, verified, unknown', 'unknown')
+    .action(async (url, opts) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const servers = extConfig.get('ext_store.federation-registry')?.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        servers[id] = {
+          url,
+          trust: opts.trust,
+          category: 'public',
+          trustScore: opts.trust === 'trusted' ? 100 : 0,
+          lastSeen: null,
+          healthy: null,
+          addedAt: new Date().toISOString(),
+        };
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        store.registry = servers;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Server added to federation registry: ${url}`));
+        console.log(`  Trust: ${chalk.white(opts.trust)}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed to add server: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('remove <url>')
+    .description('remove a server from federation registry')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        if (!registry[id]) {
+          console.log(chalk.yellow(`Server not found in registry: ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        delete registry[id];
+        store.registry = registry;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Server removed from registry: ${url}`));
+      } catch (err) {
+        console.log(chalk.red(`Failed to remove server: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('list')
+    .description('list all servers in federation registry')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const entries = Object.values(registry);
+        if (entries.length === 0) {
+          console.log(chalk.dim('No servers in federation registry.'));
+          return;
+        }
+        console.log(chalk.bold(`Federation Registry (${entries.length} servers)\n`));
+        for (const s of entries) {
+          const health = s.healthy === true ? chalk.green('●') : s.healthy === false ? chalk.red('●') : chalk.dim('○');
+          console.log(`  ${health} ${chalk.cyan(s.url)}`);
+          console.log(`    Trust: ${chalk.white(s.trust)}  Score: ${s.trustScore}  Added: ${s.addedAt || 'unknown'}`);
+        }
+      } catch (err) {
+        console.log(chalk.red(`Failed to list registry: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('peer <url>')
+    .description('initiate peering handshake with another server')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const id = url.replace(/[^a-z0-9]/gi, '_');
+        if (!registry[id]) {
+          console.log(chalk.yellow(`Server not in registry. Add it first with: pe federation registry add ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        registry[id].trust = 'verified';
+        registry[id].trustScore = Math.max(registry[id].trustScore || 0, 50);
+        registry[id].lastSeen = new Date().toISOString();
+        store.registry = registry;
+        extConfig.set('ext_store.federation-registry', store);
+        console.log(chalk.green(`✔ Peering initiated with: ${url}`));
+        console.log(`  Trust level upgraded to: ${chalk.white('verified')}`);
+      } catch (err) {
+        console.log(chalk.red(`Peering failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  registry
+    .command('resolve <handle>')
+    .description('resolve a handle across federated servers (e.g. @user@server.com)')
+    .action(async (handle) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-registry') || {};
+        const registry = store.registry || {};
+        const entries = Object.values(registry).filter(s => s.healthy !== false);
+
+        if (entries.length === 0) {
+          console.log(chalk.yellow('No healthy servers in federation registry.'));
+          process.exitCode = 1;
+          return;
+        }
+
+        let parts = handle.replace(/^@/, '').split('@');
+        let username = parts[0];
+        let server = parts[1] || null;
+
+        console.log(chalk.dim(`Resolving ${handle} across ${entries.length} server(s)...`));
+
+        if (server) {
+          const match = entries.find(s => s.url.includes(server));
+          if (match) {
+            console.log(chalk.green(`✔ Resolved via ${match.url}`));
+            console.log(`  Handle: ${chalk.cyan('@' + username)}`);
+            console.log(`  Server: ${chalk.white(match.url)}`);
+          } else {
+            console.log(chalk.yellow(`Server ${server} not in registry.`));
+            process.exitCode = 1;
+          }
+        } else {
+          console.log(chalk.dim(`Querying all ${entries.length} servers for @${username}...`));
+          for (const s of entries) {
+            console.log(`  ${chalk.dim('→')} ${s.url}: ${chalk.dim('queried')}`);
+          }
+          console.log(chalk.green(`✔ Resolution complete.`));
+        }
+      } catch (err) {
+        console.log(chalk.red(`Resolution failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  // --- Bridge subcommands ---
+  const bridge = cmd
+    .command('bridge')
+    .description('manage federation bridge connections')
+    .action(() => { bridge.outputHelp(); });
+
+  bridge
+    .command('add <url>')
+    .description('connect to a federated network')
+    .option('--relay-policy <policy>', 'relay policy: none, all', 'none')
+    .action(async (url, opts) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        if (networks.includes(url)) {
+          console.log(chalk.yellow(`Already bridged to: ${url}`));
+          return;
+        }
+        networks.push(url);
+        store.bridgedNetworks = networks;
+        store.relayPolicy = opts.relayPolicy;
+        extConfig.set('ext_store.federation-bridge', store);
+        console.log(chalk.green(`✔ Bridge connected to: ${url}`));
+        console.log(`  Relay policy: ${chalk.white(opts.relayPolicy)}`);
+      } catch (err) {
+        console.log(chalk.red(`Bridge failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('remove <url>')
+    .description('disconnect from a federated network')
+    .action(async (url) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        const idx = networks.indexOf(url);
+        if (idx === -1) {
+          console.log(chalk.yellow(`Not bridged to: ${url}`));
+          process.exitCode = 1;
+          return;
+        }
+        networks.splice(idx, 1);
+        store.bridgedNetworks = networks;
+        extConfig.set('ext_store.federation-bridge', store);
+        console.log(chalk.green(`✔ Bridge disconnected from: ${url}`));
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('list')
+    .description('list all bridge connections')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        if (networks.length === 0) {
+          console.log(chalk.dim('No bridge connections.'));
+          return;
+        }
+        console.log(chalk.bold(`Federation Bridges (${networks.length})\n`));
+        for (const url of networks) {
+          console.log(`  ${chalk.green('●')} ${chalk.cyan(url)}`);
+        }
+        console.log(`\n  Relay policy: ${chalk.white(store.relayPolicy || 'none')}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  bridge
+    .command('stats')
+    .description('show bridge relay statistics')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.federation-bridge') || {};
+        const networks = store.bridgedNetworks || [];
+        const messageLog = store.messageLog || [];
+        console.log(chalk.bold('Bridge Statistics\n'));
+        console.log(`  Connected networks: ${chalk.white(networks.length)}`);
+        console.log(`  Messages relayed:   ${chalk.white(messageLog.length)}`);
+        console.log(`  Relay policy:       ${chalk.white(store.relayPolicy || 'none')}`);
+        console.log(`  Last activity:      ${chalk.white(store.lastActivity || 'never')}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+}