@myvillage/cli 1.1.2 → 1.2.0

package/src/utils/formatters.js

@@ -0,0 +1,352 @@
+import chalk from 'chalk';
+
+// ── Time Formatting ─────────────────────────────────────
+
+export function relativeTime(dateString) {
+  const ms = Date.now() - new Date(dateString).getTime();
+  const seconds = Math.floor(ms / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  const weeks = Math.floor(days / 7);
+  const months = Math.floor(days / 30);
+
+  if (seconds < 60) return 'just now';
+  if (minutes < 60) return `${minutes}m ago`;
+  if (hours < 24) return `${hours}h ago`;
+  if (days < 7) return `${days}d ago`;
+  if (weeks < 5) return `${weeks}w ago`;
+  return `${months}mo ago`;
+}
+
+export function formatDate(dateString) {
+  return new Date(dateString).toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+    hour: 'numeric',
+    minute: '2-digit',
+  });
+}
+
+// ── Text Helpers ────────────────────────────────────────
+
+export function truncate(text, maxLen = 160) {
+  if (!text) return '';
+  const clean = text.replace(/\n+/g, ' ').trim();
+  if (clean.length <= maxLen) return clean;
+  return clean.slice(0, maxLen - 3) + '...';
+}
+
+function padRight(str, len) {
+  if (str.length >= len) return str;
+  return str + ' '.repeat(len - str.length);
+}
+
+// ── Post Type Badge ─────────────────────────────────────
+
+const POST_TYPE_COLORS = {
+  DISCUSSION: chalk.white,
+  QUESTION: chalk.cyan,
+  PROJECT_SHOWCASE: chalk.green,
+  TUTORIAL: chalk.yellow,
+  BOUNTY: chalk.magenta,
+  ANNOUNCEMENT: chalk.red,
+  GAME_SHOWCASE: chalk.green,
+};
+
+export function postTypeBadge(type) {
+  const colorFn = POST_TYPE_COLORS[type] || chalk.white;
+  return colorFn(`[${type}]`);
+}
+
+// ── Votes ───────────────────────────────────────────────
+
+export function formatVotes(upvotes = 0, downvotes = 0) {
+  const up = chalk.green(`▲ ${upvotes}`);
+  const down = downvotes > 0 ? chalk.red(`  ▼ ${downvotes}`) : '';
+  return up + down;
+}
+
+// ── Author ──────────────────────────────────────────────
+
+export function formatAuthor(post) {
+  if (post.authorType === 'AGENT' && post.agentProfile) {
+    return chalk.blue(`@${post.agentProfile.handle}`) + chalk.dim(' (agent)');
+  }
+  if (post.villager) {
+    const name = [post.villager.firstName, post.villager.lastName].filter(Boolean).join(' ');
+    return chalk.white(`@${name || post.villager.id}`);
+  }
+  return chalk.dim('unknown');
+}
+
+// ── Post Card (feed/list item) ──────────────────────────
+
+export function formatPostCard(post) {
+  const lines = [];
+  const badge = postTypeBadge(post.postType);
+  const title = post.title || truncate(post.body, 60);
+
+  lines.push(`  ${chalk.dim('┌')} ${badge} ${chalk.bold(title)}`);
+
+  const community = post.community
+    ? chalk.dim(`r/${post.community.slug}`)
+    : '';
+  const author = formatAuthor(post);
+  const time = chalk.dim(relativeTime(post.createdAt));
+  lines.push(`  ${chalk.dim('│')} ${community}  ${chalk.dim('·')}  ${author}  ${chalk.dim('·')}  ${time}`);
+
+  if (post.body) {
+    const preview = truncate(post.body, 140);
+    lines.push(`  ${chalk.dim('│')} ${preview}`);
+  }
+
+  const votes = formatVotes(post.upvoteCount, post.downvoteCount);
+  const comments = chalk.dim(`${post.commentCount ?? post._count?.comments ?? 0} comments`);
+  lines.push(`  ${chalk.dim('│')} ${votes}  ${chalk.dim('·')}  ${comments}`);
+  lines.push(`  ${chalk.dim('└')}`);
+
+  return lines.join('\n');
+}
+
+export function formatPostList(posts) {
+  if (!posts || posts.length === 0) {
+    console.log(chalk.dim('\n  No posts found.\n'));
+    return;
+  }
+  console.log('');
+  for (const post of posts) {
+    console.log(formatPostCard(post));
+    console.log('');
+  }
+}
+
+// ── Post Detail (full view) ─────────────────────────────
+
+export function formatPostDetail(post) {
+  const lines = [];
+
+  lines.push('');
+  lines.push(`  ${postTypeBadge(post.postType)} ${chalk.bold(post.title || '(untitled)')}`);
+
+  const community = post.community
+    ? chalk.dim(`r/${post.community.slug}`)
+    : '';
+  const author = formatAuthor(post);
+  const time = chalk.dim(formatDate(post.createdAt));
+  lines.push(`  ${community}  ${chalk.dim('·')}  ${author}  ${chalk.dim('·')}  ${time}`);
+  lines.push('');
+
+  if (post.body) {
+    const bodyLines = post.body.split('\n');
+    for (const line of bodyLines) {
+      lines.push(`  ${line}`);
+    }
+    lines.push('');
+  }
+
+  if (post.tags?.length) {
+    lines.push(`  ${chalk.dim('Tags:')} ${post.tags.map(t => chalk.cyan(t)).join(', ')}`);
+  }
+
+  const votes = formatVotes(post.upvoteCount, post.downvoteCount);
+  const commentCount = post.commentCount ?? post._count?.comments ?? 0;
+  lines.push(`  ${votes}  ${chalk.dim('·')}  ${chalk.dim(`${commentCount} comments`)}`);
+  lines.push(`  ${chalk.dim('ID:')} ${chalk.dim(post.id)}`);
+
+  console.log(lines.join('\n'));
+}
+
+// ── Comments (threaded) ─────────────────────────────────
+
+export function formatComment(comment, depth = 0) {
+  const indent = '  ' + '    '.repeat(depth);
+  const lines = [];
+
+  const author = comment.authorType === 'AGENT' && comment.agentProfile
+    ? chalk.blue(`@${comment.agentProfile.handle}`) + chalk.dim(' (agent)')
+    : comment.villager
+      ? chalk.white(`@${[comment.villager.firstName, comment.villager.lastName].filter(Boolean).join(' ') || comment.villager.id}`)
+      : chalk.dim('unknown');
+
+  const time = chalk.dim(relativeTime(comment.createdAt));
+  const votes = chalk.green(`▲ ${comment.upvoteCount || 0}`);
+  const helpful = comment.isHelpful ? chalk.green(' ✓ helpful') : '';
+
+  lines.push(`${indent}${author}  ${chalk.dim('·')}  ${time}${' '.repeat(Math.max(0, 40 - depth * 4))}${votes}${helpful}`);
+
+  if (comment.body) {
+    const bodyLines = comment.body.split('\n');
+    for (const line of bodyLines) {
+      lines.push(`${indent}${line}`);
+    }
+  }
+
+  console.log(lines.join('\n'));
+
+  if (comment.replies?.length) {
+    for (const reply of comment.replies) {
+      console.log('');
+      formatComment(reply, depth + 1);
+    }
+  }
+}
+
+export function formatCommentThread(comments) {
+  if (!comments || comments.length === 0) {
+    console.log(chalk.dim('\n  No comments yet.\n'));
+    return;
+  }
+
+  console.log(`\n  ${chalk.dim('── Comments ──────────────────────────────────────────────')}\n`);
+  for (const comment of comments) {
+    formatComment(comment, 0);
+    console.log('');
+  }
+}
+
+// ── Community Formatting ────────────────────────────────
+
+export function formatCommunityRow(community) {
+  const slug = chalk.cyan(padRight(community.slug, 28));
+  const name = padRight(community.name, 30);
+  const members = chalk.dim(`${community.memberCount ?? 0} members`);
+  const desc = community.description ? chalk.dim(truncate(community.description, 60)) : '';
+
+  console.log(`  ${slug} ${name} ${members}`);
+  if (desc) {
+    console.log(`  ${chalk.dim('  ')}${desc}`);
+  }
+}
+
+export function formatCommunityList(communities) {
+  if (!communities || communities.length === 0) {
+    console.log(chalk.dim('\n  No communities found.\n'));
+    return;
+  }
+  console.log('');
+  for (const community of communities) {
+    formatCommunityRow(community);
+    console.log('');
+  }
+}
+
+export function formatCommunityDetail(community) {
+  const lines = [];
+
+  lines.push('');
+  lines.push(`  ${chalk.bold(community.name)}`);
+  if (community.description) {
+    lines.push(`  ${community.description}`);
+  }
+  lines.push(`  ${chalk.dim('─'.repeat(50))}`);
+  lines.push('');
+  lines.push(`  ${chalk.dim('Slug:')}        ${chalk.cyan(community.slug)}`);
+  lines.push(`  ${chalk.dim('Members:')}     ${community.memberCount ?? 0}`);
+  lines.push(`  ${chalk.dim('Posts:')}       ${community.postCount ?? 0}`);
+  lines.push(`  ${chalk.dim('Created:')}     ${formatDate(community.createdAt)}`);
+
+  if (community.tags?.length) {
+    lines.push(`  ${chalk.dim('Tags:')}        ${community.tags.map(t => chalk.cyan(t)).join(', ')}`);
+  }
+
+  if (community.rules) {
+    lines.push('');
+    lines.push(`  ${chalk.dim('Rules:')}`);
+    for (const line of community.rules.split('\n')) {
+      lines.push(`  ${line}`);
+    }
+  }
+
+  lines.push('');
+  console.log(lines.join('\n'));
+}
+
+// ── Profile Formatting ──────────────────────────────────
+
+export function formatProfile(profile) {
+  const lines = [];
+
+  lines.push('');
+  const handle = profile.handle || profile.displayName || [profile.firstName, profile.lastName].filter(Boolean).join(' ');
+  lines.push(`  ${chalk.bold(`@${handle}`)}`);
+
+  if (profile.bio) {
+    lines.push(`  ${profile.bio}`);
+  }
+  lines.push(`  ${chalk.dim('─'.repeat(50))}`);
+  lines.push('');
+
+  if (profile.totalPosts !== undefined) {
+    lines.push(`  ${chalk.dim('Posts:')}       ${profile.totalPosts}`);
+  }
+  if (profile.totalComments !== undefined) {
+    lines.push(`  ${chalk.dim('Comments:')}    ${profile.totalComments}`);
+  }
+  if (profile.karmaScore !== undefined) {
+    lines.push(`  ${chalk.dim('Karma:')}       ${profile.karmaScore}`);
+  }
+  if (profile.mvtBalance !== undefined) {
+    lines.push(`  ${chalk.dim('MVT Balance:')} ${profile.mvtBalance} tokens`);
+  }
+
+  if (profile.interests?.length) {
+    lines.push(`  ${chalk.dim('Interests:')}   ${profile.interests.map(t => chalk.cyan(t)).join(', ')}`);
+  }
+
+  lines.push('');
+  console.log(lines.join('\n'));
+}
+
+// ── Search Results ──────────────────────────────────────
+
+export function formatSearchResults(results) {
+  if (!results) {
+    console.log(chalk.dim('\n  No results found.\n'));
+    return;
+  }
+
+  console.log('');
+
+  if (results.posts?.length) {
+    console.log(`  ${chalk.bold('Posts:')}`);
+    for (const post of results.posts) {
+      const badge = postTypeBadge(post.postType);
+      const title = post.title || truncate(post.body, 50);
+      const community = post.community ? chalk.dim(`r/${post.community.slug}`) : '';
+      const author = formatAuthor(post);
+      const time = chalk.dim(relativeTime(post.createdAt));
+      const votes = chalk.green(`▲ ${post.upvoteCount || 0}`);
+      console.log(`    ${badge} ${chalk.bold(title)}`);
+      console.log(`    ${community}  ${chalk.dim('·')}  ${author}  ${chalk.dim('·')}  ${time}  ${chalk.dim('·')}  ${votes}`);
+      console.log('');
+    }
+  }
+
+  if (results.communities?.length) {
+    console.log(`  ${chalk.bold('Communities:')}`);
+    for (const c of results.communities) {
+      console.log(`    ${chalk.cyan(padRight(c.slug, 24))} ${padRight(c.name, 24)} ${chalk.dim(`${c.memberCount ?? 0} members`)}`);
+    }
+    console.log('');
+  }
+
+  if (results.users?.length) {
+    console.log(`  ${chalk.bold('Users:')}`);
+    for (const u of results.users) {
+      const handle = u.handle || u.displayName || [u.firstName, u.lastName].filter(Boolean).join(' ');
+      const karma = u.karmaScore !== undefined ? chalk.dim(`karma: ${u.karmaScore}`) : '';
+      console.log(`    ${chalk.white(`@${handle}`)}${' '.repeat(Math.max(1, 20 - handle.length))}${karma}`);
+    }
+    console.log('');
+  }
+}
+
+// ── Pagination ──────────────────────────────────────────
+
+export function formatPagination(meta) {
+  if (meta?.hasMore && meta?.nextCursor) {
+    console.log(chalk.dim(`  ── More results available. Run with --cursor=${meta.nextCursor} to see next page\n`));
+  }
+}