@hasna/microservices 0.0.16 → 0.0.18

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

@@ -1,605 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import {
-  createCampaign,
-  getCampaign,
-  listCampaigns,
-  updateCampaign,
-  deleteCampaign,
-  pauseCampaign,
-  resumeCampaign,
-  getCampaignStats,
-  getSpendByPlatform,
-  getPlatforms,
-  bulkPause,
-  bulkResume,
-  getRankedCampaigns,
-  checkBudgetStatus,
-  comparePlatforms,
-  exportCampaigns,
-  cloneCampaign,
-  getBudgetRemaining,
-  getAdGroupStats,
-} from "../db/campaigns.js";
-import {
-  createAdGroup,
-  listAdGroups,
-} from "../db/campaigns.js";
-import {
-  createAd,
-  listAds,
-} from "../db/campaigns.js";
-
-const program = new Command();
-
-program
-  .name("microservice-ads")
-  .description("Ad campaign management microservice")
-  .version("0.0.1");
-
-// --- Campaigns ---
-
-const campaignCmd = program
-  .command("campaign")
-  .description("Campaign management");
-
-campaignCmd
-  .command("create")
-  .description("Create a new campaign")
-  .requiredOption("--platform <platform>", "Platform (google/meta/linkedin/tiktok)")
-  .requiredOption("--name <name>", "Campaign name")
-  .option("--status <status>", "Status (draft/active/paused/completed)", "draft")
-  .option("--budget-daily <amount>", "Daily budget")
-  .option("--budget-total <amount>", "Total budget")
-  .option("--start-date <date>", "Start date (YYYY-MM-DD)")
-  .option("--end-date <date>", "End date (YYYY-MM-DD)")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const campaign = createCampaign({
-      platform: opts.platform,
-      name: opts.name,
-      status: opts.status,
-      budget_daily: opts.budgetDaily ? parseFloat(opts.budgetDaily) : undefined,
-      budget_total: opts.budgetTotal ? parseFloat(opts.budgetTotal) : undefined,
-      start_date: opts.startDate,
-      end_date: opts.endDate,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaign, null, 2));
-    } else {
-      console.log(`Created campaign: ${campaign.name} [${campaign.platform}] (${campaign.id})`);
-    }
-  });
-
-campaignCmd
-  .command("list")
-  .description("List campaigns")
-  .option("--platform <platform>", "Filter by platform")
-  .option("--status <status>", "Filter by status")
-  .option("--search <query>", "Search by name")
-  .option("--limit <n>", "Limit results")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const campaigns = listCampaigns({
-      platform: opts.platform,
-      status: opts.status,
-      search: opts.search,
-      limit: opts.limit ? parseInt(opts.limit) : undefined,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaigns, null, 2));
-    } else {
-      if (campaigns.length === 0) {
-        console.log("No campaigns found.");
-        return;
-      }
-      for (const c of campaigns) {
-        const budget = c.budget_total > 0 ? ` $${c.budget_total}` : "";
-        console.log(`  [${c.platform}] ${c.name} (${c.status})${budget}`);
-      }
-      console.log(`\n${campaigns.length} campaign(s)`);
-    }
-  });
-
-campaignCmd
-  .command("get")
-  .description("Get a campaign by ID")
-  .argument("<id>", "Campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const campaign = getCampaign(id);
-    if (!campaign) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaign, null, 2));
-    } else {
-      console.log(`${campaign.name} [${campaign.platform}]`);
-      console.log(`  Status: ${campaign.status}`);
-      console.log(`  Budget: $${campaign.budget_daily}/day, $${campaign.budget_total} total`);
-      console.log(`  Spend: $${campaign.spend}`);
-      console.log(`  Impressions: ${campaign.impressions}, Clicks: ${campaign.clicks}, Conversions: ${campaign.conversions}`);
-      console.log(`  ROAS: ${campaign.roas}`);
-      if (campaign.start_date) console.log(`  Start: ${campaign.start_date}`);
-      if (campaign.end_date) console.log(`  End: ${campaign.end_date}`);
-    }
-  });
-
-campaignCmd
-  .command("update")
-  .description("Update a campaign")
-  .argument("<id>", "Campaign ID")
-  .option("--platform <platform>", "Platform")
-  .option("--name <name>", "Campaign name")
-  .option("--status <status>", "Status")
-  .option("--budget-daily <amount>", "Daily budget")
-  .option("--budget-total <amount>", "Total budget")
-  .option("--spend <amount>", "Total spend")
-  .option("--impressions <n>", "Impressions")
-  .option("--clicks <n>", "Clicks")
-  .option("--conversions <n>", "Conversions")
-  .option("--roas <n>", "ROAS")
-  .option("--start-date <date>", "Start date")
-  .option("--end-date <date>", "End date")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const input: Record<string, unknown> = {};
-    if (opts.platform !== undefined) input.platform = opts.platform;
-    if (opts.name !== undefined) input.name = opts.name;
-    if (opts.status !== undefined) input.status = opts.status;
-    if (opts.budgetDaily !== undefined) input.budget_daily = parseFloat(opts.budgetDaily);
-    if (opts.budgetTotal !== undefined) input.budget_total = parseFloat(opts.budgetTotal);
-    if (opts.spend !== undefined) input.spend = parseFloat(opts.spend);
-    if (opts.impressions !== undefined) input.impressions = parseInt(opts.impressions);
-    if (opts.clicks !== undefined) input.clicks = parseInt(opts.clicks);
-    if (opts.conversions !== undefined) input.conversions = parseInt(opts.conversions);
-    if (opts.roas !== undefined) input.roas = parseFloat(opts.roas);
-    if (opts.startDate !== undefined) input.start_date = opts.startDate;
-    if (opts.endDate !== undefined) input.end_date = opts.endDate;
-
-    const campaign = updateCampaign(id, input);
-    if (!campaign) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaign, null, 2));
-    } else {
-      console.log(`Updated: ${campaign.name} [${campaign.platform}]`);
-    }
-  });
-
-campaignCmd
-  .command("delete")
-  .description("Delete a campaign")
-  .argument("<id>", "Campaign ID")
-  .action((id) => {
-    const deleted = deleteCampaign(id);
-    if (deleted) {
-      console.log(`Deleted campaign ${id}`);
-    } else {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-
-campaignCmd
-  .command("pause")
-  .description("Pause a campaign")
-  .argument("<id>", "Campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const campaign = pauseCampaign(id);
-    if (!campaign) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaign, null, 2));
-    } else {
-      console.log(`Paused: ${campaign.name}`);
-    }
-  });
-
-campaignCmd
-  .command("resume")
-  .description("Resume a paused campaign")
-  .argument("<id>", "Campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const campaign = resumeCampaign(id);
-    if (!campaign) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(campaign, null, 2));
-    } else {
-      console.log(`Resumed: ${campaign.name}`);
-    }
-  });
-
-// 1. Bulk pause/resume
-campaignCmd
-  .command("bulk-pause")
-  .description("Pause all active campaigns on a platform")
-  .requiredOption("--platform <platform>", "Platform (google/meta/linkedin/tiktok)")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const result = bulkPause(opts.platform);
-    if (opts.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log(`Paused ${result.updated_count} campaign(s) on ${result.platform}`);
-    }
-  });
-
-campaignCmd
-  .command("bulk-resume")
-  .description("Resume all paused campaigns on a platform")
-  .requiredOption("--platform <platform>", "Platform (google/meta/linkedin/tiktok)")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const result = bulkResume(opts.platform);
-    if (opts.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.log(`Resumed ${result.updated_count} campaign(s) on ${result.platform}`);
-    }
-  });
-
-// 3. Budget alerts
-campaignCmd
-  .command("check-budget")
-  .description("Check budget status for a campaign")
-  .argument("<id>", "Campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const status = checkBudgetStatus(id);
-    if (!status) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(status, null, 2));
-    } else {
-      console.log(`Budget Status: ${status.campaign_name}`);
-      console.log(`  Over budget: ${status.over_budget ? "YES" : "No"}`);
-      console.log(`  Daily remaining: $${status.daily_remaining}`);
-      console.log(`  Total remaining: $${status.total_remaining}`);
-      console.log(`  % used: ${status.pct_used}%`);
-      console.log(`  Days active: ${status.days_active}`);
-      console.log(`  Expected spend: $${status.expected_spend}`);
-    }
-  });
-
-// 5. CSV export
-campaignCmd
-  .command("export")
-  .description("Export campaigns to CSV or JSON")
-  .option("--format <format>", "Format (csv/json)", "csv")
-  .action((opts) => {
-    const output = exportCampaigns(opts.format);
-    console.log(output);
-  });
-
-// 6. Campaign cloning
-campaignCmd
-  .command("clone")
-  .description("Clone a campaign with all ad groups and ads")
-  .argument("<id>", "Campaign ID to clone")
-  .requiredOption("--name <name>", "New campaign name")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const cloned = cloneCampaign(id, opts.name);
-    if (!cloned) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(cloned, null, 2));
-    } else {
-      console.log(`Cloned campaign: ${cloned.name} (${cloned.id})`);
-    }
-  });
-
-// 7. Budget remaining
-campaignCmd
-  .command("budget-remaining")
-  .description("Show budget remaining for a campaign")
-  .argument("<id>", "Campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const remaining = getBudgetRemaining(id);
-    if (!remaining) {
-      console.error(`Campaign '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(remaining, null, 2));
-    } else {
-      console.log(`Budget Remaining: ${remaining.campaign_name}`);
-      console.log(`  Daily budget: $${remaining.budget_daily}`);
-      console.log(`  Total budget: $${remaining.budget_total}`);
-      console.log(`  Spend: $${remaining.spend}`);
-      console.log(`  Daily remaining: $${remaining.daily_remaining}`);
-      console.log(`  Total remaining: $${remaining.total_remaining}`);
-      console.log(`  Days remaining at current rate: ${remaining.days_remaining_at_daily_rate}`);
-    }
-  });
-
-// --- Ad Groups ---
-
-const adGroupCmd = program
-  .command("ad-group")
-  .description("Ad group management");
-
-adGroupCmd
-  .command("create")
-  .description("Create a new ad group")
-  .requiredOption("--campaign <id>", "Campaign ID")
-  .requiredOption("--name <name>", "Ad group name")
-  .option("--targeting <json>", "Targeting JSON")
-  .option("--status <status>", "Status", "draft")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const adGroup = createAdGroup({
-      campaign_id: opts.campaign,
-      name: opts.name,
-      targeting: opts.targeting ? JSON.parse(opts.targeting) : undefined,
-      status: opts.status,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(adGroup, null, 2));
-    } else {
-      console.log(`Created ad group: ${adGroup.name} (${adGroup.id})`);
-    }
-  });
-
-adGroupCmd
-  .command("list")
-  .description("List ad groups")
-  .option("--campaign <id>", "Filter by campaign ID")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const adGroups = listAdGroups(opts.campaign);
-
-    if (opts.json) {
-      console.log(JSON.stringify(adGroups, null, 2));
-    } else {
-      if (adGroups.length === 0) {
-        console.log("No ad groups found.");
-        return;
-      }
-      for (const ag of adGroups) {
-        console.log(`  ${ag.name} (${ag.status}) — campaign: ${ag.campaign_id}`);
-      }
-      console.log(`\n${adGroups.length} ad group(s)`);
-    }
-  });
-
-// 8. Ad group stats
-adGroupCmd
-  .command("stats")
-  .description("Show aggregated stats for an ad group")
-  .argument("<id>", "Ad group ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const stats = getAdGroupStats(id);
-    if (!stats) {
-      console.error(`Ad group '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(stats, null, 2));
-    } else {
-      console.log(`Ad Group Stats: ${stats.ad_group_name}`);
-      console.log(`  Campaign: ${stats.campaign_id}`);
-      console.log(`  Total ads: ${stats.total_ads}`);
-      console.log(`  Active ads: ${stats.active_ads}`);
-      if (Object.keys(stats.metrics).length > 0) {
-        console.log("  Aggregated metrics:");
-        for (const [key, value] of Object.entries(stats.metrics)) {
-          console.log(`    ${key}: ${value}`);
-        }
-      }
-    }
-  });
-
-// --- Ads ---
-
-const adCmd = program
-  .command("ad")
-  .description("Ad management");
-
-adCmd
-  .command("create")
-  .description("Create a new ad")
-  .requiredOption("--ad-group <id>", "Ad group ID")
-  .requiredOption("--headline <text>", "Ad headline")
-  .option("--description <text>", "Ad description")
-  .option("--creative-url <url>", "Creative URL")
-  .option("--status <status>", "Status", "draft")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const ad = createAd({
-      ad_group_id: opts.adGroup,
-      headline: opts.headline,
-      description: opts.description,
-      creative_url: opts.creativeUrl,
-      status: opts.status,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(ad, null, 2));
-    } else {
-      console.log(`Created ad: ${ad.headline} (${ad.id})`);
-    }
-  });
-
-adCmd
-  .command("list")
-  .description("List ads")
-  .option("--ad-group <id>", "Filter by ad group ID")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const ads = listAds(opts.adGroup);
-
-    if (opts.json) {
-      console.log(JSON.stringify(ads, null, 2));
-    } else {
-      if (ads.length === 0) {
-        console.log("No ads found.");
-        return;
-      }
-      for (const a of ads) {
-        console.log(`  ${a.headline} (${a.status})`);
-      }
-      console.log(`\n${ads.length} ad(s)`);
-    }
-  });
-
-// --- Stats & Reports ---
-
-program
-  .command("stats")
-  .description("Show campaign statistics")
-  .option("--sort-by <metric>", "Sort campaigns by metric (roas/ctr/spend)")
-  .option("--limit <n>", "Limit ranked results", "10")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    // 2. Performance ranking via --sort-by
-    if (opts.sortBy) {
-      const ranked = getRankedCampaigns(opts.sortBy, parseInt(opts.limit));
-      if (opts.json) {
-        console.log(JSON.stringify(ranked, null, 2));
-      } else {
-        console.log(`Campaigns ranked by ${opts.sortBy}:`);
-        for (let i = 0; i < ranked.length; i++) {
-          const c = ranked[i];
-          const ctr = c.impressions > 0 ? ((c.clicks / c.impressions) * 100).toFixed(2) : "0.00";
-          console.log(`  ${i + 1}. ${c.name} [${c.platform}] — ROAS: ${c.roas}, CTR: ${ctr}%, Spend: $${c.spend}`);
-        }
-      }
-      return;
-    }
-
-    const stats = getCampaignStats();
-
-    if (opts.json) {
-      console.log(JSON.stringify(stats, null, 2));
-    } else {
-      console.log("Campaign Statistics:");
-      console.log(`  Total campaigns: ${stats.total_campaigns}`);
-      console.log(`  Active campaigns: ${stats.active_campaigns}`);
-      console.log(`  Total spend: $${stats.total_spend.toFixed(2)}`);
-      console.log(`  Total impressions: ${stats.total_impressions}`);
-      console.log(`  Total clicks: ${stats.total_clicks}`);
-      console.log(`  Total conversions: ${stats.total_conversions}`);
-      console.log(`  Avg ROAS: ${stats.avg_roas.toFixed(2)}`);
-    }
-  });
-
-// 4. Cross-platform comparison
-program
-  .command("compare-platforms")
-  .description("Compare ROAS/CPA/spend across platforms side-by-side")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const comparison = comparePlatforms();
-
-    if (opts.json) {
-      console.log(JSON.stringify(comparison, null, 2));
-    } else {
-      if (comparison.length === 0) {
-        console.log("No platform data.");
-        return;
-      }
-      console.log("Platform Comparison:");
-      console.log("  Platform     | Campaigns | Spend        | ROAS  | CTR    | CPA");
-      console.log("  -------------|-----------|--------------|-------|--------|-------");
-      for (const p of comparison) {
-        const platform = p.platform.padEnd(12);
-        const campaigns = String(p.campaign_count).padEnd(9);
-        const spend = `$${p.total_spend.toFixed(2)}`.padEnd(12);
-        const roas = p.avg_roas.toFixed(2).padEnd(5);
-        const ctr = `${p.avg_ctr.toFixed(2)}%`.padEnd(6);
-        const cpa = p.avg_cpa > 0 ? `$${p.avg_cpa.toFixed(2)}` : "N/A";
-        console.log(`  ${platform} | ${campaigns} | ${spend} | ${roas} | ${ctr} | ${cpa}`);
-      }
-    }
-  });
-
-program
-  .command("spend")
-  .description("Show spend by platform")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const spend = getSpendByPlatform();
-
-    if (opts.json) {
-      console.log(JSON.stringify(spend, null, 2));
-    } else {
-      if (spend.length === 0) {
-        console.log("No spend data.");
-        return;
-      }
-      console.log("Spend by Platform:");
-      for (const s of spend) {
-        console.log(`  ${s.platform}: $${s.total_spend.toFixed(2)} (${s.campaign_count} campaigns)`);
-      }
-    }
-  });
-
-program
-  .command("platforms")
-  .description("List platforms with campaigns")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const platforms = getPlatforms();
-
-    if (opts.json) {
-      console.log(JSON.stringify(platforms, null, 2));
-    } else {
-      if (platforms.length === 0) {
-        console.log("No platforms found.");
-        return;
-      }
-      console.log("Platforms:");
-      for (const p of platforms) {
-        console.log(`  ${p}`);
-      }
-    }
-  });
-
-program
-  .command("providers")
-  .description("List supported ad providers")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const providers = ["google", "meta", "linkedin", "tiktok"];
-
-    if (opts.json) {
-      console.log(JSON.stringify(providers, null, 2));
-    } else {
-      console.log("Supported Ad Providers:");
-      for (const p of providers) {
-        console.log(`  ${p}`);
-      }
-    }
-  });
-
-program.parse(process.argv);