@hasna/microservices 0.0.3 → 0.0.4

package/microservices/microservice-ads/src/db/campaigns.ts

@@ -0,0 +1,493 @@
+/**
+ * Campaign, Ad Group, and Ad CRUD operations
+ */
+
+import { getDatabase } from "./database.js";
+
+// --- Types ---
+
+export type Platform = "google" | "meta" | "linkedin" | "tiktok";
+export type CampaignStatus = "draft" | "active" | "paused" | "completed";
+
+export interface Campaign {
+  id: string;
+  platform: Platform;
+  name: string;
+  status: CampaignStatus;
+  budget_daily: number;
+  budget_total: number;
+  spend: number;
+  impressions: number;
+  clicks: number;
+  conversions: number;
+  roas: number;
+  start_date: string | null;
+  end_date: string | null;
+  created_at: string;
+  updated_at: string;
+  metadata: Record<string, unknown>;
+}
+
+interface CampaignRow {
+  id: string;
+  platform: Platform;
+  name: string;
+  status: CampaignStatus;
+  budget_daily: number;
+  budget_total: number;
+  spend: number;
+  impressions: number;
+  clicks: number;
+  conversions: number;
+  roas: number;
+  start_date: string | null;
+  end_date: string | null;
+  created_at: string;
+  updated_at: string;
+  metadata: string;
+}
+
+function rowToCampaign(row: CampaignRow): Campaign {
+  return {
+    ...row,
+    metadata: JSON.parse(row.metadata || "{}"),
+  };
+}
+
+export interface AdGroup {
+  id: string;
+  campaign_id: string;
+  name: string;
+  targeting: Record<string, unknown>;
+  status: CampaignStatus;
+  created_at: string;
+}
+
+interface AdGroupRow {
+  id: string;
+  campaign_id: string;
+  name: string;
+  targeting: string;
+  status: CampaignStatus;
+  created_at: string;
+}
+
+function rowToAdGroup(row: AdGroupRow): AdGroup {
+  return {
+    ...row,
+    targeting: JSON.parse(row.targeting || "{}"),
+  };
+}
+
+export interface Ad {
+  id: string;
+  ad_group_id: string;
+  headline: string;
+  description: string | null;
+  creative_url: string | null;
+  status: CampaignStatus;
+  metrics: Record<string, unknown>;
+  created_at: string;
+}
+
+interface AdRow {
+  id: string;
+  ad_group_id: string;
+  headline: string;
+  description: string | null;
+  creative_url: string | null;
+  status: CampaignStatus;
+  metrics: string;
+  created_at: string;
+}
+
+function rowToAd(row: AdRow): Ad {
+  return {
+    ...row,
+    metrics: JSON.parse(row.metrics || "{}"),
+  };
+}
+
+// --- Campaign CRUD ---
+
+export interface CreateCampaignInput {
+  platform: Platform;
+  name: string;
+  status?: CampaignStatus;
+  budget_daily?: number;
+  budget_total?: number;
+  spend?: number;
+  impressions?: number;
+  clicks?: number;
+  conversions?: number;
+  roas?: number;
+  start_date?: string;
+  end_date?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export function createCampaign(input: CreateCampaignInput): Campaign {
+  const db = getDatabase();
+  const id = crypto.randomUUID();
+  const metadata = JSON.stringify(input.metadata || {});
+
+  db.prepare(
+    `INSERT INTO campaigns (id, platform, name, status, budget_daily, budget_total, spend, impressions, clicks, conversions, roas, start_date, end_date, metadata)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    id,
+    input.platform,
+    input.name,
+    input.status || "draft",
+    input.budget_daily ?? 0,
+    input.budget_total ?? 0,
+    input.spend ?? 0,
+    input.impressions ?? 0,
+    input.clicks ?? 0,
+    input.conversions ?? 0,
+    input.roas ?? 0,
+    input.start_date || null,
+    input.end_date || null,
+    metadata
+  );
+
+  return getCampaign(id)!;
+}
+
+export function getCampaign(id: string): Campaign | null {
+  const db = getDatabase();
+  const row = db.prepare("SELECT * FROM campaigns WHERE id = ?").get(id) as CampaignRow | null;
+  return row ? rowToCampaign(row) : null;
+}
+
+export interface ListCampaignsOptions {
+  platform?: Platform;
+  status?: CampaignStatus;
+  search?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export function listCampaigns(options: ListCampaignsOptions = {}): Campaign[] {
+  const db = getDatabase();
+  const conditions: string[] = [];
+  const params: unknown[] = [];
+
+  if (options.platform) {
+    conditions.push("platform = ?");
+    params.push(options.platform);
+  }
+
+  if (options.status) {
+    conditions.push("status = ?");
+    params.push(options.status);
+  }
+
+  if (options.search) {
+    conditions.push("(name LIKE ?)");
+    const q = `%${options.search}%`;
+    params.push(q);
+  }
+
+  let sql = "SELECT * FROM campaigns";
+  if (conditions.length > 0) {
+    sql += " WHERE " + conditions.join(" AND ");
+  }
+  sql += " ORDER BY created_at DESC";
+
+  if (options.limit) {
+    sql += " LIMIT ?";
+    params.push(options.limit);
+  }
+  if (options.offset) {
+    sql += " OFFSET ?";
+    params.push(options.offset);
+  }
+
+  const rows = db.prepare(sql).all(...params) as CampaignRow[];
+  return rows.map(rowToCampaign);
+}
+
+export interface UpdateCampaignInput {
+  platform?: Platform;
+  name?: string;
+  status?: CampaignStatus;
+  budget_daily?: number;
+  budget_total?: number;
+  spend?: number;
+  impressions?: number;
+  clicks?: number;
+  conversions?: number;
+  roas?: number;
+  start_date?: string | null;
+  end_date?: string | null;
+  metadata?: Record<string, unknown>;
+}
+
+export function updateCampaign(
+  id: string,
+  input: UpdateCampaignInput
+): Campaign | null {
+  const db = getDatabase();
+  const existing = getCampaign(id);
+  if (!existing) return null;
+
+  const sets: string[] = [];
+  const params: unknown[] = [];
+
+  if (input.platform !== undefined) {
+    sets.push("platform = ?");
+    params.push(input.platform);
+  }
+  if (input.name !== undefined) {
+    sets.push("name = ?");
+    params.push(input.name);
+  }
+  if (input.status !== undefined) {
+    sets.push("status = ?");
+    params.push(input.status);
+  }
+  if (input.budget_daily !== undefined) {
+    sets.push("budget_daily = ?");
+    params.push(input.budget_daily);
+  }
+  if (input.budget_total !== undefined) {
+    sets.push("budget_total = ?");
+    params.push(input.budget_total);
+  }
+  if (input.spend !== undefined) {
+    sets.push("spend = ?");
+    params.push(input.spend);
+  }
+  if (input.impressions !== undefined) {
+    sets.push("impressions = ?");
+    params.push(input.impressions);
+  }
+  if (input.clicks !== undefined) {
+    sets.push("clicks = ?");
+    params.push(input.clicks);
+  }
+  if (input.conversions !== undefined) {
+    sets.push("conversions = ?");
+    params.push(input.conversions);
+  }
+  if (input.roas !== undefined) {
+    sets.push("roas = ?");
+    params.push(input.roas);
+  }
+  if (input.start_date !== undefined) {
+    sets.push("start_date = ?");
+    params.push(input.start_date);
+  }
+  if (input.end_date !== undefined) {
+    sets.push("end_date = ?");
+    params.push(input.end_date);
+  }
+  if (input.metadata !== undefined) {
+    sets.push("metadata = ?");
+    params.push(JSON.stringify(input.metadata));
+  }
+
+  if (sets.length === 0) return existing;
+
+  sets.push("updated_at = datetime('now')");
+  params.push(id);
+
+  db.prepare(
+    `UPDATE campaigns SET ${sets.join(", ")} WHERE id = ?`
+  ).run(...params);
+
+  return getCampaign(id);
+}
+
+export function deleteCampaign(id: string): boolean {
+  const db = getDatabase();
+  const result = db.prepare("DELETE FROM campaigns WHERE id = ?").run(id);
+  return result.changes > 0;
+}
+
+export function pauseCampaign(id: string): Campaign | null {
+  return updateCampaign(id, { status: "paused" });
+}
+
+export function resumeCampaign(id: string): Campaign | null {
+  return updateCampaign(id, { status: "active" });
+}
+
+export function countCampaigns(): number {
+  const db = getDatabase();
+  const row = db.prepare("SELECT COUNT(*) as count FROM campaigns").get() as { count: number };
+  return row.count;
+}
+
+// --- Ad Group CRUD ---
+
+export interface CreateAdGroupInput {
+  campaign_id: string;
+  name: string;
+  targeting?: Record<string, unknown>;
+  status?: CampaignStatus;
+}
+
+export function createAdGroup(input: CreateAdGroupInput): AdGroup {
+  const db = getDatabase();
+  const id = crypto.randomUUID();
+  const targeting = JSON.stringify(input.targeting || {});
+
+  db.prepare(
+    `INSERT INTO ad_groups (id, campaign_id, name, targeting, status)
+     VALUES (?, ?, ?, ?, ?)`
+  ).run(
+    id,
+    input.campaign_id,
+    input.name,
+    targeting,
+    input.status || "draft"
+  );
+
+  return getAdGroup(id)!;
+}
+
+export function getAdGroup(id: string): AdGroup | null {
+  const db = getDatabase();
+  const row = db.prepare("SELECT * FROM ad_groups WHERE id = ?").get(id) as AdGroupRow | null;
+  return row ? rowToAdGroup(row) : null;
+}
+
+export function listAdGroups(campaign_id?: string): AdGroup[] {
+  const db = getDatabase();
+  let sql = "SELECT * FROM ad_groups";
+  const params: unknown[] = [];
+
+  if (campaign_id) {
+    sql += " WHERE campaign_id = ?";
+    params.push(campaign_id);
+  }
+
+  sql += " ORDER BY created_at DESC";
+
+  const rows = db.prepare(sql).all(...params) as AdGroupRow[];
+  return rows.map(rowToAdGroup);
+}
+
+export function deleteAdGroup(id: string): boolean {
+  const db = getDatabase();
+  const result = db.prepare("DELETE FROM ad_groups WHERE id = ?").run(id);
+  return result.changes > 0;
+}
+
+// --- Ad CRUD ---
+
+export interface CreateAdInput {
+  ad_group_id: string;
+  headline: string;
+  description?: string;
+  creative_url?: string;
+  status?: CampaignStatus;
+  metrics?: Record<string, unknown>;
+}
+
+export function createAd(input: CreateAdInput): Ad {
+  const db = getDatabase();
+  const id = crypto.randomUUID();
+  const metrics = JSON.stringify(input.metrics || {});
+
+  db.prepare(
+    `INSERT INTO ads (id, ad_group_id, headline, description, creative_url, status, metrics)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    id,
+    input.ad_group_id,
+    input.headline,
+    input.description || null,
+    input.creative_url || null,
+    input.status || "draft",
+    metrics
+  );
+
+  return getAd(id)!;
+}
+
+export function getAd(id: string): Ad | null {
+  const db = getDatabase();
+  const row = db.prepare("SELECT * FROM ads WHERE id = ?").get(id) as AdRow | null;
+  return row ? rowToAd(row) : null;
+}
+
+export function listAds(ad_group_id?: string): Ad[] {
+  const db = getDatabase();
+  let sql = "SELECT * FROM ads";
+  const params: unknown[] = [];
+
+  if (ad_group_id) {
+    sql += " WHERE ad_group_id = ?";
+    params.push(ad_group_id);
+  }
+
+  sql += " ORDER BY created_at DESC";
+
+  const rows = db.prepare(sql).all(...params) as AdRow[];
+  return rows.map(rowToAd);
+}
+
+export function deleteAd(id: string): boolean {
+  const db = getDatabase();
+  const result = db.prepare("DELETE FROM ads WHERE id = ?").run(id);
+  return result.changes > 0;
+}
+
+// --- Aggregation helpers ---
+
+export interface CampaignStats {
+  total_campaigns: number;
+  active_campaigns: number;
+  total_spend: number;
+  total_impressions: number;
+  total_clicks: number;
+  total_conversions: number;
+  avg_roas: number;
+}
+
+export function getCampaignStats(): CampaignStats {
+  const db = getDatabase();
+  const row = db.prepare(`
+    SELECT
+      COUNT(*) as total_campaigns,
+      SUM(CASE WHEN status = 'active' THEN 1 ELSE 0 END) as active_campaigns,
+      COALESCE(SUM(spend), 0) as total_spend,
+      COALESCE(SUM(impressions), 0) as total_impressions,
+      COALESCE(SUM(clicks), 0) as total_clicks,
+      COALESCE(SUM(conversions), 0) as total_conversions,
+      COALESCE(AVG(CASE WHEN roas > 0 THEN roas END), 0) as avg_roas
+    FROM campaigns
+  `).get() as CampaignStats;
+  return row;
+}
+
+export interface SpendByPlatform {
+  platform: Platform;
+  total_spend: number;
+  campaign_count: number;
+}
+
+export function getSpendByPlatform(): SpendByPlatform[] {
+  const db = getDatabase();
+  const rows = db.prepare(`
+    SELECT
+      platform,
+      COALESCE(SUM(spend), 0) as total_spend,
+      COUNT(*) as campaign_count
+    FROM campaigns
+    GROUP BY platform
+    ORDER BY total_spend DESC
+  `).all() as SpendByPlatform[];
+  return rows;
+}
+
+export function getPlatforms(): string[] {
+  const db = getDatabase();
+  const rows = db.prepare(
+    "SELECT DISTINCT platform FROM campaigns ORDER BY platform"
+  ).all() as { platform: string }[];
+  return rows.map((r) => r.platform);
+}

package/microservices/microservice-ads/src/db/database.ts

@@ -0,0 +1,93 @@
+/**
+ * Database connection for microservice-ads
+ */
+
+import { Database } from "bun:sqlite";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { MIGRATIONS } from "./migrations.js";
+
+let _db: Database | null = null;
+
+function getDbPath(): string {
+  // Environment variable override
+  if (process.env["MICROSERVICES_DIR"]) {
+    return join(process.env["MICROSERVICES_DIR"], "microservice-ads", "data.db");
+  }
+
+  // Check for .microservices in current or parent directories
+  let dir = resolve(process.cwd());
+  while (true) {
+    const candidate = join(dir, ".microservices", "microservice-ads", "data.db");
+    const msDir = join(dir, ".microservices");
+    if (existsSync(msDir)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  // Global fallback
+  const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
+  return join(home, ".microservices", "microservice-ads", "data.db");
+}
+
+function ensureDir(filePath: string): void {
+  const dir = dirname(resolve(filePath));
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+export function getDatabase(): Database {
+  if (_db) return _db;
+
+  const dbPath = getDbPath();
+  ensureDir(dbPath);
+
+  _db = new Database(dbPath);
+  _db.exec("PRAGMA journal_mode = WAL");
+  _db.exec("PRAGMA foreign_keys = ON");
+
+  // Create migrations table
+  _db.exec(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      id INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+
+  // Apply pending migrations
+  const applied = _db
+    .query("SELECT id FROM _migrations ORDER BY id")
+    .all() as { id: number }[];
+  const appliedIds = new Set(applied.map((r) => r.id));
+
+  for (const migration of MIGRATIONS) {
+    if (appliedIds.has(migration.id)) continue;
+
+    _db.exec("BEGIN");
+    try {
+      _db.exec(migration.sql);
+      _db.prepare("INSERT INTO _migrations (id, name) VALUES (?, ?)").run(
+        migration.id,
+        migration.name
+      );
+      _db.exec("COMMIT");
+    } catch (error) {
+      _db.exec("ROLLBACK");
+      throw new Error(
+        `Migration ${migration.id} (${migration.name}) failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+
+  return _db;
+}
+
+export function closeDatabase(): void {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}

package/microservices/microservice-ads/src/db/migrations.ts

@@ -0,0 +1,60 @@
+export interface MigrationEntry {
+  id: number;
+  name: string;
+  sql: string;
+}
+
+export const MIGRATIONS: MigrationEntry[] = [
+  {
+    id: 1,
+    name: "initial_schema",
+    sql: `
+      CREATE TABLE IF NOT EXISTS campaigns (
+        id TEXT PRIMARY KEY,
+        platform TEXT NOT NULL CHECK (platform IN ('google', 'meta', 'linkedin', 'tiktok')),
+        name TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'draft' CHECK (status IN ('draft', 'active', 'paused', 'completed')),
+        budget_daily REAL NOT NULL DEFAULT 0,
+        budget_total REAL NOT NULL DEFAULT 0,
+        spend REAL NOT NULL DEFAULT 0,
+        impressions INTEGER NOT NULL DEFAULT 0,
+        clicks INTEGER NOT NULL DEFAULT 0,
+        conversions INTEGER NOT NULL DEFAULT 0,
+        roas REAL NOT NULL DEFAULT 0,
+        start_date TEXT,
+        end_date TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+        metadata TEXT NOT NULL DEFAULT '{}'
+      );
+
+      CREATE TABLE IF NOT EXISTS ad_groups (
+        id TEXT PRIMARY KEY,
+        campaign_id TEXT NOT NULL REFERENCES campaigns(id) ON DELETE CASCADE,
+        name TEXT NOT NULL,
+        targeting TEXT NOT NULL DEFAULT '{}',
+        status TEXT NOT NULL DEFAULT 'draft' CHECK (status IN ('draft', 'active', 'paused', 'completed')),
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS ads (
+        id TEXT PRIMARY KEY,
+        ad_group_id TEXT NOT NULL REFERENCES ad_groups(id) ON DELETE CASCADE,
+        headline TEXT NOT NULL,
+        description TEXT,
+        creative_url TEXT,
+        status TEXT NOT NULL DEFAULT 'draft' CHECK (status IN ('draft', 'active', 'paused', 'completed')),
+        metrics TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_campaigns_platform ON campaigns(platform);
+      CREATE INDEX IF NOT EXISTS idx_campaigns_status ON campaigns(status);
+      CREATE INDEX IF NOT EXISTS idx_campaigns_name ON campaigns(name);
+      CREATE INDEX IF NOT EXISTS idx_ad_groups_campaign ON ad_groups(campaign_id);
+      CREATE INDEX IF NOT EXISTS idx_ad_groups_status ON ad_groups(status);
+      CREATE INDEX IF NOT EXISTS idx_ads_ad_group ON ads(ad_group_id);
+      CREATE INDEX IF NOT EXISTS idx_ads_status ON ads(status);
+    `,
+  },
+];

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

@@ -0,0 +1,39 @@
+/**
+ * microservice-ads — Ad campaign management microservice
+ */
+
+export {
+  createCampaign,
+  getCampaign,
+  listCampaigns,
+  updateCampaign,
+  deleteCampaign,
+  pauseCampaign,
+  resumeCampaign,
+  countCampaigns,
+  getCampaignStats,
+  getSpendByPlatform,
+  getPlatforms,
+  createAdGroup,
+  getAdGroup,
+  listAdGroups,
+  deleteAdGroup,
+  createAd,
+  getAd,
+  listAds,
+  deleteAd,
+  type Campaign,
+  type CreateCampaignInput,
+  type UpdateCampaignInput,
+  type ListCampaignsOptions,
+  type Platform,
+  type CampaignStatus,
+  type AdGroup,
+  type CreateAdGroupInput,
+  type Ad,
+  type CreateAdInput,
+  type CampaignStats,
+  type SpendByPlatform,
+} from "./db/campaigns.js";
+
+export { getDatabase, closeDatabase } from "./db/database.js";