@paylobster/cli 4.6.0 → 4.6.1

package/src/commands/init.ts

@@ -0,0 +1,256 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+
+const CONFIG_DIR = path.join(process.env.HOME || '~', '.paylobster');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials');
+
+function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function selectPrompt(question: string, options: { label: string; value: string }[]): Promise<string> {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    console.log(chalk.bold.white(`\n  ${question}\n`));
+    options.forEach((opt, i) => {
+      console.log(chalk.cyan(`    ${i + 1}) `) + chalk.white(opt.label));
+    });
+    console.log();
+
+    rl.question(chalk.gray('  Enter choice (number): '), (answer) => {
+      rl.close();
+      const idx = parseInt(answer.trim(), 10) - 1;
+      if (idx >= 0 && idx < options.length) {
+        resolve(options[idx].value);
+      } else {
+        // Default to first option
+        resolve(options[0].value);
+      }
+    });
+  });
+}
+
+function generateApiKey(): string {
+  const bytes = crypto.randomBytes(24);
+  return `pl_live_${bytes.toString('base64url').slice(0, 32)}`;
+}
+
+function ensureConfigDir(): void {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+function openBrowser(url: string): void {
+  const platform = process.platform;
+  const cmd = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
+  try {
+    require('child_process').execSync(`${cmd} "${url}"`, { stdio: 'ignore' });
+  } catch {
+    console.log(chalk.gray(`  Open this URL in your browser: ${url}`));
+  }
+}
+
+export function createInitCommand(): Command {
+  const cmd = new Command('init')
+    .description('🦞 Interactive setup wizard — get started with Pay Lobster in 60 seconds')
+    .option('--wallet <address>', 'Pre-set wallet address')
+    .option('--role <role>', 'Pre-set role (developer, agent-operator, business)')
+    .option('--network <network>', 'Network to use (base, base-sepolia)', 'base')
+    .action(async (options) => {
+      // ─── Welcome Banner ───
+      console.log();
+      console.log(chalk.cyan('  ┌─────────────────────────────────────────┐'));
+      console.log(chalk.cyan('  │') + '                                         ' + chalk.cyan('│'));
+      console.log(chalk.cyan('  │') + chalk.bold.white('   🦞 Welcome to Pay Lobster!            ') + chalk.cyan('│'));
+      console.log(chalk.cyan('  │') + chalk.gray('   Payments made simple on Base           ') + chalk.cyan('│'));
+      console.log(chalk.cyan('  │') + '                                         ' + chalk.cyan('│'));
+      console.log(chalk.cyan('  └─────────────────────────────────────────┘'));
+      console.log();
+      console.log(chalk.gray('  Let\'s get you set up in under 60 seconds.\n'));
+
+      // ─── Step 1: Wallet Address ───
+      console.log(chalk.bold.blue('  Step 1 of 3') + chalk.gray(' — Connect your wallet\n'));
+
+      let walletAddress = options.wallet || '';
+
+      if (!walletAddress) {
+        const walletChoice = await selectPrompt('How would you like to connect?', [
+          { label: '📋 Enter an existing wallet address', value: 'enter' },
+          { label: '🌐 Create a Smart Wallet (opens browser)', value: 'create' },
+        ]);
+
+        if (walletChoice === 'create') {
+          const spinner = ora({
+            text: chalk.white('Opening Pay Lobster to create your wallet...'),
+            spinner: 'dots',
+          }).start();
+
+          openBrowser('https://paylobster.com/onboard?source=cli');
+
+          spinner.succeed(chalk.green('Browser opened!'));
+          console.log(chalk.gray('  Create your wallet with just a passkey — no seed phrase needed.\n'));
+
+          walletAddress = await prompt(chalk.white('  Paste your wallet address here: '));
+        } else {
+          walletAddress = await prompt(chalk.white('  Enter your wallet address (0x...): '));
+        }
+      }
+
+      // Validate address format
+      if (!walletAddress.match(/^0x[a-fA-F0-9]{40}$/)) {
+        if (walletAddress.length > 0) {
+          console.log(chalk.yellow('\n  ⚠ That doesn\'t look like a valid address, but we\'ll save it anyway.'));
+        } else {
+          walletAddress = '0x0000000000000000000000000000000000000000';
+          console.log(chalk.gray('\n  No address provided — you can set one later with: paylobster config set wallet <address>'));
+        }
+      } else {
+        console.log(chalk.green(`\n  ✓ Wallet: ${walletAddress.slice(0, 6)}...${walletAddress.slice(-4)}\n`));
+      }
+
+      // ─── Step 2: Role ───
+      console.log(chalk.bold.blue('  Step 2 of 3') + chalk.gray(' — Tell us about yourself\n'));
+
+      let role = options.role || '';
+
+      if (!role) {
+        role = await selectPrompt('What best describes you?', [
+          { label: '💻 Developer — building with the SDK or API', value: 'developer' },
+          { label: '🤖 Agent operator — running AI agents', value: 'agent-operator' },
+          { label: '🏢 Business — accepting payments', value: 'business' },
+        ]);
+      }
+
+      const roleLabels: Record<string, string> = {
+        'developer': '💻 Developer',
+        'agent-operator': '🤖 Agent Operator',
+        'business': '🏢 Business',
+      };
+
+      console.log(chalk.green(`\n  ✓ Role: ${roleLabels[role] || role}\n`));
+
+      // ─── Step 3: Generate API Key & Save Config ───
+      console.log(chalk.bold.blue('  Step 3 of 3') + chalk.gray(' — Setting up your environment\n'));
+
+      const spinner = ora({
+        text: chalk.white('Generating your API key...'),
+        spinner: 'dots',
+      }).start();
+
+      // Simulate a brief delay for UX
+      await new Promise((r) => setTimeout(r, 800));
+
+      const apiKey = generateApiKey();
+      const network = options.network || 'base';
+
+      // Save config
+      ensureConfigDir();
+
+      const config = {
+        version: 1,
+        wallet: walletAddress,
+        role,
+        network,
+        createdAt: new Date().toISOString(),
+        defaults: {
+          currency: 'USDC',
+          confirmations: 1,
+          ...(role === 'developer' ? { testnet: true, network: 'base-sepolia' } : {}),
+          ...(role === 'agent-operator' ? { autoApprove: false, maxEscrow: '100' } : {}),
+          ...(role === 'business' ? { webhookUrl: '', autoSettle: true } : {}),
+        },
+      };
+
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+
+      // Save credentials
+      const credentials = [
+        `# Pay Lobster credentials`,
+        `# Generated: ${new Date().toISOString()}`,
+        `PAYLOBSTER_API_KEY=${apiKey}`,
+        `PAYLOBSTER_WALLET=${walletAddress}`,
+        `PAYLOBSTER_NETWORK=${network}`,
+      ].join('\n');
+
+      fs.writeFileSync(CREDENTIALS_FILE, credentials, 'utf-8');
+      fs.chmodSync(CREDENTIALS_FILE, 0o600);
+
+      spinner.succeed(chalk.green('All set!'));
+
+      // ─── Summary ───
+      console.log();
+      console.log(chalk.cyan('  ┌─────────────────────────────────────────┐'));
+      console.log(chalk.cyan('  │') + chalk.bold.white('   ✅ You\'re ready to go!                 ') + chalk.cyan('│'));
+      console.log(chalk.cyan('  └─────────────────────────────────────────┘'));
+      console.log();
+      console.log(chalk.white('  Config saved to:      ') + chalk.gray(CONFIG_FILE));
+      console.log(chalk.white('  API key saved to:     ') + chalk.gray(CREDENTIALS_FILE));
+      console.log(chalk.white('  API key:              ') + chalk.yellow(apiKey.slice(0, 12) + '...' + apiKey.slice(-4)));
+      console.log();
+
+      // ─── Next Steps (role-specific) ───
+      console.log(chalk.bold.white('  🚀 Try your first command:\n'));
+
+      if (role === 'developer') {
+        console.log(chalk.gray('  # Create a test escrow'));
+        console.log(chalk.cyan('  paylobster escrow create --to 0x1234...abcd --amount 1 --desc "Test payment"'));
+        console.log();
+        console.log(chalk.gray('  # Check your reputation'));
+        console.log(chalk.cyan('  paylobster reputation check'));
+        console.log();
+        console.log(chalk.gray('  # View SDK docs'));
+        console.log(chalk.cyan('  paylobster docs --open'));
+      } else if (role === 'agent-operator') {
+        console.log(chalk.gray('  # Register your AI agent'));
+        console.log(chalk.cyan('  paylobster register --name "My Agent" --type ai-agent'));
+        console.log();
+        console.log(chalk.gray('  # Create an escrow payment'));
+        console.log(chalk.cyan('  paylobster escrow create --to 0x1234...abcd --amount 5 --desc "Agent task"'));
+        console.log();
+        console.log(chalk.gray('  # Set up MCP server'));
+        console.log(chalk.cyan('  paylobster quickstart --mcp'));
+      } else if (role === 'business') {
+        console.log(chalk.gray('  # Create a payment link'));
+        console.log(chalk.cyan('  paylobster pay create-link --amount 50 --desc "Invoice #001"'));
+        console.log();
+        console.log(chalk.gray('  # Check incoming payments'));
+        console.log(chalk.cyan('  paylobster dashboard'));
+        console.log();
+        console.log(chalk.gray('  # View your balance'));
+        console.log(chalk.cyan('  paylobster status'));
+      }
+
+      console.log();
+      console.log(chalk.gray('  ─────────────────────────────────────────'));
+      console.log(chalk.gray('  📖 Docs:     ') + chalk.blue('https://paylobster.com/docs'));
+      console.log(chalk.gray('  💬 Support:  ') + chalk.blue('https://paylobster.com/discord'));
+      console.log(chalk.gray('  🦞 Web app:  ') + chalk.blue('https://paylobster.com'));
+      console.log();
+    });
+
+  return cmd;
+}

package/src/commands/link.ts

@@ -0,0 +1,240 @@
+import { Command } from 'commander';
+import { success, error, info, withSpinner, outputJSON, formatAddress } from '../lib/display';
+import type { OutputOptions } from '../lib/types';
+
+const API_URL = process.env.PAYLOBSTER_API_URL || 'https://paylobster.com';
+
+interface PaymentLink {
+  id: string;
+  url: string;
+  shortUrl: string;
+  amount: string;
+  token: string;
+  memo: string;
+  recipient: string;
+  mode: 'direct' | 'escrow';
+  expiresAt: string | null;
+  createdAt: string;
+  paid?: boolean;
+  txHash?: string | null;
+}
+
+/**
+ * Payment links command
+ */
+export function createLinkCommand(): Command {
+  const cmd = new Command('link')
+    .description('Create and manage payment links');
+
+  // Create subcommand
+  cmd
+    .command('create')
+    .description('Create a payment link')
+    .requiredOption('--amount <amount>', 'Amount in tokens')
+    .requiredOption('--recipient <address>', 'Recipient address')
+    .option('--memo <text>', 'Payment memo/description')
+    .option('--token <symbol>', 'Token symbol', 'USDC')
+    .option('--mode <mode>', 'Payment mode: direct or escrow', 'direct')
+    .option('--expires-in <seconds>', 'Expiration time in seconds')
+    .option('--json', 'Output as JSON')
+    .action(async (options: {
+      amount: string;
+      recipient: string;
+      memo?: string;
+      token?: string;
+      mode?: string;
+      expiresIn?: string;
+    } & OutputOptions) => {
+      try {
+        // Validate recipient address
+        if (!options.recipient.startsWith('0x') || options.recipient.length !== 42) {
+          error('Invalid recipient address format');
+          process.exit(1);
+        }
+
+        // Validate amount
+        const amount = parseFloat(options.amount);
+        if (isNaN(amount) || amount <= 0) {
+          error('Invalid amount. Must be a positive number');
+          process.exit(1);
+        }
+
+        // Validate mode
+        if (options.mode && !['direct', 'escrow'].includes(options.mode)) {
+          error('Mode must be either "direct" or "escrow"');
+          process.exit(1);
+        }
+
+        const link = await withSpinner(
+          'Creating payment link...',
+          async () => {
+            const response = await fetch(`${API_URL}/api/v3/links`, {
+              method: 'POST',
+              headers: {
+                'Content-Type': 'application/json',
+              },
+              body: JSON.stringify({
+                amount: options.amount,
+                recipient: options.recipient,
+                memo: options.memo,
+                token: options.token,
+                mode: options.mode,
+                expiresIn: options.expiresIn ? parseInt(options.expiresIn) : undefined,
+              }),
+            });
+
+            if (!response.ok) {
+              const err = await response.json() as { error?: string };
+              throw new Error(err.error || 'Failed to create payment link');
+            }
+
+            return response.json() as Promise<PaymentLink>;
+          }
+        );
+
+        if (outputJSON(link, options)) {
+          return;
+        }
+
+        success('Payment link created!');
+        console.log();
+        console.log('  Link ID:    ', link.id);
+        console.log('  URL:        ', link.url);
+        console.log('  Amount:     ', link.amount, link.token);
+        console.log('  Recipient:  ', formatAddress(link.recipient));
+        console.log('  Mode:       ', link.mode);
+        if (link.memo) {
+          console.log('  Memo:       ', link.memo);
+        }
+        if (link.expiresAt) {
+          console.log('  Expires:    ', new Date(link.expiresAt).toLocaleString());
+        }
+        console.log();
+        info('Share this link with the payer!');
+      } catch (err) {
+        error(`Failed to create payment link: ${(err as Error).message}`);
+        process.exit(1);
+      }
+    });
+
+  // Get subcommand
+  cmd
+    .command('get <code>')
+    .description('Get payment link details')
+    .option('--json', 'Output as JSON')
+    .action(async (code: string, options: OutputOptions) => {
+      try {
+        const link = await withSpinner(
+          'Fetching payment link...',
+          async () => {
+            const response = await fetch(`${API_URL}/api/v3/links/${code}`, {
+              method: 'GET',
+              headers: {
+                'Content-Type': 'application/json',
+              },
+            });
+
+            if (!response.ok) {
+              const err = await response.json() as { error?: string };
+              throw new Error(err.error || 'Failed to fetch payment link');
+            }
+
+            return response.json() as Promise<PaymentLink & { expired?: boolean }>;
+          }
+        );
+
+        if (outputJSON(link, options)) {
+          return;
+        }
+
+        console.log();
+        console.log('Payment Link Details:');
+        console.log('  Link ID:    ', link.id);
+        console.log('  Amount:     ', link.amount, link.token);
+        console.log('  Recipient:  ', formatAddress(link.recipient));
+        console.log('  Mode:       ', link.mode);
+        console.log('  Status:     ', link.paid ? '✅ Paid' : link.expired ? '❌ Expired' : '⏳ Pending');
+        if (link.memo) {
+          console.log('  Memo:       ', link.memo);
+        }
+        if (link.txHash) {
+          console.log('  TX Hash:    ', link.txHash);
+        }
+        console.log('  Created:    ', new Date(link.createdAt).toLocaleString());
+        if (link.expiresAt) {
+          console.log('  Expires:    ', new Date(link.expiresAt).toLocaleString());
+        }
+        console.log();
+      } catch (err) {
+        error(`Failed to fetch payment link: ${(err as Error).message}`);
+        process.exit(1);
+      }
+    });
+
+  // List subcommand
+  cmd
+    .command('list <recipient>')
+    .description('List payment links for a recipient')
+    .option('--json', 'Output as JSON')
+    .action(async (recipient: string, options: OutputOptions) => {
+      try {
+        // Validate recipient address
+        if (!recipient.startsWith('0x') || recipient.length !== 42) {
+          error('Invalid recipient address format');
+          process.exit(1);
+        }
+
+        const result = await withSpinner(
+          'Fetching payment links...',
+          async () => {
+            const response = await fetch(
+              `${API_URL}/api/v3/links?recipient=${encodeURIComponent(recipient)}`,
+              {
+                method: 'GET',
+                headers: {
+                  'Content-Type': 'application/json',
+                },
+              }
+            );
+
+            if (!response.ok) {
+              const err = await response.json() as { error?: string };
+              throw new Error(err.error || 'Failed to fetch payment links');
+            }
+
+            return response.json() as Promise<{ links: PaymentLink[]; total: number }>;
+          }
+        );
+
+        if (outputJSON(result, options)) {
+          return;
+        }
+
+        if (result.links.length === 0) {
+          info('No payment links found for this recipient');
+          return;
+        }
+
+        console.log();
+        console.log(`Found ${result.total} payment link(s):`);
+        console.log();
+
+        for (const link of result.links) {
+          console.log(`  ${link.id}`);
+          console.log(`    Amount:  ${link.amount} ${link.token}`);
+          console.log(`    Status:  ${link.paid ? '✅ Paid' : '⏳ Pending'}`);
+          console.log(`    Mode:    ${link.mode}`);
+          if (link.memo) {
+            console.log(`    Memo:    ${link.memo}`);
+          }
+          console.log(`    Created: ${new Date(link.createdAt).toLocaleString()}`);
+          console.log();
+        }
+      } catch (err) {
+        error(`Failed to fetch payment links: ${(err as Error).message}`);
+        process.exit(1);
+      }
+    });
+
+  return cmd;
+}