pal-explorer-cli 0.4.11 → 0.4.13

package/lib/commands/register.js

@@ -1,171 +1,171 @@
-import chalk from 'chalk';
-import config from '../utils/config.js';
-import { setIdentityHandle, getIdentity } from '../core/identity.js';
-import { getPrimaryServer, postTo, parseHandle } from '../core/discoveryClient.js';
-import { updateProfileHandle } from '../core/users.js';
-
-export default function registerCommand(program) {
-  program
-    .command('register <handle>')
-    .description('register your identity with a handle on the discovery network')
-    .option('--email <email>', 'Verify ownership via email OTP (required for first registration)')
-    .option('--server <url>', 'Register on a specific discovery server')
-    .addHelpText('after', `
-Examples:
-  $ pe register alice               Register handle @alice (direct signature)
-  $ pe register alice --email a@b   Register with email OTP verification
-  $ pe register alice --server https://custom.com   Register on specific server
-`)
-    .action(async (handle, opts) => {
-      handle = handle.replace(/^@/, '');
-      const identity = await getIdentity();
-      if (!identity) {
-        console.log(chalk.red('No identity found. Run `pe init <name>` first.'));
-        process.exitCode = 1; return;
-      }
-
-      if (!/^[a-zA-Z0-9_-]{3,32}$/.test(handle)) {
-        console.log(chalk.red('Handle must be 3-32 characters: letters, numbers, hyphens, underscores only.'));
-        process.exitCode = 1; return;
-      }
-
-      const serverUrl = opts.server || getPrimaryServer();
-
-      if (opts.email) {
-        // OTP flow: request OTP sent to email
-        console.log(chalk.blue(`Sending OTP to ${opts.email}...`));
-        try {
-          const res = await postTo(serverUrl, '/otp/send', { handle, publicKey: identity.publicKey });
-          const data = await res.json();
-          if (!res.ok) {
-            console.log(chalk.red(`Failed: ${data.error}`));
-            process.exitCode = 1; return;
-          }
-          console.log(chalk.green('OTP sent. Run `pe verify <code>` with the code from your email.'));
-          config.set('_pendingRegistration', { handle, publicKey: identity.publicKey, email: opts.email, serverUrl });
-        } catch {
-          console.log(chalk.red(`Could not reach discovery server at ${serverUrl}`));
-          process.exitCode = 1;
-        }
-        return;
-      }
-
-      // Challenge-response registration
-      const sodium = (await import('sodium-native')).default;
-      const privateKey = Buffer.from(identity.privateKey, 'hex');
-
-      try {
-        process.stdout.write(chalk.gray(`Registering @${handle} on ${serverUrl}... `));
-
-        // Step 1: Request challenge from server
-        const challengeRes = await postTo(serverUrl, '/register/challenge', { handle, publicKey: identity.publicKey });
-        const challengeData = await challengeRes.json();
-        if (!challengeRes.ok || !challengeData.challengeId) {
-          console.log(chalk.red(`\nFailed: ${challengeData.error || 'Could not get challenge'}`));
-          if (challengeData.suggestions?.length > 0) {
-            console.log(chalk.yellow('Available alternatives:'));
-            for (const s of challengeData.suggestions) {
-              console.log(chalk.white(`  @${s}`));
-            }
-          }
-          process.exitCode = 1; return;
-        }
-
-        // Step 2: Sign challenge and complete registration
-        const message = `register:${handle}:${challengeData.nonce}`;
-        const sig = Buffer.alloc(sodium.crypto_sign_BYTES);
-        sodium.crypto_sign_detached(sig, Buffer.from(message), privateKey);
-
-        const res = await postTo(serverUrl, '/register', { challengeId: challengeData.challengeId, signature: sig.toString('hex') });
-        const result = await res.json();
-        if (res.status === 403 && result.code === 'VANITY_HANDLE_PRO_REQUIRED') {
-          console.log(chalk.red(`\nVanity handle "@${handle}" requires Pro.`));
-          console.log(chalk.yellow('Short custom handles (3-15 chars) are a Pro feature.'));
-          console.log(chalk.gray('Upgrade: pe billing upgrade'));
-          console.log(chalk.gray('Or use an auto-generated handle instead.'));
-          process.exitCode = 1; return;
-        }
-        if (result.success) {
-          console.log(chalk.green('done.'));
-          // Store full federated handle if registered on non-primary server
-          const primary = getPrimaryServer();
-          const fullHandle = (opts.server && opts.server !== primary)
-            ? `${handle}@${serverUrl.replace(/^https?:\/\//, '')}`
-            : handle;
-          console.log(chalk.green(`Registered as @${fullHandle}`));
-          setIdentityHandle(fullHandle);
-          updateProfileHandle(identity.publicKey, fullHandle);
-          config.delete('_pendingRegistration');
-
-          // Publish to DHT for decentralized fallback
-          try {
-            const { DHTDiscovery } = await import('../core/dhtDiscovery.js');
-            const dht = new DHTDiscovery();
-            const dhtHash = await dht.publish(handle, identity.publicKey, identity.privateKey);
-            const cache = config.get('handleCache') || {};
-            if (!cache[handle]) cache[handle] = {};
-            cache[handle].dhtHash = dhtHash;
-            config.set('handleCache', cache);
-            console.log(chalk.gray(`Published to DHT (hash: ${dhtHash.slice(0, 12)}...)`));
-            dht.destroy();
-          } catch (err) {
-            console.log(chalk.yellow(`DHT publish skipped: ${err.message}`));
-          }
-        } else {
-          console.log(chalk.red(`\nFailed: ${result.error}`));
-          process.exitCode = 1;
-        }
-      } catch {
-        console.log(chalk.red(`\nCould not reach discovery server at ${serverUrl}`));
-        process.exitCode = 1;
-      }
-    });
-
-  program
-    .command('verify <code>')
-    .description('complete OTP email verification for handle registration')
-    .addHelpText('after', `
-Examples:
-  $ pe verify 123456                Complete OTP verification
-`)
-    .action(async (code) => {
-      const pending = config.get('_pendingRegistration');
-      if (!pending?.handle) {
-        console.log(chalk.red('No pending registration. Run `pe register <handle> --email <email>` first.'));
-        process.exitCode = 1; return;
-      }
-
-      const identity = await getIdentity();
-      if (!identity?.privateKey) {
-        console.log(chalk.red('No identity found.'));
-        process.exitCode = 1; return;
-      }
-
-      const serverUrl = pending.serverUrl || getPrimaryServer();
-      const sodium = (await import('sodium-native')).default;
-      const privateKey = Buffer.from(identity.privateKey, 'hex');
-      const now = Date.now();
-      const message = `${pending.handle}:${code}:${now}`;
-      const sig = Buffer.alloc(sodium.crypto_sign_BYTES);
-      sodium.crypto_sign_detached(sig, Buffer.from(message), privateKey);
-
-      try {
-        process.stdout.write(chalk.gray(`Verifying @${pending.handle}... `));
-        const res = await postTo(serverUrl, '/otp/verify', { handle: pending.handle, code, signature: sig.toString('hex'), timestamp: now });
-        const result = await res.json();
-        if (result.success) {
-          console.log(chalk.green('done.'));
-          console.log(chalk.green(`Handle @${pending.handle} verified and registered.`));
-          setIdentityHandle(pending.handle);
-          updateProfileHandle(identity.publicKey, pending.handle);
-          config.delete('_pendingRegistration');
-        } else {
-          console.log(chalk.red(`\nVerification failed: ${result.error}`));
-          process.exitCode = 1;
-        }
-      } catch {
-        console.log(chalk.red(`\nCould not reach discovery server at ${serverUrl}`));
-        process.exitCode = 1;
-      }
-    });
-}
+import chalk from 'chalk';
+import config from '../utils/config.js';
+import { setIdentityHandle, getIdentity } from '../core/identity.js';
+import { getPrimaryServer, postTo, parseHandle } from '../core/discoveryClient.js';
+import { updateProfileHandle } from '../core/users.js';
+
+export default function registerCommand(program) {
+  program
+    .command('register <handle>')
+    .description('register your identity with a handle on the discovery network')
+    .option('--email <email>', 'Verify ownership via email OTP (required for first registration)')
+    .option('--server <url>', 'Register on a specific discovery server')
+    .addHelpText('after', `
+Examples:
+  $ pal register alice               Register handle @alice (direct signature)
+  $ pal register alice --email a@b   Register with email OTP verification
+  $ pal register alice --server https://custom.com   Register on specific server
+`)
+    .action(async (handle, opts) => {
+      handle = handle.replace(/^@/, '');
+      const identity = await getIdentity();
+      if (!identity) {
+        console.log(chalk.red('No identity found. Run `pal init <name>` first.'));
+        process.exitCode = 1; return;
+      }
+
+      if (!/^[a-zA-Z0-9_-]{3,32}$/.test(handle)) {
+        console.log(chalk.red('Handle must be 3-32 characters: letters, numbers, hyphens, underscores only.'));
+        process.exitCode = 1; return;
+      }
+
+      const serverUrl = opts.server || getPrimaryServer();
+
+      if (opts.email) {
+        // OTP flow: request OTP sent to email
+        console.log(chalk.blue(`Sending OTP to ${opts.email}...`));
+        try {
+          const res = await postTo(serverUrl, '/otp/send', { handle, publicKey: identity.publicKey });
+          const data = await res.json();
+          if (!res.ok) {
+            console.log(chalk.red(`Failed: ${data.error}`));
+            process.exitCode = 1; return;
+          }
+          console.log(chalk.green('OTP sent. Run `pal verify <code>` with the code from your email.'));
+          config.set('_pendingRegistration', { handle, publicKey: identity.publicKey, email: opts.email, serverUrl });
+        } catch {
+          console.log(chalk.red(`Could not reach discovery server at ${serverUrl}`));
+          process.exitCode = 1;
+        }
+        return;
+      }
+
+      // Challenge-response registration
+      const sodium = (await import('sodium-native')).default;
+      const privateKey = Buffer.from(identity.privateKey, 'hex');
+
+      try {
+        process.stdout.write(chalk.gray(`Registering @${handle} on ${serverUrl}... `));
+
+        // Step 1: Request challenge from server
+        const challengeRes = await postTo(serverUrl, '/register/challenge', { handle, publicKey: identity.publicKey });
+        const challengeData = await challengeRes.json();
+        if (!challengeRes.ok || !challengeData.challengeId) {
+          console.log(chalk.red(`\nFailed: ${challengeData.error || 'Could not get challenge'}`));
+          if (challengeData.suggestions?.length > 0) {
+            console.log(chalk.yellow('Available alternatives:'));
+            for (const s of challengeData.suggestions) {
+              console.log(chalk.white(`  @${s}`));
+            }
+          }
+          process.exitCode = 1; return;
+        }
+
+        // Step 2: Sign challenge and complete registration
+        const message = `register:${handle}:${challengeData.nonce}`;
+        const sig = Buffer.alloc(sodium.crypto_sign_BYTES);
+        sodium.crypto_sign_detached(sig, Buffer.from(message), privateKey);
+
+        const res = await postTo(serverUrl, '/register', { challengeId: challengeData.challengeId, signature: sig.toString('hex') });
+        const result = await res.json();
+        if (res.status === 403 && result.code === 'VANITY_HANDLE_PRO_REQUIRED') {
+          console.log(chalk.red(`\nVanity handle "@${handle}" requires Pro.`));
+          console.log(chalk.yellow('Short custom handles (3-15 chars) are a Pro feature.'));
+          console.log(chalk.gray('Upgrade: pal billing upgrade'));
+          console.log(chalk.gray('Or use an auto-generated handle instead.'));
+          process.exitCode = 1; return;
+        }
+        if (result.success) {
+          console.log(chalk.green('done.'));
+          // Store full federated handle if registered on non-primary server
+          const primary = getPrimaryServer();
+          const fullHandle = (opts.server && opts.server !== primary)
+            ? `${handle}@${serverUrl.replace(/^https?:\/\//, '')}`
+            : handle;
+          console.log(chalk.green(`Registered as @${fullHandle}`));
+          setIdentityHandle(fullHandle);
+          updateProfileHandle(identity.publicKey, fullHandle);
+          config.delete('_pendingRegistration');
+
+          // Publish to DHT for decentralized fallback
+          try {
+            const { DHTDiscovery } = await import('../core/dhtDiscovery.js');
+            const dht = new DHTDiscovery();
+            const dhtHash = await dht.publish(handle, identity.publicKey, identity.privateKey);
+            const cache = config.get('handleCache') || {};
+            if (!cache[handle]) cache[handle] = {};
+            cache[handle].dhtHash = dhtHash;
+            config.set('handleCache', cache);
+            console.log(chalk.gray(`Published to DHT (hash: ${dhtHash.slice(0, 12)}...)`));
+            dht.destroy();
+          } catch (err) {
+            console.log(chalk.yellow(`DHT publish skipped: ${err.message}`));
+          }
+        } else {
+          console.log(chalk.red(`\nFailed: ${result.error}`));
+          process.exitCode = 1;
+        }
+      } catch {
+        console.log(chalk.red(`\nCould not reach discovery server at ${serverUrl}`));
+        process.exitCode = 1;
+      }
+    });
+
+  program
+    .command('verify <code>')
+    .description('complete OTP email verification for handle registration')
+    .addHelpText('after', `
+Examples:
+  $ pal verify 123456                Complete OTP verification
+`)
+    .action(async (code) => {
+      const pending = config.get('_pendingRegistration');
+      if (!pending?.handle) {
+        console.log(chalk.red('No pending registration. Run `pal register <handle> --email <email>` first.'));
+        process.exitCode = 1; return;
+      }
+
+      const identity = await getIdentity();
+      if (!identity?.privateKey) {
+        console.log(chalk.red('No identity found.'));
+        process.exitCode = 1; return;
+      }
+
+      const serverUrl = pending.serverUrl || getPrimaryServer();
+      const sodium = (await import('sodium-native')).default;
+      const privateKey = Buffer.from(identity.privateKey, 'hex');
+      const now = Date.now();
+      const message = `${pending.handle}:${code}:${now}`;
+      const sig = Buffer.alloc(sodium.crypto_sign_BYTES);
+      sodium.crypto_sign_detached(sig, Buffer.from(message), privateKey);
+
+      try {
+        process.stdout.write(chalk.gray(`Verifying @${pending.handle}... `));
+        const res = await postTo(serverUrl, '/otp/verify', { handle: pending.handle, code, signature: sig.toString('hex'), timestamp: now });
+        const result = await res.json();
+        if (result.success) {
+          console.log(chalk.green('done.'));
+          console.log(chalk.green(`Handle @${pending.handle} verified and registered.`));
+          setIdentityHandle(pending.handle);
+          updateProfileHandle(identity.publicKey, pending.handle);
+          config.delete('_pendingRegistration');
+        } else {
+          console.log(chalk.red(`\nVerification failed: ${result.error}`));
+          process.exitCode = 1;
+        }
+      } catch {
+        console.log(chalk.red(`\nCould not reach discovery server at ${serverUrl}`));
+        process.exitCode = 1;
+      }
+    });
+}

package/lib/commands/relay.js

@@ -1,131 +1,131 @@
-import chalk from 'chalk';
-import crypto from 'crypto';
-
-export default function relayCommand(program) {
-  const cmd = program
-    .command('relay')
-    .description('manage the TURN relay server extension')
-    .addHelpText('after', `
-Examples:
-  $ pe relay start                   Start the relay server
-  $ pe relay stop                    Stop the relay server
-  $ pe relay status                  Show relay status
-  $ pe relay credentials             Generate TURN credentials (default 1h TTL)
-  $ pe relay credentials 3600       Generate credentials with custom TTL (seconds)
-`)
-    .action(() => {
-      cmd.outputHelp();
-    });
-
-  cmd
-    .command('start')
-    .description('start the TURN relay server')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const cfg = extConfig.get('ext.relay') || {};
-
-        if (!cfg.secret) {
-          cfg.secret = crypto.randomBytes(32).toString('hex');
-          extConfig.set('ext.relay', { ...cfg });
-        }
-
-        const port = cfg.port || 3478;
-        const realm = cfg.realm || 'palexplorer';
-
-        const store = extConfig.get('ext_store.relay') || {};
-        store.running = true;
-        store.activeAllocations = store.activeAllocations || {};
-        extConfig.set('ext_store.relay', store);
-
-        console.log(chalk.green(`✔ Relay server started`));
-        console.log(`  Port:  ${chalk.white(port)}`);
-        console.log(`  Realm: ${chalk.white(realm)}`);
-      } catch (err) {
-        console.log(chalk.red(`Failed to start relay: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('stop')
-    .description('stop the TURN relay server')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const store = extConfig.get('ext_store.relay') || {};
-        store.running = false;
-        store.activeAllocations = {};
-        extConfig.set('ext_store.relay', store);
-
-        console.log(chalk.green(`✔ Relay server stopped`));
-      } catch (err) {
-        console.log(chalk.red(`Failed to stop relay: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('status')
-    .description('show relay server status')
-    .action(async () => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const cfg = extConfig.get('ext.relay') || {};
-        const store = extConfig.get('ext_store.relay') || {};
-
-        const running = store.running || false;
-        const port = cfg.port || 3478;
-        const realm = cfg.realm || 'palexplorer';
-        const maxBandwidth = cfg.maxBandwidth || 'unlimited';
-        const allocations = Object.keys(store.activeAllocations || {}).length;
-
-        console.log('');
-        console.log(chalk.cyan.bold('TURN Relay Status'));
-        console.log(`  Status:      ${running ? chalk.green('running') : chalk.red('stopped')}`);
-        console.log(`  Port:        ${chalk.white(port)}`);
-        console.log(`  Realm:       ${chalk.white(realm)}`);
-        console.log(`  Bandwidth:   ${chalk.white(maxBandwidth)}`);
-        console.log(`  Allocations: ${chalk.white(allocations)}`);
-        console.log(`  Secret:      ${cfg.secret ? chalk.gray(cfg.secret.slice(0, 8) + '...') : chalk.yellow('not set')}`);
-        console.log('');
-      } catch (err) {
-        console.log(chalk.red(`Failed to get status: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-
-  cmd
-    .command('credentials [ttl]')
-    .description('generate TURN credentials (HMAC-SHA1 based)')
-    .action(async (ttl) => {
-      try {
-        const extConfig = (await import('../utils/config.js')).default;
-        const cfg = extConfig.get('ext.relay') || {};
-
-        if (!cfg.secret) {
-          cfg.secret = crypto.randomBytes(32).toString('hex');
-          extConfig.set('ext.relay', { ...cfg });
-        }
-
-        const credentialTTL = parseInt(ttl, 10) || cfg.credentialTTL || 3600;
-        const timestamp = Math.floor(Date.now() / 1000) + credentialTTL;
-        const username = `${timestamp}:palexplorer`;
-        const password = crypto
-          .createHmac('sha1', cfg.secret)
-          .update(username)
-          .digest('base64');
-
-        console.log('');
-        console.log(chalk.cyan.bold('TURN Credentials'));
-        console.log(`  Username: ${chalk.white(username)}`);
-        console.log(`  Password: ${chalk.white(password)}`);
-        console.log(`  TTL:      ${chalk.white(credentialTTL + 's')}`);
-        console.log(`  Expires:  ${chalk.gray(new Date(timestamp * 1000).toISOString())}`);
-        console.log('');
-      } catch (err) {
-        console.log(chalk.red(`Failed to generate credentials: ${err.message}`));
-        process.exitCode = 1;
-      }
-    });
-}
+import chalk from 'chalk';
+import crypto from 'crypto';
+
+export default function relayCommand(program) {
+  const cmd = program
+    .command('relay')
+    .description('manage the TURN relay server extension')
+    .addHelpText('after', `
+Examples:
+  $ pal relay start                   Start the relay server
+  $ pal relay stop                    Stop the relay server
+  $ pal relay status                  Show relay status
+  $ pal relay credentials             Generate TURN credentials (default 1h TTL)
+  $ pal relay credentials 3600       Generate credentials with custom TTL (seconds)
+`)
+    .action(() => {
+      cmd.outputHelp();
+    });
+
+  cmd
+    .command('start')
+    .description('start the TURN relay server')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const cfg = extConfig.get('ext.relay') || {};
+
+        if (!cfg.secret) {
+          cfg.secret = crypto.randomBytes(32).toString('hex');
+          extConfig.set('ext.relay', { ...cfg });
+        }
+
+        const port = cfg.port || 3478;
+        const realm = cfg.realm || 'palexplorer';
+
+        const store = extConfig.get('ext_store.relay') || {};
+        store.running = true;
+        store.activeAllocations = store.activeAllocations || {};
+        extConfig.set('ext_store.relay', store);
+
+        console.log(chalk.green(`✔ Relay server started`));
+        console.log(`  Port:  ${chalk.white(port)}`);
+        console.log(`  Realm: ${chalk.white(realm)}`);
+      } catch (err) {
+        console.log(chalk.red(`Failed to start relay: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('stop')
+    .description('stop the TURN relay server')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const store = extConfig.get('ext_store.relay') || {};
+        store.running = false;
+        store.activeAllocations = {};
+        extConfig.set('ext_store.relay', store);
+
+        console.log(chalk.green(`✔ Relay server stopped`));
+      } catch (err) {
+        console.log(chalk.red(`Failed to stop relay: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('status')
+    .description('show relay server status')
+    .action(async () => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const cfg = extConfig.get('ext.relay') || {};
+        const store = extConfig.get('ext_store.relay') || {};
+
+        const running = store.running || false;
+        const port = cfg.port || 3478;
+        const realm = cfg.realm || 'palexplorer';
+        const maxBandwidth = cfg.maxBandwidth || 'unlimited';
+        const allocations = Object.keys(store.activeAllocations || {}).length;
+
+        console.log('');
+        console.log(chalk.cyan.bold('TURN Relay Status'));
+        console.log(`  Status:      ${running ? chalk.green('running') : chalk.red('stopped')}`);
+        console.log(`  Port:        ${chalk.white(port)}`);
+        console.log(`  Realm:       ${chalk.white(realm)}`);
+        console.log(`  Bandwidth:   ${chalk.white(maxBandwidth)}`);
+        console.log(`  Allocations: ${chalk.white(allocations)}`);
+        console.log(`  Secret:      ${cfg.secret ? chalk.gray(cfg.secret.slice(0, 8) + '...') : chalk.yellow('not set')}`);
+        console.log('');
+      } catch (err) {
+        console.log(chalk.red(`Failed to get status: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+
+  cmd
+    .command('credentials [ttl]')
+    .description('generate TURN credentials (HMAC-SHA1 based)')
+    .action(async (ttl) => {
+      try {
+        const extConfig = (await import('../utils/config.js')).default;
+        const cfg = extConfig.get('ext.relay') || {};
+
+        if (!cfg.secret) {
+          cfg.secret = crypto.randomBytes(32).toString('hex');
+          extConfig.set('ext.relay', { ...cfg });
+        }
+
+        const credentialTTL = parseInt(ttl, 10) || cfg.credentialTTL || 3600;
+        const timestamp = Math.floor(Date.now() / 1000) + credentialTTL;
+        const username = `${timestamp}:palexplorer`;
+        const password = crypto
+          .createHmac('sha1', cfg.secret)
+          .update(username)
+          .digest('base64');
+
+        console.log('');
+        console.log(chalk.cyan.bold('TURN Credentials'));
+        console.log(`  Username: ${chalk.white(username)}`);
+        console.log(`  Password: ${chalk.white(password)}`);
+        console.log(`  TTL:      ${chalk.white(credentialTTL + 's')}`);
+        console.log(`  Expires:  ${chalk.gray(new Date(timestamp * 1000).toISOString())}`);
+        console.log('');
+      } catch (err) {
+        console.log(chalk.red(`Failed to generate credentials: ${err.message}`));
+        process.exitCode = 1;
+      }
+    });
+}