pal-explorer-cli 0.4.11 → 0.4.13

package/lib/commands/pal.js

@@ -1,180 +1,403 @@
-import chalk from 'chalk';
-import { getFriends, saveFriends } from '../core/users.js';
-import { decodeInvite } from './invite.js';
-import { getSharesForPal, removeRecipientFromShare, rotateShareKey } from '../core/shares.js';
-import { resolveHandle as resolveHandleFull } from '../core/resolver.js';
-import { getPrimaryServer } from '../core/discoveryClient.js';
-
-async function resolveHandle(handle) {
-  const data = await resolveHandleFull(handle);
-  if (!data) return null;
-  return data.publicKey || data.publicKeys?.[0] || null;
-}
-
-async function addPal(id, resolvedName, handle) {
-  const friends = getFriends();
-
-  const existing = friends.find(f => f.id === id);
-  if (existing) {
-    console.log(chalk.yellow(`This ID is already in your list as '${existing.name}'.`));
-    return false;
-  }
-
-  const palName = resolvedName || 'Unnamed Pal';
-  if (friends.find(f => f.name === palName)) {
-    console.log(chalk.red(`Error: The name '${palName}' is already taken. Please provide a unique nickname.`));
-    return false;
-  }
-
-  const newPal = { id, name: palName, handle: handle || null, addedAt: new Date().toISOString() };
-  friends.push(newPal);
-  saveFriends(friends);
-  return newPal;
-}
-
-export default function palCommand(program) {
-  const pal = program.command('pal').description('manage your list of pals (friends)')
-    .addHelpText('after', `
-Examples:
-  $ pe pal add @alice               Add pal by handle
-  $ pe pal add pal://... bob        Add pal from invite link
-  $ pe pal add abc123def456 carol   Add pal by public key
-  $ pe pal list                     Show all pals
-  $ pe pal remove @alice            Remove a pal (rotates affected share keys)
-`);
-
-  pal
-    .command('add <target> [name]')
-    .description('add a pal by @handle, invite link (pal://...), or raw public key')
-    .action(async (target, name) => {
-      // --- Mode 1: Magic invite link ---
-      if (target.startsWith('pal://')) {
-        const decoded = decodeInvite(target);
-        if (!decoded) {
-          console.log(chalk.red('Invalid invite link.'));
-          process.exitCode = 1;
-          return;
-        }
-        const palName = name || decoded.n || 'Unnamed Pal';
-        const result = await addPal(decoded.pk, palName, decoded.h);
-        if (result) {
-          console.log(chalk.green(`✔ Added pal: ${result.name}${decoded.h ? ` (@${decoded.h})` : ''}`));
-        }
-        return;
-      }
-
-      // --- Mode 2: Handle lookup (@handle or plain handle string) ---
-      const isHandle = target.startsWith('@') || (!target.match(/^[0-9a-fA-F]{20,}$/));
-      if (isHandle) {
-        const handle = target.startsWith('@') ? target.slice(1) : target;
-        process.stdout.write(chalk.gray(`Resolving @${handle}... `));
-        let publicKey;
-        try {
-          publicKey = await resolveHandle(handle);
-        } catch {
-          console.log(chalk.red(`\nCould not reach discovery server(s)`));
-          process.exitCode = 1;
-          return;
-        }
-        if (!publicKey) {
-          console.log(chalk.red(`\nHandle @${handle} not found.`));
-          process.exitCode = 1;
-          return;
-        }
-        console.log(chalk.green('found.'));
-        const palName = name || handle;
-        const result = await addPal(publicKey, palName, handle);
-        if (result) {
-          console.log(chalk.green(`✔ Added pal: ${result.name} (@${handle})`));
-        }
-        return;
-      }
-
-      // --- Mode 3: Raw public key ---
-      const palName = name || 'Unnamed Pal';
-      const result = await addPal(target, palName, null);
-      if (result) {
-        console.log(chalk.green(`✔ Added pal: ${result.name} (${target})`));
-      }
-    });
-
-  pal
-    .command('list')
-    .description('list all your pals with online status')
-    .action(async () => {
-      const friends = getFriends();
-      if (friends.length === 0) {
-        if (program.opts().json) {
-          console.log(JSON.stringify({ pals: [] }, null, 2));
-          return;
-        }
-        console.log(chalk.gray('Your pal list is empty. Use `pe pal add @handle` or `pe invite` to add friends.'));
-        return;
-      }
-
-      const discoveryUrl = getPrimaryServer();
-      for (const f of friends) {
-        if (f.handle) {
-          try {
-            const res = await fetch(`${discoveryUrl}/api/v1/presence/${encodeURIComponent(f.handle)}`, {
-              signal: AbortSignal.timeout(3000),
-            });
-            if (res.ok) {
-              const p = await res.json();
-              f._online = p.online;
-              f._lastSeen = p.devices?.[0]?.lastSeen;
-            }
-          } catch {}
-        }
-      }
-
-      if (program.opts().json) {
-        const pals = friends.map(f => ({ id: f.id, name: f.name, handle: f.handle, online: !!f._online, lastSeen: f._lastSeen || null }));
-        console.log(JSON.stringify({ pals }, null, 2));
-        return;
-      }
-
-      console.log('');
-      console.log(chalk.cyan('Your Pals:'));
-      friends.forEach(f => {
-        const handle = f.handle ? chalk.cyan(` @${f.handle}`) : '';
-        const statusIcon = f._online ? chalk.green('\u25cf') : chalk.gray('\u25cb');
-        const statusText = f._online ? chalk.green('online') : chalk.gray('offline');
-        console.log(`${statusIcon} ${chalk.white(f.name)}${handle} ${statusText} [${chalk.gray(f.id)}]`);
-      });
-    });
-
-  pal
-    .command('remove <id>')
-    .description('remove a pal from your list by their public key or @handle')
-    .action(async (id) => {
-      const friends = getFriends();
-      const target = id.startsWith('@') ? id.slice(1) : id;
-      const removed = friends.find(f => f.id === target || f.handle === target);
-      const filtered = friends.filter(f => f.id !== target && f.handle !== target);
-      if (!removed) {
-        console.log(chalk.red('Pal not found.'));
-        return;
-      }
-      saveFriends(filtered);
-      console.log(chalk.green('✔ Pal removed.'));
-
-      // Rotate keys for any shares this pal was a recipient of
-      const affectedShares = getSharesForPal(removed.id);
-      if (affectedShares.length > 0) {
-        console.log(chalk.blue(`Rotating keys for ${affectedShares.length} affected share(s)...`));
-        for (const share of affectedShares) {
-          try {
-            removeRecipientFromShare(share.id, removed.id);
-            if (share.visibility === 'private') {
-              await rotateShareKey(share.id);
-              console.log(chalk.gray(`  ✔ Rotated key for "${share.name || share.id}"`));
-            }
-          } catch (err) {
-            console.log(chalk.yellow(`  Warning: Could not rotate key for ${share.id}: ${err.message}`));
-          }
-        }
-        console.log(chalk.green('Key rotation complete. Re-run `pe serve` to seed with new keys.'));
-      }
-    });
-}
+import chalk from 'chalk';
+import { getFriends, saveFriends } from '../core/users.js';
+import { decodeInvite } from './invite.js';
+import { getSharesForPal, removeRecipientFromShare, rotateShareKey } from '../core/shares.js';
+import { resolveHandle as resolveHandleFull } from '../core/resolver.js';
+import { getPrimaryServer } from '../core/discoveryClient.js';
+import { updateProfile, getProfile, PRESENCE_STATUSES } from '../core/identity.js';
+
+async function resolveHandle(handle) {
+  const data = await resolveHandleFull(handle);
+  if (!data) return null;
+  return data.publicKey || data.publicKeys?.[0] || null;
+}
+
+async function addPal(id, resolvedName, handle) {
+  const friends = getFriends();
+
+  const existing = friends.find(f => f.id === id);
+  if (existing) {
+    console.log(chalk.yellow(`This ID is already in your list as '${existing.name}'.`));
+    return false;
+  }
+
+  const palName = resolvedName || null;
+  if (palName && friends.find(f => f.name === palName)) {
+    console.log(chalk.red(`Error: The name '${palName}' is already taken. Please provide a unique nickname.`));
+    return false;
+  }
+
+  const newPal = { id, name: palName, handle: handle || null, addedAt: new Date().toISOString() };
+  friends.push(newPal);
+  saveFriends(friends);
+  return newPal;
+}
+
+export default function palCommand(program) {
+  const pal = program.command('pal').description('manage your list of pals (friends)')
+    .addHelpText('after', `
+Examples:
+  $ pal pal add @alice               Add pal by handle (requires discovery server)
+  $ pal pal add pal://... bob        Add pal from invite link
+  $ pal pal add abc123def456 carol   Add pal by public key (pure P2P)
+  $ pal pal add abc123def456         Add pal without nickname (shows as key prefix)
+  $ pal pal list                     Show all pals
+  $ pal pal name abc123de "Alice"    Set or change a pal's nickname
+  $ pal pal unname Alice             Remove a pal's nickname
+  $ pal pal remove Alice             Remove a pal (rotates affected share keys)
+`);
+
+  pal
+    .command('add <target> [name]')
+    .description('add a pal by @handle, invite link (pal://...), or raw public key')
+    .action(async (target, name) => {
+      // --- Mode 1: Magic invite link ---
+      if (target.startsWith('pal://')) {
+        const decoded = decodeInvite(target);
+        if (!decoded) {
+          console.log(chalk.red('Invalid invite link.'));
+          process.exitCode = 1;
+          return;
+        }
+        const palName = name || decoded.n || null;
+        const result = await addPal(decoded.pk, palName, decoded.h);
+        if (result) {
+          console.log(chalk.green(`✔ Added pal: ${result.name}${decoded.h ? ` (@${decoded.h})` : ''}`));
+        }
+        return;
+      }
+
+      // --- Mode 2: Handle lookup (@handle or plain handle string) ---
+      const isHandle = target.startsWith('@') || (!target.match(/^[0-9a-fA-F]{20,}$/));
+      if (isHandle) {
+        const handle = target.startsWith('@') ? target.slice(1) : target;
+        process.stdout.write(chalk.gray(`Resolving @${handle}... `));
+        let publicKey;
+        try {
+          publicKey = await resolveHandle(handle);
+        } catch {
+          console.log(chalk.red(`\nCould not reach discovery server(s)`));
+          process.exitCode = 1;
+          return;
+        }
+        if (!publicKey) {
+          console.log(chalk.red(`\nHandle @${handle} not found.`));
+          process.exitCode = 1;
+          return;
+        }
+        console.log(chalk.green('found.'));
+        const palName = name || handle;
+        const result = await addPal(publicKey, palName, handle);
+        if (result) {
+          console.log(chalk.green(`✔ Added pal: ${result.name} (@${handle})`));
+        }
+        return;
+      }
+
+      // --- Mode 3: Raw public key ---
+      const palName = name || null;
+      const result = await addPal(target, palName, null);
+      if (result) {
+        const display = result.name || target.slice(0, 8) + '...' + target.slice(-8);
+        console.log(chalk.green(`✔ Added pal: ${display} (${target})`));
+      }
+    });
+
+  pal
+    .command('list')
+    .description('list all your pals with online status')
+    .action(async () => {
+      const friends = getFriends();
+      if (friends.length === 0) {
+        if (program.opts().json) {
+          console.log(JSON.stringify({ pals: [] }, null, 2));
+          return;
+        }
+        console.log(chalk.gray('Your pal list is empty. Use `pal pal add @handle` or `pal invite` to add friends.'));
+        return;
+      }
+
+      const discoveryUrl = getPrimaryServer();
+      for (const f of friends) {
+        if (f.handle) {
+          try {
+            const res = await fetch(`${discoveryUrl}/api/v1/presence/${encodeURIComponent(f.handle)}`, {
+              signal: AbortSignal.timeout(3000),
+            });
+            if (res.ok) {
+              const p = await res.json();
+              f._online = p.online;
+              f._lastSeen = p.devices?.[0]?.lastSeen;
+            }
+          } catch {}
+        }
+      }
+
+      if (program.opts().json) {
+        const pals = friends.map(f => ({ id: f.id, name: f.name || null, handle: f.handle, online: !!f._online, lastSeen: f._lastSeen || null }));
+        console.log(JSON.stringify({ pals }, null, 2));
+        return;
+      }
+
+      console.log('');
+      console.log(chalk.cyan('Your Pals:'));
+      friends.forEach(f => {
+        const displayName = f.name || (f.id.slice(0, 8) + '...' + f.id.slice(-8));
+        const handle = f.handle ? chalk.cyan(` @${f.handle}`) : '';
+        const statusIcon = f._online ? chalk.green('\u25cf') : chalk.gray('\u25cb');
+        const statusText = f._online ? chalk.green('online') : chalk.gray('offline');
+        console.log(`${statusIcon} ${chalk.white(displayName)}${handle} ${statusText} [${chalk.gray(f.id)}]`);
+      });
+    });
+
+  pal
+    .command('info <pal>')
+    .description('show detailed profile info for a pal')
+    .action(async (palId) => {
+      const friends = getFriends();
+      const target = palId.startsWith('@') ? palId.slice(1) : palId;
+      const pal = friends.find(f => f.id === target || f.handle === target || f.name === target);
+      if (!pal) {
+        console.log(chalk.red('Pal not found. Use `pal pal list` to see your pals.'));
+        process.exitCode = 1;
+        return;
+      }
+
+      const displayName = pal.name || (pal.id.slice(0, 8) + '...' + pal.id.slice(-8));
+      console.log('');
+      console.log(chalk.cyan(`Pal: ${displayName}`));
+      console.log(`  ${'Public Key'.padEnd(14)} ${chalk.gray(pal.id)}`);
+      if (pal.handle) console.log(`  ${'Handle'.padEnd(14)} ${chalk.cyan('@' + pal.handle)}`);
+      console.log(`  ${'Added'.padEnd(14)} ${pal.addedAt || chalk.gray('unknown')}`);
+
+      // Fetch presence + profile from discovery server
+      if (pal.handle) {
+        const discoveryUrl = getPrimaryServer();
+        process.stdout.write(chalk.gray('\n  Fetching presence... '));
+        try {
+          const res = await fetch(`${discoveryUrl}/api/v1/presence/${encodeURIComponent(pal.handle)}`, {
+            signal: AbortSignal.timeout(5000),
+          });
+          if (res.ok) {
+            const p = await res.json();
+            const profile = p.profile || {};
+            const online = p.online;
+            const presenceStatus = profile.presenceStatus || (online ? 'online' : 'offline');
+            const presenceColors = { online: 'green', away: 'yellow', dnd: 'red', invisible: 'gray', offline: 'gray' };
+            const colorFn = chalk[presenceColors[presenceStatus] || 'gray'];
+
+            console.log(colorFn(presenceStatus));
+            console.log('');
+
+            const rows = [
+              ['Display Name', profile.displayName],
+              ['Avatar', profile.avatar],
+              ['Bio', profile.bio],
+              ['Presence', presenceStatus],
+              ['Status', profile.statusText || profile.status],
+              ['Age', profile.age != null ? String(profile.age) : null],
+              ['Gender', profile.gender],
+              ['Country', profile.country],
+              ['Language', profile.language],
+              ['Interests', profile.interests?.length ? profile.interests.join(', ') : null],
+              ['Joined', profile.joinedAt],
+            ];
+
+            for (const [label, value] of rows) {
+              if (value) console.log(`  ${chalk.white(label.padEnd(14))} ${value}`);
+            }
+
+            // Devices
+            const devices = p.devices || [];
+            if (devices.length > 0) {
+              console.log('');
+              console.log(chalk.cyan('  Devices:'));
+              for (const d of devices) {
+                const dStatus = d.status === 'online' ? chalk.green('online') : chalk.gray('offline');
+                console.log(`    ${d.deviceName || d.deviceId} — ${dStatus}`);
+              }
+            }
+
+            // Shared with me
+            const { getSharesForPal } = await import('../core/shares.js');
+            const sharedShares = getSharesForPal(pal.id);
+            if (sharedShares.length > 0) {
+              console.log('');
+              console.log(chalk.cyan(`  Shares with this pal (${sharedShares.length}):`));
+              for (const s of sharedShares) {
+                console.log(`    ${s.name || s.id} ${s.category ? chalk.gray(`[${s.category}]`) : ''}`);
+              }
+            }
+          } else {
+            console.log(chalk.yellow('unavailable'));
+          }
+        } catch {
+          console.log(chalk.yellow('server unreachable (pure P2P mode)'));
+        }
+      }
+      console.log('');
+    });
+
+  pal
+    .command('remove <id>')
+    .description('remove a pal from your list by their public key or @handle')
+    .action(async (id) => {
+      const friends = getFriends();
+      const target = id.startsWith('@') ? id.slice(1) : id;
+      const removed = friends.find(f => f.id === target || f.handle === target || f.name === target);
+      const filtered = friends.filter(f => f !== removed);
+      if (!removed) {
+        console.log(chalk.red('Pal not found.'));
+        return;
+      }
+      saveFriends(filtered);
+      console.log(chalk.green('✔ Pal removed.'));
+
+      // Rotate keys for any shares this pal was a recipient of
+      const affectedShares = getSharesForPal(removed.id);
+      if (affectedShares.length > 0) {
+        console.log(chalk.blue(`Rotating keys for ${affectedShares.length} affected share(s)...`));
+        for (const share of affectedShares) {
+          try {
+            removeRecipientFromShare(share.id, removed.id);
+            if (share.visibility === 'private') {
+              await rotateShareKey(share.id);
+              console.log(chalk.gray(`  ✔ Rotated key for "${share.name || share.id}"`));
+            }
+          } catch (err) {
+            console.log(chalk.yellow(`  Warning: Could not rotate key for ${share.id}: ${err.message}`));
+          }
+        }
+        console.log(chalk.green('Key rotation complete. Re-run `pal serve` to seed with new keys.'));
+      }
+    });
+
+  pal
+    .command('name <pal> <nickname>')
+    .description('set or change a pal\'s nickname')
+    .action(async (palId, nickname) => {
+      const friends = getFriends();
+      const target = palId.startsWith('@') ? palId.slice(1) : palId;
+      const pal = friends.find(f => f.id === target || f.handle === target || f.name === target);
+      if (!pal) {
+        console.log(chalk.red('Pal not found.'));
+        process.exitCode = 1;
+        return;
+      }
+      if (friends.find(f => f !== pal && f.name === nickname)) {
+        console.log(chalk.red(`The name '${nickname}' is already taken by another pal.`));
+        process.exitCode = 1;
+        return;
+      }
+      const oldName = pal.name || pal.id.slice(0, 8) + '...' + pal.id.slice(-8);
+      pal.name = nickname;
+      saveFriends(friends);
+      console.log(chalk.green(`✔ Renamed ${oldName} → ${nickname}`));
+    });
+
+  pal
+    .command('unname <pal>')
+    .description('remove a pal\'s nickname (will show as truncated public key)')
+    .action(async (palId) => {
+      const friends = getFriends();
+      const target = palId.startsWith('@') ? palId.slice(1) : palId;
+      const pal = friends.find(f => f.id === target || f.handle === target || f.name === target);
+      if (!pal) {
+        console.log(chalk.red('Pal not found.'));
+        process.exitCode = 1;
+        return;
+      }
+      if (!pal.name) {
+        console.log(chalk.yellow('This pal has no nickname.'));
+        return;
+      }
+      const oldName = pal.name;
+      pal.name = null;
+      saveFriends(friends);
+      console.log(chalk.green(`✔ Removed nickname '${oldName}' — pal will show as ${pal.id.slice(0, 8)}...${pal.id.slice(-8)}`));
+    });
+
+  // ── Profile management ──
+
+  pal
+    .command('profile')
+    .description('view or update your profile')
+    .option('--display-name <name>', 'set display name (max 50 chars)')
+    .option('--bio <text>', 'set bio (max 200 chars)')
+    .option('--status <text>', 'set status text (max 100 chars)')
+    .option('--presence <status>', `set presence: ${PRESENCE_STATUSES.join(', ')}`)
+    .option('--age <n>', 'set age (or "clear" to remove)')
+    .option('--gender <value>', 'set gender (or "clear" to remove)')
+    .option('--country <code>', 'set country ISO code, e.g. US, IL (or "clear")')
+    .option('--language <code>', 'set language code, e.g. en, he (or "clear")')
+    .option('--interests <tags>', 'comma-separated interests, e.g. "p2p,crypto,gaming"')
+    .option('--avatar <emoji>', 'set emoji avatar')
+    .action(async (opts) => {
+      const updates = {};
+      let hasUpdates = false;
+
+      if (opts.displayName !== undefined) { updates.displayName = opts.displayName.slice(0, 50); hasUpdates = true; }
+      if (opts.bio !== undefined) { updates.bio = opts.bio.slice(0, 200); hasUpdates = true; }
+      if (opts.status !== undefined) { updates.statusText = opts.status.slice(0, 100); hasUpdates = true; }
+      if (opts.presence !== undefined) { updates.presenceStatus = opts.presence; hasUpdates = true; }
+      if (opts.avatar !== undefined) { updates.avatar = opts.avatar; hasUpdates = true; }
+      if (opts.age !== undefined) {
+        updates.age = opts.age === 'clear' ? null : opts.age;
+        hasUpdates = true;
+      }
+      if (opts.gender !== undefined) {
+        updates.gender = opts.gender === 'clear' ? undefined : opts.gender.slice(0, 20);
+        hasUpdates = true;
+      }
+      if (opts.country !== undefined) {
+        updates.country = opts.country === 'clear' ? undefined : opts.country.toUpperCase().slice(0, 2);
+        hasUpdates = true;
+      }
+      if (opts.language !== undefined) {
+        updates.language = opts.language === 'clear' ? undefined : opts.language.toLowerCase().slice(0, 5);
+        hasUpdates = true;
+      }
+      if (opts.interests !== undefined) {
+        updates.interests = opts.interests.split(',').map(s => s.trim()).filter(Boolean);
+        hasUpdates = true;
+      }
+
+      if (hasUpdates) {
+        try {
+          updateProfile(updates);
+          console.log(chalk.green('✔ Profile updated.'));
+        } catch (err) {
+          console.log(chalk.red(`Error: ${err.message}`));
+          process.exitCode = 1;
+          return;
+        }
+      }
+
+      const profile = getProfile();
+      if (!profile) {
+        console.log(chalk.yellow('No identity found. Run `pal init` first.'));
+        return;
+      }
+
+      console.log('');
+      console.log(chalk.cyan('Your Profile:'));
+      const rows = [
+        ['Display Name', profile.displayName || chalk.gray('(not set)')],
+        ['Avatar', profile.avatar || chalk.gray('(not set)')],
+        ['Bio', profile.bio || chalk.gray('(not set)')],
+        ['Presence', profile.presenceStatus || 'online'],
+        ['Status', profile.statusText || chalk.gray('(not set)')],
+        ['Age', profile.age != null ? String(profile.age) : chalk.gray('(not set)')],
+        ['Gender', profile.gender || chalk.gray('(not set)')],
+        ['Country', profile.country || chalk.gray('(not set)')],
+        ['Language', profile.language || chalk.gray('(not set)')],
+        ['Interests', profile.interests?.length ? profile.interests.join(', ') : chalk.gray('(none)')],
+        ['Joined', profile.joinedAt || chalk.gray('unknown')],
+      ];
+      if (profile.avatarHash) rows.splice(2, 0, ['Avatar Image', chalk.gray(profile.avatarHash.slice(0, 16) + '...')]);
+
+      for (const [label, value] of rows) {
+        console.log(`  ${chalk.white(label.padEnd(14))} ${value}`);
+      }
+    });
+}