@hasna/microservices 0.0.3 → 0.0.5

package/microservices/microservice-social/src/cli/index.ts

@@ -0,0 +1,689 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import {
+  createAccount,
+  getAccount,
+  listAccounts,
+  updateAccount,
+  deleteAccount,
+  createPost,
+  getPost,
+  listPosts,
+  updatePost,
+  deletePost,
+  schedulePost,
+  publishPost,
+  createTemplate,
+  listTemplates,
+  getTemplate,
+  deleteTemplate,
+  useTemplate,
+  getEngagementStats,
+  getStatsByPlatform,
+  getCalendar,
+  getOverallStats,
+  batchSchedule,
+  crossPost,
+  getBestTimeToPost,
+  reschedulePost,
+  submitPostForReview,
+  approvePost,
+  createRecurringPost,
+  getHashtagStats,
+  checkPlatformLimit,
+  PLATFORM_LIMITS,
+  type Platform,
+  type PostStatus,
+  type Recurrence,
+} from "../db/social.js";
+
+const program = new Command();
+
+program
+  .name("microservice-social")
+  .description("Social media management microservice")
+  .version("0.0.1");
+
+// --- Posts ---
+
+const postCmd = program
+  .command("post")
+  .description("Post management");
+
+postCmd
+  .command("create")
+  .description("Create a new post")
+  .requiredOption("--account <id>", "Account ID")
+  .requiredOption("--content <text>", "Post content")
+  .option("--media <urls>", "Comma-separated media URLs")
+  .option("--status <status>", "Post status (draft/scheduled/published/failed)", "draft")
+  .option("--scheduled-at <datetime>", "Schedule date/time")
+  .option("--tags <tags>", "Comma-separated tags")
+  .option("--recurring <recurrence>", "Recurrence (daily/weekly/biweekly/monthly)")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    // Check platform character limit
+    const warning = checkPlatformLimit(opts.content, opts.account);
+    if (warning) {
+      console.warn(`Warning: Content (${warning.content_length} chars) exceeds ${warning.platform} limit (${warning.limit} chars) by ${warning.over_by} chars`);
+    }
+
+    const post = createPost({
+      account_id: opts.account,
+      content: opts.content,
+      media_urls: opts.media ? opts.media.split(",").map((u: string) => u.trim()) : undefined,
+      status: opts.status as PostStatus,
+      scheduled_at: opts.scheduledAt,
+      tags: opts.tags ? opts.tags.split(",").map((t: string) => t.trim()) : undefined,
+      recurrence: opts.recurring as Recurrence | undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(post, null, 2));
+    } else {
+      console.log(`Created post: ${post.id} [${post.status}]`);
+      console.log(`  Content: ${post.content.substring(0, 80)}${post.content.length > 80 ? "..." : ""}`);
+    }
+  });
+
+postCmd
+  .command("list")
+  .description("List posts")
+  .option("--account <id>", "Filter by account ID")
+  .option("--status <status>", "Filter by status")
+  .option("--tag <tag>", "Filter by tag")
+  .option("--search <query>", "Search post content")
+  .option("--limit <n>", "Limit results")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const posts = listPosts({
+      account_id: opts.account,
+      status: opts.status as PostStatus | undefined,
+      tag: opts.tag,
+      search: opts.search,
+      limit: opts.limit ? parseInt(opts.limit) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(posts, null, 2));
+    } else {
+      if (posts.length === 0) {
+        console.log("No posts found.");
+        return;
+      }
+      for (const p of posts) {
+        const preview = p.content.substring(0, 60) + (p.content.length > 60 ? "..." : "");
+        const tags = p.tags.length ? ` [${p.tags.join(", ")}]` : "";
+        console.log(`  [${p.status}] ${preview}${tags}`);
+      }
+      console.log(`\n${posts.length} post(s)`);
+    }
+  });
+
+postCmd
+  .command("get")
+  .description("Get a post by ID")
+  .argument("<id>", "Post ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const post = getPost(id);
+    if (!post) {
+      console.error(`Post '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(post, null, 2));
+    } else {
+      console.log(`Post ${post.id} [${post.status}]`);
+      console.log(`  Content: ${post.content}`);
+      console.log(`  Account: ${post.account_id}`);
+      if (post.scheduled_at) console.log(`  Scheduled: ${post.scheduled_at}`);
+      if (post.published_at) console.log(`  Published: ${post.published_at}`);
+      if (post.tags.length) console.log(`  Tags: ${post.tags.join(", ")}`);
+      if (Object.keys(post.engagement).length) {
+        console.log(`  Engagement: ${JSON.stringify(post.engagement)}`);
+      }
+    }
+  });
+
+postCmd
+  .command("schedule")
+  .description("Schedule a post")
+  .argument("<id>", "Post ID")
+  .requiredOption("--at <datetime>", "Schedule date/time")
+  .option("--recurring <recurrence>", "Recurrence (daily/weekly/biweekly/monthly)")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    if (opts.recurring) {
+      const post = getPost(id);
+      if (!post) {
+        console.error(`Post '${id}' not found.`);
+        process.exit(1);
+      }
+      updatePost(id, { recurrence: opts.recurring as Recurrence });
+    }
+
+    const post = schedulePost(id, opts.at);
+    if (!post) {
+      console.error(`Post '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(post, null, 2));
+    } else {
+      console.log(`Scheduled post ${post.id} for ${post.scheduled_at}${post.recurrence ? ` (recurring: ${post.recurrence})` : ""}`);
+    }
+  });
+
+postCmd
+  .command("publish")
+  .description("Mark a post as published")
+  .argument("<id>", "Post ID")
+  .option("--platform-id <id>", "Platform post ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const post = publishPost(id, opts.platformId);
+    if (!post) {
+      console.error(`Post '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(post, null, 2));
+    } else {
+      console.log(`Published post ${post.id} at ${post.published_at}`);
+    }
+  });
+
+postCmd
+  .command("schedule-batch")
+  .description("Schedule multiple posts from a JSON file")
+  .requiredOption("--file <path>", "Path to JSON file with post array")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    let postsData;
+    try {
+      postsData = JSON.parse(readFileSync(opts.file, "utf-8"));
+    } catch (err) {
+      console.error(`Failed to read file: ${err instanceof Error ? err.message : String(err)}`);
+      process.exit(1);
+    }
+
+    if (!Array.isArray(postsData)) {
+      console.error("File must contain a JSON array of posts.");
+      process.exit(1);
+    }
+
+    const result = batchSchedule(postsData);
+
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Scheduled ${result.scheduled.length} post(s)`);
+      if (result.errors.length > 0) {
+        console.log(`Errors: ${result.errors.length}`);
+        for (const err of result.errors) {
+          console.log(`  [${err.index}] ${err.error}`);
+        }
+      }
+      if (result.warnings.length > 0) {
+        console.log("Warnings:");
+        for (const w of result.warnings) {
+          console.log(`  ${w.platform}: content (${w.content_length}) exceeds limit (${w.limit}) by ${w.over_by} chars`);
+        }
+      }
+    }
+  });
+
+postCmd
+  .command("crosspost")
+  .description("Create identical post on multiple platforms")
+  .requiredOption("--content <text>", "Post content")
+  .requiredOption("--platforms <list>", "Comma-separated platforms (x,linkedin,bluesky,...)")
+  .option("--tags <tags>", "Comma-separated tags")
+  .option("--scheduled-at <datetime>", "Schedule date/time")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const platforms = opts.platforms.split(",").map((p: string) => p.trim()) as Platform[];
+
+    try {
+      const result = crossPost(opts.content, platforms, {
+        tags: opts.tags ? opts.tags.split(",").map((t: string) => t.trim()) : undefined,
+        scheduled_at: opts.scheduledAt,
+      });
+
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Cross-posted to ${result.posts.length} platform(s):`);
+        for (const post of result.posts) {
+          const account = getAccount(post.account_id);
+          console.log(`  ${account?.platform || "?"} → ${post.id} [${post.status}]`);
+        }
+        if (result.warnings.length > 0) {
+          console.log("Warnings:");
+          for (const w of result.warnings) {
+            console.log(`  ${w.platform}: content (${w.content_length}) exceeds limit (${w.limit}) by ${w.over_by} chars`);
+          }
+        }
+      }
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+
+postCmd
+  .command("reschedule")
+  .description("Reschedule a post to a new date/time")
+  .argument("<id>", "Post ID")
+  .requiredOption("--to <datetime>", "New schedule date/time")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    try {
+      const post = reschedulePost(id, opts.to);
+      if (!post) {
+        console.error(`Post '${id}' not found.`);
+        process.exit(1);
+      }
+
+      if (opts.json) {
+        console.log(JSON.stringify(post, null, 2));
+      } else {
+        console.log(`Rescheduled post ${post.id} to ${post.scheduled_at}`);
+      }
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+
+postCmd
+  .command("submit")
+  .description("Submit a draft post for review")
+  .argument("<id>", "Post ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    try {
+      const post = submitPostForReview(id);
+      if (!post) {
+        console.error(`Post '${id}' not found.`);
+        process.exit(1);
+      }
+
+      if (opts.json) {
+        console.log(JSON.stringify(post, null, 2));
+      } else {
+        console.log(`Post ${post.id} submitted for review [${post.status}]`);
+      }
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+
+postCmd
+  .command("approve")
+  .description("Approve a post pending review")
+  .argument("<id>", "Post ID")
+  .option("--at <datetime>", "Schedule date/time for approved post")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    try {
+      const post = approvePost(id, opts.at);
+      if (!post) {
+        console.error(`Post '${id}' not found.`);
+        process.exit(1);
+      }
+
+      if (opts.json) {
+        console.log(JSON.stringify(post, null, 2));
+      } else {
+        console.log(`Post ${post.id} approved and scheduled for ${post.scheduled_at}`);
+      }
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+
+postCmd
+  .command("delete")
+  .description("Delete a post")
+  .argument("<id>", "Post ID")
+  .action((id) => {
+    const deleted = deletePost(id);
+    if (deleted) {
+      console.log(`Deleted post ${id}`);
+    } else {
+      console.error(`Post '${id}' not found.`);
+      process.exit(1);
+    }
+  });
+
+// --- Accounts ---
+
+const accountCmd = program
+  .command("account")
+  .description("Account management");
+
+accountCmd
+  .command("add")
+  .description("Add a social media account")
+  .requiredOption("--platform <platform>", "Platform (x/linkedin/instagram/threads/bluesky)")
+  .requiredOption("--handle <handle>", "Account handle")
+  .option("--display-name <name>", "Display name")
+  .option("--connected", "Mark as connected", false)
+  .option("--token-env <var>", "Environment variable for access token")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const account = createAccount({
+      platform: opts.platform as Platform,
+      handle: opts.handle,
+      display_name: opts.displayName,
+      connected: opts.connected,
+      access_token_env: opts.tokenEnv,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(account, null, 2));
+    } else {
+      console.log(`Added account: @${account.handle} on ${account.platform} (${account.id})`);
+    }
+  });
+
+accountCmd
+  .command("list")
+  .description("List accounts")
+  .option("--platform <platform>", "Filter by platform")
+  .option("--connected", "Show only connected accounts")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const accounts = listAccounts({
+      platform: opts.platform as Platform | undefined,
+      connected: opts.connected ? true : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(accounts, null, 2));
+    } else {
+      if (accounts.length === 0) {
+        console.log("No accounts found.");
+        return;
+      }
+      for (const a of accounts) {
+        const connected = a.connected ? " (connected)" : "";
+        const name = a.display_name ? ` - ${a.display_name}` : "";
+        console.log(`  [${a.platform}] @${a.handle}${name}${connected}`);
+      }
+      console.log(`\n${accounts.length} account(s)`);
+    }
+  });
+
+accountCmd
+  .command("remove")
+  .description("Remove an account")
+  .argument("<id>", "Account ID")
+  .action((id) => {
+    const deleted = deleteAccount(id);
+    if (deleted) {
+      console.log(`Removed account ${id}`);
+    } else {
+      console.error(`Account '${id}' not found.`);
+      process.exit(1);
+    }
+  });
+
+// --- Calendar ---
+
+program
+  .command("calendar")
+  .description("View scheduled posts by date")
+  .option("--start <date>", "Start date (YYYY-MM-DD)")
+  .option("--end <date>", "End date (YYYY-MM-DD)")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const calendar = getCalendar(opts.start, opts.end);
+
+    if (opts.json) {
+      console.log(JSON.stringify(calendar, null, 2));
+    } else {
+      const dates = Object.keys(calendar).sort();
+      if (dates.length === 0) {
+        console.log("No scheduled posts.");
+        return;
+      }
+      for (const date of dates) {
+        console.log(`\n${date}:`);
+        for (const post of calendar[date]) {
+          const preview = post.content.substring(0, 50) + (post.content.length > 50 ? "..." : "");
+          console.log(`  ${post.scheduled_at} — ${preview}`);
+        }
+      }
+    }
+  });
+
+// --- Analytics ---
+
+const analyticsCmd = program
+  .command("analytics")
+  .description("Engagement analytics");
+
+analyticsCmd
+  .command("engagement")
+  .description("View engagement analytics")
+  .option("--account <id>", "Filter by account ID")
+  .option("--by-platform", "Group by platform")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    if (opts.byPlatform) {
+      const stats = getStatsByPlatform();
+
+      if (opts.json) {
+        console.log(JSON.stringify(stats, null, 2));
+      } else {
+        if (stats.length === 0) {
+          console.log("No platform data.");
+          return;
+        }
+        for (const s of stats) {
+          console.log(`\n${s.platform} (${s.account_count} account(s), ${s.post_count} post(s)):`);
+          console.log(`  Published: ${s.engagement.total_posts}`);
+          console.log(`  Likes: ${s.engagement.total_likes} (avg ${s.engagement.avg_likes})`);
+          console.log(`  Shares: ${s.engagement.total_shares} (avg ${s.engagement.avg_shares})`);
+          console.log(`  Comments: ${s.engagement.total_comments} (avg ${s.engagement.avg_comments})`);
+          console.log(`  Impressions: ${s.engagement.total_impressions} (avg ${s.engagement.avg_impressions})`);
+        }
+      }
+    } else {
+      const stats = getEngagementStats(opts.account);
+
+      if (opts.json) {
+        console.log(JSON.stringify(stats, null, 2));
+      } else {
+        console.log("Engagement Analytics:");
+        console.log(`  Published posts: ${stats.total_posts}`);
+        console.log(`  Total likes: ${stats.total_likes} (avg ${stats.avg_likes})`);
+        console.log(`  Total shares: ${stats.total_shares} (avg ${stats.avg_shares})`);
+        console.log(`  Total comments: ${stats.total_comments} (avg ${stats.avg_comments})`);
+        console.log(`  Total impressions: ${stats.total_impressions} (avg ${stats.avg_impressions})`);
+        console.log(`  Total clicks: ${stats.total_clicks} (avg ${stats.avg_clicks})`);
+      }
+    }
+  });
+
+analyticsCmd
+  .command("best-time")
+  .description("Find best time to post based on historical engagement")
+  .requiredOption("--account <id>", "Account ID")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const result = getBestTimeToPost(opts.account);
+
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      if (result.total_analyzed === 0) {
+        console.log("No published posts to analyze.");
+        return;
+      }
+      console.log(`Analyzed ${result.total_analyzed} published post(s)\n`);
+
+      if (result.best_hours.length > 0) {
+        console.log("Best hours to post:");
+        for (const slot of result.best_hours.slice(0, 5)) {
+          console.log(`  ${slot.day_name} ${slot.hour}:00 — avg engagement: ${slot.avg_engagement} (${slot.post_count} posts)`);
+        }
+      }
+
+      if (result.best_days.length > 0) {
+        console.log("\nBest days to post:");
+        for (const day of result.best_days) {
+          console.log(`  ${day.day_name} — avg engagement: ${day.avg_engagement} (${day.post_count} posts)`);
+        }
+      }
+    }
+  });
+
+analyticsCmd
+  .command("hashtags")
+  .description("Hashtag performance analytics")
+  .requiredOption("--account <id>", "Account ID")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const stats = getHashtagStats(opts.account);
+
+    if (opts.json) {
+      console.log(JSON.stringify(stats, null, 2));
+    } else {
+      if (stats.length === 0) {
+        console.log("No hashtags found in published posts.");
+        return;
+      }
+      console.log("Hashtag Analytics:");
+      for (const h of stats) {
+        console.log(`  #${h.hashtag} — ${h.post_count} post(s), avg engagement: ${h.avg_engagement}`);
+        console.log(`    likes: ${h.total_likes}, shares: ${h.total_shares}, comments: ${h.total_comments}`);
+      }
+    }
+  });
+
+// --- Templates ---
+
+const templateCmd = program
+  .command("template")
+  .description("Post template management");
+
+templateCmd
+  .command("create")
+  .description("Create a post template")
+  .requiredOption("--name <name>", "Template name")
+  .requiredOption("--content <content>", "Template content (use {{var}} for variables)")
+  .option("--variables <vars>", "Comma-separated variable names")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const template = createTemplate({
+      name: opts.name,
+      content: opts.content,
+      variables: opts.variables ? opts.variables.split(",").map((v: string) => v.trim()) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(template, null, 2));
+    } else {
+      console.log(`Created template: ${template.name} (${template.id})`);
+    }
+  });
+
+templateCmd
+  .command("list")
+  .description("List templates")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const templates = listTemplates();
+
+    if (opts.json) {
+      console.log(JSON.stringify(templates, null, 2));
+    } else {
+      if (templates.length === 0) {
+        console.log("No templates found.");
+        return;
+      }
+      for (const t of templates) {
+        const vars = t.variables.length ? ` (vars: ${t.variables.join(", ")})` : "";
+        console.log(`  ${t.name}${vars}`);
+      }
+      console.log(`\n${templates.length} template(s)`);
+    }
+  });
+
+templateCmd
+  .command("use")
+  .description("Create a post from a template")
+  .argument("<template-id>", "Template ID")
+  .requiredOption("--account <id>", "Account ID")
+  .option("--values <json>", "JSON object of variable values")
+  .option("--tags <tags>", "Comma-separated tags")
+  .option("--json", "Output as JSON", false)
+  .action((templateId, opts) => {
+    const values = opts.values ? JSON.parse(opts.values) : {};
+    const tags = opts.tags ? opts.tags.split(",").map((t: string) => t.trim()) : undefined;
+
+    const post = useTemplate(templateId, opts.account, values, tags);
+
+    if (opts.json) {
+      console.log(JSON.stringify(post, null, 2));
+    } else {
+      console.log(`Created post from template: ${post.id}`);
+      console.log(`  Content: ${post.content.substring(0, 80)}${post.content.length > 80 ? "..." : ""}`);
+    }
+  });
+
+templateCmd
+  .command("delete")
+  .description("Delete a template")
+  .argument("<id>", "Template ID")
+  .action((id) => {
+    const deleted = deleteTemplate(id);
+    if (deleted) {
+      console.log(`Deleted template ${id}`);
+    } else {
+      console.error(`Template '${id}' not found.`);
+      process.exit(1);
+    }
+  });
+
+// --- Stats ---
+
+program
+  .command("stats")
+  .description("Overall statistics")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const stats = getOverallStats();
+
+    if (opts.json) {
+      console.log(JSON.stringify(stats, null, 2));
+    } else {
+      console.log("Social Media Stats:");
+      console.log(`  Accounts: ${stats.total_accounts}`);
+      console.log(`  Posts: ${stats.total_posts}`);
+      if (Object.keys(stats.posts_by_status).length) {
+        for (const [status, count] of Object.entries(stats.posts_by_status)) {
+          console.log(`    ${status}: ${count}`);
+        }
+      }
+      console.log(`  Templates: ${stats.total_templates}`);
+      console.log(`  Published engagement:`);
+      console.log(`    Likes: ${stats.engagement.total_likes}`);
+      console.log(`    Shares: ${stats.engagement.total_shares}`);
+      console.log(`    Comments: ${stats.engagement.total_comments}`);
+      console.log(`    Impressions: ${stats.engagement.total_impressions}`);
+    }
+  });
+
+program.parse(process.argv);