replit.md

Workspace

Overview

pnpm workspace monorepo using TypeScript. Each package manages its own dependencies.

Stack

• Monorepo tool: pnpm workspaces
• Node.js version: 24
• Package manager: pnpm
• TypeScript version: 5.9
• API framework: Express 5
• Database: PostgreSQL + Drizzle ORM
• Validation: Zod (zod/v4), drizzle-zod
• API codegen: Orval (from OpenAPI spec)
• Build: esbuild (CJS bundle)

Key Commands

• pnpm run typecheck — full typecheck across all packages
• pnpm run build — typecheck + build all packages
• pnpm --filter @workspace/api-spec run codegen — regenerate API hooks and Zod schemas from OpenAPI spec
• pnpm --filter @workspace/db run push — push DB schema changes (dev only)
• pnpm --filter @workspace/api-server run dev — run API server locally

See the pnpm-workspace skill for workspace structure, TypeScript setup, and package details.

FB Group Publisher PRO (artifacts/fb-publisher)

Arabic RTL web port of the Chrome extension. Architecture:

• Web app (this artifact): hosts UI, auth, subscriptions, saved lists, all main logic.
• Bridge extension (public/extension/): tiny Chrome extension installed by users; injects a content script on the web app that exposes Facebook cookies and tab scripting via window.postMessage (sources: fbpub-web ↔ fbpub-bridge).
• Auth: Clerk (mandatory). Express uses clerkMiddleware + a proxy from web /api to api-server.
• Payments: PayPal Sandbox subscription, $2.50 every 2 months with 1‑month free trial. Plan auto-created on first subscribe and IDs cached in app_config table.
• DB tables: users, subscriptions, saved_lists, app_config (drizzle).
• Pages: Landing, Sign-in/up, InstallExtension, Subscription, SubscriptionReturn, Publisher.

Chrome Extension — حماية الكود

• الكود المصدري الأصلي محفوظ في: artifacts/fb-publisher/public/extension/src/background.source.js (مُستبعد من Git)
• الكود الموزّع في background.js مُشفّر دائماً باستخدام javascript-obfuscator
• لتعديل الكود: عدّل src/background.source.js ثم شغّل pnpm run obfuscate-extension
• السكريبت: scripts/obfuscate-extension.cjs — يشفّر الكود ويبني ZIP تلقائياً
• التبعية: javascript-obfuscator مثبتة في الجذر (workspace root)