@hasna/microservices 0.0.16 → 0.0.17

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

@@ -1,46 +0,0 @@
-/**
- * microservice-social — Social media management microservice
- */
-
-export {
-  createAccount,
-  getAccount,
-  listAccounts,
-  updateAccount,
-  deleteAccount,
-  countAccounts,
-  createPost,
-  getPost,
-  listPosts,
-  updatePost,
-  deletePost,
-  countPosts,
-  schedulePost,
-  publishPost,
-  createTemplate,
-  getTemplate,
-  listTemplates,
-  deleteTemplate,
-  useTemplate,
-  getEngagementStats,
-  getStatsByPlatform,
-  getCalendar,
-  getOverallStats,
-  type Platform,
-  type PostStatus,
-  type Account,
-  type Post,
-  type Template,
-  type Engagement,
-  type EngagementStats,
-  type PlatformStats,
-  type CreateAccountInput,
-  type UpdateAccountInput,
-  type ListAccountsOptions,
-  type CreatePostInput,
-  type UpdatePostInput,
-  type ListPostsOptions,
-  type CreateTemplateInput,
-} from "./db/social.js";
-
-export { getDatabase, closeDatabase } from "./db/database.js";

package/microservices/microservice-social/src/lib/audience.ts

@@ -1,353 +0,0 @@
-/**
- * Follower sync and audience insights
- */
-
-import { getDatabase } from "../db/database.js";
-
-// ---- Types ----
-
-export interface Follower {
-  id: string;
-  account_id: string;
-  platform_user_id: string | null;
-  username: string | null;
-  display_name: string | null;
-  follower_count: number;
-  following: boolean;
-  followed_at: string | null;
-  unfollowed_at: string | null;
-  metadata: Record<string, unknown>;
-  created_at: string;
-}
-
-interface FollowerRow {
-  id: string;
-  account_id: string;
-  platform_user_id: string | null;
-  username: string | null;
-  display_name: string | null;
-  follower_count: number;
-  following: number;
-  followed_at: string | null;
-  unfollowed_at: string | null;
-  metadata: string;
-  created_at: string;
-}
-
-function rowToFollower(row: FollowerRow): Follower {
-  return {
-    ...row,
-    following: row.following === 1,
-    metadata: JSON.parse(row.metadata || "{}"),
-  };
-}
-
-export interface AudienceSnapshot {
-  id: string;
-  account_id: string;
-  follower_count: number;
-  following_count: number;
-  snapshot_at: string;
-}
-
-export interface CreateFollowerInput {
-  account_id: string;
-  platform_user_id?: string;
-  username?: string;
-  display_name?: string;
-  follower_count?: number;
-  following?: boolean;
-  followed_at?: string;
-  metadata?: Record<string, unknown>;
-}
-
-export interface ListFollowersFilters {
-  following?: boolean;
-  search?: string;
-  limit?: number;
-  offset?: number;
-}
-
-export interface UpdateFollowerInput {
-  username?: string;
-  display_name?: string;
-  follower_count?: number;
-  following?: boolean;
-  unfollowed_at?: string;
-  metadata?: Record<string, unknown>;
-}
-
-export interface AudienceInsights {
-  total_followers: number;
-  growth_rate_7d: number;
-  growth_rate_30d: number;
-  new_followers_7d: number;
-  lost_followers_7d: number;
-  top_followers: Follower[];
-}
-
-export interface GrowthPoint {
-  date: string;
-  count: number;
-}
-
-// ---- Followers CRUD ----
-
-export function createFollower(input: CreateFollowerInput): Follower {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-  const metadata = JSON.stringify(input.metadata || {});
-
-  db.prepare(
-    `INSERT INTO followers (id, account_id, platform_user_id, username, display_name, follower_count, following, followed_at, metadata)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    id,
-    input.account_id,
-    input.platform_user_id || null,
-    input.username || null,
-    input.display_name || null,
-    input.follower_count ?? 0,
-    input.following !== false ? 1 : 0,
-    input.followed_at || null,
-    metadata
-  );
-
-  return getFollower(id)!;
-}
-
-export function getFollower(id: string): Follower | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM followers WHERE id = ?").get(id) as FollowerRow | null;
-  return row ? rowToFollower(row) : null;
-}
-
-export function listFollowers(accountId: string, filters: ListFollowersFilters = {}): Follower[] {
-  const db = getDatabase();
-  const conditions: string[] = ["account_id = ?"];
-  const params: unknown[] = [accountId];
-
-  if (filters.following !== undefined) {
-    conditions.push("following = ?");
-    params.push(filters.following ? 1 : 0);
-  }
-
-  if (filters.search) {
-    conditions.push("(username LIKE ? OR display_name LIKE ?)");
-    params.push(`%${filters.search}%`, `%${filters.search}%`);
-  }
-
-  let sql = `SELECT * FROM followers WHERE ${conditions.join(" AND ")} ORDER BY follower_count DESC`;
-
-  if (filters.limit) {
-    sql += " LIMIT ?";
-    params.push(filters.limit);
-  }
-  if (filters.offset) {
-    sql += " OFFSET ?";
-    params.push(filters.offset);
-  }
-
-  const rows = db.prepare(sql).all(...params) as FollowerRow[];
-  return rows.map(rowToFollower);
-}
-
-export function updateFollower(id: string, input: UpdateFollowerInput): Follower | null {
-  const db = getDatabase();
-  const existing = getFollower(id);
-  if (!existing) return null;
-
-  const sets: string[] = [];
-  const params: unknown[] = [];
-
-  if (input.username !== undefined) {
-    sets.push("username = ?");
-    params.push(input.username);
-  }
-  if (input.display_name !== undefined) {
-    sets.push("display_name = ?");
-    params.push(input.display_name);
-  }
-  if (input.follower_count !== undefined) {
-    sets.push("follower_count = ?");
-    params.push(input.follower_count);
-  }
-  if (input.following !== undefined) {
-    sets.push("following = ?");
-    params.push(input.following ? 1 : 0);
-  }
-  if (input.unfollowed_at !== undefined) {
-    sets.push("unfollowed_at = ?");
-    params.push(input.unfollowed_at);
-  }
-  if (input.metadata !== undefined) {
-    sets.push("metadata = ?");
-    params.push(JSON.stringify(input.metadata));
-  }
-
-  if (sets.length === 0) return existing;
-
-  params.push(id);
-  db.prepare(`UPDATE followers SET ${sets.join(", ")} WHERE id = ?`).run(...params);
-
-  return getFollower(id);
-}
-
-export function removeFollower(id: string): boolean {
-  const db = getDatabase();
-  const result = db.prepare("DELETE FROM followers WHERE id = ?").run(id);
-  return result.changes > 0;
-}
-
-// ---- Sync ----
-
-export interface SyncResult {
-  synced: number;
-  new_followers: number;
-  unfollowed: number;
-  message: string;
-}
-
-/**
- * Stub that would call the platform API for follower list, upsert into DB.
- * In production this would call X/Instagram/LinkedIn APIs.
- */
-export function syncFollowers(accountId: string): SyncResult {
-  // In a real implementation, this would:
-  // 1. Call the platform API to get the current follower list
-  // 2. Upsert new followers into the DB
-  // 3. Mark unfollowed users (following=0, set unfollowed_at)
-  // 4. Update follower metadata (display_name, follower_count)
-
-  const db = getDatabase();
-  const currentFollowers = db.prepare(
-    "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 1"
-  ).get(accountId) as { count: number };
-
-  return {
-    synced: currentFollowers.count,
-    new_followers: 0,
-    unfollowed: 0,
-    message: "Sync stub — connect platform API credentials to enable live sync.",
-  };
-}
-
-// ---- Snapshots ----
-
-export function createSnapshot(
-  accountId: string,
-  followerCount: number,
-  followingCount: number
-): AudienceSnapshot {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-
-  db.prepare(
-    `INSERT INTO audience_snapshots (id, account_id, follower_count, following_count)
-     VALUES (?, ?, ?, ?)`
-  ).run(id, accountId, followerCount, followingCount);
-
-  return db.prepare("SELECT * FROM audience_snapshots WHERE id = ?").get(id) as AudienceSnapshot;
-}
-
-/**
- * Creates a daily snapshot from current follower counts in the DB.
- */
-export function trackGrowth(accountId: string): AudienceSnapshot {
-  const db = getDatabase();
-
-  const followerCount = (
-    db.prepare(
-      "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 1"
-    ).get(accountId) as { count: number }
-  ).count;
-
-  const followingCount = (
-    db.prepare(
-      "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 0"
-    ).get(accountId) as { count: number }
-  ).count;
-
-  return createSnapshot(accountId, followerCount, followingCount);
-}
-
-// ---- Insights ----
-
-export function getAudienceInsights(accountId: string): AudienceInsights {
-  const db = getDatabase();
-
-  // Total current followers
-  const total_followers = (
-    db.prepare(
-      "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 1"
-    ).get(accountId) as { count: number }
-  ).count;
-
-  // New followers in last 7 days
-  const new_followers_7d = (
-    db.prepare(
-      "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 1 AND created_at >= datetime('now', '-7 days')"
-    ).get(accountId) as { count: number }
-  ).count;
-
-  // Lost followers in last 7 days
-  const lost_followers_7d = (
-    db.prepare(
-      "SELECT COUNT(*) as count FROM followers WHERE account_id = ? AND following = 0 AND unfollowed_at >= datetime('now', '-7 days')"
-    ).get(accountId) as { count: number }
-  ).count;
-
-  // Growth rates from snapshots
-  const growth_rate_7d = calculateGrowthRate(accountId, 7);
-  const growth_rate_30d = calculateGrowthRate(accountId, 30);
-
-  // Top followers by their follower count
-  const top_followers = listFollowers(accountId, { following: true, limit: 10 });
-
-  return {
-    total_followers,
-    growth_rate_7d,
-    growth_rate_30d,
-    new_followers_7d,
-    lost_followers_7d,
-    top_followers,
-  };
-}
-
-function calculateGrowthRate(accountId: string, days: number): number {
-  const db = getDatabase();
-
-  const latest = db.prepare(
-    "SELECT follower_count FROM audience_snapshots WHERE account_id = ? ORDER BY snapshot_at DESC LIMIT 1"
-  ).get(accountId) as { follower_count: number } | null;
-
-  const older = db.prepare(
-    `SELECT follower_count FROM audience_snapshots WHERE account_id = ? AND snapshot_at <= datetime('now', '-${days} days') ORDER BY snapshot_at DESC LIMIT 1`
-  ).get(accountId) as { follower_count: number } | null;
-
-  if (!latest || !older || older.follower_count === 0) return 0;
-
-  return Math.round(((latest.follower_count - older.follower_count) / older.follower_count) * 10000) / 100;
-}
-
-// ---- Growth Chart ----
-
-export function getFollowerGrowthChart(accountId: string, days: number = 30): GrowthPoint[] {
-  const db = getDatabase();
-
-  const rows = db.prepare(
-    `SELECT date(snapshot_at) as date, MAX(follower_count) as count
-     FROM audience_snapshots
-     WHERE account_id = ? AND snapshot_at >= datetime('now', '-${days} days')
-     GROUP BY date(snapshot_at)
-     ORDER BY date ASC`
-  ).all(accountId) as GrowthPoint[];
-
-  return rows;
-}
-
-// ---- Top Followers ----
-
-export function getTopFollowers(accountId: string, limit: number = 10): Follower[] {
-  return listFollowers(accountId, { following: true, limit });
-}

package/microservices/microservice-social/src/lib/content-ai.ts

@@ -1,278 +0,0 @@
-/**
- * AI-powered content generation for social media.
- * Supports OpenAI (gpt-4o-mini) and Anthropic (claude-haiku) — same pattern as transcriber summarizer.
- * Default: OpenAI if OPENAI_API_KEY set, else Anthropic.
- */
-
-import { PLATFORM_LIMITS, type Platform } from "../db/social.js";
-
-export type AIProvider = "openai" | "anthropic";
-export type Tone = "professional" | "casual" | "witty";
-
-export interface GeneratePostOptions {
-  tone?: Tone;
-  includeHashtags?: boolean;
-  includeEmoji?: boolean;
-  language?: string;
-}
-
-export interface GeneratedPost {
-  content: string;
-  hashtags: string[];
-  suggested_media_prompt: string;
-}
-
-export interface OptimizedPost {
-  optimized_content: string;
-  improvements: string[];
-}
-
-export interface RepurposedPost {
-  content: string;
-}
-
-// ---- Provider Detection ----
-
-export function getDefaultAIProvider(): AIProvider | null {
-  if (process.env["OPENAI_API_KEY"]) return "openai";
-  if (process.env["ANTHROPIC_API_KEY"]) return "anthropic";
-  return null;
-}
-
-function resolveProvider(provider?: AIProvider): AIProvider {
-  const resolved = provider ?? getDefaultAIProvider();
-  if (!resolved) throw new Error("No AI API key found. Set OPENAI_API_KEY or ANTHROPIC_API_KEY.");
-  return resolved;
-}
-
-// ---- Prompt Builders (exported for testing) ----
-
-export function buildGeneratePostPrompt(
-  topic: string,
-  platform: Platform,
-  options: GeneratePostOptions = {}
-): string {
-  const limit = PLATFORM_LIMITS[platform];
-  const tone = options.tone || "professional";
-  const lang = options.language || "English";
-  const hashtagLine = options.includeHashtags !== false
-    ? "Include 3-5 relevant hashtags."
-    : "Do NOT include hashtags.";
-  const emojiLine = options.includeEmoji
-    ? "Use emojis where appropriate."
-    : "Do not use emojis.";
-
-  return `Write a social media post about the following topic for ${platform}.
-Character limit: ${limit} characters. The post content MUST be within this limit.
-Tone: ${tone}
-Language: ${lang}
-${hashtagLine}
-${emojiLine}
-
-Return ONLY valid JSON with these fields:
-- "content": the post text (within ${limit} chars)
-- "hashtags": array of hashtag strings (without # prefix)
-- "suggested_media_prompt": a short description for AI image generation that would complement this post
-
-Topic: ${topic}`;
-}
-
-export function buildSuggestHashtagsPrompt(
-  content: string,
-  platform: Platform,
-  count: number
-): string {
-  return `Analyze the following social media post for ${platform} and suggest ${count} relevant hashtags.
-Return ONLY a valid JSON array of strings (without the # prefix).
-
-Post: ${content}`;
-}
-
-export function buildOptimizePostPrompt(content: string, platform: Platform): string {
-  const limit = PLATFORM_LIMITS[platform];
-  return `Optimize the following social media post for better engagement on ${platform}.
-Character limit: ${limit} characters. The optimized content MUST be within this limit.
-
-Return ONLY valid JSON with these fields:
-- "optimized_content": the improved post text (within ${limit} chars)
-- "improvements": array of strings explaining each change made
-
-Original post: ${content}`;
-}
-
-export function buildGenerateThreadPrompt(topic: string, tweetCount: number): string {
-  return `Write a Twitter/X thread of exactly ${tweetCount} tweets about the following topic.
-Each tweet MUST be within 280 characters.
-Number each tweet (1/${tweetCount}, 2/${tweetCount}, etc.) at the start.
-
-Return ONLY a valid JSON array of strings, one per tweet.
-
-Topic: ${topic}`;
-}
-
-export function buildRepurposePostPrompt(
-  content: string,
-  sourcePlatform: Platform,
-  targetPlatform: Platform
-): string {
-  const targetLimit = PLATFORM_LIMITS[targetPlatform];
-  return `Adapt the following ${sourcePlatform} post for ${targetPlatform}.
-Target character limit: ${targetLimit} characters. The content MUST be within this limit.
-Adjust the tone, length, hashtag style, and formatting to match ${targetPlatform} conventions.
-
-Return ONLY valid JSON with a single field:
-- "content": the adapted post text (within ${targetLimit} chars)
-
-Original ${sourcePlatform} post: ${content}`;
-}
-
-// ---- AI Functions ----
-
-export async function generatePost(
-  topic: string,
-  platform: Platform,
-  options: GeneratePostOptions = {},
-  provider?: AIProvider
-): Promise<GeneratedPost> {
-  const resolved = resolveProvider(provider);
-  const prompt = buildGeneratePostPrompt(topic, platform, options);
-
-  const raw = resolved === "openai"
-    ? await callOpenAI(prompt, 500)
-    : await callAnthropic(prompt, 500);
-
-  return parseJSON<GeneratedPost>(raw, {
-    content: "",
-    hashtags: [],
-    suggested_media_prompt: "",
-  });
-}
-
-export async function suggestHashtags(
-  content: string,
-  platform: Platform,
-  count: number = 5,
-  provider?: AIProvider
-): Promise<string[]> {
-  const resolved = resolveProvider(provider);
-  const prompt = buildSuggestHashtagsPrompt(content, platform, count);
-
-  const raw = resolved === "openai"
-    ? await callOpenAI(prompt, 200)
-    : await callAnthropic(prompt, 200);
-
-  const parsed = parseJSON<string[]>(raw, []);
-  return Array.isArray(parsed) ? parsed : [];
-}
-
-export async function optimizePost(
-  content: string,
-  platform: Platform,
-  provider?: AIProvider
-): Promise<OptimizedPost> {
-  const resolved = resolveProvider(provider);
-  const prompt = buildOptimizePostPrompt(content, platform);
-
-  const raw = resolved === "openai"
-    ? await callOpenAI(prompt, 600)
-    : await callAnthropic(prompt, 600);
-
-  return parseJSON<OptimizedPost>(raw, {
-    optimized_content: "",
-    improvements: [],
-  });
-}
-
-export async function generateThread(
-  topic: string,
-  tweetCount: number = 5,
-  provider?: AIProvider
-): Promise<string[]> {
-  const resolved = resolveProvider(provider);
-  const prompt = buildGenerateThreadPrompt(topic, tweetCount);
-
-  const raw = resolved === "openai"
-    ? await callOpenAI(prompt, 1500)
-    : await callAnthropic(prompt, 1500);
-
-  const parsed = parseJSON<string[]>(raw, []);
-  return Array.isArray(parsed) ? parsed : [];
-}
-
-export async function repurposePost(
-  content: string,
-  sourcePlatform: Platform,
-  targetPlatform: Platform,
-  provider?: AIProvider
-): Promise<RepurposedPost> {
-  const resolved = resolveProvider(provider);
-  const prompt = buildRepurposePostPrompt(content, sourcePlatform, targetPlatform);
-
-  const raw = resolved === "openai"
-    ? await callOpenAI(prompt, 500)
-    : await callAnthropic(prompt, 500);
-
-  return parseJSON<RepurposedPost>(raw, { content: "" });
-}
-
-// ---- JSON Parser ----
-
-function parseJSON<T>(raw: string, fallback: T): T {
-  const cleaned = raw.replace(/```json\n?/g, "").replace(/```\n?/g, "").trim();
-  try {
-    return JSON.parse(cleaned) as T;
-  } catch {
-    return fallback;
-  }
-}
-
-// ---- Shared AI Callers ----
-
-export async function callOpenAI(prompt: string, maxTokens: number): Promise<string> {
-  const apiKey = process.env["OPENAI_API_KEY"];
-  if (!apiKey) throw new Error("OPENAI_API_KEY is not set");
-
-  const res = await fetch("https://api.openai.com/v1/chat/completions", {
-    method: "POST",
-    headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
-    body: JSON.stringify({
-      model: "gpt-4o-mini",
-      messages: [{ role: "user", content: prompt }],
-      max_tokens: maxTokens,
-      temperature: 0.7,
-    }),
-  });
-
-  if (!res.ok) {
-    const body = await res.text();
-    throw new Error(`OpenAI API error ${res.status}: ${body}`);
-  }
-  const data = (await res.json()) as { choices: Array<{ message: { content: string } }> };
-  return data.choices[0]?.message?.content?.trim() ?? "";
-}
-
-export async function callAnthropic(prompt: string, maxTokens: number): Promise<string> {
-  const apiKey = process.env["ANTHROPIC_API_KEY"];
-  if (!apiKey) throw new Error("ANTHROPIC_API_KEY is not set");
-
-  const res = await fetch("https://api.anthropic.com/v1/messages", {
-    method: "POST",
-    headers: {
-      "x-api-key": apiKey,
-      "anthropic-version": "2023-06-01",
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      model: "claude-haiku-4-5-20251001",
-      max_tokens: maxTokens,
-      messages: [{ role: "user", content: prompt }],
-    }),
-  });
-
-  if (!res.ok) {
-    const body = await res.text();
-    throw new Error(`Anthropic API error ${res.status}: ${body}`);
-  }
-  const data = (await res.json()) as { content: Array<{ type: string; text: string }> };
-  return data.content.find((b) => b.type === "text")?.text?.trim() ?? "";
-}