pal-explorer-cli 0.4.7 → 0.4.9

package/bin/pal.js

@@ -1,231 +1,231 @@
-#!/usr/bin/env node
-
-// Enable V8 code caching for faster subsequent boots
-import 'v8-compile-cache-lib';
-
-import { program } from 'commander';
-import chalk from 'chalk';
-
-// Utility for lazy loading commands
-const lazy = (path) => async (program) => {
-  const mod = await import(path);
-  if (mod.default) mod.default(program);
-  else if (typeof mod === 'function') mod(program);
-};
-
-// --- Eagerly load ONLY what is needed for initial setup/parsing ---
-import logger from '../lib/utils/logger.js';
-import { installGlobalErrorHandler } from '../lib/core/analytics.js';
-installGlobalErrorHandler();
-
-globalThis.__palMode = 'cli';
-
-// --- Lazy load the big migration/core logic only if needed ---
-const runMigrations = async () => {
-  const { migrateShareKeys } = await import('../lib/core/shares.js');
-  const { migrateToMultiUser } = await import('../lib/core/users.js');
-  await migrateShareKeys();
-  migrateToMultiUser();
-};
-
-// Apply persisted log level from config before anything else
-import config from '../lib/utils/config.js';
-const settings = config.get('settings') || {};
-const configuredLevel = settings.logLevel;
-if (configuredLevel) logger.setLevel(configuredLevel);
-
-// Parse --log-level early (before Commander) so it works before subcommands
-const logLevelIdx = process.argv.indexOf('--log-level');
-if (logLevelIdx !== -1 && process.argv[logLevelIdx + 1]) {
-  const cliLevel = process.argv[logLevelIdx + 1];
-  if (logger.LEVELS.includes(cliLevel)) {
-    logger.setLevel(cliLevel);
-    process.argv.splice(logLevelIdx, 2);
-  }
-}
-
-logger.applyGlobalOverride();
-
-program
-  .name('pe')
-  .description('p2p file sharing for friends')
-  .version('0.4.0')
-  .option('--json', 'output in JSON format')
-  .option('--log-level <level>', 'set log level (debug, info, warn, error, silent)');
-
-// Register Commands LAZILY
-// Note: Commander requires commands to be defined upfront for help/autocompletion,
-// but the actual .js files containing the complex registration logic (with their own imports) 
-// are what we are lazy-loading here.
-const commands = [
-  ['init', '../lib/commands/init.js'],
-  ['whoami', '../lib/commands/whoami.js'],
-  ['register', '../lib/commands/register.js'],
-  ['recover', '../lib/commands/recover.js'],
-  ['share', '../lib/commands/share.js'],
-  ['download', '../lib/commands/download.js'],
-  ['list', '../lib/commands/list.js'],
-  ['revoke', '../lib/commands/revoke.js'],
-  ['serve', '../lib/commands/serve.js'],
-  ['pal', '../lib/commands/pal.js'],
-  ['invite', '../lib/commands/invite.js'],
-  ['nearby', '../lib/commands/nearby.js'],
-  ['group', '../lib/commands/group.js'],
-  ['sync', '../lib/commands/sync.js'],
-  ['transfers', '../lib/commands/transfers.js'],
-  ['config', '../lib/commands/config.js'],
-  ['device', '../lib/commands/device.js'],
-  ['server', '../lib/commands/server.js'],
-  ['explorer', '../lib/commands/explorer.js'],
-  ['status', '../lib/commands/status.js'],
-  ['log', '../lib/commands/log.js'],
-  ['completion', '../lib/commands/completion.js'],
-  ['web', '../lib/commands/web.js'],
-  ['web-login', '../lib/commands/web-login.js'],
-  ['gui-share', '../lib/commands/gui-share.js'],
-  ['vfs', '../lib/commands/vfs.js'],
-  ['file', '../lib/commands/file.js'],
-  ['remote', '../lib/commands/remote.js'],
-  ['user', '../lib/commands/user.js'],
-  ['schedule', '../lib/commands/schedule.js'],
-  ['chat', '../lib/commands/chat.js'],
-  ['backup', '../lib/commands/backup.js'],
-  ['api-keys', '../lib/commands/api-keys.js'],
-  ['share-link', '../lib/commands/share-link.js'],
-  ['comment', '../lib/commands/comment.js'],
-  ['update', '../lib/commands/update.js'],
-  ['auth', '../lib/commands/auth.js'],
-  ['network', '../lib/commands/network.js'],
-  ['search', '../lib/commands/search.js'],
-  ['connect', '../lib/commands/connect.js'],
-  ['protocol', '../lib/commands/protocol.js'],
-  ['workspace', '../lib/commands/workspace.js'],
-  ['favorite', '../lib/commands/favorite.js'],
-  ['pin', '../lib/commands/pin.js'],
-  ['stream', '../lib/commands/stream.js'],
-  ['uninstall', '../lib/commands/uninstall.js'],
-  ['extension', '../lib/commands/extension.js'],
-  ['ext', '../lib/commands/extension.js'],
-  ['billing', '../lib/commands/billing.js'],
-  ['permissions', '../lib/commands/permissions.js'],
-  ['org', '../lib/commands/org.js'],
-  ['su', '../lib/commands/su.js'],
-  ['federation', '../lib/commands/federation.js'],
-  ['analytics', '../lib/commands/analytics.js'],
-  ['webhook', '../lib/commands/webhook.js'],
-  ['relay', '../lib/commands/relay.js'],
-  ['compliance', '../lib/commands/compliance.js'],
-  ['sso', '../lib/commands/sso.js'],
-  ['rbac', '../lib/commands/rbac.js'],
-  ['scim', '../lib/commands/scim.js'],
-  ['audit', '../lib/commands/audit.js'],
-  ['scanner', '../lib/commands/scanner.js'],
-  ['notify', '../lib/commands/notify.js'],
-  ['cloud-backup', '../lib/commands/cloud-backup.js'],
-  ['dept', '../lib/commands/dept.js'],
-];
-
-// To keep it truly fast, we should only register the specific command being run.
-// Commander's parseAsync will handle the matching.
-const currentCmd = process.argv[2];
-const cmdMatch = commands.find(c => c[0] === currentCmd);
-
-// Commands that don't modify data — skip migrations for speed
-const readOnlyCommands = new Set([
-  'whoami', 'status', 'list', 'log', 'completion', 'nearby',
-  'protocol', 'pin', 'favorite', 'search', 'workspace',
-]);
-const isVersionOrHelp = !currentCmd || currentCmd === '--help' || currentCmd === '-h'
-  || currentCmd === '--version' || currentCmd === '-V';
-const needsMigrations = cmdMatch && !readOnlyCommands.has(cmdMatch[0]) && !isVersionOrHelp;
-
-if (cmdMatch) {
-  if (needsMigrations) await runMigrations();
-  const register = await lazy(cmdMatch[1]);
-  await register(program);
-} else if (isVersionOrHelp) {
-  // Help/version — load all commands for full help text, skip migrations
-  await Promise.all(commands.map(c => lazy(c[1])(program)));
-} else {
-  // Unknown command — load all for Commander to handle
-  await runMigrations();
-  await Promise.all(commands.map(c => lazy(c[1])(program)));
-}
-
-// Grouped help text
-program.addHelpText('after', `
-${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('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
-  ${chalk.yellow('Social:')}       pal, invite, nearby, group, chat, comment
-  ${chalk.yellow('Search:')}       search (files, pals, groups)
-  ${chalk.yellow('Network:')}      network create/list/info/invite/join/members/groups/connect/disconnect
-  ${chalk.yellow('Workspace:')}    workspace list/create/delete/add/remove
-  ${chalk.yellow('Management:')}   transfers, config, device, server, explorer, vfs, web, schedule, favorite
-  ${chalk.yellow('Protocol:')}     protocol info/policy/route/envelope/keys
-  ${chalk.yellow('PIN:')}          pin set/remove/status
-  ${chalk.yellow('Billing:')}      billing status/plans/activate/deactivate/checkout
-  ${chalk.yellow('Pro:')}          backup, api-keys
-  ${chalk.yellow('Streaming:')}    stream local/remote/stop/status/broadcast/join/transport
-  ${chalk.yellow('Extensions:')}   ext list/install/remove/enable/disable/info/config/create
-  ${chalk.yellow('Orgs:')}         org create/list/info/invite/remove/subscribe/unsubscribe/billing
-  ${chalk.yellow('Utilities:')}    status, log, completion, gui-share, uninstall
-
-${chalk.gray('Aliases: pe connect → pe network connect, pe disconnect → pe network disconnect')}
-`);
-
-// Load extensions and emit lifecycle hooks
-let extensionsLoaded = false;
-if (!isVersionOrHelp) {
-  try {
-    const { loadAllExtensions, hooks, ensureDefaultExtensions } = await import('../lib/core/extensions.js');
-    ensureDefaultExtensions();
-    await loadAllExtensions();
-    extensionsLoaded = true;
-
-    // Clean stale transfers (0% for >24h)
-    const { cleanStaleTransfers } = await import('../lib/core/transfers.js');
-    const cleaned = cleanStaleTransfers(24);
-    if (cleaned > 0) console.log(`[transfers] Cleaned ${cleaned} stale transfer(s)`);
-
-    const identity = (await import('../lib/utils/config.js')).default.get('identity');
-    await hooks.emit('on:app:ready', {
-      version: program.version(),
-      identity: identity ? { handle: identity.handle, publicKey: identity.publicKey } : null,
-      mode: 'cli',
-    });
-
-    const shutdown = async () => {
-      await hooks.emit('on:app:shutdown', {});
-      process.exit(process.exitCode || 0);
-    };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-  } catch (err) {
-    // Extension loading is non-fatal
-    logger.warn?.(`Extension loading failed: ${err.message}`) || console.warn(`[extensions] ${err.message}`);
-  }
-}
-
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
-} else {
-  try {
-    await program.parseAsync(process.argv);
-  } catch (err) {
-    if (err.code !== 'commander.helpDisplayed' && err.code !== 'commander.unknownCommand') {
-      console.error(chalk.red(`Error: ${err.message}`));
-    }
-  }
-}
-
-// keytar's native D-Bus handles block the event loop on headless Linux
-const longRunning = new Set(['serve', 'nearby', 'stream']);
-if (!longRunning.has(currentCmd)) {
-  process.exit(process.exitCode || 0);
-}
+#!/usr/bin/env node
+
+// Enable V8 code caching for faster subsequent boots
+import 'v8-compile-cache-lib';
+
+import { program } from 'commander';
+import chalk from 'chalk';
+
+// Utility for lazy loading commands
+const lazy = (path) => async (program) => {
+  const mod = await import(path);
+  if (mod.default) mod.default(program);
+  else if (typeof mod === 'function') mod(program);
+};
+
+// --- Eagerly load ONLY what is needed for initial setup/parsing ---
+import logger from '../lib/utils/logger.js';
+import { installGlobalErrorHandler } from '../lib/core/analytics.js';
+installGlobalErrorHandler();
+
+globalThis.__palMode = 'cli';
+
+// --- Lazy load the big migration/core logic only if needed ---
+const runMigrations = async () => {
+  const { migrateShareKeys } = await import('../lib/core/shares.js');
+  const { migrateToMultiUser } = await import('../lib/core/users.js');
+  await migrateShareKeys();
+  migrateToMultiUser();
+};
+
+// Apply persisted log level from config before anything else
+import config from '../lib/utils/config.js';
+const settings = config.get('settings') || {};
+const configuredLevel = settings.logLevel;
+if (configuredLevel) logger.setLevel(configuredLevel);
+
+// Parse --log-level early (before Commander) so it works before subcommands
+const logLevelIdx = process.argv.indexOf('--log-level');
+if (logLevelIdx !== -1 && process.argv[logLevelIdx + 1]) {
+  const cliLevel = process.argv[logLevelIdx + 1];
+  if (logger.LEVELS.includes(cliLevel)) {
+    logger.setLevel(cliLevel);
+    process.argv.splice(logLevelIdx, 2);
+  }
+}
+
+logger.applyGlobalOverride();
+
+program
+  .name('pe')
+  .description('p2p file sharing for friends')
+  .version('0.4.0')
+  .option('--json', 'output in JSON format')
+  .option('--log-level <level>', 'set log level (debug, info, warn, error, silent)');
+
+// Register Commands LAZILY
+// Note: Commander requires commands to be defined upfront for help/autocompletion,
+// but the actual .js files containing the complex registration logic (with their own imports) 
+// are what we are lazy-loading here.
+const commands = [
+  ['init', '../lib/commands/init.js'],
+  ['whoami', '../lib/commands/whoami.js'],
+  ['register', '../lib/commands/register.js'],
+  ['recover', '../lib/commands/recover.js'],
+  ['share', '../lib/commands/share.js'],
+  ['download', '../lib/commands/download.js'],
+  ['list', '../lib/commands/list.js'],
+  ['revoke', '../lib/commands/revoke.js'],
+  ['serve', '../lib/commands/serve.js'],
+  ['pal', '../lib/commands/pal.js'],
+  ['invite', '../lib/commands/invite.js'],
+  ['nearby', '../lib/commands/nearby.js'],
+  ['group', '../lib/commands/group.js'],
+  ['sync', '../lib/commands/sync.js'],
+  ['transfers', '../lib/commands/transfers.js'],
+  ['config', '../lib/commands/config.js'],
+  ['device', '../lib/commands/device.js'],
+  ['server', '../lib/commands/server.js'],
+  ['explorer', '../lib/commands/explorer.js'],
+  ['status', '../lib/commands/status.js'],
+  ['log', '../lib/commands/log.js'],
+  ['completion', '../lib/commands/completion.js'],
+  ['web', '../lib/commands/web.js'],
+  ['web-login', '../lib/commands/web-login.js'],
+  ['gui-share', '../lib/commands/gui-share.js'],
+  ['vfs', '../lib/commands/vfs.js'],
+  ['file', '../lib/commands/file.js'],
+  ['remote', '../lib/commands/remote.js'],
+  ['user', '../lib/commands/user.js'],
+  ['schedule', '../lib/commands/schedule.js'],
+  ['chat', '../lib/commands/chat.js'],
+  ['backup', '../lib/commands/backup.js'],
+  ['api-keys', '../lib/commands/api-keys.js'],
+  ['share-link', '../lib/commands/share-link.js'],
+  ['comment', '../lib/commands/comment.js'],
+  ['update', '../lib/commands/update.js'],
+  ['auth', '../lib/commands/auth.js'],
+  ['network', '../lib/commands/network.js'],
+  ['search', '../lib/commands/search.js'],
+  ['connect', '../lib/commands/connect.js'],
+  ['protocol', '../lib/commands/protocol.js'],
+  ['workspace', '../lib/commands/workspace.js'],
+  ['favorite', '../lib/commands/favorite.js'],
+  ['pin', '../lib/commands/pin.js'],
+  ['stream', '../lib/commands/stream.js'],
+  ['uninstall', '../lib/commands/uninstall.js'],
+  ['extension', '../lib/commands/extension.js'],
+  ['ext', '../lib/commands/extension.js'],
+  ['billing', '../lib/commands/billing.js'],
+  ['permissions', '../lib/commands/permissions.js'],
+  ['org', '../lib/commands/org.js'],
+  ['su', '../lib/commands/su.js'],
+  ['federation', '../lib/commands/federation.js'],
+  ['analytics', '../lib/commands/analytics.js'],
+  ['webhook', '../lib/commands/webhook.js'],
+  ['relay', '../lib/commands/relay.js'],
+  ['compliance', '../lib/commands/compliance.js'],
+  ['sso', '../lib/commands/sso.js'],
+  ['rbac', '../lib/commands/rbac.js'],
+  ['scim', '../lib/commands/scim.js'],
+  ['audit', '../lib/commands/audit.js'],
+  ['scanner', '../lib/commands/scanner.js'],
+  ['notify', '../lib/commands/notify.js'],
+  ['cloud-backup', '../lib/commands/cloud-backup.js'],
+  ['dept', '../lib/commands/dept.js'],
+];
+
+// To keep it truly fast, we should only register the specific command being run.
+// Commander's parseAsync will handle the matching.
+const currentCmd = process.argv[2];
+const cmdMatch = commands.find(c => c[0] === currentCmd);
+
+// Commands that don't modify data — skip migrations for speed
+const readOnlyCommands = new Set([
+  'whoami', 'status', 'list', 'log', 'completion', 'nearby',
+  'protocol', 'pin', 'favorite', 'search', 'workspace',
+]);
+const isVersionOrHelp = !currentCmd || currentCmd === '--help' || currentCmd === '-h'
+  || currentCmd === '--version' || currentCmd === '-V';
+const needsMigrations = cmdMatch && !readOnlyCommands.has(cmdMatch[0]) && !isVersionOrHelp;
+
+if (cmdMatch) {
+  if (needsMigrations) await runMigrations();
+  const register = await lazy(cmdMatch[1]);
+  await register(program);
+} else if (isVersionOrHelp) {
+  // Help/version — load all commands for full help text, skip migrations
+  await Promise.all(commands.map(c => lazy(c[1])(program)));
+} else {
+  // Unknown command — load all for Commander to handle
+  await runMigrations();
+  await Promise.all(commands.map(c => lazy(c[1])(program)));
+}
+
+// Grouped help text
+program.addHelpText('after', `
+${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('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
+  ${chalk.yellow('Social:')}       pal, invite, nearby, group, chat, comment
+  ${chalk.yellow('Search:')}       search (files, pals, groups)
+  ${chalk.yellow('Network:')}      network create/list/info/invite/join/members/groups/connect/disconnect
+  ${chalk.yellow('Workspace:')}    workspace list/create/delete/add/remove
+  ${chalk.yellow('Management:')}   transfers, config, device, server, explorer, vfs, web, schedule, favorite
+  ${chalk.yellow('Protocol:')}     protocol info/policy/route/envelope/keys
+  ${chalk.yellow('PIN:')}          pin set/remove/status
+  ${chalk.yellow('Billing:')}      billing status/plans/activate/deactivate/checkout
+  ${chalk.yellow('Pro:')}          backup, api-keys
+  ${chalk.yellow('Streaming:')}    stream local/remote/stop/status/broadcast/join/transport
+  ${chalk.yellow('Extensions:')}   ext list/install/remove/enable/disable/info/config/create
+  ${chalk.yellow('Orgs:')}         org create/list/info/invite/remove/subscribe/unsubscribe/billing
+  ${chalk.yellow('Utilities:')}    status, log, completion, gui-share, uninstall
+
+${chalk.gray('Aliases: pe connect → pe network connect, pe disconnect → pe network disconnect')}
+`);
+
+// Load extensions and emit lifecycle hooks
+let extensionsLoaded = false;
+if (!isVersionOrHelp) {
+  try {
+    const { loadAllExtensions, hooks, ensureDefaultExtensions } = await import('../lib/core/extensions.js');
+    ensureDefaultExtensions();
+    await loadAllExtensions();
+    extensionsLoaded = true;
+
+    // Clean stale transfers (0% for >24h)
+    const { cleanStaleTransfers } = await import('../lib/core/transfers.js');
+    const cleaned = cleanStaleTransfers(24);
+    if (cleaned > 0) console.log(`[transfers] Cleaned ${cleaned} stale transfer(s)`);
+
+    const identity = (await import('../lib/utils/config.js')).default.get('identity');
+    await hooks.emit('on:app:ready', {
+      version: program.version(),
+      identity: identity ? { handle: identity.handle, publicKey: identity.publicKey } : null,
+      mode: 'cli',
+    });
+
+    const shutdown = async () => {
+      await hooks.emit('on:app:shutdown', {});
+      process.exit(process.exitCode || 0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+  } catch (err) {
+    // Extension loading is non-fatal
+    logger.warn?.(`Extension loading failed: ${err.message}`) || console.warn(`[extensions] ${err.message}`);
+  }
+}
+
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+} else {
+  try {
+    await program.parseAsync(process.argv);
+  } catch (err) {
+    if (err.code !== 'commander.helpDisplayed' && err.code !== 'commander.unknownCommand') {
+      console.error(chalk.red(`Error: ${err.message}`));
+    }
+  }
+}
+
+// keytar's native D-Bus handles block the event loop on headless Linux
+const longRunning = new Set(['serve', 'nearby', 'stream']);
+if (!longRunning.has(currentCmd)) {
+  process.exit(process.exitCode || 0);
+}

package/extensions/@palexplorer/analytics/extension.json

@@ -17,7 +17,7 @@
   ],
   "permissions": ["config:read", "config:write", "net:http"],
   "config": {
-    "enabled": { "type": "boolean", "default": true, "description": "Enable anonymous usage analytics" },
+    "enabled": { "type": "boolean", "default": true, "description": "Enable anonymous usage analytics (PostHog)" },
     "posthogKey": { "type": "string", "default": "phc_PSslPgpRuFzQf6s5qbN9atXFGUDHzCvMlmpBTtdTkte", "description": "PostHog project API key (leave empty for default)" },
     "posthogHost": { "type": "string", "default": "https://us.i.posthog.com", "description": "PostHog ingestion host" },
     "sessionTracking": { "type": "boolean", "default": true, "description": "Track session duration" }

package/extensions/@palexplorer/discovery/extension.json

@@ -8,6 +8,7 @@
   "hooks": ["on:app:ready"],
   "permissions": ["config:read", "config:write", "identity:read"],
   "config": {
+    "enabled": { "type": "boolean", "default": true, "description": "Enable discovery server integration" },
     "bootstrapServers": { "type": "array", "default": ["https://discovery-1.palexplorer.com", "https://discovery-2.palexplorer.com"], "description": "Bootstrap discovery server URLs" },
     "refreshInterval": { "type": "number", "default": 1800000, "description": "Server list refresh interval in ms (default: 30 min)" },
     "enableGossip": { "type": "boolean", "default": true, "description": "Exchange server lists with connected peers" }

package/extensions/@palexplorer/explorer-integration/extension.json

@@ -8,6 +8,6 @@
   "hooks": [],
   "permissions": ["fs:write"],
   "config": {},
-  "tier": "free",
+  "tier": "pro",
   "minAppVersion": "0.5.0"
 }

package/extensions/@palexplorer/networks/extension.json

@@ -13,5 +13,5 @@
     ]
   },
   "config": { "enabled": { "type": "boolean", "default": false } },
-  "tier": "free"
+  "tier": "enterprise"
 }

package/extensions/@palexplorer/vfs/extension.json

@@ -12,6 +12,6 @@
     "driveLetter": { "type": "string", "default": "P", "description": "Windows drive letter" },
     "autoMount": { "type": "boolean", "default": true, "description": "Auto-mount on startup" }
   },
-  "tier": "free",
+  "tier": "pro",
   "minAppVersion": "0.5.0"
 }