heyhank 0.1.0 → 0.2.0

package/server/socialmedia/store.ts

@@ -5,16 +5,18 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, unlink
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import type { SocialMediaSettings, SocialPost, ListPostsOpts } from "./types.js";
+import type { SocialMediaSettings, SocialPost, ListPostsOpts, HashtagPool } from "./types.js";
 import { DEFAULT_SOCIAL_SETTINGS } from "./types.js";
 
 const BASE_DIR = join(homedir(), ".heyhank", "socialmedia");
 const SETTINGS_FILE = join(BASE_DIR, "settings.json");
 const POSTS_DIR = join(BASE_DIR, "posts");
+const HASHTAG_POOLS_DIR = join(BASE_DIR, "hashtag-pools");
 
 function ensureDirs(): void {
   if (!existsSync(BASE_DIR)) mkdirSync(BASE_DIR, { recursive: true });
   if (!existsSync(POSTS_DIR)) mkdirSync(POSTS_DIR, { recursive: true });
+  if (!existsSync(HASHTAG_POOLS_DIR)) mkdirSync(HASHTAG_POOLS_DIR, { recursive: true });
 }
 
 // ─── Settings ────────────────────────────────────────────────────────────────
@@ -96,3 +98,51 @@ export function deleteLocalPost(postId: string): boolean {
     return false;
   }
 }
+
+// ─── Hashtag Pools ──────────────────────────────────────────────────────────
+
+export function saveHashtagPool(pool: HashtagPool): void {
+  ensureDirs();
+  if (!pool.id) pool.id = randomUUID();
+  const file = join(HASHTAG_POOLS_DIR, `${pool.id}.json`);
+  writeFileSync(file, JSON.stringify(pool, null, 2), "utf-8");
+}
+
+export function getHashtagPool(poolId: string): HashtagPool | null {
+  const file = join(HASHTAG_POOLS_DIR, `${poolId}.json`);
+  if (!existsSync(file)) return null;
+  try {
+    return JSON.parse(readFileSync(file, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
+export function listHashtagPools(): HashtagPool[] {
+  ensureDirs();
+  try {
+    return readdirSync(HASHTAG_POOLS_DIR)
+      .filter((f) => f.endsWith(".json"))
+      .map((f) => {
+        try {
+          return JSON.parse(readFileSync(join(HASHTAG_POOLS_DIR, f), "utf-8")) as HashtagPool;
+        } catch {
+          return null;
+        }
+      })
+      .filter(Boolean) as HashtagPool[];
+  } catch {
+    return [];
+  }
+}
+
+export function deleteHashtagPool(poolId: string): boolean {
+  const file = join(HASHTAG_POOLS_DIR, `${poolId}.json`);
+  if (!existsSync(file)) return false;
+  try {
+    unlinkSync(file);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/server/socialmedia/types.ts

@@ -1,6 +1,6 @@
 // Social Media Types
 
-export type SocialBackendId = "postiz" | "ayrshare" | "buffer";
+export type SocialBackendId = "postiz" | "buffer";
 
 export type SocialPlatform = "twitter" | "instagram" | "linkedin" | "facebook" | "tiktok" | "threads";
 
@@ -35,7 +35,7 @@ export interface SocialPost {
   platforms: SocialPlatform[];
   scheduledAt?: string | null;
   mediaUrls: string[];
-  status: "published" | "scheduled" | "failed" | "draft";
+  status: "published" | "scheduled" | "failed" | "draft" | "partial" | "archived";
   backendId: SocialBackendId | null;
   backendPostId?: string | null;
   backendData?: unknown;
@@ -74,6 +74,13 @@ export interface SocialMediaSettings {
   backend: SocialBackendId | null;
   backends: Partial<Record<SocialBackendId, SocialBackendConfig>>;
   defaultPlatforms: SocialPlatform[];
+  requireApproval?: boolean;
+  /**
+   * Platforms for which posting should use the BrowserAdapter (persistent
+   * Playwright session via SocialView) instead of the primary backend (Postiz).
+   * v1 supports only "twitter" and "tiktok".
+   */
+  browserPlatforms?: SocialPlatform[];
 }
 
 export interface ListPostsOpts {
@@ -86,4 +93,30 @@ export const DEFAULT_SOCIAL_SETTINGS: SocialMediaSettings = {
   backend: null,
   backends: {},
   defaultPlatforms: [],
+  requireApproval: false,
+  browserPlatforms: [],
 };
+
+// ─── Hashtag Pools ─────────────────────────────────────────────────────────
+
+export interface HashtagPool {
+  id: string;
+  /** Business or brand name (e.g. "Ferienhaus Steiermark") */
+  name: string;
+  /** Industry/niche (e.g. "tourism", "saas", "fashion") */
+  industry: string;
+  /** Language for hashtags (e.g. "de", "en") */
+  language: string;
+  /** High-reach hashtags (>1M posts) */
+  popular: string[];
+  /** Medium-reach hashtags (100K-1M posts) */
+  medium: string[];
+  /** Niche/specific hashtags (<100K posts) */
+  niche: string[];
+  /** Branded hashtags (company-specific) */
+  branded: string[];
+  /** Hashtags to NEVER use (banned, irrelevant, competitor) */
+  blocked: string[];
+  createdAt: string;
+  updatedAt: string;
+}

package/server/socialview/browser-manager.ts

@@ -0,0 +1,150 @@
+// ─── Browser Manager ─────────────────────────────────────────────────────────
+// Manages a headed Chromium per platform, rendered into a shared Xvfb display
+// (:99). Each platform has a persistent user-data-dir so cookies/session
+// survive restarts. User logs in once manually via the noVNC viewer.
+
+import { spawn, type ChildProcess } from "node:child_process";
+import { mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { chromium, type BrowserContext, type Page } from "playwright";
+import { HEYHANK_HOME } from "../paths.js";
+import { PLATFORM_URLS, type SocialPlatform, type SocialViewStatus } from "./types.js";
+
+const DISPLAY = ":99";
+const DISPLAY_WIDTH = 1440;
+const DISPLAY_HEIGHT = 900;
+const PROFILES_DIR = join(HEYHANK_HOME, "browser-profiles");
+
+let xvfbProc: ChildProcess | null = null;
+
+interface Session {
+  platform: SocialPlatform;
+  context: BrowserContext;
+  page: Page;
+  startedAt: number;
+}
+
+const sessions = new Map<SocialPlatform, Session>();
+
+/** Start Xvfb on DISPLAY if not running. Idempotent. */
+async function ensureXvfb(): Promise<void> {
+  if (xvfbProc && !xvfbProc.killed && xvfbProc.exitCode === null) return;
+  // eslint-disable-next-line no-console
+  console.log(`[socialview] starting Xvfb on ${DISPLAY}`);
+  xvfbProc = spawn(
+    "Xvfb",
+    [DISPLAY, "-screen", "0", `${DISPLAY_WIDTH}x${DISPLAY_HEIGHT}x24`, "-ac", "+extension", "RANDR"],
+    { stdio: "ignore", detached: false },
+  );
+  xvfbProc.on("exit", (code) => {
+    // eslint-disable-next-line no-console
+    console.log(`[socialview] Xvfb exited with code ${code}`);
+    xvfbProc = null;
+  });
+  // Give Xvfb a moment to start listening on the display socket.
+  await new Promise((r) => setTimeout(r, 500));
+}
+
+/** Launch a persistent-context Chromium for a platform, navigate to its URL. */
+export async function startPlatform(platform: SocialPlatform): Promise<SocialViewStatus> {
+  const existing = sessions.get(platform);
+  if (existing && !existing.page.isClosed()) {
+    return getStatus(platform);
+  }
+
+  await ensureXvfb();
+
+  mkdirSync(PROFILES_DIR, { recursive: true });
+  const userDataDir = join(PROFILES_DIR, platform);
+  mkdirSync(userDataDir, { recursive: true });
+
+  const context = await chromium.launchPersistentContext(userDataDir, {
+    headless: false,
+    viewport: { width: DISPLAY_WIDTH, height: DISPLAY_HEIGHT },
+    env: { ...process.env, DISPLAY },
+    args: [
+      "--no-sandbox",
+      "--disable-dev-shm-usage",
+      `--window-size=${DISPLAY_WIDTH},${DISPLAY_HEIGHT}`,
+      "--window-position=0,0",
+    ],
+  });
+
+  const page = context.pages()[0] ?? (await context.newPage());
+  await page.goto(PLATFORM_URLS[platform], { waitUntil: "domcontentloaded" }).catch(() => {
+    // Navigation errors are non-fatal; user can manually retry.
+  });
+
+  const session: Session = { platform, context, page, startedAt: Date.now() };
+  sessions.set(platform, session);
+
+  context.on("close", () => {
+    sessions.delete(platform);
+  });
+
+  return getStatus(platform);
+}
+
+export async function stopPlatform(platform: SocialPlatform): Promise<void> {
+  const s = sessions.get(platform);
+  if (!s) return;
+  try {
+    await s.context.close();
+  } finally {
+    sessions.delete(platform);
+  }
+}
+
+export async function gotoUrl(platform: SocialPlatform, url: string): Promise<SocialViewStatus> {
+  const s = sessions.get(platform);
+  if (!s) throw new Error(`Platform ${platform} not running`);
+  await s.page.goto(url, { waitUntil: "domcontentloaded" });
+  return getStatus(platform);
+}
+
+export function getStatus(platform: SocialPlatform): SocialViewStatus {
+  const s = sessions.get(platform);
+  if (!s) {
+    return { platform, running: false, loggedIn: null, currentUrl: null, startedAt: null };
+  }
+  const currentUrl = s.page.isClosed() ? null : s.page.url();
+  // Heuristic: URL contains "login" or "signin" or is root → not logged in
+  const loggedIn =
+    currentUrl === null
+      ? null
+      : !/\/(login|signin|accounts\/login|uas\/login)/i.test(currentUrl);
+  return {
+    platform,
+    running: !s.page.isClosed(),
+    loggedIn,
+    currentUrl,
+    startedAt: s.startedAt,
+  };
+}
+
+/** Returns the live Playwright Page for a running platform, or null. */
+export function getPage(platform: SocialPlatform): Page | null {
+  const s = sessions.get(platform);
+  if (!s || s.page.isClosed()) return null;
+  return s.page;
+}
+
+export function getAllStatus(): SocialViewStatus[] {
+  const platforms: SocialPlatform[] = ["instagram", "twitter", "linkedin", "facebook", "tiktok"];
+  return platforms.map(getStatus);
+}
+
+export function hasProfile(platform: SocialPlatform): boolean {
+  return existsSync(join(PROFILES_DIR, platform));
+}
+
+/** Shut down all browsers + Xvfb. Called on process exit. */
+export async function shutdown(): Promise<void> {
+  for (const p of Array.from(sessions.keys())) {
+    await stopPlatform(p).catch(() => {});
+  }
+  if (xvfbProc && !xvfbProc.killed) {
+    xvfbProc.kill();
+    xvfbProc = null;
+  }
+}