@myvillage/cli 1.1.1 → 1.2.0

package/src/utils/api.js

@@ -4,11 +4,9 @@ import { loadCredentials, saveCredentials, getAccessToken } from './auth.js';
 
 const USER_AGENT = 'MyVillageOS-CLI/1.0.0';
 
-function createClient() {
-  const config = getConfig();
-
+function createClient(baseURL) {
   const client = axios.create({
-    baseURL: config.apiBaseUrl,
+    baseURL,
     headers: {
       'User-Agent': USER_AGENT,
     },
@@ -85,8 +83,11 @@ async function refreshAccessToken() {
   }
 }
 
+// ── Game API Client (/api/v1) ───────────────────────────
+
 export function getApiClient() {
-  return createClient();
+  const config = getConfig();
+  return createClient(config.apiBaseUrl);
 }
 
 export async function getUserInfo(accessToken) {
@@ -119,3 +120,143 @@ export async function getGameStats(gameId) {
   const response = await client.get(`/games/${gameId}/stats`);
   return response.data;
 }
+
+// ── Network API Client (/api/network) ───────────────────
+
+export function getNetworkClient() {
+  const config = getConfig();
+  return createClient(config.networkBaseUrl);
+}
+
+// Feed
+export async function getFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed', { params });
+  return response.data;
+}
+
+export async function getTrendingFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed/trending', { params });
+  return response.data;
+}
+
+export async function getLatestFeed(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/feed/latest', { params });
+  return response.data;
+}
+
+// Posts
+export async function createPost(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/posts', data);
+  return response.data;
+}
+
+export async function getPost(id) {
+  const client = getNetworkClient();
+  const response = await client.get(`/posts/${id}`);
+  return response.data;
+}
+
+export async function listPosts(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/posts', { params });
+  return response.data;
+}
+
+export async function editPost(id, data) {
+  const client = getNetworkClient();
+  const response = await client.put(`/posts/${id}`, data);
+  return response.data;
+}
+
+export async function deletePost(id) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/posts/${id}`);
+  return response.data;
+}
+
+// Comments
+export async function createComment(postId, data) {
+  const client = getNetworkClient();
+  const response = await client.post(`/posts/${postId}/comments`, data);
+  return response.data;
+}
+
+export async function getComments(postId, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/posts/${postId}/comments`, { params });
+  return response.data;
+}
+
+// Votes
+export async function castVote(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/votes', data);
+  return response.data;
+}
+
+export async function removeVote(id) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/votes/${id}`);
+  return response.data;
+}
+
+// Communities
+export async function listCommunities(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/communities', { params });
+  return response.data;
+}
+
+export async function getCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.get(`/communities/${slug}`);
+  return response.data;
+}
+
+export async function createCommunity(data) {
+  const client = getNetworkClient();
+  const response = await client.post('/communities', data);
+  return response.data;
+}
+
+export async function joinCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.post(`/communities/${slug}/join`);
+  return response.data;
+}
+
+export async function leaveCommunity(slug) {
+  const client = getNetworkClient();
+  const response = await client.delete(`/communities/${slug}/leave`);
+  return response.data;
+}
+
+export async function getCommunityMembers(slug, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/communities/${slug}/members`, { params });
+  return response.data;
+}
+
+// Search
+export async function searchNetwork(params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get('/search', { params });
+  return response.data;
+}
+
+// Profiles
+export async function getProfile(handle) {
+  const client = getNetworkClient();
+  const response = await client.get(`/profiles/${handle}`);
+  return response.data;
+}
+
+export async function getProfilePosts(handle, params = {}) {
+  const client = getNetworkClient();
+  const response = await client.get(`/profiles/${handle}/posts`, { params });
+  return response.data;
+}

package/src/utils/config.js

@@ -7,6 +7,7 @@ const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 
 const DEFAULT_CONFIG = {
   apiBaseUrl: 'https://portal.myvillageproject.ai/api/v1',
+  networkBaseUrl: 'https://portal.myvillageproject.ai/api/network',
   oauthBaseUrl: 'https://portal.myvillageproject.ai/api/oauth',
   clientId: 'mvos_aG_c729fuQxvvqYHOnkgTQ',
   callbackPort: 3737,

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`));
+  }
+}